home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / ansi / ansi_la1.zip / ANSI-LA.DOC < prev    next >
Text File  |  1986-08-02  |  26KB  |  484 lines

  1.  
  2.  
  3.  
  4.  
  5.                         A N S I  of  L o s  A n g e l e s                        A N S I  of  L o s  A n g e l e s
  6.                                        by
  7.                                 Eric C. Lambart
  8.  
  9.                                   Version 1.03 
  10.                             Saturday, August 2, 1986
  11.  
  12.  
  13.          Welcome  to  ANSI of LA,  the latest and greatest in  ANSI  screen 
  14.     editing  software.   ANSI of LA [AoLA] has been written in Turbo Pascal 
  15.     to make it fast, and it has been specifically designed for ease of use. 
  16.  
  17.          ANSI of LA will edit ANSI (Color), ASCII (Plain text), or Dump (An 
  18.     exact copy of video memory)  screens.   With AoLA,  you can easily draw 
  19.     pictures,  color advertisements,  and color menus or welcome files  for 
  20.     your Bulletin Board,  limited ONLY by your imagination and the IBM PC's 
  21.     extended-ASCII character set!
  22.  
  23.          ANSI of Los Angeles  is  a  new  addition to the list of excellent 
  24.     Easyware    programs in existance.    Easyware is a novel new software-
  25.     distribution concept,   also known as "Shareware" or "Freeware,"  where  
  26.     program(s)    can be freely distributed to friends and  other  bulletin 
  27.     boards,    but still must be paid for.   If you try  a Easyware program 
  28.     that  you have been given,   and continue to use it,  you MUST pay  the 
  29.     author for the program's use.  
  30.          
  31.          If you enjoy AoLA,  and use it (more than just testing it),   then 
  32.     please pay me  (Eric  Ryan-Lambart)  $15,   and  you  will get your own 
  33.     registered copy of the latest version of ANSI of Los Angeles.
  34.          
  35.          Please  send  $15,  payable to ***Eric Ryan***,   and include your 
  36.     name and address  so we can send you the latest release of ANSI of  LA,   
  37.     with  a printed manual. 
  38.          
  39.          Send Check or Money Order payable to : 
  40.  
  41.           Eric Lambart
  42.           Post Office Box 2,
  43.           Santa Monica, California 90406-0002 
  44.  
  45.  
  46.  
  47.  
  48.                                  -- THANKS!! --                                 -- THANKS!! --
  49.  
  50.                               Table of Contents                              _________________
  51.  
  52.     Getting Started :                                   1
  53.          Cursor Movement Commands                               1
  54.          The Status Line                                        1
  55.          Function Key Commands                                  1
  56.          Escape Commands                                        1
  57.          Other Commands                                         2
  58.     Command Details :                                   3
  59.          F1    - Toggle Draw Mode on/off                        3
  60.          F2    - Set Tabs on Ruler Line                         3
  61.          F3    - Get Color at Cursor                            3
  62.          F4    - Put Current Color at Cursor                    3
  63.          F5    - Toggle Show Color on/off                       3
  64.          F6    - Flip through Screens 1 to 3                    3
  65.          F7    - Mark and Cut                                   4
  66.          F8    - Paste Marked Text                              4
  67.          F9    - Swap Foreground and Background Colors          4
  68.          F10   - ASCII Table                                    4
  69.          Esc-B - Set Background Text Color                      4
  70.          Esc-C - Set Foreground and Background Colors           4
  71.          Esc-D - Set Direction of Travel                        5
  72.          Esc-F - Set Foreground Text Color                      5
  73.          Esc-H - Show Help Screen                               5
  74.          Esc-L - Load an Image File                             5
  75.          Esc-O - Go to Object Library Menu                      5
  76.          Esc-Q - Quit to DOS                                    6
  77.          Esc-S - Save an Image File                             6
  78.          Esc-W - Wipe-out (clear) Current Screen                6
  79.          Ctl-Q - Quote Next Key Pressed                         6
  80.          Ctl-\ - Clear Current Line                             6
  81.          Ctl-_ - Save Screen for Undo                           6
  82.          Ctl-* - Undo Recent Changes                            7
  83.          Alt-1..Alt-0 
  84.                - Select Character Sets                          7
  85.          1..9, /, -, \ & +
  86.                - Display Characters in Current Set              7
  87.          Tab   - Move to Next Tabstop                           7
  88.          Sft-Tab 
  89.                - Move to Previous Tabstop                       7
  90.          Ins   - Insert a Space at Cursor                       7
  91.          Del   - Delete Character at Cursor                     7
  92.     Revision History                                    8
  93.  
  94.     ANSI of Los Angeles                                              Page 1    ANSI of Los Angeles                                              Page 1
  95.  
  96.                              ...Getting Started...
  97.  
  98.                            Cursor Movement Commands : 
  99.     
  100.                     Up-arrow      - Move up one character.       
  101.                     Down-arrow    - Move down one character.     
  102.                     Left-arrow    - Move left one character.     
  103.                     ^Left-arrow   - Move left one word.
  104.                     Right-arrow   - Move right one char
  105.                     ^Right-arrow  - Move right one word.
  106.                     Home          - Move to left of line.
  107.                     Control-Home  - Move to top line.
  108.                     End           - Move to right of line.
  109.                     Control-End   - Move to bottom line.
  110.  
  111.  
  112.                                The Status Line :
  113.  
  114.   Cursor position \      / Color at cursor   Current direction\
  115. 1%%%%%%%%%%%%%%%%80,24%White on Black%%%%%%%%%%%%%%%%%%%%%Color>Set :123456789/-
  116.  \Current editing screen                      Current color/   Current Set /
  117.  
  118.  
  119.                             Function Key Commands :
  120.  
  121.                F1  - Toggle Draw Mode on/off
  122.                F2  - Set Tabs on Ruler Line
  123.                F3  - Get Color at Cursor
  124.                F4  - Put Current Color at Cursor
  125.                F5  - Toggle Show Color on/off
  126.                F6  - Flip through Screens 1 to 3
  127.                F7  - Mark and Cut
  128.                F8  - Paste Marked Text
  129.                F9  - Swap Foreground and Background Colors
  130.                F10 - ASCII Table
  131.  
  132.                      Escape Commands (Press Escape First) :
  133.  
  134.                B   - Set Background Text Color
  135.                C   - Set Foreground and Background Colors
  136.                D   - Set Direction of Travel
  137.                F   - Set Foreground Text Color
  138.                H   - Show Help Screen
  139.                L   - Load an Image File
  140.                O   - Go to Object Library Menu
  141.                Q   - Quit to DOS
  142.                S   - Save an Image File
  143.                W   - Wipe-out (clear) Current Screen
  144.  
  145.     ANSI of Los Angeles                                              Page 2    ANSI of Los Angeles                                              Page 2
  146.                                 Other Commands :
  147.  
  148.                Control-Q        - Quote Next Key Pressed
  149.                Control-\        - Clear Current Line
  150.                Control-_        - Save Screen for Undo
  151.                Control-*        - Undo Recent Changes
  152.                Alt-1..Alt-0     - Select Character Sets
  153.                1..9, /, -, \, + - Display Characters in Current Set
  154.                Tab              - Move to Next Tabstop
  155.                Shift-Tab        - Move to Previous Tabstop
  156.                Ins              - Insert a Space at Cursor
  157.                Del              - Delete Character at Cursor
  158.                Esc              - Enter Command Mode
  159.     
  160.     ANSI of Los Angeles                                              Page 3    ANSI of Los Angeles                                              Page 3
  161.                                Command Details :
  162.  
  163.                          F1 - Toggle Draw Mode on/off
  164.  
  165.          Pressing  F1   will  toggle Draw mode on/off.   If  Draw  mode  is 
  166.     currently active, the word "Draw" will appear on the Status-Line.  Draw 
  167.     mode  is an EASY way to draw boxes and lines on your  screen.    Rather 
  168.     than  using  1..9,/,-,\,  and + key to draw lines and boxes,   you  can 
  169.     activate draw mode,  then just use the keypad cursor-keys to draw lines 
  170.     wherever you move the cursor. 
  171.          Draw mode only works for character sets 2 through 6.  (Press Alt-2 
  172.     through  Alt-6   to activate one of those sets.  Make sure you use  the 
  173.     keyboard numbers, not the keypad!!) 
  174.  
  175.                           F2  - Set Tabs on Ruler Line
  176.  
  177.          If  you want to line up objects or text in a vertical column,  you 
  178.     can   use set Tab Stops,   and then press the Tab or Shift-Tab keys  to 
  179.     move to a set position.    When you press the F2  key,  a   blank ruler 
  180.     line   appears  on the bottom line of the screen,    with  every  tenth 
  181.     column  marked off.    To set or reset a Tab Stop,   move the cursor to 
  182.     the   position on the ruler line,   then press the Space Bar to  toggle 
  183.     the stop on and off.    Press Esc,  Up-Arrow, or F2   again to exit the 
  184.     ruler line. 
  185.  
  186.                             F3 - Get Color at Cursor 
  187.  
  188.          If you press F3,  ANSI of LA will change the current text color to 
  189.     the color of whatever text the cursor is on. 
  190.  
  191.                         F4 - Put Current Color at Cursor 
  192.  
  193.          Pressing F4  will change the color of whatever text the cursor  is 
  194.     on to the current text color. 
  195.  
  196.                          F5 - Toggle Show Color on/off 
  197.  
  198.          The default Show-Color mode is on.   Show-Color simply means  that 
  199.     ANSI  of  LA spells out,  in English,  the color of whatever  text  the 
  200.     cursor is on. 
  201.  
  202.                         F6 - Flip through Screens 1 to 3 
  203.  
  204.          ANSI  of  LA  allows you to edit up to three separate  screens  in 
  205.     memory,  at the same time!  To toggle through the screens, simply press 
  206.     F6.   The current screen number is displayed at the first character  in 
  207.     the status line. 
  208.     ANSI of Los Angeles                                              Page 4    ANSI of Los Angeles                                              Page 4
  209.                                F7 - Mark and Cut 
  210.  
  211.          With  ANSI  of LA,  you can copy portions of one screen  to  other 
  212.     portions of the same screen,  or to one of the other 2 editing screens.  
  213.     To Mark and Cut a block of text, position the cursor at the upper-left-
  214.     hand corner of the block,  then press F7.   Then move the cursor to the 
  215.     lower-right-hand corner,  and press F7  again.   To abort a  block-cut, 
  216.     press Esc while marking.
  217.  
  218.  
  219.                              F8 - Paste Marked Text 
  220.  
  221.          To Paste a block of text previously marked with F7,  position  the 
  222.     cursor  to  the place on the screen where you want the  upper-left-hand 
  223.     corner of the block to rest,  then press F8.  If you press F8 somewhere 
  224.     within the original block on the screen, you may mess up the block,  so 
  225.     be careful!
  226.          
  227.                    F9 - Swap Foreground and Background Colors 
  228.  
  229.          Rather  than  pressing Esc-C to set your forground and  background 
  230.     colors for inverse (a color with a non-black background),  you can just 
  231.     press F9, and the background color will become the foreground,  and the 
  232.     foreground color will become the background.   You can see what the new 
  233.     combination  looks  like by looking at where it says  "Color"   on  the 
  234.     status line.
  235.          
  236.                                F10 - ASCII Table 
  237.  
  238.          Many  of  IBM's  extended character set  are  represented  in  the 
  239.     different AoLA character sets, but some are not.  To see the full range 
  240.     of extended-ASCII characters,  press F10,  and a table of the extended-
  241.     ASCII characters will be displayed.   To enter any of the characters on 
  242.     the table,  simply hold down the Alt key while entering the code number 
  243.     on the _Keypad_, then release the Alt key. 
  244.  
  245.                      Escape Commands (Press Escape First) :
  246.  
  247.                        Esc-B - Set Background Text Color :
  248.  
  249.          Press Esc-B to set the Background color.  For normal text,  set it 
  250.     to  black.   If you want inverse,  try setting it to an  actual  color.  
  251.     Also, see the F9 command. 
  252.  
  253.                  Esc-C - Set Foreground and Background Colors :
  254.  
  255.          Pressing  Esc-F will act as if you pressed Esc-F then  Esc-B;   it 
  256.     just sets the Foreground and Background colors.  See those commands. 
  257.     ANSI of Los Angeles                                              Page 5    ANSI of Los Angeles                                              Page 5
  258.                        Esc-D - Set Direction of Travel :
  259.  
  260.          Travel  direction  is another exclusive AoLA feature.    Normally, 
  261.     when  you  type anything in the editor,  the cursor will then move  one 
  262.     space  to  the right.   If you want it to move in any other  direction, 
  263.     press  Esc-D,  then press the cursor key corresponding to the direction 
  264.     that you want the cursor to travel.  The F4 command is also affected by 
  265.     the Esc-D setting, so you can create stripes of color in any direction. 
  266.          You can also set diagonal directions by using the Home, End,  PgUp 
  267.     and  PgDn keys.   The current direction of travel is indicated  by  the 
  268.     arrow  just before the word "Set"  on the status line.  If it is a "\", 
  269.     then it is either up-and-left or down-and-right, and if it is "/"  then 
  270.     it is either up-and-right or down-and-left. 
  271.  
  272.  
  273.                       Esc-F - Set Foreground Text Color :
  274.  
  275.          Press Esc-F to set the foreground text color.   Anything you  type 
  276.     in will be in this color with the current background color. 
  277.  
  278.                            Esc-H - Show Help Screen :
  279.  
  280.          If you press Esc-H, a short help summary will pop-up, describing 
  281.     most of the ANSI of LA commands.
  282.  
  283.                           Esc-L - Load an Image File :
  284.  
  285.          To  load  any  text  screen,  press Esc-L.    After  entering  the 
  286.     filename, if the file exists, AoLA will prompt you for the screen type.  
  287.     If it is a color screen, press C.  For a non-color screen, press A, and 
  288.     if  it's a screen-dump,  press D.   If you decide not to load  a  file, 
  289.     enter  a  non-existant filename or press Esc when AoLA prompts you  for 
  290.     the screen type. 
  291.  
  292.                       Esc-O - Go to Object Library Menu :
  293.  
  294.          Object  libraries are one of ANSI of LA's best exclusive features.  
  295.     An  object  library  is a file full of pictures to  be  used  in  color 
  296.     screens.  The sample library (Sample.Obl) contains 4 such pictures.  If 
  297.     you  create  any interesting or useful pictures of objects  with  AoLA, 
  298.     such as a picture of a computer,  and want to save it in an OBL (object 
  299.     library),   position  the cursor at the upper-left-hand-corner  of  the 
  300.     object  and press Esc-O-S,   then enter the name for the OBL.   If  the 
  301.     file already exists,  the object will be appended,  if it's a new file, 
  302.     it  will be created.   After entering the filename,  move the cursor to 
  303.     the  lower-right-hand-corner of the block,  then press Enter or F7   to 
  304.     close up the block. 
  305.          To read in an object from an OBL, position the cursor at the place 
  306.     where  you want the upper-left-hand-corner of the object to sit,   then 
  307.     press Esc-O-L, and enter the OBL name.   You can then use PgDn and PgUp 
  308.     to  page through the different objects.   When you find one  you  like, 
  309.     press  Enter,   and  the object will be inserted at  the  position  you 
  310.     selected.  If you do not see one you like, press Esc to exit OBL mode. 
  311.     ANSI of Los Angeles                                              Page 6    ANSI of Los Angeles                                              Page 6
  312.                              Esc-Q - Quit to DOS :
  313.  
  314.          C'MON! You mean you need an EXPLANATION??
  315.  
  316.                           Esc-S - Save an Image File :
  317.                      
  318.          To save any screen you have created,  press Esc-S,  then enter the 
  319.     filename. If the file already exists,  AoLA will check to make sure you 
  320.     want  to  overwrite the file,  then it will prompt you for  the  screen 
  321.     type.  If it is a color screen, press C.  For a non-color screen, press 
  322.     A,  and if it's a screen-dump,  press D.   If you select C, you will be 
  323.     prompted  whether you want to start with a clear-screen code,   and  if 
  324.  
  325.  
  326.     you  want  to "Optimize for BBS messages,"  which is  another exclusive 
  327.     feature; you can limit the width of all lines to 70  columns so you can 
  328.     upload the file into a BBS message base. If you decide  not to save the 
  329.     screen, just Esc when AoLA prompts you for the screen type. 
  330.  
  331.                    Esc-W - Wipe-out (clear) Current Screen :
  332.  
  333.          This will erase the current screen,  after prompting you to insure 
  334.     that you did not press Esc-W accidentally. 
  335.  
  336.                                 Other Commands :
  337.  
  338.                        Control-Q - Quote Next Key Pressed 
  339.  
  340.          You have probably don't really need this function,  but's it  here 
  341.     if  you  want  it.   You may have noticed that  you  can't  enter  such 
  342.     characters as Escape,  Backspace,  Carriage Return,  etc.   If for some 
  343.     strange reason, you want to, press Control-Q, and the "Quote" indicator 
  344.     will  appear on the status line.   Then press whatever key you wish  to 
  345.     enter. 
  346.     
  347.                          Control-\ - Clear Current Line
  348.  
  349.          If you need to clear the contents of any line,  the easiest way to 
  350.     do so is by pressing Control-Backslash (\)  twice, which will erase the 
  351.     current  line.   You must press it twice to avoid accidentally  erasing 
  352.     your data. 
  353.  
  354.                         Control-_ - Save Screen for Undo
  355.  
  356.          If  you  are about to make some major changes which could mess  up 
  357.     your screen,  press Control-Underline (_),  which will save the current 
  358.     screen temporarily.   If you want to go back to the old screen,   press 
  359.     Control-* (See the following command description). 
  360.     ANSI of Los Angeles                                              Page 7    ANSI of Los Angeles                                              Page 7
  361.                         Control-* - Undo Recent Changes      
  362.  
  363.          Whenever you load a new screen or toggle screens with F6,  the new 
  364.     screen is  automatically saved in another area of memory so it can   be   
  365.     brought  back   if  anything on the screen is accidentally  erased   or   
  366.     destroyed, or if you are dissatisfied with a certain recent change made 
  367.     on  the  screen.    You can  also save  the  screen   temporarily    by  
  368.     pressing  Control-_  (See previous command description). 
  369.          To bring back the saved screen, simply press Control-Star (*), and 
  370.     any  changes will be lost and replaced by the most recent screen in the 
  371.     hold area. 
  372.  
  373.                       Alt-1..Alt-0 - Select Character Sets 
  374.  
  375.          AoLA  supports  ten separate character sets which can  be  entered 
  376.     using  the keypad.   See the help screen for the exact sets.   Pressing 
  377.     Alt-1,  Alt-2,  ...,  Alt-0  bring up sets 1 through 10,  respectively.  
  378.     Sets 2 through 6 support line drawing... see F1. 
  379.  
  380.               1..9, /, -, \, + - Display Characters in Current Set
  381.  
  382.          To display any character in a set,  you can either use the keys on 
  383.     the top of the keyboard,  or use the shift key with the numeric keypad. 
  384.     The "Set"  indicator on the status line shows the 11  characters in the 
  385.     current  set.    The  first  9  are displayed  by  keys  1  through  9, 
  386.     respectively.   The tenth is entered with the '-' key, and the eleventh 
  387.     can be entered by either the '\' key, the '/' key, or the '+' key. 
  388.  
  389.                            Tab - Move to Next Tabstop
  390.  
  391.          Pressing  the Tab key will move the cursor to the next preset  Tab 
  392.     position.    If there are no more tabs to the right of the cursor,   it 
  393.     will go to the end of the line.  To set tabs, see the F2 command. 
  394.  
  395.                       Shift-Tab - Move to Previous Tabstop     
  396.  
  397.          The  action of the Shifted Tab key is exactly opposite of the  Tab 
  398.     key.    Pressing Shift-Tab will move the cursor to the previous  preset 
  399.     Tab position, or to the beginning of the line if there are no more tabs 
  400.     to the left of the cursor position.  To set tabs, see the F2 command. 
  401.  
  402.                          Ins - Insert a Space at Cursor 
  403.  
  404.          If you press the Ins key,  a  blank space will be inserted in  the 
  405.     current line, at the cursor position.   The right-most character in the 
  406.     line will be destroyed when you do this.
  407.           
  408.                        Del - Delete Character at Cursor 
  409.  
  410.          Press  the  Del  key,  and a character will be  deleted  from  the 
  411.     current line, at the cursor position.   
  412.  
  413.     ANSI of Los Angeles                                              Page 8    ANSI of Los Angeles                                              Page 8
  414.  
  415.  
  416.  
  417.  
  418.                               ANSI of Los Angeles 
  419.                                Revision History :
  420.  
  421.          Version 1.00 - July 23, 1986
  422.               * Original release
  423.          
  424.          Version 1.01 - July 26, 1986
  425.               * Fixed  bug  --  Screen did not clear before  loading  ASCII 
  426.                 file, causing it to overlay old screen. 
  427.               * Added "undo" command to undo mistakes
  428.               * Added resettable tabstops, with Tab and Backtab keys.
  429.               * Added command (^\) to clear current line
  430.  
  431.          Version 1.02 - July 28, 1986
  432.               * Fixed bug --  AoLA did not properly sense the presence of a 
  433.                 monochrome card, and would not work with one. Now it SHOULD 
  434.                 work. 
  435.               * Instead  of   resetting the screen when you enter AoLA,  it 
  436.                 just  leaves it in its present state and clears the screen.  
  437.                 This  is for users of Genoa,  Paradise,  Compaq,  and other 
  438.                 video cards that emulate a monochrome mode,  but are really 
  439.                 "color"   cards,  so if AoLA senses a color card,  it  will 
  440.                 still use whatever the current video mode is, sensed by the 
  441.                 fix above. 
  442.               * I realized that Shareware is a trademark of Quicksoft,  the 
  443.                 makers of the incredible Pc-Write,  so,  to hopefully avoid 
  444.                 any  legal  trouble,   I   made up a new  (I  hope!)   term 
  445.                 "Easyware," which means essentially the same thing. 
  446.               * Eliminated all "blue" colors from the startup screen,  help 
  447.                 screen, and ASCII table so that it won't underline and look 
  448.                 messy on a monochrome screen. 
  449.  
  450.          Version 1.03 - August 2, 1986
  451.               * Added display of X,Y position on the status line.
  452.               * Improved  optimization  feature  when  saving  ANSI  screen 
  453.                 images.  Now, files should be even shorter line-wise.  This 
  454.                 improved  optimization ONLY works if you start with a clear 
  455.                 screen. If you do not, it will just optimize as before. 
  456.               * Fixed a bug -- When you pressed Ctrl-Left Arrow,  and there 
  457.                 was  no beginning of a word to the left,  it would stop  at 
  458.                 the  second  column.  Now it stops correctly at  the  first 
  459.                 column. 
  460.               * Fixed a "bug" -- This one was not a definite bug, but after 
  461.                 you saved an ANSI screen image,  AoLA would leave the color 
  462.                 in the file the same as the last color used.   Thus, if you  
  463.                 TYPEd  the file in DOS,  or read it on a BBS message,   the 
  464.                 colors would be messed up.  Now, it sets the color to white 
  465.                 on black. 
  466.     ANSI of Los Angeles                                              Page 9    ANSI of Los Angeles                                              Page 9
  467.               * Fixed a bug --  When I attempted to load an ANSI file I had 
  468.                 downloaded  from a BBS,  AoLA crashed because the lines  in 
  469.                 the file were LONG - up to 500 characters per line, and the 
  470.                 limit for AoLA was 255.  Now, rather than reading in a line 
  471.                 at  a time,  AoLA will read ONE CHARACTER AT A TIME,  which 
  472.                 may  seem  a bit slower,  but will allow you to read  lines 
  473.                 with unlimited lengths.  However, when loading ASCII files, 
  474.                 the limit is still 255 characters. 
  475.               * Added a new feature!     When you have an ANSI file that is 
  476.                 more than 24 lines long,  rather than letting it scroll by, 
  477.                 AoLA  will STOP,  and prompt you whether you want  to  stop 
  478.                 there,  or continue to the next page.   Thus,  you can load 
  479.                 long files,  a screen at a time,  then save them separately 
  480.                 (i.e.   screen 1 : "Screen.001",  2  :  "Screen.002",  etc.  
  481.                 Then,   to paste them together again,  you can use the  DOS 
  482.                 COPY command : "copy Screen.001+Screen.002 Screen.Col". 
  483.  
  484.