home *** CD-ROM | disk | FTP | other *** search
/ Frostbyte's 1980s DOS Shareware Collection / floppyshareware.zip / floppyshareware / USCX / DOSUT-17.ZIP / SCR.TXT < prev    next >
Text File  |  1987-01-15  |  29KB  |  859 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.                                                      tm    
  16.                           T I Y L I   S O F T W A R E
  17.  
  18.                               is proud to present
  19.  
  20.                   +----------------------------------------+
  21.                   |         The Screen Image Editor        |
  22.                   |                                        |
  23.                   |            and Batch Utility           |
  24.                   |                                        |
  25.                   |                   by                   |
  26.                   |         Frank M. Ramaekers Jr.         |
  27.                   +----------------------------------------+
  28.             (c) Copyright 1984-86 "Try-It-You'll-Like-It" Software
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61. (c) Copyright 1984-86 Frank M. Ramaekers Jr.          User-supported Software
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. 12/20/86          Screen Image Editor and Batch Utility V2.1f           Page i
  71.  
  72. Table of Contents:
  73.  
  74. 0.0  The User-supported Concept . . . . . . . . . . . . . . . . . . . . . .  1
  75.  
  76. 1.0  Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  1
  77.      1.1  Overview  . . . . . . . . . . . . . . . . . . . . . . . . . . . .  1
  78.      1.2  The Screen Image Editor . . . . . . . . . . . . . . . . . . . . .  1
  79.      1.3  The Batch Utility . . . . . . . . . . . . . . . . . . . . . . . .  2
  80.      1.4  Minimum Requirements  . . . . . . . . . . . . . . . . . . . . . .  2
  81.  
  82. 2.0  Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  2
  83.      2.1  The Screen Image Editor . . . . . . . . . . . . . . . . . . . . .  2
  84.           2.1.1  Function Key Assignments . . . . . . . . . . . . . . . . .  2
  85.           2.1.2  Alternate Function Key Assignments . . . . . . . . . . . .  3
  86.           2.1.3  Shift Function Key Assignment  . . . . . . . . . . . . . .  3
  87.           2.1.4  Control Key Assignments  . . . . . . . . . . . . . . . . .  4
  88.           2.1.5  Special Key Assignments  . . . . . . . . . . . . . . . . .  4
  89.           2.1.6  Alternate Key Assignments  . . . . . . . . . . . . . . . .  5
  90.           2.1.7  Graphic Keyboard Layout  . . . . . . . . . . . . . . . . .  5
  91.           2.1.8  Line 25 Information  . . . . . . . . . . . . . . . . . . .  5
  92.           2.1.9  Color Chart  . . . . . . . . . . . . . . . . . . . . . . .  5
  93.      2.2  The Batch Utility . . . . . . . . . . . . . . . . . . . . . . . .  6
  94.           2.2.1  Command Format . . . . . . . . . . . . . . . . . . . . . .  6
  95.           2.2.2  Examples . . . . . . . . . . . . . . . . . . . . . . . . .  7
  96.           2.2.3  A Batch File Example . . . . . . . . . . . . . . . . . . .  8
  97.      2.3  The Conversion Utility  . . . . . . . . . . . . . . . . . . . . .  9
  98.      2.4  The Programming Languages Interfaces  . . . . . . . . . . . . . . 10
  99.           2.4.1  The Clipper Interface (SCRCLIPR.OBJ) . . . . . . . . . . . 10
  100.           2.4.2  The COBOL Interface (SCRCOB.OBJ) . . . . . . . . . . . . . 10
  101.           2.4.3  The dBASE III+ Interface (SCRDBASE.BIN)  . . . . . . . . . 10
  102.           2.4.4  The QuickBASIC Interface (SCRQBAS.OBJ) . . . . . . . . . . 10
  103.  
  104. 3.0  Registration Form  . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127. (c) Copyright 1984-86 Frank M. Ramaekers Jr.          User-supported Software
  128.  
  129.  
  130.  
  131.  
  132.  
  133. 12/20/86         Screen Image Editor and Batch Utility V2.1f           Page 1
  134.  
  135.  
  136. 0.0     The User-supported Concept
  137. ----------------------------------
  138.  
  139.      This product is distributed on a basis that the product will sell itself.  
  140. This reduces advertising, distribution, and copy-protection costs.  This means 
  141. that you can copy and share this program with others,  on the conditions  that 
  142. the  program  is  not distributed in modified form and that no  fee  or  other 
  143. consideration  is  charged.   The  only thing I ask is that if you  find  this 
  144. product  of  value,  please send a donation ($24 suggested) to  the  following 
  145. address:
  146.  
  147.         Frank M. Ramaekers Jr.
  148.         4614 Arapahoe Tr.
  149.         Austin, Texas  78745
  150.  
  151.      Your contribution entitles you to the following:
  152.  
  153.           1)   The latest version of this system.  Which will be mailed to you  
  154.                upon receipt of your donation.
  155.           2)   When  a new version is available,  you will be  notified.   You 
  156.                will then have the option of sending your original (with return 
  157.                postage) for this new version.
  158.           3)   You will also be notified of future products.
  159.           4)   Responses to questions, complaints or problems that you send in.
  160.  
  161.  
  162. 1.0  Introduction
  163. --------------------
  164.  
  165. 1.1  Overview
  166. -------------
  167.      The  Screen  Image processing system was created to  assist  in  creating 
  168. menus  and  help  screens.   Current DOS batch commands (e.g.  ECHO  and  REM) 
  169. provide only line-by-line creation of a screen image that was extremely  slow.  
  170. Also,  these  batch  files were very tedious to edit,  especially  if  graphic 
  171. characters  were used.   In addition,  neither command provides for  attribute 
  172. selection.  Plus, DOS makes no provisions for keyboard input to facilitate the 
  173. selection  process.  The SCREDIT.COM program provides a method of  retrieving, 
  174. editing  and  saving  screen  images  that  can  be  used  in  a  batch  file.  
  175. SCRBATCH.COM  was created to display the screen image and optionally accept  a 
  176. response  from the keyboard and set the ERRORLEVEL (so it can be tested  using 
  177. the IF batch subcommand).
  178.  
  179. 1.2  The Screen Image Editor
  180. ----------------------------
  181.      The  Screen Image Editor is a utility by which users can maintain  screen 
  182. images.   Screen images can be loaded,  edited, and saved.  Most of the common 
  183. graphic characters are easily accessable through the keyboard and are arranged 
  184. in a conevient layout.   All the major editing functions are incorporated into 
  185. this editor. In addition, the editor allows full utilization of all attributes 
  186. in  either  black & white or color.   Also,  an interactive help  facility  is 
  187. provided.  This facility provides information on all key assignments.
  188.  
  189.  
  190.  
  191.  
  192.  
  193. (c) Copyright 1984-86 Frank M. Ramaekers Jr.          User-supported Software
  194.  
  195.  
  196.  
  197.  
  198.  
  199. 12/20/86         Screen Image Editor and Batch Utility V2.1f           Page 2
  200.  
  201.  
  202. 1.3  The Screen Image Batch Utility
  203. -----------------------------------
  204.      The Batch Utility provides a means of displaying screen images created by 
  205. the  editor.   This utility also includes a means of accepting input (via  the 
  206. keyboard)  and  setting the ERRORLEVEL.   In turn,  a batch file can test  the 
  207. ERRORLEVEL (with the IF batch subcommand) and process the request accordingly.
  208.  
  209. 1.4  Minimum Requirements
  210. -------------------------
  211.      1)   An IBM PC (tm) or compatible.
  212.      2)   PC or MS DOS 2.0 or higher.
  213.      3)   A Minimum of 64k of memory
  214.      4)   One monitor card & monitor (color or monochrome).
  215.      5)   At least one single-sided diskette drive.
  216.      6)   The following programs:   SCREDIT.COM  SCRBATCH.COM SCRHELPA.COM
  217.           SCRHELPB.COM SCRHELPC.COM SCRHELPD.COM SCRHELPE.COM SCRCONV.COM
  218.           SCRCLIPR.OBJ SCRCOB.OBJ   SCRDBASE.BIN SCRQBAS.OBJ  SCR.TXT
  219.  
  220.  
  221. 2.0  Instructions
  222. -----------------
  223.  
  224. 2.1  Screen Image Editor
  225. ------------------------
  226.      To  invoke the screen image editor,  insert the  program  diskette,  then 
  227. enter SCREDIT then press enter.  There are no operands nor options.
  228.  
  229. A>SCREDIT
  230.  
  231. 2.1.1  Function Key Assignments
  232. -------------------------------
  233.      F1  - Toggle  between  Text(standard)/Graphics  keyboard  layouts.   When 
  234.            initialized  SCREDIT  will  have  the  standard  keyboard   layout.  
  235.            Pressing  the  F1 key will toggle to the graphics  keyboard  layout 
  236.            (hexadecimal characters 80 - FF).
  237.  
  238.      F2  - Toggle foreground blink attribute.  This will toggle the foreground 
  239.            blink attribute bit.
  240.  
  241.      F3  - Swap  background/foreground attributes.   This will logically  swap 
  242.            the  background/foreground attributes.   Blink and highlight cannot 
  243.            be swapped and are retained.  Therefore, the background (foreground 
  244.            after  swap)  attribute  will  reflect  the  blink  and   highlight 
  245.            settings.
  246.  
  247.      F4  - Toggle   bright  foreground  attribute.    This  will  toggle   the 
  248.            foreground bright attribute bit.
  249.  
  250.      F5  - Increase foreground attribute value.  This will logically increment 
  251.            the  current  value  of the foreground attribute  (black  [0]  will 
  252.            become blue [1], blue [1] will become green [2], ... white [F] will 
  253.            become black [0]).
  254.  
  255.  
  256.  
  257.  
  258.  
  259. (c) Copyright 1984-86 Frank M. Ramaekers Jr.          User-supported Software
  260.  
  261.  
  262.  
  263.  
  264.  
  265. 12/20/86         Screen Image Editor and Batch Utility V2.1f           Page 3
  266.  
  267.  
  268. 2.1.1  Function Key Assignments (cont.)
  269. ---------------------------------------
  270.      F6  - Decrease foreground attribute value.  This will logically decrement 
  271.            the current value of the foreground attribute (blue [1] will become 
  272.            black  [0],  green  [2] will become blue [1],  ...  black [0]  will 
  273.            become white [F]).
  274.      F7  - Increase background attribute value.  This will logically increment 
  275.            the  current  value  of the background attribute  (black  [0]  will 
  276.            become blue [1], blue [1] will become green [2], ... white [7] will 
  277.            become black [0]).
  278.  
  279.      F8  - Decrease background attribute value.  This will logically decrement 
  280.            the current value of the background attribute (blue [1] will become 
  281.            black  [0],  green [2] will become blue [1],  ...  black  [0]  will 
  282.            become white [7]).
  283.  
  284.      F9  - Load screen image (or block) from disk.
  285.  
  286.      F10 - Save screen image to disk.
  287.  
  288. 2.1.2  Alternate Function Key Assignments
  289. -----------------------------------------
  290.      Alt-F1  - Help information which includes all key assignments. 
  291.  
  292.      Alt-F5  - Clear screen using the current attribute setting.
  293.  
  294.      Alt-F7  - Change all occurances of the attribute at the  current  cursor 
  295.                location with the current attribute setting.
  296.  
  297.      Alt-F9  - Exit temporarily to DOS.  (Use the EXIT command to return.)
  298.  
  299.      Alt-F10 - Return to DOS.
  300.  
  301. 2.1.3  Shift Function Key Assignments
  302. -----------------------------------------
  303.      Shift-F1  - Mark block at cursor position.
  304.  
  305.      Shift-F2  - Unmark block.
  306.  
  307.      Shift-F3  - Move the currently marked block.
  308.                  (The  area  vacated  is filled with spaces using  the  current 
  309.                  attribute.)
  310.  
  311.      Shift-F4  - Copy the currently marked block.
  312.  
  313.      Shift-F5  - Fill the currently marked block with a specified character.
  314.                  (The  fill character entered is effected by the keyboard  mode 
  315.                  currently set.)
  316.  
  317.      Shift-F10 - Save the currently marked block to disk.
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325. (c) Copyright 1984-86 Frank M. Ramaekers Jr.          User-supported Software
  326.  
  327.  
  328.  
  329.  
  330.  
  331. 12/20/86         Screen Image Editor and Batch Utility V2.1f           Page 4
  332.  
  333.  
  334. 2.1.4  Control Key Assignments
  335. ------------------------------
  336.      ^2 - Set/Clear tab settings. 
  337.           (use cursor/tab-key to position, T to set/clear)
  338.      ^A - Move cursor to beginning of previous word.
  339.      ^D - Move cursor forward one character.
  340.      ^E - Move cursor up one line.
  341.      ^F - Move cursor to beginning of next word.
  342.      ^G - Delete character at cursor position.
  343.      ^H - Delete character before cursor position.
  344.      ^I - Tab forward.
  345.      ^J - Left justify line.
  346.      ^K - Center line.
  347.      ^L - Right justify line.
  348.      ^M - Move cursor to beginning of next line.
  349.      ^N - Move remainder of line to next line.
  350.      ^Q - Delete previous word.
  351.      ^S - Move cursor backward one column.
  352.      ^T - Delete next word.
  353.      ^V - Toggle to/from insert mode.
  354.      ^X - Move cursor down one line.
  355.      ^Y - Delete line.
  356.  
  357. (Note:   Functions ^G,  ^H, ^N, ^Q, ^T and ^Y fill using the current attribute 
  358. and a space for the character.)
  359.  
  360. 2.1.5  Special Key Assignments
  361. ------------------------------
  362.      ->      - Move cursor right one column.
  363.      <-      - Move cursor left one column.
  364.      ^       - Move cursor up one row.
  365.      v       - Move cursor down one row.
  366.      <-->    - Tab key.
  367.      BkSp    - Delete character before cursor.
  368.      Home    - Move cursor to first character on line.
  369.      End     - Move cursor to last character on line.
  370.      Pg Up   - Move cursor to row 1, column 1.
  371.      Pg Dn   - Move cursor to row 24, column 80.
  372.      Ins     - Toggle to/from insert mode.
  373.      Del     - Delete character above cursor.
  374.      ^->     - Move cursor to next word.
  375.      ^<-     - Move cursor to previous word.
  376.      ^Home   - Erase to beginning of line.
  377.      ^End    - Erase to end of line.
  378.      ^Pg Up  - Erase to beginning of screen.
  379.      ^Pg Dn  - Erase to end of screen.
  380.      Sh <--> - Backward tab (Sh is the shift key).
  381.  
  382. (Note:   All  erase functions fill using the current attribute and a space for 
  383. the character.)
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391. (c) Copyright 1984-86 Frank M. Ramaekers Jr.          User-supported Software
  392.  
  393.  
  394.  
  395.  
  396.  
  397. 12/20/86         Screen Image Editor and Batch Utility V2.1f           Page 5
  398.  
  399.  
  400. 2.1.6  Alternate Key Assignments
  401. --------------------------------
  402.      Please see page 4 of the help facility (Alt-F1) for this information.
  403.  
  404. 2.1.7  Graphic Keyboard Layout
  405. ------------------------------
  406.      Please see page 3 of the help facility (Alt-F1) for this information.
  407.  
  408. 2.1.8  Line 25 Information
  409. --------------------------
  410.      Please see page 5 of the help facility (Alt-F1) for this information.
  411.  
  412. 2.1.9  Color Chart
  413. ------------------
  414.      The  attribute  byte  of the screen image has the  following  format  (in 
  415. binary):  XYYY  ZZZZ.   Where  X is the forground blink toggle.   YYY  is  the 
  416. background color and ZZZZ is the foreground color.
  417.  
  418. -------------------------------------------
  419. | Hex. | Binary | Background | Foreground |
  420. -------+--------+------------+------------+
  421. |  0   |  0000  |  Black     | Black      |
  422. |  1   |  0001  |  Blue      | Blue       |
  423. |  2   |  0010  |  Green     | Green      |
  424. |  3   |  0011  |  Cyan      | Cyan       |
  425. |  4   |  0100  |  Red       | Red        |
  426. |  5   |  0101  |  Magenta   | Magenta    |
  427. |  6   |  0110  |  Yellow    | Brown      |
  428. |  7   |  0111  |  White     | Light Grey |
  429. |  8   |  1000  | * Black    | Dark Grey  |
  430. |  9   |  1001  | * Blue     | Light Blue |
  431. |  A   |  1010  | * Green    | Lt. Green  |
  432. |  B   |  1011  | * Cyan     | Light Cyan |
  433. |  C   |  1100  | * Red      | Light Red  |
  434. |  D   |  1101  | * Magenta  | Lt. Magenta|
  435. |  E   |  1110  | * Yellow   | Yellow     |
  436. |  F   |  1111  | * White    | White      |
  437. -------------------------------------------
  438.  
  439. * These attributes cause the character to blink
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457. (c) Copyright 1984-86 Frank M. Ramaekers Jr.          User-supported Software
  458.  
  459.  
  460.  
  461.  
  462.  
  463. 12/20/86         Screen Image Editor and Batch Utility V2.1f           Page 6
  464.  
  465.  
  466. 2.2  The Batch Utility
  467. ----------------------
  468.  
  469. 2.2.1  Command Format
  470. ---------------------
  471. A>SCRBATCH [d:] [path\] [filename] [.SCR | .ext]  
  472.                [/a | /c | /n | /pnnn | /q | /sxxxxxxx]
  473.                [/i  @xxxxxxxxxxxxxxxxxxxxxxxxxxxxx@]  [/o##]  [/v | /x##]
  474.  
  475.                d:      - Drive of screen image.
  476.                path\   - Path to screen image.
  477.                filename- Filename of screen image.
  478.                .ext    - Extension of screen image (.SCR assumed).
  479.                /a      - Ask   (return   ERRORLEVEL=ASCII   of   key   struck, 
  480.                          translated to upper case).
  481.                /b      - Beep the IBM internal speaker.
  482.                /c      - Ask Character (return ERRORLEVEL=0 if 'A' key struck,  
  483.                          1 of 'B' key struck ...  25 if 'Z' key  struck.   The 
  484.                          character is translated to upper-case).
  485.                /f      - Ask Function key (return ERRORLEVEL=0 if F1 key is
  486.                          struck, 2 if F2 is struck ... 10 if shift-F1 is
  487.                          struck ... 20 if CTRL-F1 is struck ... 30 if ALT-F1 is
  488.                          struck).
  489.                /i      - Line 25 input prompt (first non-blank character after 
  490.                          the 'i' will be the delimiter for the string).
  491.                /n      - Ask Numeric (return ERRORLEVEL=0 if '0' key struck, 1 
  492.                          if '1' key struck ... 9 if '9' key struck).
  493.                /o##    - Override  attribute on line 25 (## is valid hex code, 
  494.                          default  attribute is what DOS uses when  writing  to 
  495.                          the screen).
  496.                /pnnn   - Wait for nnn seconds or until a key is pressed if nnn 
  497.                          is equal to zero or omitted.
  498.                /sxxxxx - Selection   list.    xxxxxx  specifies  a  validation                          
  499.                          selection  list  of ASCII  characters.   The  special                          
  500.                          character ~ designates any character.  The ERRORLEVEL                          
  501.                          will  be set based on the relative position  in  this                          
  502.                          list.   Matching  to this list is not case-sensitive. 
  503.                          (for example if /sabcde~ was specified, the ERRORLEVEL
  504.                          will be set to 1 if 'A' is struck, 2 if 'B' is struck 
  505.                          ...  5  if  'E' is struck and 6 if any other  key  is                          
  506.                          struck.)  (NOTE:  The selection list is terminated by 
  507.                          either a space or a '/'.)
  508.                /q      - Query  (return ERRORLEVEL=0 if 'y' or 'Y' key  struck 
  509.                          or ERRORLEVEL=1 if 'n' or 'N' key struck.)
  510.                /v      - Pop-over  Screen  Image  (the  old  screen  image  is 
  511.                          retained and restored after execution).
  512.                /x##    - Clear screen before displaying Screen Image (if ## is 
  513.                          specified it will be used as the attribute as in /o).
  514.  
  515.  
  516.         Notes:
  517.                 a)  The  complete  file  name  (drive,   path,   filename  and                      
  518.                     extension),  if  specified,  must be the first  parameter.  
  519.                     Options are position independent.
  520.  
  521.  
  522.  
  523. (c) Copyright 1984-86 Frank M. Ramaekers Jr.          User-supported Software
  524.  
  525.  
  526.  
  527.  
  528.  
  529. 12/20/86         Screen Image Editor and Batch Utility V2.1f           Page 7
  530.  
  531.  
  532.         Notes (continued):
  533.                 b)  If  more  than one of the following options  is  specified,
  534.                     the first one issued from this list will take presidence:
  535.                     /p /q /a /n /c /f /s.
  536.                 c)  SCRBATCH.COM must be on each diskette that utilizes it.
  537.                 d)  Both /v and /x cannot be specified at the same time.
  538.  
  539.  
  540. 2.2.2  Examples
  541. ---------------
  542. A>SCRBATCH C:\SCR\SCRHELPA /P /I'Press any key to continue'/o87
  543.      This  will  display the screen SCRHELPA.SCR in sub-directory SCR and  wait 
  544.      for  a  key  to  be pressed.   On line 25 the prompt  'Press  any  key  to 
  545.      continue' will be centered and blinking (87h attribute).
  546.  
  547. A>SCRBATCH C:SCRHELPA.XXX /Q /I [Please respond by pressing the 'y' or 'n' key[
  548.      This  will display the screen image SCRHELPA.XXX and set the ERRORLEVEL to 
  549.      0  if a 'y' or 'Y' and to 1 if 'n' or 'N' key was struck.   In addition  a 
  550.      prompt is displayed centered on line 25.
  551.  
  552. A>SCRBATCH C:HELP01 /A
  553.      This will display the screen image HELP01.   The ERRORLEVEL will be set to 
  554.      the ASCII value of the key that was struck.
  555.  
  556. A>SCRBATCH HELP01A /i'Select 0 through 9 from list above.'/n/o8f
  557.      This  will display the screen image HELP01A.SCR.   The ERRORLEVEL will  be 
  558.      set to the value 0 - 9 corresponding to keys '0' - '9'.   Also,  a  prompt 
  559.      message will appear centered on line 25 with a blink & bright attribute.
  560.  
  561. A>SCRBATCH CHKDSK /sABCD~ /i'Select a the drive you desire (A-D)'
  562.      This  will display the screen image CHKDSK.SCR.   The ERRORLEVEL will  be 
  563.      set to the value 1 - 4 corresponding to the keys 'A' - 'D'.  If any other 
  564.      key is pressed the ERRORLEVEL will be set to 5. 
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589. (c) Copyright 1984-86 Frank M. Ramaekers Jr.          User-supported Software
  590.  
  591.  
  592.  
  593.  
  594.  
  595. 12/20/86         Screen Image Editor and Batch Utility V2.1f           Page 8
  596.  
  597.  
  598. 2.2.3  A Batch File Example
  599. ---------------------------
  600.  1)  SCRBATCH \HELP\LOGO /P3
  601.  2)  :BEGIN
  602.  3)  SCRBATCH \HELP\MENU/I'Select 0 through 9 from list above.'/8f/s0123456789~
  603.  4)  :DOIT
  604.  5)  IF ERRORLEVEL 11 GOTO ERROR
  605.  6)  CLS
  606.  7)  IF ERRORLEVEL 10 GOTO EXIT
  607.  8)  IF ERRORLEVEL 9 GOTO TREE
  608.  9)  IF ERRORLEVEL 8 GOTO CHKDSK
  609. 10)  IF ERRORLEVEL 7 GOTO DIR
  610. 11)  IF ERRORLEVEL 6 GOTO BASICA
  611. 12)  IF ERRORLEVEL 5 GOTO BASIC
  612. 13)  IF ERRORLEVEL 4 GOTO COMM
  613. 14)  IF ERRORLEVEL 3 GOTO DBASE
  614. 15)  IF ERRORLEVEL 2 GOTO LOTUS
  615. 16)  IF ERRORLEVEL 1 GOTO WS 
  616. 17)  :ERROR
  617. 18)  SCRBATCH \HELP\ERROR /p3/v/b
  618. 19)  SCRBATCH /s0123456789~
  619. 20)  :WS
  620. 21)  CD \WS
  621. 22)  WS
  622. 23)  GOTO BEGIN
  623. 24)  :LOTUS
  624. 25)  CD \LOTUS
  625. 26)  LOTUS
  626. 27)  GOTO BEGIN
  627. 28)  :DBASE
  628. 29)  CD \DBASE3
  629. 30)  ECHO Insert the DBASE III system diskette into drive A: (left drive).
  630. 31)  ECHO  
  631. 32)  PAUSE
  632. 33)  DBASE
  633. 34)  GOTO BEGIN
  634. 35)  :COMM
  635. 36)  CD \COMM
  636. 37)  PROCOMM
  637. 38)  GOTO BEGIN
  638. 39)  :BASIC
  639. 40)  CD \BASIC
  640. 41)  BASIC
  641. 42)  GOTO BEGIN
  642. 43)  :BASICA
  643. 44)  CD \BASIC
  644. 45)  BASICA
  645. 46)  GOTO BEGIN
  646. 46)  :DIR
  647. 47)  DIR|MORE
  648. 48)  PAUSE
  649. 49)  GOTO BEGIN
  650. 50)  :CHKDSK
  651. 51)  CHKDSK
  652. 52)  PAUSE
  653.  
  654.  
  655. (c) Copyright 1984-86 Frank M. Ramaekers Jr.          User-supported Software
  656.  
  657.  
  658.  
  659.  
  660.  
  661. 12/20/86         Screen Image Editor and Batch Utility V2.1f           Page 9
  662.  
  663.  
  664. 2.2.3  A Batch File Example (cont.)
  665. -----------------------------------
  666.  
  667. 53)  GOTO BEGIN
  668. 54)  :TREE
  669. 55)  TREE/F|MORE
  670. 56)  PAUSE
  671. 57)  GOTO BEGIN
  672. 58)  :EXIT
  673. 59)  CD \
  674.  
  675.      Statement 1 displays the screen image LOGO.SCR in sub-directory \HELP for 
  676. 3  seconds.   The  next statement (2) is a label that will be  used  later  to 
  677. redisplay the menu screen.  Statement 3 displayes the screen image MENU.SCR in 
  678. sub-directory \HELP until a key is struck.   In turn,  the ERRORLEVEL will  be 
  679. set  according  to the selection list provided.   If a zero  is  pressed,  the 
  680. ERRORLEVEL will be set to 1, pressing a the '1' key will set the ERRORLEVEL to 
  681. 2 ...  any other key will set the ERRORLEVEL to 11.  The next statement (4) is 
  682. a  label  that  will be used later on.   In the next  statement  (5),  invalid 
  683. responses are filtered out.  The purpose of statement 6 is to clear the screen 
  684. before  the  program is executed.   The next statement (7) checks if  the  key 
  685. struck was '9',  if so a branch is made to the label :EXIT,  which  terminates 
  686. the batch file.   (Notice that the highest value of ERRORLEVEL is filtered off 
  687. first.   This  is  because the 'IF ERRORLEVEL' batch subcommand operates on  a 
  688. greater than or equal to premise.)  Skipping down to statement 16,  if the '0' 
  689. key  is  struck the ERRORLEVEL is set to 1 and a branch is made to  the  label 
  690. :WS.
  691.      In statement 20 has the label :WS.   The next statement (21) changes  the 
  692. current  directory  to \WS.   Statement 22 actually executes  WordStar.   When 
  693. WordStar  is  terminated  statement  23 is executed  which  branches  back  to 
  694. redisplay the menu.
  695.      If an invalid response was entered on the menu,  statement 5 branches  to 
  696. the label :ERROR at statement 17.   In statement 18,  a beep sound is made and 
  697. an error message is 'popped-over' the menu for an interval of 3 seconds. After 
  698. the  three  seconds  has expired the screens returns to it's  original  state.  
  699. Then  in  the next statement (19),  no screen is loaded,   but a  response  is 
  700. expected  from the user as in the the menu ('0' - '9').   After the  user  has 
  701. made a selection statement 20 returns to the filtering process (:DOIT).
  702.      This  batch  file  makes no attempt to reset  the  directory  after  each 
  703. program is executed.  For this reason each change directory statement (CD) and 
  704. references  to screen files begins with a '\'.   Then upon exit from the batch 
  705. file the current directory is reset to the root. 
  706.  
  707.  
  708. 2.3  The Conversion Utility
  709. ---------------------------
  710.      This  utility program will convert a screen image file (.SCR) to either a 
  711. BASIC BLOAD file or a standard ASCII file.   Also available is conversion to a 
  712. screen image file from either a BASIC BLOAD file or a standard ASCII file.  
  713.      To invoke the Conversion Utility enter SCRCONV and press enter.
  714.  
  715. A>SCRCONV
  716.  
  717.  
  718.  
  719.  
  720.  
  721. (c) Copyright 1984-86 Frank M. Ramaekers Jr.          User-supported Software
  722.  
  723.  
  724.  
  725.  
  726.  
  727. 12/20/86         Screen Image Editor and Batch Utility V2.1f           Page 10
  728.  
  729.  
  730. 2.4  The Programming Language Interfaces
  731. ----------------------------------------
  732.      The  programming language interfaces provide for 3  different  functions.  
  733. The  first  is to load a saved screen image from disk onto  the  screen.   The 
  734. second is to save a screen image into memory.  Lastly there is an interface to 
  735. restore  a previously saved image from memory back to the screen.   With these 
  736. three  interfaces  a  programmer can give the illusion  of  pop-over  windows.
  737. To  accomplish this,  the original screen is saved.   Then another screen  (or 
  738. portion  of  a screen) is loaded.   Then the original screen can  be  restored 
  739. without repainting the image in the programming language.
  740.  
  741.                   *
  742. 2.4.1  The Clipper Interface
  743. ----------------------------
  744. To load a screen from disk:      CALL SCRDBASE WITH "LOAD d:\path\filename.ext"
  745. To save a screen to memory:      CALL SCRDBASE WITH "PUSH"
  746. To restore a screen from memory: CALL SCRDBASE WITH "POP"
  747.  
  748.              *
  749. 2.4.2  The MS COBOL Interface
  750. -----------------------------
  751. To load a screen from disk:      CALL "SCRLOAD" USING filename, return-code.
  752. To save a screen to memory:      CALL "SCRPUSH".
  753. To restore a screen from memory: CALL "SCRPOP".
  754.  
  755. (Note:  return codes 1-255 are DOS errors and 257 means that filename is not a 
  756. screen  image file.   Also,  the data-name filename must be terminated with  a 
  757. space.)
  758.  
  759.                      *
  760. 2.4.3  The dBASE III+ Interface
  761. -------------------------------
  762. To load then Interface module:   LOAD SCRDBASE.
  763. To load a screen from disk:      CALL SCRDBASE WITH "LOAD d:\path\filename.ext"
  764. To save a screen to memory:      CALL SCRDBASE WITH "PUSH"
  765. To restore a screen from memory: CALL SCRDBASE WITH "POP"
  766.  
  767.              *
  768. 2.4.4  The MS QuickBASIC Interface
  769. ----------------------------------
  770. To load a screen from disk:      CALL SCRLOAD(filename$,retcode%)
  771. To save a screen to memory:      CALL SCRPUSH
  772. To restore a screen from memory: CALL POP
  773.  
  774. (Note:  return codes 1-255 are DOS errors,  256 means that the screen is in an 
  775. improper mode and 257 means that filename$ is not a screen image file.)
  776.  
  777.  
  778.  
  779.  
  780.  
  781. * Clipper is a registered trademark of Nantucket.
  782.   MS is a registered trademark of Microsoft Coporation.
  783.   dBASE III+ is a registered trademark of Aston-Tate.
  784.  
  785.  
  786.  
  787. (c) Copyright 1984-86 Frank M. Ramaekers Jr.          User-supported Software
  788.  
  789.  
  790.  
  791.  
  792.  
  793. 12/20/86         Screen Image Editor and Batch Utility V2.1f           Page 11
  794.  
  795.  
  796. -------------------------------------------------------------------------------
  797.  
  798.                      Screen Image Editor Registration Form                v2.1f
  799.     
  800.  
  801.  
  802. Name: _______________________________________________      Date:____/____/____
  803.        (Last)            (First)     (Middle Initial)           (MM   DD   YY)
  804.  
  805.  
  806. Address: ____________________________________________
  807.  
  808.  
  809. City: _______________________  State: _______________  Zip Code: _____________
  810.  
  811.  
  812. Amount Enclosed: ___________________
  813.                                         +-------------------------------------
  814.                                         |********** DO NOT MARK HERE *********
  815. Send to:  Frank M. Ramaekers Jr.        |
  816.           4614 Arapahoe Tr.             | Serial No.___________________
  817.           Austin, Texas  78745          |
  818.                                         | Version No.__________________
  819.                                         |
  820.                                         | Date issued:_________________
  821. -------------------------------------------------------------------------------
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853. (c) Copyright 1984-86 Frank M. Ramaekers Jr.          User-supported Software
  854.  
  855.  
  856.  
  857.  
  858.  
  859.