




                                COLOR.TXT
                               Prepared by
                               Chris Jenks






  This text file explains how the Color/Music text  files  work  and  how
they  can  be  made.  I  wrote  this  file  because  I  couldn't  find an
explanation of the text files anywhere,  until I came across  3101CWG.MRG
which had the actual PC-TALK routines in it.

  The escape sequences in  the  text  files  all  start  with  an  escape
(Character  code  =  27),  followed by a bracket ([,  Character code 91),
followed by commands which tell  your  communications  software  (PCT666,
QMODEM,  etc.)  what  to do.  The following is a list of all these escape
commands and a description of each.  A dollar sign ($) will  be  used  to
indicate  the  escape  character,  and a percent sign (%) will be used to
indicate character 14.

                              Color Control

  This is an escape,  bracket,  two digit integers separated  by  another
character,  and  ending  in  "m"  or "J".  It doesn't make any difference
whether you use "m" or "J".  The separating character,  required for more
that  one  integer,  may  be  almost  any character.  The integer usually
represents the color for the cursor to change to,  and there is almost no
limit to the number of integers you can put in.

Example: $[31m
         Would cause the text printed to be red.

         $[01;05;34;41J
         Would cause the next text printed to be blinking high  intensity
         blue on blinking high intensity red.

  The  two  digit  integers  used  in  these sequences have the following
meanings:

  00 -- Resets foreground and background colors to default.
  01 -- Makes text printed high intensity.
  02 -- Clears the screen and puts the cursor at the top.
  05 -- Makes text printed blink.

  Foreground | Background | Color value | Color
 ------------+------------+-------------+---------
      30     |     40     |      0      | Black
      31     |     41     |      4      | Red
      32     |     42     |      2      | Green
      33     |     43     |      6      | Brown
      34     |     44     |      1      | Blue
      35     |     45     |      5      | Magenta
      36     |     46     |      3      | Cyan
      37     |     47     |      7      | White

                             Cursor Position

  This is an escape,  bracket,  and two two digit integers  separated  by
another  character,  and ending in "f".  As in the previous example,  the
separating character can be  almost  any  character.  The  first  integer
represents the row, the second represents the column.

Example: $[10;40f
         Would move the cursor to row 10, column 40.

                              Music Control

  This is an escape, bracket, a string to play, and a character 14 
(Character 14 looks like a note symbol). The string to play is the same 
one you would use for the Basic PLAY command.

Example: $[CDEFGAB%
         Would play the notes CDEFGAB.

                              Screen Control

  This is an escape,  bracket,  four  two  digit  integers  separated  by
characters,  and  a  close  bracket  (]).  This command is used to change
screens (See the Basic SCREEN command).  The first integer represents the
mode,  the  second  integer  represents  the  burst,  the  third  integer
represents the apage, and the fourth represents the vpage.

Example: $[00;01;02;03]
         Would write to page 2,  display page 3,  and be in 80  character
         color text mode.

                               String Input

  This is an escape, a bracket, and a vertical line (|). When your 
communications program receives this, it executes the following line:
INPUT I$:PRINT #1,I$

  #1 is the channel your modem is open to.
                                                                                             