home *** CD-ROM | disk | FTP | other *** search
Text File | 1991-01-19 | 47.7 KB | 1,055 lines |
-
-
-
-
-
-
-
-
-
- WISP
-
- (Whole Instruction Serial Processor)
-
- Version 3.0
-
-
-
-
- A new INTERPRETER
-
-
-
-
- For IBM and compatible computers.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- (C) 1990 Sitting Duck Software POBox 130 Veneta, OR 97487
- All rights reserved.
-
-
-
-
-
- WISP (Whole Instruction Serial Processor) Version 3.0
-
-
-
- An INTERPRETER by Sitting Duck Software
-
-
-
- WISP, as does any interpreter, loads a text file containing commands which it
- can recognize and act upon. The loaded text file will be a PROGRAM which you
- will write. WISP is similar to the BASIC interpreter but has a command
- structure which has been specifically designed to eliminate most of the coding
- needed to accomplish certain tasks and the goals of the programmer. WISP is
- also similar in some respects to PILOT but has a more intuitive syntax and many
- commands not available with PILOT. WISP.EXE is only about 25K in size (before
- compression) and is designed to be distributed, along with a program file, on a
- floppy disc.
-
- For an interpreter to be of such diminutive size requires a limited command
- set. Given the below described uses of the program allowed us to forego many
- of the commands found in other languages. For example, WISP will not perform
- any math, not even 2+2. Neither are there any graphics, looping, data,
- printing and, hold on to your hat, there is no error checking whatsoever.
- When WISP acts upon a line of code, it presumes it to be PERFECT!
-
- Because of the limited instruction set, opportunities are provided to SHELL
- from WISP and run other programs or batch files. Proper use of WISP will
- allow you to perform a number of different tasks with a minimum of programming
- effort and a relatively short learning curve. The following represent some of
- the tasks that WISP was designed to do:
-
- - CATALOGS
- - MENUING SYSTEMS
- - INSTALLATION PROGRAMS
- - SLIDE SHOWS
- - INSTRUCTION
- - INTERACTIVE TUTORIALS
- - DEMONSTRATIONS
- - MENU DRIVEN, MULTIPLE CHOICE TESTING
- - MENU DRIVEN, TRUE-FALSE TESTING
- - BATCH FILES PROCESSING
-
-
- The WISP command set does not allow for the execution of normal DOS batch file
- commands although WISP does provide it's own implementation of some of DOS's
- features such as clearing the screen and changing drives or directories. Any
- DOS command that WISP cannot handle can be performed by SHELLing from WISP.
-
- The command for loading and running a WISP program is:
-
- WISP FILENAME
-
- Where FILENAME is the name of a program file (which you write) with the .WSP
- extension. The extension .WSP is not used when running WISP.
-
-
-
- For one of the demonstration programs on the accompanying disc, the program
- file is -MAIN.WSP. To run the demo, type:
-
- WISP -MAIN
-
- WISP loads itself then loads the program -MAIN.WSP into memory. WISP will then
- process the commands within the program file IF it recognizes the command.
- From within WISP and it's loaded file, you can run other programs, display text
- in a number of different ways, create single or nested menuing systems, control
- the screen colors, draw boxes, load a previously saved screen, change drives
- and directories, and retain desirable control over these activities by way of
- the GOTO and MENU commands.
-
- WISP.EXE is less than 10K in size and will, thereby, take up little of your disk
- space and load rapidly. You may locate WISP anywhere, including a RAM disk, and
- establish a path to it. WISP and the required program file are generally small
- enough to be used with 360K floppy diskettes.
-
- You should make hard copies of all the .WSP files; they will be helpful in
- explaining the structure and syntax of WISP commands.
-
-
- THE WISP EDITOR AND ENVIRONMENT
-
- In order to make it easy to write and test your WISP programs, you can run
- WISPED. WISPED is an editing environment from which you can compose, save and
- test run your WISP programs. WISPED is also an interpreter and is almost
- identical to WISP except that it contains a line editor and provides a limited
- amount of syntax checking. After you are sure that your program functions
- perfectly and needs no further editing, use WISP rather than WISPED to run the
- file.
-
- Typing: WISPED TESTFILE
-
- from the DOS command line, runs WISPED and loads in the file TESTFILE. If
- TESTFILE does not yet exist you will be presented with a blank screen. If the
- file already exists, it will be loaded in, ready for editing. You will
- probably want to load -MAIN.WSP into the editor a play around with it; make
- sure you have a backup copy.
-
- Currently, WISPED does enough syntax checking to keep your programs from
- locking up your machine. An upcoming enhancement will provide for more
- extensive syntax checking.
-
- The maximum number of lines in any WISP program file is limited to 1990; more
- than enough to accomplish the purposes for which WISP has been designed.
-
- The first line of the file is reserved for use of the editor. You may put the
- cursor on this line and press <ENTER> in order to insert a new line at the top
- of your program file.
-
- Each line of the program can contain one, and only one, command.
-
-
- The line you wish to edit is selected with the up and down cursor keys. The
- HOME, END, INSERT, BACKSPACE and DELETE keys allow you to navigate and edit the
- highlit line. PageUp and PageDown move you forward or backward in the file,
- in 15 line increments.
-
- EDITOR COMMANDS
-
- <ALT><1> Copies the highlit line into a holding area.
-
- <ALT><2> Copies the contents of the holding area to the highlit line.
-
- <F1> Displays the proper syntax of the available WISP commands at
- the bottom of the screen. Use the up and down cursor keys to
- scroll through the syntax list. You may transfer the entire
- syntax line into your program by pressing <F1> or you can type
- the line in manually. If you transfer the command, you will
- have to edit it in order to insert your parameters. Press
- <ESC> to exit the syntax display. Along with the syntax of
- existing commands, the syntax list contains probable commands
- for enhancements which are being considered.
-
- <F2> Displays the amount of character space remaining in your
- program. Generally, you will run out of lines before running
- out of character space.
-
- <F3> Save to disc the program you are working on. After you edit
- a program file, you SHOULD save it to disc before running it.
- If the program crashes and you have not saved your work, you
- may have to do it all over.
-
- <F4> Helps you locate words or groups of words in your file. Just
- follow the displayed prompts.
-
- ^<F5> Sends the program file to your printer via port #1.
-
- <F6> RUNS the program.
-
- <F7> Toggles the INSERT/OVERSTRIKE mode for the line editor. This
- may be temporarily over-ridden by pressing the INSERT key.
-
- <F8> Deletes the highlit line and moves the following lines up one
- place.
-
- <F9> Toggles syntax checking on and off.
-
- <F10> Displays a handy chart of the extended ASCII characters and
- all of the 255 possible color combinations available to use
- with the the program statements requiring requiring a COLOR
- value.
-
-
- <ESC> Exits WISPED. You must manually save a modified file before
- exiting if you wish to keep the changes. No warning is given
- if you have not saved your work.
-
- <ENTER> Inserts a line below the highlit line and moves the following
- lines down one place.
-
-
- The following is a summary of the rules and commands recognized by WISP.
-
- INDENTATION- Any command or text may be intended for readability and style.
- Line numbers or labels may not be indented.
-
- CASE - All commands may be in either upper or lower case. Text is
- displayed in the case in which it is written.
-
- SEPARATORS - 1. The ONLY legal command separator is the slash (/).
- 2. Text for BLOCKPRINT must not contain a /.
- 3. Text for a MENU choice must not contain a /.
-
- REMARKS & - 1. A { left brace indicates a remark.
- THE LEFT 2. A { must not precede a command.
- BRACE 3. A { must precede a remark.
- 4. A remark must not contain a / (slash).
- 5. Text within a command must not contain a { or a / .
- PRINT/5/9/{Hello/31 is not allowed.
-
- WISPED loads in the entire program file, including remarks.
- WISP, having no use for remarks, does not load in any file line
- characters which follow the left brace.
-
- FILE SIZE - The file which WISP loads may contain as many as 1990 lines of
- text, which is more than adequate for the intended use.
-
- EDITING - You do not have to compose your programs with WISPED. Any word
- processor able to save in ASCII format is suitable. However,
- you should test your programs with WISPED to find any syntax
- errors.
-
- RESIDENCY - WISP is not a TSR program and will not cause any of the problems
- that TSRs often do.
-
- ANSI - WISP does NOT require the loading of ANSI.SYS to make full use of
- color.
-
- COMPILATION- Text files written for use with WISP do not require compiling.
-
- ERRORS - In order to keep WISP.EXE small and as fast as possible, no
- error checking is performed on the program file which it loads.
- It will be up to YOU to ensure the proper syntax and usage of the
- WISP commands.
-
-
- ECHO - Proper use of WISP commands will allow you to avoid the pesky
- DOS ECHO command if you plan to do a lot of SHELLing.
-
- SHELL - Shelling is not altogether reliable in DOS Versions 2.xx and you
- should avoid shelling unless you have V3.0 or later.
-
- SCREEN MODE - WISP currently supports only 25 line, 80 column text screens.
-
- LINE NUMBERS- Line numbers must be placed flush left. Line numbers that are
- not flush left will be placed so during syntax checking.
-
- LINE LABELS - Line labels must begin with :: (a pair of colons) and cannot
- contain a "/" or a "{". Line labels, if not flush left, will be
- placed so during syntax checking.
-
- BLANK LINES - There are no blank lines in a WISP program. Blank lines are
- purged during syntax checking and again when the file is saved.
-
- EXITING - Exiting a WISP program cannot be accomplished unless you allow
- for it by either; providing a menu choice as we did in the -MAIN
- demonstration program OR, using the BREAK command described in
- the syntax section on the following pages.
-
- STRUCTURE - A WISP program can be structured in a number of different ways
- and the method you select should be based on personal preference.
- There are two basic structural forms, INLINE and SUB-PROCEDURE.
-
- INLINE * Program code may be completely INLINE. The following is an
- example of INLINE coding:
-
- ::Main Menu {comments OK on this line
- MENU/ TITLE /4/1/1/112/78/78/0/S
- Choice A=
- Choice B=
- Choice C=
- Choice D= {an escape route!
- 1
- Perform all the activities Choice A requires (may be many
- lines of code)
- GOTO/Main Menu
- 2
- Perform all the activities Choice B requires (may be many
- lines of code)
- GOTO/Main Menu
- 3
- Perform all the activities Choice C requires (may be many
- lines of code)
- GOTO/Main Menu {comments are NOT OK on this line!
- 4
- CLS/7
- CURSORON
- LEAVE
-
-
- SUBS * Sub procedures can make the program easier to read as in the
- following example:
-
- ::Main Menu
- MENU/ TITLE /4/1/1/112/78/78/0/S
- Choice A=
- Choice B=
- Choice C=
- Choice D=
- 1
- GOTO/Choice A
- 2
- GOTO/Choice B
- 3
- GOTO/Choice C
- 4
- CLS/7
- CURSORON
- LEAVE
-
- ::Choice A
- Perform all the activities Choice A requires
- GOTO/Main Menu
- ::Choice B
- Perform all the activities Choice B requires
- GOTO/Main Menu
- ::Choice C
- Perform all the activities Choice C requires
- GOTO/Main Menu
-
- For a simple, one menu program, the INLINE code would probably
- be preferable. With multiple menus, the SUBS format might
- be easier.
-
- 1 FILE Using a single file for an entire program ensures the fastest
- execution speed at the possible expense of program readibility.
- If your program needs to be very large, the single file method
- will be of little value.
-
- 2+ FILES There are two alternatives to having a single large program;
- have several smaller programs that can run each other via the
- L-RUN command. This is illustrated in the program series
- -FILE1/FILE2/FILE3 which is started by typing: WISP -FILE1.
-
- The second alternative is to have separate files for each page
- of text and use the DSPF command to display them. This is
- illustrated in the -MAIN.WSP program and is our preferred choice
- unless there is a compelling reason to do otherwise. WISPED is
- not suitable for writing these text files; use a Word Processor
- or text editor, saving in ASCII.
-
-
- -----------------Command syntax, examples and descriptions--------------------
-
- NOTE: Only one command per line!
-
- BOX/BR/BC/ER/EC/CHR/COLOR/C/S Draws a BOX where BR is the beginning row,
- BC the beginning column, ER the ending row,
- and EC the ending column where BR<ER and
- BC<EC. CHR is either a 1 or 2 indicating a
- single or double line box. COLOR is a
- single value representing the foreground and
- background colors. See the Single Color
- Chart elsewhere in the documentation.
- Appending a /C to the argument clears the
- inside of the box to the color specified by
- COLOR. Append a /S if you wish the box to
- cast a shadow.
-
- *CAPTION/F/ROW/COLUMN/COLOR A probable future enhancement. Will control
- captioning. Captioning would be a line of
- text that would always be displayed on all
- screens when the F flag is set; useful for
- having a company name or message always
- visible without continuously re-printing it.
-
- CURSOROFF Turns the cursor off. If you find yourself
- at the DOS prompt without a cursor, simply
- type: WISPED CURSORON
-
- CURSORON Turns the cursor on. If you turn the cursor
- off, remember to turn it back on before
- leaving WISP.
-
- DSPF/FILENAME/ROW/COLUMN/COLOR Displays the text file FILENAME at Row,
- Column in color COLOR. The file must be an
- ASCII text file, 22 lines maximum. If the
- file is shorter than 22 lines it will
- display that which is available, if longer
- it will be truncated to 22 lines. The EOF
- marker will not be displayed. Text files
- are smaller than BLOADable files but are
- confined to one color combination. FILENAME
- may contain a drive and path.
-
- Example: DSPF/C:\BUSINESS\FILEA.WSP/2/2/31
-
- FILLSCRN/BR/BC/ER/EC/COLOR/ASCII Fills a screen area defined by BR, BC, ER
- and EC with the character ASCII in the color
- COLOR. To clear the screen use 32 for
- ASCII.
-
- Example: FILLSCRN/10/10/15/75/31/43
-
- Fills an area of the screen bounded by row
- 10 column 10 and row 15 column 75 with
- bright white on blue, plus signs.
-
-
- *GOSUB/LINELABEL A probable future enhancement.
-
- *RETURN A matching return statement. Gosubs will
- not be nestable.
-
- IFKEYHIT/ASCII/LINE# Compares the ASCII value of the key pressed
- in response to the WAIT statement against
- ASCII. If the values match program control
- is transferred to LINE#. You must create a
- loop to handle non-matching variables.
-
- 1
- .
- .
- Example: 10
- WAIT
- IFKEYHIT/27/99
- IFKEYHIT/-71/1
- GOTO/10
- .
- .
- 99
-
- WAIT waits for a keypress. If the key
- pressed was <ESC> the program transfers to
- line 99. If the key pressed was <HOME> the
- program transfers to line 1. If any other
- key was pressed, the program will go to line
- 10 and wait for another keypress. A chart
- showing the ASCII values of keypresses is
- included in this documentation.
-
- The target LINE# must exist in the program.
-
- BRIGHT Trades blinking for high intensity colors.
- Color selections above 127 are normally
- blinking. Calling BRIGHT trades this blink-
- ing for high intensity background colors.
-
- DIM Restores blinking characteristics for colors
- above 127. Exiting the program by way of
- LEAVE, SHELL or L-RUN automatically restores
- colors to blinking.
-
-
-
-
- LOCATE/ROW/COLUMN Locates the cursor at ROW and COLUMN.
-
- PAINT/BR/BC/ER/EC/COLOR Paints the screen area defined by BR, BC, ER
- and EC with COLOR.
-
- PRINT/ROW/COLUMN/TEXT/COLOR Print TEXT in color COLOR beginning at the
- specified row and column location.
-
- *RUNFILE/FILENAME A probable future enhancement. Will load
- into WISPED or WISP, FILENAME. This will
- allow you to run another WISP program
- without re-loading WISP or WISPED. The
- RETURN pointer for GOSUB will be erased and
- CAPTIONing will be turned off.
-
- SHELL/XXXX Shells and runs the program XXXX, returning
- when done. XXXX may contain a drive and
- path. If you save the screen prior to
- shelling and restore it just after the
- shell command, you can use GOTO to place you
- where you left off.
-
- Example: Shell/C:\WORDPROC\GALAXY
- GOTO/101
-
- Leaves WISP under a new command shell and
- runs the GALAXY program located on drive
- C in the directory WORDPROC.
-
- SHELL is useful for running DOS commands
- which WISP does not provide for. Use SHELL
- only with DOS versions 3.0 or later.
-
- SHELL Shells. Leaves WISP under a new command
- shell. You must type EXIT at the DOS
- command line to return. Be careful with
- both uses of the SHELL command; a poorly
- written program could leave you with many
- copies of the command environment. Use
- SHELL only with DOS versions 3.0 or later.
-
- *SAVESCRN A probable future enhancement. Saves the
- current screen. This will be useful before
- using the SHELL command.
-
-
- *RESTSCRN A probable future enhancement. Restores the
- screen to it's condition when the last
- SAVESCRN command was used. If the screen is
- saved prior to shelling and then restored
- after returning from the shell, a GOTO can
- return you to the exact place of departure.
- DO NOT use RESTSCRN unless a previous
- SAVESCRN has been used.
-
- Example: SAVESCRN save it.
- CLS/0 clear the screen.
- SHELL/PROGRAM run a program.
- RESTSCRN restore the screen.
- GOTO/WHEREEVER return to where you
- left off.
-
- LEAVE Exits the program and returns you to DOS.
- To ensure that you have not inadvertently
- terminated your program while in a second
- environment, type EXIT at the DOS prompt.
- If you return to WISP, your program needs
- some work!
-
- L-RUN/XXXX Exits and runs the program XXXX. XXXX is
- limited to 14 characters. XXXX may be a
- .BAT, .COM or .EXE program.
-
- Example: L-RUN/GALAXY
-
- Exits WISP and runs the GALAXY program.
- Since XXXX is limited to 14 characters, you
- would have to change the directory and drive,
- if necessary, before using L-RUN. Lines in
- the program might, then, look like:
-
- CDRV/C
- CDIR/WORDPROC
- L-RUN/GALAXY
-
-
- GOTO/LINE# Where LINE# is any flush left, 3 digit
- integer within the program. Only comments
- may be placed to the right and on the same
- line as the number. The range of GOTO
- target lines is 1-999 and need not be
- sequential in the program file. Do not
- confuse the line number you provide your
- program with the file line numbers displayed
- by the editor; they are not related.
-
- Example: GOTO/250
- .
- 250 {This is the target line.
-
- GOTO/LINELABEL Where LINELABEL is the name of a target
- line beginning with :: (a pair of colons).
- Line labels MAY NOT contain a "/" or "{".
- There may not be any remarks or other text
- on the same line as the GOTO call.
- Line labels are case insensitive.
-
- Goto Example: GOTO/HOME SWEET HOME
- Target Examples: ::HOME SWEET HOME OK
- ::any text HOME SWEET HOME NO
- ::Home Sweet Home any text OK
-
- GOTO/THIS LINE some remarks
- is illegal unless you have a target line
- which is identical, ie.
-
- ::THIS LINE some remarks
-
- Endless loops may be established if you are not careful with the GOTO command!
-
- MENU/TITLE/NOI/R/C/HLC/NC/TC/GTO/S
- Where:
-
- TITLE is the title of the menu which will
- appear inside the box.
- NOI is the number of selectable menu items.
- R/C is the ROW and COLUMN in which the
- upper left corner of the surrounding
- box will appear. The lower right box
- corner will be calculated by the
- program based on the length of the
- title and number of menu items.
- HLC is the color of the moving highlight.
- NC is the color of the menu items and
- surrounding box.
- TC is the color of the menu title.
- GTO (Go To Offset) is a pointer. The line
- number the menu selection will take
- you to is the menu choice + the GTO.
- /S provides a shadow.
-
- There must be a target line # for each menu choice.
-
-
- Items in the menu list must immediately
- follow the call to MENU and each must be on
- a separate line. The items in the menu list
- must be no greater nor less than NOI. The
- menu list should not be longer than there is
- room for on the screen minus the space taken
- for the box, title and dividing line. All
- menu choices MUST be the same length, end
- in a equal sign and be the same length as
- the title. The equal sign serves the
- WISPED syntax checker and helps to ensure
- equal lengths. WISP will remove the = so it
- will not be visible in the menu.
- MENU CHOICES MAY NOT BEGIN WITH A NUMBER.
-
- Example: MENU/ MY MENU /5/4/3/78/31/78/10
- Choice 1 =
- Choice #2 =
- Choice Three=
- Choice #4 =
- Choice 5 =
-
- This will present you with a 5 item menu,
- with the UL corner of the box at row 4,
- column 3. The highlight bar will be yellow
- on red, the box and menu choices will be
- white on blue and the title will be yellow
- on red. If the third item in the menu list
- is selected, you will GOTO line number 13
- which is the menu item choice (3) plus the
- GTO (10). If you have several menus in a
- program file, the GTO of each one must be
- sufficiently different in order to avoid
- overlapping. The spacing on either side of
- the menu title can be adjusted to center
- the title within the box.
-
-
- Options while menu is displayed: <F1> Blanks the screen until any key is
- pressed. You may want to display this
- option as is done in the demo.
-
- <F2> Sends a form feed to printer port 1.
-
- Note: For the editor, WISPED, a <F3> keypress stops program operation and
- returns you to the editing environment.
-
-
- Menu items may be selected in two ways;
- by placing the highlight bar on the desired
- selection and pressing <ENTER> or, by
- pressing a letter key which corresponds to
- the desired selection. The A key will select
- item 1, the B key item 2, etc.
-
- If HLC and NC are the same, causing the
- highlight bar to be invisible, the <ENTER>
- key is disabled and menu selections may be
- made only by letter selections. This is
- done in the example program MCTEST.WSP.
-
- BLOCKPRINT/NOI/CLR/ROW/COL Where:
-
- NOI is the number of line of text that
- follow which are to be displayed.
- CLR is the color in which the text will be
- displayed.
- ROW is the first row for the text block.
- COL is the first column for the text block.
-
- The line length of text is limited to 76
- characters.
-
- Example: BLOCKPRINT/4/95/5/10
- Now is the time
- for all good men
- to come to the aid
- of their party.
-
- This will print the 4 lines of text shown,
- with line 1 on row 5 starting at column 10,
- in bright white on magenta.
-
- BREAK/ASCII/LINE# Placing BREAK at the beginning of a program
- will allow you to break out of the program
- while waiting for a response due to a WAIT
- instruction. If the value of the key press
- is equal to ASCII, program control will
- transfer to line number LINE#. This is not
- needed with WISPED because <F3> puts you
- into the editor mode. However, the feature
- is in WISPED so you can test it with your
- programs.
-
- Example: BREAK/-117/999
-
- While waiting for a key press in response
- to WAIT, if the key press is CTRL-END,
- program control transfers to line 999.
-
- The target LINE# must exist in the program.
-
-
- CDRV/DRIVE Changes active drive specification.
-
- Example: CDRV/D
-
- Changes to drive D
-
- CDIR/DIR Changes directories.
-
- Example: CDIR/D:\WORDPROC
-
- Changes to the directory WORDPROC on drive
- D. If you want to change the drives and
- directory, before shelling for example, the
- sequence of commands would be as follows:
-
- CDRV/D
- CDIR/D:\WORDPROC
- SHELL/GALAXY
-
- The CDRV and CDIR commands are useful only in conjunction with the L-RUN and
- SHELL commands.
-
- WAIT/ROW/COLUMN/COLOR/TEXT Prints TEXT at ROW and COLUMN in COLOR then
- waits for a keypress. WAIT without
- arguments simply waits for a keypress.
-
- Example: WAIT/5/16/78/Press any key
-
- Prints "Press any key" in row 5, starting at
- column 16 in yellow on red, waits for a key
- press. If any key press will do, then WAIT
- is sufficient. If you need to control the
- program direction and limit the key press
- response, the command IFKEYHIT should be
- used on the following line.
-
- Note: For the editor, WISPED, a <F3> keypress stops program operation and
- returns you to the editing environment.
-
- CLS/COLOR Clears the screen to COLOR.
-
- BLOAD/FILENAME$ Loads a complete text screen file from disc
- into video memory. The memory area into
- which the file is loaded is automatically
- determined by the monitor in use. The
- screen file must be in the proper format.
- BLOAD brings in screen files with colors
- intact. BLOADable files are about 4K in
- size and may be created with BASIC.
-
- *BSAVE/FILENAME$ A probable enhancement. Saves a screen in
- BLOADable format. This feature will allow
- you to predesign screens for your programs.
- BSAVE will be availabe only in WISPED, where
- it is useful.
-
-
- *XSCROLL/BR/BC/ER/EC/TIMES/S A probable future enhancement.
- Where X is replaced by either U, D, L or R
- to scroll Up, Down, Left or Right. The area
- of the screen defined by BR, BC, ER and EC
- is scrolled TIMES times at speed S. Speed
- values of 0 to 5 are useful; 0 being the
- fastest.
-
- Example: USCROLL/5/5/10/15/3/0
-
- Scrolls the area bounded by row 5, column 5
- and row 10, column 15, upwards 3 times as
- fast as possible.
-
- *VPCX/FILENAME A probable future enhancement. Display a
- graphics PCX file on any monitor.
-
- VPRINT/ROW/COLUMN/TEXT/COLOR Will display TEXT vertically beginning at ROW
- and COLUMN in COLOR.
-
- Example: VPRINT/5/10/abcd/31
-
- Displays:
- a
- b
- c
- d
-
- YNKP/TEXT/R/C/COLOR/GTY/GYN Waits for either a Yes or No answer.
- Displays TEXT at row R and column C in
- COLOR. Waits for either a Y, y, N or n
- keypress. If Y or y (YES) then the GOTO
- target line is GTY otherwise the target line
- is GTN. Other key presses are invalid.
-
- Example: YNKP/Are you sure?/10/20/12/101/201
-
- If answer is yes then the program transfers
- control to line 101, if no control is
- transfered to line 201.
-
- YNKP is similar to IFKEYHIT except that only
- YyNn are legal responses. YNKP eliminates
- the loop required by IFKEYHIT should a
- simple Yes-No response be sufficient.
-
- The target lines GTY and GTN must exist in your program.
-
-
- Note: For the editor, WISPED, a <F3> keypress stops program operation and
- returns you to the editing environment.
-
-
-
- *COUNTERUP Adds 1 to the value of an internal counter.
-
-
- *COUNTERDOWN Subtracts 1 from the value of the counter.
-
-
- *COUNTERCLEAR Sets the counter to zero.
-
-
- *DISPLAYCOUNTER/ROW/COLUMN/COLOR Displays the current value of the counter
- at row, column in color.
-
-
- *BEEP Makes a beep through the speaker.
-
-
-
-
-
-
-
-
-
-
-
- *FUTURE ENHANCEMENTS: We were working on the enhancements when this version of
- the program was released. Considering the delay between release and eventual
- distribution, most of the work is likely done.
-
-
- --------------------------------Color Chart-----------------------------------
-
- Use the values in this chart for the COLOR argument in all routines.
-
-
- --------------------------Background-------------------------
-
- Black Blue Green Cyan Red Magenta Brown White
- Foreground
-
- Black 0 16 32 48 64 80 96 112
- Blue 1 17 33 49 65 81 97 113
- Green 2 18 34 50 66 82 98 114
- Cyan 3 19 35 51 67 83 99 115
- Red 4 20 36 52 68 84 100 116
- Magenta 5 21 37 53 69 85 101 117
- Brown 6 22 38 54 70 86 102 118
- White 7 23 39 55 71 87 103 119
- Gray 8 24 40 56 72 88 104 120
- Bright Blue 9 25 41 57 73 89 105 121
- Bright Green 10 26 42 58 74 90 105 122
- Bright Cyan 11 27 43 59 75 91 107 123
- Bright Red 12 28 44 60 76 92 108 124
- Bright Magenta 13 29 45 61 77 93 109 125
- Bright Brown 14 30 46 62 78 94 110 126
- Bright White 15 31 47 63 79 95 111 127
-
- For a blinking foreground add 128 to the above values.
-
- Not all color combinations are suitable for all monitors. Check your programs
- on the monitor type that will be in use.
-
-
- ASCII VALUES OF KEYPRESSES
-
- Shift-Tab -15 F1 -59 Home - 71
- Alt-A -30 F2 -60 Ctrl-PrtSc -114
- Alt-B -48 F3 -61 Ctrl-End -117
- Alt-C -46 F4 -62 Ctrl-PgDn -118
- Alt-D -32 F5 -63 Ctrl-PgUp -132
- Alt-E -18 F6 -64 Ctrl-Home -119
- Alt-F -33 F7 -65 Cursor Up - 72
- Alt-G -34 F8 -66 Cursor Down - 80
- Alt-H -35 F9 -67 Cursor Right - 77
- Alt-I -23 F10 -68 Cursor Left - 75
- Alt-J -36 Ctrl-F1 -94 PgUp - 73
- Alt-K -37 Ctrl F2 -95 PgDown - 81
- Alt-L -38 Ctrl F3 -96 End - 79
- Alt-M -50 Ctrl F4 -97 Insert - 82
- Alt-N -49 Ctrl F5 -98 Delete - 83
- Alt-O -24 Ctrl F6 -99
- Alt-P -25 Ctrl F7 -100
- Alt-Q -16 Ctrl F8 -101
- Alt-R -19 Ctrl F9 -102
- Alt-S -31 Ctrl F10 -103
- Alt-T -20 Alt-F1 -104
- Alt-U -22 Alt-F2 -105
- Alt-V -47 Alt-F3 -106
- Alt-W -17 Alt-F4 -107
- Alt-X -45 Alt-F5 -108
- Alt-Y -21 Alt-F6 -109
- Alt-Z -44 Alt-F7 -110
- Alt-F8 -111
- Alt-F9 -112
- Alt-F10 -113
-
- The dash preceding the number shown is a minus sign and must be used.
-
-
- REGISTRATION OF WISP
-
- WISP is shareware, not public domain. As such, you are expected to register
- your copy if you use it.
-
- Registration is $45, for which you get:
-
- 1. The latest version with at least 80% of the proposed enhancements.
- 2. A printed manual.
- 3. Placement on the update list.
- 4. Telephone support.
- 5. One additional upgrade beyond that which you receive when registering,
- when it becomes available.
-
- Check with us, before you register, on the status of the enhancements if one
- or more of the enhancements is the deciding factor for registration.
-
- The following uses of WISP require either site licenses or distribution fees:
-
- 1. Demonstration programs to potential customers.
- 2. Business use on more than one computer.
- 3. Installation or tutorial programs for customers.
- 4. Disc catalogs offering merchandise for sale.
- 5. Any other activity in which the use of WISP allows you to make
- additional profit or gain good will for your business.
- 6. Use on more than 1 computer in an institution of learning above
- grade 12.
-
- The following uses of WISP require no additional fees beyond the basic
- registration:
-
- 1. Non-profit charitable organizations.
- 2. Non-profit educational institutions, grades 12 and below.
- 3. Shareware catalogs which mention, on the main screen, that WISP was
- used to develop the catalog.
-
- If you are unsure of your need for a license, check with us.
-
-
-
- WISP REGISTRATION FORM Date_________________________
-
-
- Name___________________________________________________________ Apt._________
-
- Company_________________________________________________________MS___________
-
- Address______________________________________________________________________
-
- City______________________________________________ State_______ Zip__________
-
- Phone ( ) - Ext.__________
-
- Where did you get this program?______________________________________________
-
- Computer_____________________Monitor___________Drives________________________
-
- DOS Version__________________
-
- Do you program?________Which language(s)?____________________________________
-
- What do you expect to do with WISP?__________________________________________
-
- _____________________________________________________________________________
-
- I want to register and use the verison of WISP I now have. US $15.00 ________
-
- I want to register and get the upgrade, manual, etc. US $45.00 ________
-
- I am adding for overseas air shipment. US $ 5.00 ________
-
- I need some information on site or distribution licenses for the purpose of:
-
- _____________________________________________________________________________
-
- I would like to see the following features added to WISP:____________________
-
- _____________________________________________________________________________
-
- _____________________________________________________________________________
-
- _____________________________________________________________________________
-
- _____________________________________________________________________________
-
-
- MAIL TO: Sitting Duck Software Sorry, we cannot accept credit cards.
- POBox 130 We will ship COD, via UPS only, for
- Veneta, OR 97487 a $5.00 COD fee if you prefer to order
- (503) 935-3982 by telephone.
-
-
-
- In addition to your written suggestions above, please checkmark any of the
- following features if they would be of interest to you.
-
-
-
- 1. Writing to a sequential file. ____
-
- 2. Send text to printer. ____
-
- 3. TimerOn, TimerOff, etc.; for timed testing. ____
-
- 4. Random integer generation. ____
-
- 5. Text input, ie: a person might input their name ____
- for some yet to be determined purpose.
-
-
-
-