CAI Commands Help File
@1,Instructional command for PC-CAI "@" At commands
@2,Textual commands for PC-CAI "." Dot commands
@3,Example of Using @Case Command to Make a Menu
@5,Example Uses of Graphics and Animation
@7,What is Shareware
@8,How to Become a Registered User
@9,Assocation of Shareware Professionals
##1
                            PC-CAI "@" (AT) COMMANDS
                            ------------------------

@BEGIN QUESTION - Marker at first of a question
@CASE - Branch according to user's answer
@END QUESTION - End of a question
@ESCAPE - What happens when user presses Esc
@GOTO - Goto a label (@LABEL)
@GOBACK - Go back to top, then search for a label
@IF - Branching
@LABEL - Branching Location
@MENU - Goto DOS .CAI menu
@OPTION - Controls Esc key
@READ - User enters an answer
@RIGHT (*TEXT*) [KEYWORD,EXACT,EXACT NOCASE,SOUNDEX . . .]
@SHELL (*DOSCOMMAND*) - Execute a DOS command
@STOP - End the tutorial
@TRIES ## - Number of times to allow wrong answers
@WRONG (*TEXT*)
@TRIES ##

##2

                            PC-CAI TEXTUAL COMMANDS
                            -----------------------

.ANIMATE - make up to four images move in sequence
.BLANK ##
.CENTER (*text*) - center text
.CIRCLE - craw a circle
.CLS or .CLEAR - CLEAR SCREEN
.COLOR - set monitor color
.DRAW - draw lines in graphic mode
.GET - Get an impage into memory
.INFORMATION ## (*text*) CONDITIONAL - collect informtion from user response
.LINE (x,y)-(x,y)
.LOCATE y,x - locate cursor on the screen at y,x
.MOVE - move a single image around the screen
.PAINT - fill an graphic image with a color

continue...
##3

                       PC-CAI TEXTUAL COMMANDS continued
                       ---------------------------------

.PALETTE - choose graphic color palette
.PAUSE (*PROMPT*) - pause until Enter is pressed
.PCX name x,y - Display a PCX (Paintbrush graphic)
.PLAY (*designation*) ... plays music
.PSET - Place graphic pointer on screen
.RECORD (*TEXT*) FILE=oufile ... records answers
.REM - Remark
.SKIP ##
.USE  - PROG=progname ... temporarily use another file
.WAIT # - wait # seconds


##4
                    EXAMPLE OF USING @CASE TO CREATE A MENU
                    ---------------------------------------
                                                                               
@CASE(*ABCD:PCX,ANIM,MOVE,END*) center border
  A - Show A Sample PCX Graphics File
  B - Show a Sample Animation
  C - Show Sample Move
  D - End This Program
@END
.pause
@LABEL:PCX
...place commands here
@LABEL:ANIM
...place commands here
@LABEL:MOVE
...place commands here
@LABEL:END
.locate 24,1
.pause (*Press Enter to End this Program*)
@STOP menu

##5

                      EXAMPLES OF USING GRAPHICS COMMANDS
                      -----------------------------------
                                                                               
EXAMPLE DISPLAY PCX GRAPHIC
---------------------------
.screen 1
.cls
.pcx pcxtest.pcx 1,2


EXAMPLE MOVE
-------------
.screen 1
.cls
.locate 20,1(*Example Moving Single Image*)
.get runner1
.move (1,100)-(250,100)
.locate 20,1 (*                            *)
.locate 20,1
.pause


##6

                               EXAMPLE ANIMATION
                              ------------------
                                                                               
.SCREEN 1
.cls
.locate 20,1 (*Example Animation*)
.line (1,130)-(155,95)
.line (155,95)-(315,130)
.line (1,130)-(315,130)
.LOAD RUNNER1,RUNNER2,RUNNER3,RUNNER4
.ANIMATE (1,100)-(150,60) STEPX=4 STEPY=-1 PAUSE=.1
.ANIMATE (150,65)-(300,130) STEPX=4 STEPY=1 PAUSE=.1
.locate 20,1 (*                              *)
.locate 20,1
.pause
##7
                               S H A R E W A R E
                               _________________


                            TRY IT BEFORE YOU BUY IT

The purpose of shareware products is to allow you to try software products
before you buy them.  PC-CAI is not a public domain program, it is fully
copyrighted. Persons who use PC-CAI beyond "trying it out" should purchase a
copy. You receive several benefits from becoming an official registered user:

1. You are officially licensed to use the program.
2. You help to keep the product growing to meet your needs.
3. You receive the very latest version, with a printed, bound, and expanded
manual.
4. You receive periodic newsletters announcing new releases, and pointing out
important information on any bugs and fixes.
5. You are able to purchase update to new versions for a reduced cost.

See the next screen on "How to Register" . . .
##8

                        HOW TO BECOME A REGISTERED USER
                        -------------------------------


Print out the file on disk named ORDER, fill it out and mail it directly to
TexaSoft. To print this file, you can use the command:

COPY ORDER LPT1:

or

PRINT ORDER

To purchase by phone, call 214-291-2115 during business house (Central Time).
Please have your MasterCard or Visa handy. Corporations, schools and
governmental bodies may order with a purchase order. Organizational quantity
discounts and site licenses are available.

                              ---Order Today!---

##9

                           ┌─────────┐
                     ┌─────┴───┐     │              (tm)
                   ──│         │o    │──────────────────
                     │   ┌─────┴╨──┐ │  Association of
                     │   │         │─┘  Shareware
                     └───│    o    │    Professionals
                   ──────│    ║    │────────────────────
                         └────╨────┘    MEMBER

TexaSoft is a member of the Association of Shareware Professionals (ASP).
ASP wants to make sure that the shareware principle works for you.  If you
are unable to resolve a shareware-related problem with an ASP member by
contacting the member directly, ASP may be able to help. The ASP Ombudsman
can help you resolve a dispute or problem with an ASP member, but does not
provide technical support for members' products.  Please write to the ASP
Ombudsman at P.O. Box 5786, Bellevue, WA 98006 or send a Compuserve message
via Easyplex to ASP Ombudsman (70007,3536).

