













                                                     tm    
                          T I Y L I   S O F T W A R E

                              is proud to present

                  +----------------------------------------+
                  |         The Screen Image Editor        |
                  |                                        |
                  |            and Batch Utility           |
                  |                                        |
                  |                   by                   |
                  |         Frank M. Ramaekers Jr.         |
                  +----------------------------------------+
            (c) Copyright 1984,85 "Try-It-You'll-Like-It" Software
































(c) Copyright 1984,85 Frank M. Ramaekers Jr.          User-supported Software



01/28/85          Screen Image Editor and Batch Utility V2.1c           Page i

Table of Contents:

0.0  The User-supported Concept . . . . . . . . . . . . . . . . . . . . . .  1

1.0  Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  1
     1.1  Overview  . . . . . . . . . . . . . . . . . . . . . . . . . . . .  1
     1.2  The Screen Image Editor . . . . . . . . . . . . . . . . . . . . .  1
     1.3  The Batch Utility . . . . . . . . . . . . . . . . . . . . . . . .  2
     1.4  Minimum Requirements  . . . . . . . . . . . . . . . . . . . . . .  2

2.0  Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  2
     2.1  The Screen Image Editor . . . . . . . . . . . . . . . . . . . . .  2
          2.1.1  Function Key Assignments . . . . . . . . . . . . . . . . .  2
          2.1.2  Alternate Function Key Assignments . . . . . . . . . . . .  3
          2.1.3  Control Key Assignments  . . . . . . . . . . . . . . . . .  3
          2.1.4  Special Key Assignments  . . . . . . . . . . . . . . . . .  4
          2.1.5  Alternate Key Assignments  . . . . . . . . . . . . . . . .  4
          2.1.6  Graphic Keyboard Layout  . . . . . . . . . . . . . . . . .  4
          2.1.7  Line 25 Information  . . . . . . . . . . . . . . . . . . .  4
          2.1.8  Color Chart  . . . . . . . . . . . . . . . . . . . . . . .  5
     2.2  The Batch Utility . . . . . . . . . . . . . . . . . . . . . . . .  5
          2.2.1  Command Format . . . . . . . . . . . . . . . . . . . . . .  5
          2.2.2  Examples . . . . . . . . . . . . . . . . . . . . . . . . .  6
          2.2.3  A Batch File Example . . . . . . . . . . . . . . . . . . .  6
     2.3  The Conversion Utility  . . . . . . . . . . . . . . . . . . . . .  8

3.0  Registration Form  . . . . . . . . . . . . . . . . . . . . . . . . . .  9




























(c) Copyright 1984,85 Frank M. Ramaekers Jr.          User-supported Software
01/28/85         Screen Image Editor and Batch Utility V2.1c           Page 1


0.0     The User-supported Concept
----------------------------------

     This product is distributed on a basis that the product will sell itself.  
This reduces advertising, distribution, and copy-protection costs.  This means 
that you can copy and share this program with others,  on the conditions  that 
the  program  is  not distributed in modified form and that no  fee  or  other 
consideration  is  charged.   The  only thing I ask is that if you  find  this 
product  of  value,  please send a donation ($24 suggested) to  the  following 
address:

        Frank M. Ramaekers Jr.
        4614 Arapahoe Tr.
        Austin, Texas  78745

     Your contribution entitles you to the following:

          1)   The latest version of this system.  Which will be mailed to you  
               upon receipt of your donation.
          2)   When  a new version is available,  you will be  notified.   You 
               will then have the option of sending your original (with return 
               postage) for this new version.
          3)   You will also be notified of future products.
          4)   Responses to questions, complaints or problems that you send in.


1.0  Introduction
--------------------

1.1  Overview
-------------
     The  Screen  Image processing system was created to  assist  in  creating 
menus  and  help  screens.   Current DOS batch commands (e.g.  ECHO  and  REM) 
provide only line-by-line creation of a screen image that was extremely  slow.  
Also,  these  batch  files were very tedious to edit,  especially  if  graphic 
characters  were used.   In addition,  neither command provides for  attribute 
selection.  Plus, DOS makes no provisions for keyboard input to facilitate the 
selection  process.  The SCREDIT.COM program provides a method of  retrieving, 
editing  and  saving  screen  images  that  can  be  used  in  a  batch  file.  
SCRBATCH.COM  was created to display the screen image and optionally accept  a 
response  from the keyboard and set the ERRORLEVEL (so it can be tested  using 
the IF batch subcommand).

1.2  The Screen Image Editor
----------------------------
     The  Screen Image Editor is a utility by which users can maintain  screen 
images.   Screen images can be loaded,  edited, and saved.  Most of the common 
graphic characters are easily accessable through the keyboard and are arranged 
in a conevient layout.   All the major editing functions are incorporated into 
this editor. In addition, the editor allows full utilization of all attributes 
in  either  black & white or color.   Also,  an interactive help  facility  is 
provided.  This facility provides information on all key assignments.





(c) Copyright 1984,85 Frank M. Ramaekers Jr.          User-supported Software
01/28/85         Screen Image Editor and Batch Utility V2.1c           Page 2


1.3  The Screen Image Batch Utility
-----------------------------------
     The Batch Utility provides a means of displaying screen images created by 
the  editor.   This utility also includes a means of accepting input (via  the 
keyboard)  and  setting the ERRORLEVEL.   In turn,  a batch file can test  the 
ERRORLEVEL (with the IF batch subcommand) and process the request accordingly.

1.4  Minimum Requirements
-------------------------
     1)   An IBM PC (tm) or compatible.
     2)   PC or MS DOS 2.0 or higher.
     3)   A Minimum of 64k of memory
     4)   One monitor card & monitor (color or monochrome).
     5)   At least one single-sided diskette drive.
     6)   The following programs:   SCREDIT.COM  SCRBATCH.COM SCRHELPA.COM
          SCRHELPB.COM SCRHELPC.COM SCRHELPD.COM SCRHELPE.COM


2.0  Instructions
-----------------

2.1  Screen Image Editor
------------------------
     To  invoke the screen image editor,  insert the  program  diskette,  then 
enter SCREDIT then press enter.  There are no operands nor options.

A>SCREDIT

2.1.1  Function Key Assignments
-------------------------------
     F1  - Toggle  between  Text(standard)/Graphics  keyboard  layouts.   When 
           initialized  SCREDIT  will  have  the  standard  keyboard   layout.  
           Pressing  the  F1 key will toggle to the graphics  keyboard  layout 
           (hexadecimal characters 80 - FF).

     F2  - Toggle foreground blink attribute.  This will toggle the foreground 
           blink attribute bit.

     F3  - Swap  background/foreground attributes.   This will logically  swap 
           the  background/foreground attributes.   Blink and highlight cannot 
           be swapped and are retained.  Therefore, the background (foreground 
           after  swap)  attribute  will  reflect  the  blink  and   highlight 
           settings.

     F4  - Toggle   bright  foreground  attribute.    This  will  toggle   the 
           foreground bright attribute bit.

     F5  - Increase foreground attribute value.  This will logically increment 
           the  current  value  of the foreground attribute  (black  [0]  will 
           become blue [1], blue [1] will become green [2], ... white [F] will 
           become black [0]).






(c) Copyright 1984,85 Frank M. Ramaekers Jr.          User-supported Software
01/28/85         Screen Image Editor and Batch Utility V2.1c           Page 3


2.1.1  Function Key Assignments (cont.)
---------------------------------------
     F6  - Decrease foreground attribute value.  This will logically decrement 
           the current value of the foreground attribute (blue [1] will become 
           black  [0],  green  [2] will become blue [1],  ...  black [0]  will 
           become white [F]).
     F7  - Increase background attribute value.  This will logically increment 
           the  current  value  of the background attribute  (black  [0]  will 
           become blue [1], blue [1] will become green [2], ... white [7] will 
           become black [0]).

     F8  - Decrease background attribute value.  This will logically decrement 
           the current value of the background attribute (blue [1] will become 
           black  [0],  green [2] will become blue [1],  ...  black  [0]  will 
           become white [7]).

     F9  - Load screen image from disk.

     F10 - Save screen image to disk.

2.1.2  Alternate Function Key Assignments
-----------------------------------------
     Alt-F1  - Help information which includes all key assignments. 

     Alt-F5  - Clear screen using the current attribute setting.

     Alt-F9  - Exit temporarily to DOS.  (Use the EXIT command to return.)

     Alt-F10 - Return to DOS.

2.1.3  Control Key Assignments
------------------------------
     ^2 - Set/Clear tab settings. 
          (use cursor/tab-key to position, T to set/clear)
     ^A - Move cursor to beginning of previous word.
     ^D - Move cursor forward one character.
     ^E - Move cursor up one line.
     ^F - Move cursor to beginning of next word.
     ^G - Delete character at cursor position.
     ^H - Delete character before cursor position.
     ^I - Tab forward.
     ^J - Left justify line.
     ^K - Center line.
     ^L - Right justify line.
     ^M - Move cursor to beginning of next line.
     ^N - Move remainder of line to next line.
     ^Q - Delete previous word.
     ^S - Move cursor backward one column.
     ^T - Delete next word.
     ^V - Toggle to/from insert mode.
     ^X - Move cursor down one line.
     ^Y - Delete line.

(Note:   Functions ^G,  ^H, ^N, ^Q, ^T and ^Y fill using the current attribute 
and a space for the character.)


(c) Copyright 1984,85 Frank M. Ramaekers Jr.          User-supported Software
01/28/85         Screen Image Editor and Batch Utility V2.1c           Page 4


2.1.4  Special Key Assignments
------------------------------
     ->      - Move cursor right one column.
     <-      - Move cursor left one column.
     ^       - Move cursor up one row.
     v       - Move cursor down one row.
     <-->    - Tab key.
     Home    - Move cursor to first character on line.
     End     - Move cursor to last character on line.
     Pg Up   - Move cursor to row 1, column 1.
     Pg Dn   - Move cursor to row 24, column 80.
     Ins     - Toggle to/from insert mode.
     Del     - Delete character above cursor.
     ^->     - Move cursor to next word.
     ^<-     - Move cursor to previous word.
     ^Home   - Erase to beginning of line.
     ^End    - Erase to end of line.
     ^Pg Up  - Erase to beginning of screen.
     ^Pg Dn  - Erase to end of screen.
     Sh <--> - Backward tab (Sh is the shift key).

(Note:   All  erase functions fill using the current attribute and a space for 
the character.)

2.1.5  Alternate Key Assignments
--------------------------------
     Please see page 4 of the help facility (Alt-F1) for this information.

2.1.6  Graphic Keyboard Layout
------------------------------
     Please see page 3 of the help facility (Alt-F1) for this information.

2.1.7  Line 25 Information
--------------------------
     Please see page 5 of the help facility (Alt-F1) for this information.






















(c) Copyright 1984,85 Frank M. Ramaekers Jr.          User-supported Software
01/28/85         Screen Image Editor and Batch Utility V2.1c           Page 5


2.1.8  Color Chart
------------------
     The  attribute  byte  of the screen image has the  following  format  (in 
binary):  XYYY  ZZZZ.   Where  X is the forground blink toggle.   YYY  is  the 
background color and ZZZZ is the foreground color.

-------------------------------------------
| Hex. | Binary | Background | Foreground |
-------+--------+------------+------------+
|  0   |  0000  |  Black     | Black      |
|  1   |  0001  |  Blue      | Blue       |
|  2   |  0010  |  Green     | Green      |
|  3   |  0011  |  Cyan      | Cyan       |
|  4   |  0100  |  Red       | Red        |
|  5   |  0101  |  Magenta   | Magenta    |
|  6   |  0110  |  Yellow    | Brown      |
|  7   |  0111  |  White     | Light Grey |
|  8   |  1000  |   (the     | Dark Grey  |
|  9   |  1001  | high-order | Light Blue |
|  A   |  1010  |    bit     | Lt. Green  |
|  B   |  1011  |    is      | Light Cyan |
|  C   |  1100  |    used    | Light Red  |
|  D   |  1101  |    for     | Lt. Magenta|
|  E   |  1110  | foreground | Yellow     |
|  F   |  1111  |  blink)    | White      |
-------------------------------------------

2.2  The Batch Utility
----------------------

2.2.1  Command Format
---------------------
A>SCRBATCH [d:] [path\] filename [.SCR | .ext]  [/a | /c | /n | /pnnn | /q]
               [/i @xxxxxxxxxxxxxxxxxxxxxxxxxxxxx@]  [/o##] 

               d:      - Drive of screen image.
               path\   - Path to screen image.
               filename- Filename of screen image
               .ext    - Extension of screen image (.SCR assumed).
               /a      - Ask   (return   ERRORLEVEL=ASCII   of   key   struck, 
                         translated to upper case.)
               /c      - Ask Character (return ERRORLEVEL=0 if 'A' key struck,  
                         1 of 'B' key struck ...  25 if 'Z' key  struck.   The 
                         character is translated to upper-case.)
               /i      - Line 25 input prompt (first non-blank character after 
                         the 'i' will be the delimiter for the string)
               /n      - Ask Numeric (return ERRORLEVEL=0 if '0' key struck, 1 
                         if '1' key struck ... 9 if '9' key struck)
               /o      - Override  attribute on line 25 (## is valid hex code, 
                         default attribute is 07 - normal - white on black)
               /pnnn   - Wait for nnn seconds or until a key is pressed if nnn 
                         is equal to zero or omitted.
               /q      - Query  (return ERRORLEVEL=0 if 'y' or 'Y' key  struck 
                         or ERRORLEVEL=1 if 'n' or 'N' key struck.)



(c) Copyright 1984,85 Frank M. Ramaekers Jr.          User-supported Software
01/28/85         Screen Image Editor and Batch Utility V2.1c           Page 6


2.2.1  Command Format (cont.)
-----------------------------
        Notes:
                a)  The complete file name (drive, path, filename and extension
                    must be the first parameter.  Options are position inde-
                    pendent.
                b)  If  more  than one of the following options  is  specified,
                    the first one issued from this list will take presidence:
                    /p /q /a /n /c
                c)  SCRBATCH.COM must be on each diskette that utilizes it.

2.2.2  Examples
---------------
A>SCRBATCH C:\SCR\SCRHELPA /P /I'Press any key to continue'/o87
     This  will  display the screen SCRHELPA.SCR in sub-directory SCR and  wait 
     for  a  key  to  be pressed.   On line 25 the prompt  'Press  any  key  to 
     continue' will be centered and blinking (87h attribute).

A>SCRBATCH C:SCRHELPA.XXX /Q /I [Please respond by pressing the 'y' or 'n' key[
     This  will display the screen image SCRHELPA.XXX and set the ERRORLEVEL to 
     0  if a 'y' or 'Y' and to 1 if 'n' or 'N' key was struck.   In addition  a 
     prompt is displayed centered on line 25.

A>SCRBATCH C:HELP01 /A
     This will display the screen image HELP01.   The ERRORLEVEL will be set to 
     the ASCII value of the key that was struck.

A>SCRBATCH HELP01A /i'Select 0 through 9 from list above.'/n/o8f
     This  will display the screen image HELP01A.SCR.   The ERRORLEVEL will  be 
     set to the value 0 - 9 corresponding to keys '0' - '9'.   Also,  a  prompt 
     message will appear centered on line 25 with a blink & bright attribute.

2.2.3  A Batch File Example
---------------------------
 1)  SCRBATCH \HELP\LOGO /P3
 2)  :BEGIN
 3)  SCRBATCH \HELP\MENU/I'Select 0 through 9 from list above.'/8f/n
 4)  IF ERRORLEVEL 10 GOTO BEGIN
 5)  CLS
 6)  IF ERRORLEVEL 9 GOTO EXIT
 7)  IF ERRORLEVEL 8 GOTO TREE
 8)  IF ERRORLEVEL 7 GOTO CHKDSK
 9)  IF ERRORLEVEL 6 GOTO DIR
10)  IF ERRORLEVEL 5 GOTO BASICA
11)  IF ERRORLEVEL 4 GOTO BASIC
12)  IF ERRORLEVEL 3 GOTO TALK
13)  IF ERRORLEVEL 2 GOTO DBASE
14)  IF ERRORLEVEL 1 GOTO LOTUS
15)  IF ERRORLEVEL 0 GOTO WS 
16)  :WS
17)  CD \WS
18)  WS
19)  GOTO BEGIN
20)  :LOTUS
21)  CD \LOTUS


(c) Copyright 1984,85 Frank M. Ramaekers Jr.          User-supported Software
01/28/85         Screen Image Editor and Batch Utility V2.1c           Page 7


2.2.3  A Batch File Example (cont.)
-----------------------------------
22)  LOTUS
23)  GOTO BEGIN
24)  :DBASE
25)  CD \DBASE3
26)  ECHO Insert the DBASE III system diskette into drive A: (left drive).
27)  ECHO  
28)  PAUSE
29)  DBASE
30)  GOTO BEGIN
31)  :TALK
32)  CD \TALK
33)  PC-TALK
34)  GOTO BEGIN
35)  :BASIC
36)  CD \BASIC
37)  BASIC
38)  GOTO BEGIN
39)  :BASICA
40)  CD \BASIC
41)  BASICA
42)  :DIR
43)  DIR|MORE
44)  PAUSE
45)  GOTO BEGIN
46)  :CHKDSK
47)  CHKDSK
48)  PAUSE
49)  GOTO BEGIN
50)  :TREE
51)  TREE/F|MORE
52)  PAUSE
53)  GOTO BEGIN
54)  :EXIT
55)  CD /

     Statement 1 displays the screen image LOGO.SCR in sub-directory \HELP for 
3  seconds.   The  next statement (2) is a label that will be  used  later  to 
redisplay the menu screen.  Statement 3 displayse the screen image MENU.SCR in 
sub-directory  \HELP  until  a  valid key  (0-9)  is  struck.   In  turn,  the 
ERRORLEVEL will be set corresponding to the key struck.  In the next statement 
(4), invalid responses are filtered out (although the ERRORLEVEL will never be 
set  to 10,  this is to demonstrate how edit the responses).   The purpose  of 
statement  5 is to clear the screen before the program is executed.   The next 
statement  (6) checks if the key struck was 9,  if so a branch is made to  the 
label  :WS.   (Notice  that the highest value of ERRORLEVEL  is  filtered  off 
first.   This  is  because the 'IF ERRORLEVEL' batch subcommand operates on  a 
greater than or equal to premise.)
     In statement 16 has the label :WS.   The next statement (17) changes  the 
current  directory  to \WS.   Statement 18 actually executes  WordStar.   When 
WordStar  is  terminated  statement  19 is executed  which  branches  back  to 
redisplay the menu.




(c) Copyright 1984,85 Frank M. Ramaekers Jr.          User-supported Software
01/28/85         Screen Image Editor and Batch Utility V2.1c           Page 8


2.2.3  A Batch File Example (cont.)
-----------------------------------
     This  batch  file  makes no attempt to reset  the  directory  after  each 
program  is  executed.   For this reason each change directory statement  (CD) 
starts  at  the root directory (\).   Then upon exit from the batch  file  the 
current directory is reset to the root. 

2.3  The Conversion Utility
---------------------------
     This  utility program will convert a screen image file (.SCR) to either a 
BASIC BLOAD file or a standard ASCII file.   Also available is conversion to a 
screen image file from either a BASIC BLOAD file or a standard ASCII file.  
     To invoke the Conversion Utility enter SCRCONV and press enter.

A>SCRCONV










































(c) Copyright 1984,85 Frank M. Ramaekers Jr.          User-supported Software
01/28/85         Screen Image Editor and Batch Utility V2.1c           Page 9


-------------------------------------------------------------------------------

                     Screen Image Editor Registration Form                v2.1c
    


Name: _______________________________________________      Date:____/____/____
       (Last)            (First)     (Middle Initial)           (MM   DD   YY)


Address: --------------------------------------------


City: _______________________  State: _______________  Zip Code: _____________


Amount Enclosed: ___________________
                                        +-------------------------------------
                                        |********** DO NOT MARK HERE *********
Send to:  Frank M. Ramaekers Jr.        |
          4614 Arapahoe Tr.             | Serial No.___________________
          Austin, Texas  78745          |
                                        | Version No.__________________
                                        |
                                        | Date issued:_________________
-------------------------------------------------------------------------------































(c) Copyright 1984,85 Frank M. Ramaekers Jr.          User-supported Software
 liiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiire)1t ee