home *** CD-ROM | disk | FTP | other *** search
/ CD Actual 14 / CDACTUAL.iso / cdactual / demobin / share / program / Basic / QSCR20.ZIP / QSCR20.DOC < prev    next >
Encoding:
Text File  |  1988-06-10  |  27.7 KB  |  608 lines
  1.  
  2. ╒═════════════════════════════════════════════════════════════════════════════╕
  3. │ File: QSCR20.DOC               Date: 06-10-88                      Page:  1 │
  4. ╘═════════════════════════════════════════════════════════════════════════════╛
  5.  
  6.   Contents;
  7.  
  8.   Documentation for QSCR20.EXE - Quick Screen Generator Version 2.00
  9.  
  10.   Written By;    - Robert K. Wrenn Jr.
  11.          - 4014A Night Heron Court
  12.          - Waldorf, MD 20601
  13.  
  14.          - Phone: (301) 843-7733
  15.  
  16. ───────────────────────────────────────────────────────────────────────────────
  17.  
  18.   Program Files And Others Included;
  19.  
  20.       QSCR20.DOC - This file...
  21.  
  22.       QSCR20.EXE - Quick Screen Generator Program
  23.          - Version 2.0 Specifications:
  24.          - Size: 78570 Bytes    Date: 06-10-88    Time: 05:22p
  25.          - Written with QuickBASIC Ver 3.0 BASIC Compiler
  26.          - Compiled using BASWIND2 user library written by
  27.          - Dave Evers for the slick window routines.
  28.  
  29.       COLORS.SCR - Contains color scheme for binary screen saves and loads
  30.          - Updated with current colors when a binary screen is saved
  31.          - Read for previous colors when a binary screen is loaded
  32.  
  33.       SCREEN.BIN - Sample binary screen to play around with.
  34.  
  35. ───────────────────────────────────────────────────────────────────────────────
  36.  
  37.   Files created by QSCR20.EXE;
  38.  
  39.     filename.QBS - QuickBASIC subroutine using GOSUB/RETURN commands
  40.  
  41.     filename.QBC - QuickBASIC subroutine using SUB/ENDSUB and CALL commands
  42.  
  43.     filename.BAS - Interpreter BASIC subroutine using GOSUB/RETURN commands
  44.  
  45.     filename.BIN - Binary screen file using the BLOAD/BSAVE commands
  46.  
  47.   Where 'filename' is any legal DOS filename 1-8 characters, the QBS, QBC,
  48.   BAS, and BIN extensions are added to the routine 'filename' by QSCR20.EXE.
  49.   The file is a copy of the entire screen in various forms which may be used
  50.   in other programs.
  51.  
  52.  
  53. ╒═════════════════════════════════════════════════════════════════════════════╕
  54. │ File: QSCR20.DOC               Date: 06-10-88                      Page:  2 │
  55. ╘═════════════════════════════════════════════════════════════════════════════╛
  56.  
  57.   Yet another screen program...
  58.  
  59.   In fiddling with several screen draw/save type programs I saw the need for
  60.   something quick and easy. There is some pretty heavy code in both the
  61.   public and private sectors for drawing and manipulating screen/visual data.
  62.   However, everyone has something that everyone else wants. In other words,
  63.   'some' programs have features which make them nice, but are lacking in areas
  64.   that 'other' programs handle very strongly. These 'other' programs lack the
  65.   features which make the 'some' programs strong. So, you are into 2 and 3
  66.   different programs just to get 'all' of the features you require, messing
  67.   around, forgetting which command is which, etc. I needed something fast,
  68.   with a small group of commands to let me easily draw and save screens for
  69.   use in my BASIC programming projects. This program incorporates 'just' the
  70.   features that I need the most in one place, and, at one time.
  71.  
  72.   Revision History;
  73.  
  74.   This program was developed on an AT&T PC6300 with 640k RAM and a 20 Mb
  75.   fixed-disk, using the AT&T 640x400 monochrome monitor. This monitor is
  76.   CGA color compatible and displays colors as 16 shades of green. The
  77.   GWBASIC interpreter program was used as the first tool used for initial
  78.   development. All source code was then moved over to the QuickBASIC compiler
  79.   system to take full advantage of the structured and highly-ordered
  80.   environment that was offered. As a result the program code was basically,
  81.   pardon the pun, re-written a 'bit' at a time, ha. When I was satisfied with
  82.   the interactive interface I released QSCR10.EXE to the public domain. For
  83.   reference, the naming conventions are as outlined;
  84.  
  85.                QSCRvr.ARC           where   v = version#   (1..9)
  86.                ||                       r = release#   (0..9)
  87.          version# /  \ release#
  88.  
  89.   Date: 01-01-87 - SCRNGEN.BAS - coded in standard BASIC and unreleased to
  90.   the public sector. Used as basis for QSCRxx development.
  91.  
  92.   Date: 01-01-88 - QSCR10.EXE - first version and initial release of
  93.   QuickScreen drawing program.
  94.  
  95.   Date: 06-01-88 - QSCR20.EXE - This release supersedes QSCR10.EXE. I felt
  96.   a new version number was necessary rather than a different release number
  97.   as many enhancements have been made to the source code.
  98.  
  99.  
  100. ╒═════════════════════════════════════════════════════════════════════════════╕
  101. │ File: QSCR20.DOC               Date: 06-10-88                      Page:  3 │
  102. ╘═════════════════════════════════════════════════════════════════════════════╛
  103.  
  104.   QSCR20.EXE - Additions And Revisions:
  105.  
  106.   A few small bugs have bitten the dust as well as some new features have
  107.   been added, as follows;
  108.  
  109.   ] The box draw routine has been enhanced.
  110.  
  111.   ] Windows used in most other functions called a subroutine to actually draw
  112.     the window. This was error-prone and produced strange side effects if the
  113.     operator changed his/her mind in midstream. All functions now have their
  114.     own window call with constants rather than variables in a subroutine.
  115.     This has improved the speed at which the windows are drawn and removed.
  116.  
  117.   ] Command line handling of screen retrace test as been added. Screen
  118.     retrace is tested for by default. If you desire to disable the retrace
  119.     feature enter: 'QSCR20 1'. The '1' in the command line will disable the
  120.     screen retrace feature. Any other value, or no value, will enable screen
  121.     retrace and eliminate any 'snow' encountered when windows are drawn.
  122.     When testing for retrace is disabled windows can be drawn slightly faster.
  123.  
  124.   ] ALT-F1 through ALT-F4 will no immediately select one of the four
  125.     predefined function key sets as seen with the ALT-F keypress.
  126.  
  127.   ] ALT-N - new screen function has been added.
  128.  
  129.   ] ALT-P - Pen character selection has been added. Use ALT-P to define the
  130.     current pen character and use the INSERT key to toggle the pen up or down.
  131.  
  132.   ] The delete key has been enabled and will delete one (1) character to
  133.     the left of the cursor.
  134.  
  135.   ] Status line #24 has been modifed to display new program status
  136.     flags and indicators.
  137.  
  138.   ] ALT-H - Help screen has been modified slightly for ALT-Fn function key
  139.     description.
  140.  
  141.   ] Ability to generate program code for QuickBASIC GOSUB/RETURN and
  142.     SUB/ENDSUB, as well as Interpreter BASIC with line numbers.
  143.  
  144.   ] All File, (ALT-L/ALT-W/ALT-G), options now prompt for a file name.
  145.  
  146.   ] Monochrome operation is now supported.
  147.  
  148.   ] Various IF-THEN logic has been optimized for faster execution.
  149.  
  150.   ] Program documentation has been revised.
  151.  
  152.   ] Error trapping is now provided. In the event of unrecoverable error the
  153.     program will display a warning massage and error number. Please note this
  154.     number as it will aid in tracking those nasty little program logic bugs,
  155.     (rapidus bombus), and thus ensuring their inevitable demise and speedy
  156.     deliverance to null state - binary heaven...
  157.  
  158.  
  159. ╒═════════════════════════════════════════════════════════════════════════════╕
  160. │ File: QSCR20.DOC               Date: 06-10-88                      Page:  4 │
  161. ╘═════════════════════════════════════════════════════════════════════════════╛
  162.  
  163.   Upon execution the screen will be blank with the status lines present in
  164.   rows 23-25. The cursor is in the home position, (row 1, column 1).
  165.  
  166.   Status Line Display Description;
  167.  
  168.   line# 23 messages go here...
  169.   Row[ 1] Col[ 1] Mode[Curs] Fore[ 7] Back[ 0] Pen [Up] Chr[ ] Val[ 32]   Alt-H
  170.   F1 ┌ │ F2 ┐ │ F3 └ │ F4 ┘ │ F5 │ │ F6 ─ │ F7 ├ │ F8 ┤ │ F9 ┬ │ F10 ┴ │   Help
  171.  
  172.   Line# 23   - reserved for various messages to aid in program operation
  173.  
  174.   Line# 24   - contains the following information:
  175.   Row[xx]    - current cursor row position
  176.   Col[yy]    - current cursor column position
  177.   Mode[xxxx] - Curs = cursor movement
  178.          - Text = enable keyboard for text and function keys
  179.              - Box  = box drawing
  180.   Fore[nn]   - current foreground color
  181.   Back[nn]   - current background color
  182.   Pen[xx]    - current pen status
  183.              - Up = pen up, cursor behaves normally
  184.          - Dn = pen down, pen character printed wherever cursor goes
  185.   Chr[x]     - current pen character, initially set to space
  186.   Val[nnn]   - current pen character value, initially set to space
  187.  
  188.   Line# 25   - F1 through F10 current function key assignments
  189.          - enabled in Text mode
  190.          - instantly changeable with ALT-F1 through ALT-F4
  191.  
  192. ───────────────────────────────────────────────────────────────────────────────
  193.  
  194.   Pressing ALT-H will display a help window with all program commands;
  195.  
  196.     ╒[ Help ]════════════════════════════════════════╕
  197.     │ ALT-B  >  Box Mode - Draw Various Sizes/Styles │
  198.     │ ALT-C  >  Change Video Display Color Scheme    │
  199.     │ ALT-D  >  Delete Current Line                  │
  200.     │ ALT-F  >  Function Key Assignments Menu        │  ╔[ Help ]═════════════╗
  201.     │ ALT-G  >  Generate Program Code Menu           │  ║ ALT-F1 > ┌┐└┘│─├┤┬┴ ║
  202.     │ ALT-H  >  Help Window - This Window...         │  ║ ALT-F2 > ╔╗╚╝║═╠╣╦╩ ║
  203.     │ ALT-L  >  Load Binary Screen                   │  ║ ALT-F3 > ╓╖╙╜║─╟╢╥╨ ║
  204.     │ ALT-N  >  New Screen                           │  ║ ALT-F4 > ╒╕╘╛│═╞╡╤╧ ║
  205.     │ ALT-P  >  Pen Character Change                 │  ╚═════════════════════╝
  206.     │ ALT-R  >  Restore Line Stored In Buffer        │
  207.     │ ALT-S  >  Store Current Line In Buffer         │
  208.     │ ALT-T  >  Text Mode - Enable Keyboard          │
  209.     │ ALT-W  >  Write Binary Screen                  │
  210.     │ ALT-X  >  eXit This Program                    │
  211.     ╘════════════════════════════════════════════════╛
  212.  
  213.   Command description detail is outlined in the following pages.
  214.  
  215.  
  216. ╒═════════════════════════════════════════════════════════════════════════════╕
  217. │ File: QSCR20.DOC               Date: 06-10-88                      Page:  5 │
  218. ╘═════════════════════════════════════════════════════════════════════════════╛
  219.  
  220.   COMMAND SUMMARY;
  221.  
  222.   ALT-B - Box Mode:
  223.   This choice allows creation of boxes in one of four frame styles.
  224.   First, move the cursor to the upper-left corner of the box position and
  225.   press ALT-B. A dot character will appear as visual reference.
  226.   Line# 23 will prompt as follows;
  227.  
  228.   BOX MODE - Move To Lower-Right Corner And Press [ALT-B] Again To Mark
  229.   Row[ 1] Col[ 1] Mode[Curs] Fore[ 7] Back[ 0] Pen [Up] Chr[ ] Val[ 32]   Alt-H
  230.   F1 ┌ │ F2 ┐ │ F3 └ │ F4 ┘ │ F5 │ │ F6 ─ │ F7 ├ │ F8 ┤ │ F9 ┬ │ F10 ┴ │   Help
  231.  
  232.   Next, move the cursor to the lower-right corner of the box and press ALT-B
  233.   again and the dot character will appear. Line# 23 will then prompt for a
  234.   box label;
  235.  
  236.   [∙∙∙∙∙∙∙]
  237.   You May Enter Up To [ 7] Characters - Hit [RETURN] For No Label
  238.   F1 ┌ │ F2 ┐ │ F3 └ │ F4 ┘ │ F5 │ │ F6 ─ │ F7 ├ │ F8 ┤ │ F9 ┬ │ F10 ┴ │
  239.  
  240.   Enter any text between the brackets or press [RETURN] for no label.
  241.   Use the [BACKSPACE] key to correct any typing mistakes. Press [RETURN]
  242.   when done and the box will appear.
  243.  
  244.   Notes: Boxes overwrite the entire area underneath. This includes borders
  245.          and all space between.
  246.  
  247.          There are 4 frame styles available. The current frame style is the
  248.          same as the function current function key assignments. However, if
  249.          a custom function key set is defined then the default frame style
  250.          is the most recent frame style 1 through 4. See note concerning
  251.          frame styles in the function key assignments section.
  252.  
  253.      Movement is not necessarily limited to the lower-right corner of
  254.      the box. If movement is inverted, ie to upper left corner, the box
  255.      coordinates are inverted accordingly.
  256.  
  257.   ALT-C - Change Video Display Color Scheme:
  258.   This choice permits changing the current foreground and background colors.
  259.   Use the up/down arrow keys to increment/decrement the current selection.
  260.   The color will change interactively as the number changes. Use the [RETURN]
  261.   or the [TAB] key to move between 'Fore' and 'Back' input areas. Hit [ESC]
  262.   to quit, this will make the new 'Fore' and 'Back' color selections the
  263.   current colors. A Sample window;
  264.  
  265.     ╒[ Change Display Colors ]═══╕
  266.     │                            │
  267.     │  Current Color Selection:  │
  268.     │                            │
  269.     │     Fore[ 7]  Back[ 0]     │
  270.     │                            │
  271.     │     Hit [ESC] To Exit      │
  272.     │                            │
  273.     ╘════════════════════════════╛
  274.  
  275.  
  276. ╒═════════════════════════════════════════════════════════════════════════════╕
  277. │ File: QSCR20.DOC               Date: 06-10-88                      Page:  6 │
  278. ╘═════════════════════════════════════════════════════════════════════════════╛
  279.  
  280.   ALT-D - Delete Current Line:
  281.   This choice clears the current row to blanks in the current color scheme.
  282.  
  283.   ALT-F - Change Function Key Assignments:
  284.   This choice allows re-assigning the function keys with different values.
  285.   There are four complete sets shown and a custom set is available. Key sets
  286.   1 through 4 determine which of the 4 different box frame styles will be
  287.   used. When the custom function key set is active, the default frame style
  288.   will be function key set to the legal frame style which was most recently
  289.   active. A sample window is shown below;
  290.  
  291.     ╒[ Function Key Sets ]══════════╕
  292.     │                               │
  293.     │  1 >  ┌ ┐ └ ┘ │ ─ ├ ┤ ┬ ┴     │     Please Note:
  294.     │                               │
  295.     │  2 >  ╔ ╗ ╚ ╝ ║ ═ ╠ ╣ ╦ ╩     │     Some printers print key sets 2-4
  296.     │                               │
  297.     │  3 >  ╓ ╖ ╙ ╜ ║ ─ ╟ ╢ ╥ ╨     │     the same as key set 1.
  298.     │                               │
  299.     │  4 >  ╒ ╕ ╘ ╛ │ ═ ╞ ╡ ╤ ╧     │
  300.     │                               │
  301.     │  5 >  Custom Function Key Set │
  302.     │                               │
  303.     │ Enter 1-5 Or [RETURN] To Quit │
  304.     │                               │
  305.     │ Your Choice [ ]               │
  306.     ╘═══════════════════════════════╛
  307.  
  308.   Choice 5 displays the entire character set available with the unprintable
  309.   characters as a period '.'. Use the cursor keys to move around and press
  310.   [RETURN] to select and load the function key. Loaded keys are displayed in
  311.   a different color to indicate they have been changed. The current key number
  312.   is noted in the lower left corner of the character set window. Pressing the
  313.   [SPACEBAR] will advance the key number without any changes. When finished,
  314.   press [ESC] to exit with the new character set. When ALT-F is chosen again
  315.   the new set, or the most recent legal set, will be displayed in choice 5.
  316.  
  317.   Notes: I chose not to include the character set window in this text as the
  318.      characters 0-31 act as printer control codes and wreak havoc when
  319.      dumped to the line printer.
  320.  
  321.      ALT-F1 through ALT-F4 keys instantly select predefined keyset
  322.      1 through 4 respectively. This will also reset the current
  323.      frame style to the new function keyset.
  324.  
  325.  
  326. ╒═════════════════════════════════════════════════════════════════════════════╕
  327. │ File: QSCR20.DOC               Date: 06-10-88                      Page:  7 │
  328. ╘═════════════════════════════════════════════════════════════════════════════╛
  329.  
  330.   ALT-G - Generate Program Code:
  331.   This choice allows the current screen to be copied in an ASCII file with
  332.   the appropriate language statements for various BASIC calls. The selection
  333.   menu is shown below;
  334.  
  335.     ╒[ Generate Code ]══════════════╕
  336.     │                               │
  337.     │ 1 > QuickBASIC Subroutine     │
  338.     │                               │
  339.     │ 2 > QuickBASIC Call           │
  340.     │                               │
  341.     │ 3 > Interpreter BASIC         │
  342.     │                               │
  343.     │ Enter 1-3 Or [RETURN] To Quit │
  344.     │                               │
  345.     │ Your Choice [ ]               │
  346.     ╘═══════════════════════════════╛
  347.  
  348.   Line #23 message area will display helpful remarks;
  349.  
  350.   1 > GOSUB/RETURN   │ 2 > SUB/ENDSUB     │ 3 > BASIC   │ [RETURN] > EXIT
  351.   Row[ 5] Col[ 1] Mode[Curs] Fore[ 7] Back[ 0] Pen [Up] Chr[ ] Val[ 32]   Alt-H
  352.   F1 ┌ │ F2 ┐ │ F3 └ │ F4 ┘ │ F5 │ │ F6 ─ │ F7 ├ │ F8 ┤ │ F9 ┬ │ F10 ┴ │   Help
  353.  
  354.   Type the number of your choice. Choice 1 will produce QuickBASIC code for
  355.   the GOSUB/RETURN procedure. Choice 2 will produce QuickBASIC code for the
  356.   SUB/ENDSUB procedure along with the CALL statement needed to perform the
  357.   procedure. Choice 3 will produce interpreted BASIC code for the GOSUB/RETURN
  358.   procedure and will contain line numbers. At this point type a number and
  359.   press [RETURN] or just press [RETURN] with no entry to quit or exit without
  360.   code generation. Upon reciept of a valid choice, Line #23 will prompt for a
  361.   file name (1-8 characters). Enter the file name or press [RETURN] to exit
  362.   without code generation. File naming conventions are shown below;
  363.  
  364.     filename.QBS - QuickBASIC subroutine using GOSUB/RETURN commands
  365.  
  366.     filename.QBC - QuickBASIC subroutine using SUB/ENDSUB and CALL commands
  367.  
  368.     filename.BAS - Interpreter BASIC subroutine using GOSUB/RETURN commands
  369.  
  370.     filename.BIN - Binary screen file using the BLOAD/BSAVE commands
  371.  
  372.   Where 'filename' is any legal DOS filename 1-8 characters, the QBS, QBC,
  373.   BAS, and BIN extensions are added to the routine 'filename' by QSCR20.EXE.
  374.   The file is a copy of the entire screen in various forms which may be used
  375.   in other programs. Use a text editor and merge the modules in with other
  376.   programs. The DOS command COPY may also be used to merge modules together.
  377.   Consult your DOS manual for the use of the COPY command and concatenation
  378.   of files.
  379.  
  380.  
  381. ╒═════════════════════════════════════════════════════════════════════════════╕
  382. │ File: QSCR20.DOC               Date: 06-10-88                      Page:  8 │
  383. ╘═════════════════════════════════════════════════════════════════════════════╛
  384.  
  385.   ALT-L - Load Binary Screen:
  386.   Line #23 will prompt for a filename, (1-8 characters), the extension 'BIN'
  387.   is supplied to the filename. 'BIN' indicates 'Binary File', meaning, use
  388.   the BLOAD-BSAVE commands to manipulate the data. This choice allows the
  389.   current screen to be saved along with the current color scheme for later
  390.   recall. The screens are saved in a binary format and are usable from BASIC
  391.   in this form too. Please refer to appendix A example 1 on loading binary
  392.   screens for sample code.
  393.  
  394.   ALT-N - New screen:
  395.   This choice will clear the screen to spaces in the current color scheme.
  396.  
  397.   ALT-P - Pen character change:
  398.   This choice permits re-assigning the pen character value. When the pen is
  399.   down this character will be printed wherever the cursor goes. When invoked,
  400.   the character set window is displayed as with the ALT-F function key custom
  401.   key set. Move cursor with the arrow keys and press [RETURN] to select the
  402.   character of choice. Press [ESC] to exit the character set window. Use the
  403.   INSERT key to toggle the pen up and down. When the pen is down, the current
  404.   pen character will printed wherever the cursor goes. When the pen is up,
  405.   the cursor behaves as normal. Also, the cursor will shrink to denote the
  406.   pen is down and the status line will contain the current pen character
  407.   value and status.
  408.  
  409.   Notes: This is similar to defining a custom function keyset, however, only
  410.      one character is selected. For the same reasons noted in the ALT-F
  411.      description I did not include the input window in this text.
  412.  
  413.   ALT-R - Restore Line Stored In Buffer:
  414.   This choice restores the row saved with ALT-S to the current row erasing
  415.   the old line.
  416.  
  417.   ALT-S - Store Current Line In Buffer:
  418.   This choice saves the current row for later recall with ALT-R.
  419.  
  420.   ALT-T - Text Mode - Enable Keyboard:
  421.   This choice allows normal text and function key entry.
  422.  
  423.   ALT-W - Write Binary Screen:
  424.   Line #23 will prompt for a filename, (1-8 characters), the extension 'BIN'
  425.   is supplied to the filename. 'BIN' indicates 'Binary File', meaning, use
  426.   the BLOAD-BSAVE commands to manipulate the data. This choice writes the
  427.   current display lines 1-22, columns 1-80 in a binary file for later recall.
  428.   Please refer to appendix A example 2 for saving binary screens for sample
  429.   code.
  430.  
  431.   ALT-X - Exit This Program:
  432.   This choice exits the program. Line# 23 prompts for 'Y' or 'N' in case
  433.   the selection was inadvertent.
  434.  
  435.  
  436. ╒═════════════════════════════════════════════════════════════════════════════╕
  437. │ File: QSCR20.DOC               Date: 06-10-88                      Page:  9 │
  438. ╘═════════════════════════════════════════════════════════════════════════════╛
  439.  
  440.   Written By:                Robert K. Wrenn Jr.
  441.                              4014A Night Heron Court
  442.                              Waldorf, MD 20601
  443.  
  444.                              Phone: (301) 843-7733
  445.  
  446.   Please feel free to copy this program and give it to everyone you know.
  447.   I am not out for any huge returns for this program, however if you feel
  448.   that future revisions and other straight-forward utility programs pique
  449.   your interest, call or drop me a letter expressing your thoughts. Any
  450.   comments, criticisms, suggestions are all appreciated. I am also keeping
  451.   a database of names and addresses of registered users whom I will get back
  452.   to by mail with the advent of new revisions or releases of software. Users
  453.   will receive a short description of the software and the names and numbers
  454.   of all local BBS's I plan to try to upload to. Users who contribute $10.00
  455.   or more will receive the new software and documentation on diskette.
  456.  
  457. ───────────────────────────────────────────────────────────────────────────────
  458.  
  459.   Future enhancements and wish list:
  460.  
  461.   01) Response from the user community greatly affects project direction.
  462.  
  463.   02) Add capability to generate full color ANSI.SYS compatible screens.
  464.  
  465.   03) Variable default frame styles when the custom key set is active.
  466.  
  467.   04) Tighten up delete key operations.
  468.  
  469.   05) Add more values to the ALT-Fn keypress sequence.
  470.  
  471.   06) Tighten ALT-F function key definition operations.
  472.  
  473.   07) Continue to refine and optimize program code.
  474.  
  475.  
  476. ╒═════════════════════════════════════════════════════════════════════════════╕
  477. │ File: QSCR20.DOC               Date: 06-10-88                      Page: 10 │
  478. ╘═════════════════════════════════════════════════════════════════════════════╛
  479.  
  480.   Appendix A - Loading and Saving Binary Screens:
  481.  
  482. ───────────────────────────────────────────────────────────────────────────────
  483.  
  484.   1) Loading a Binary Screen using QuickBASIC;
  485.  
  486.                   :' define variables
  487.     pagbas=&hb800             :' video buffer base address for color monitors
  488.                   :' use &hb000 for monochrome monitors
  489.     offset=&h0000             :' starting byte to be loaded
  490.  
  491.                   :' load screen
  492.     def seg=pagbas            :' set segment pointer to video buffer
  493.     bload "screen.bin",offset :' read binary file into buffer at byte 0
  494.     def seg                   :' reset segment pointer
  495.  
  496.   The color scheme of the binary screen is saved in the file COLORS.SCR and
  497.   can be accessed as follows in QuickBASIC:
  498.  
  499.                   :' get screen colors
  500.     open "i",#1,"colors.scr"  :' open for sequential read
  501.     input#1,fore%,back%       :' read foreground and background values
  502.     close#1                   :' close file
  503.     color fore%,back%         :' set color scheme
  504.  
  505.   Notes: The file COLORS.SCR need not be used as you may set any color scheme
  506.      you wish. COLORS.SCR is updated each time the ALT-W option is used.
  507.  
  508. ───────────────────────────────────────────────────────────────────────────────
  509.  
  510.   2) Saving a Binary Screen using QuickBASIC;
  511.  
  512.                   :' Define variables
  513.     pagbas=&hb800             :' video buffer base address for color monitors
  514.                   :' Use &hb000 for monochrome monitors
  515.     paglen=&h0dc0             :' number of lines to save to disk (22)
  516.     offset=&h0000             :' starting byte to be saved
  517.  
  518.                      :' save screen
  519.     def seg=pagbas                   :' set segment pointer to video buffer
  520.     bsave "screen.bin",offset,paglen :' save binary file to disk
  521.     def seg                          :' reset segment pointer
  522.  
  523.   The color scheme of the binary is saved in the file COLORS.SCR as follows
  524.   in QuickBASIC:
  525.                   :' save current colors
  526.     open "o",#1,"colors.scr"  :' open for sequential write
  527.     print#1,fore%;",";back%   :' write foreground and background values
  528.     close#1                   :' close file
  529.  
  530.   Notes: The above methods work with interpreter BASIC as well.
  531.  
  532.  
  533. ╒═════════════════════════════════════════════════════════════════════════════╕
  534. │ File: QSCR20.DOC               Date: 06-10-88                      Page: 11 │
  535. ╘═════════════════════════════════════════════════════════════════════════════╛
  536.  
  537.   Appendix B - Quick Reference Command Card Cut-Outs:
  538.  
  539. ───────────────────────────────────────────────────────────────────────────────
  540.  
  541.   ╒════════════════════════════════════════════════╕  QSCR20.EXE ver 2.0
  542.   │ ALT-B  >  Box Mode - Draw Various Sizes/Styles │  Quick Reference Card
  543.   │ ALT-C  >  Change Video Display Color Scheme    │  IBM print mode
  544.   │ ALT-D  >  Delete Current Line                  │
  545.   │ ALT-F  >  Function Key Assignments Menu        │  ╔═════════════════════╗
  546.   │ ALT-G  >  Generate Program Code Menu           │  ║ ALT-F1 > ┌┐└┘│─├┤┬┴ ║
  547.   │ ALT-H  >  Help Window - This Window...         │  ║ ALT-F2 > ╔╗╚╝║═╠╣╦╩ ║
  548.   │ ALT-L  >  Load Binary Screen                   │  ║ ALT-F3 > ╓╖╙╜║─╟╢╥╨ ║
  549.   │ ALT-N  >  New Screen                           │  ║ ALT-F4 > ╒╕╘╛│═╞╡╤╧ ║
  550.   │ ALT-P  >  Pen Character Change                 │  ╚═════════════════════╝
  551.   │ ALT-R  >  Restore Line Stored In Buffer        │
  552.   │ ALT-S  >  Store Current Line In Buffer         │
  553.   │ ALT-T  >  Text Mode - Enable Keyboard          │
  554.   │ ALT-W  >  Write Binary Screen                  │
  555.   │ ALT-X  >  eXit This Program                    │
  556.   ╘════════════════════════════════════════════════╛
  557.  
  558. ───────────────────────────────────────────────────────────────────────────────
  559.  
  560.   +[ Help ]----------------------------------------+  QSCR20.EXE ver 2.0
  561.   | ALT-B  >  Box Mode - Draw Various Sizes/Styles |  Quick Reference Card
  562.   | ALT-C  >  Change Video Display Color Scheme    |  ASCII print mode
  563.   | ALT-D  >  Delete Current Line                  |
  564.   | ALT-F  >  Function Key Assignments Menu        |  +--------------------+
  565.   | ALT-G  >  Generate Program Code Menu           |  | ALT-F1 > Key Set 1 |
  566.   | ALT-H  >  Help Window - This Window...         |  | ALT-F2 > Key Set 2 |
  567.   | ALT-L  >  Load Binary Screen                   |  | ALT-F3 > Key Set 3 |
  568.   | ALT-N  >  New Screen                           |  | ALT-F4 > Key Set 4 |
  569.   | ALT-P  >  Pen Character Change                 |  +--------------------+
  570.   | ALT-R  >  Restore Line Stored In Buffer        |
  571.   | ALT-S  >  Store Current Line In Buffer         |
  572.   | ALT-T  >  Text Mode - Enable Keyboard          |
  573.   | ALT-W  >  Write Binary Screen                  |
  574.   | ALT-X  >  eXit This Program                    |
  575.   +------------------------------------------------+
  576.  
  577.  
  578. ╒═════════════════════════════════════════════════════════════════════════════╕
  579. │ File: QSCR20.DOC               Date: 06-10-88                      Page: 12 │
  580. ╘═════════════════════════════════════════════════════════════════════════════╛
  581.  
  582.   Appendix C - Table Of Contents:
  583.  
  584. ───────────────────────────────────────────────────────────────────────────────
  585.  
  586.   Page  01 ............. Cover Letter and Files Description
  587.  
  588.   Page  02 ............. Personal Insights and Revision History
  589.  
  590.   Page  03 ............. Additions and Revisions List
  591.  
  592.   Page  04 ............. Initial Functional Description and Help Screen
  593.  
  594.   Pages 05-08 .......... Command Summary
  595.  
  596.   Page  09 ............. Closing Comments and Wish List
  597.  
  598.   Page  10 ............. Appendix A - Loading and Saving Binary Screens
  599.  
  600.   Page  11 ............. Appendix B - Quick Reference Command Card Cut-Outs
  601.  
  602.   Page  12 ............. Appendix C - Table Of Contents (this page)
  603.  
  604.  
  605.  
  606.   {eof QSCR20.DOC}
  607.  
  608.