home *** CD-ROM | disk | FTP | other *** search
/ Dr. CD ROM (Annual Premium Edition) / premium.zip / premium / DOSGRAPH / ANSBLK10.ZIP / ANSIBLK.DOC next >
Text File  |  1993-02-17  |  9KB  |  169 lines
  1.  
  2.  
  3.  
  4.                            ┌─────────╖   ┌─────────╖
  5.                            │         ║   │         ║
  6.                            │         ║   │         ║
  7.                            │      ┌──╫───┼──┐      ║
  8.                            ╘══════╪══╝   ╘══╪══════╝
  9.                                   │         │
  10.                            ┌──────├──╖   ┌──┼──────╖
  11.                            │      └──╫───┼──┘      ║
  12.                            │         ║   │         ║
  13.                            │         ║   │         ║
  14.                            ╘═════════╝   ╘═════════╝
  15.  
  16.                           ANSIBlk, Ver. 1.0, (c) 1993
  17.                         EFD Systems, All Rights Reserved
  18.  
  19.                               304 Smokerise Circle
  20.                                Marietta, GA 30067
  21.                              CompuServe: 72627,3026
  22.  
  23.  
  24.  
  25. ───────────────────────────────────────────────────────────────────────────────
  26.                                   DESCRIPTION
  27.  
  28. ANSIBlk (short for ANSI BLOCK) is a rudimentary program for producing colorized
  29. text mode display screens, commonly referred to as ANSI graphics.  ANSIBlk will
  30. work with screens up to 80 cols by 25 rows; however, it was specifically
  31. designed to work equally well with smaller partial screen images or blocks. In
  32. addition to reading binary format screen files, ANSIBlk can import character
  33. data from standard ASCII files.  Data can only be saved on disk as a binary
  34. display memory image with a 2 byte header (block width and height).  Storage of
  35. ESC code sequences, as required by ANSI.SYS, is not supported.  By reading and
  36. writing directly to screen memory, ANSIBlk provides complete control over
  37. character display attributes without requiring the use of the ANSI.SYS screen
  38. driver.  Obviously, a color monitor is required; otherwise, there is no reason
  39. to use ANSIBlk.  ANSIBlk was developed for use in programming applications;
  40. however, the provided DSPLYBLK utility allows blocks to be displayed from the
  41. command line and from batch files at any given screen location.
  42.  
  43. Other ANSI graphics software commonly available provides similiar or even more
  44. extensive capabilities; however, these were all unacceptable to me for one
  45. reason or another.  Many will not work well with partial screen images.  For
  46. example, some will allow a partial screen block to be easily saved but not so
  47. easily re-loaded.  Others are simply too complex, in my opinion, for occasional
  48. users.  Hence, ANSIBlk was born.
  49. ───────────────────────────────────────────────────────────────────────────────
  50.                                  USING ANSIBlk
  51.  
  52. To use ANSIBlk type:  ANSIBlk filename [/A]
  53.  
  54.                where:  "filename" is a valid DOS file name.  A .BIN extension is
  55.                        assumed unless otherwise specified. The file is created
  56.                        if it does not exist.
  57.  
  58.                        "/A" is used only for importing ASCII text.  Only the
  59.                        first 80 columns X 25 lines of the file are imported.  A
  60.                        binary file format is assumed unless otherwise specified.
  61.  
  62. ANSIBlk provides limited editing capability.  Existing display characters can be
  63. either painted (colorized) with selected foreground and background colors or
  64. they may be overwritten with new characters.  A full set of block functions
  65. (PAINT, CUT, COPY, and PASTE) are provided for working with rectangular screen
  66. regions.  A box drawing mode is also provided.  If more extensive editing
  67. capability is required, you should consider creating the screen using an ASCII
  68. editor and then import the ASCII screen into ANSIBlk for colorization.
  69.  
  70. All displayable character input from the keyboard is interpreted literally for
  71. screen display.  For example, pressing ENTER simply displays an ASCII character
  72. 13 at the current cursor location in the currently selected colors.
  73. ───────────────────────────────────────────────────────────────────────────────
  74.                                     PAINTING
  75.  
  76. The color of existing screen characters can be altered by "painting" with a
  77. virtual pen or brush.  Painting is a 3 step process:
  78.  
  79. 1) select the desired foreground (F2) and background (F3) colors then;
  80. 2) place the pen in the DOWN position using Page Down and;
  81. 3) move the cursor using the Arrow keys.  Every screen position touched by the
  82.    cursor while the pen is DOWN will have both it's foreground and background
  83.    colors changed to the current color settings.
  84.  
  85. Page Up and Page Down are used to control the Pen position.  Pen DOWN is
  86. indicated on-screen by an asterisk in the lower left corner.  With the Pen UP,
  87. the arrows keys simply move the cursor without painting.
  88.  
  89. To erase with the Pen, set both foreground and background colors to zero (0).
  90.  
  91. Character input from the keyboard is displayed without regard to the current
  92. Pen position.
  93.  
  94.  
  95.  
  96.  
  97. ───────────────────────────────────────────────────────────────────────────────
  98.                                   BOX DRAWING
  99.  
  100. F4 toggles the box drawing ON and OFF and allows the user to select one of four
  101. different drawing modes.  With box drawing on, the keys on the numeric keypad
  102. are re-defined in a convenient geometric pattern, as shown below, to facilitate
  103. easy drawing of boxes.  UP, DN, L and R indicates the cursor direction for keys
  104. which move the cursor in addition to drawing the character shown.
  105.  
  106.  
  107. SINGLE              DOUBLE              DOUBLE TOP          DOUBLE SIDE
  108. ┌───┬───┬───┬───┐   ┌───┬───┬───┬───┐   ┌───┬───┬───┬───┐   ┌───┬───┬───┬───┐
  109. │7 ┌│8 ┬│9 ┐│ - │   │7 ╔│8 ╦│9 ╗│ - │   │7 ╒│8 ╤│9 ╕│ - │   │7 ╓│8 ╥│9 ╖│ - │
  110. ├───┼───┼───┤UP││   ├───┼───┼───┤UP║│   ├───┼───┼───┤UP││   ├───┼───┼───┤UP║│
  111. │4 ├│5 ┼│6 ┤│   │   │4 ╠│5 ╬│6 ╣│   │   │4 ╞│5 ╪│6 ╡│   │   │4 ╟│5 ╫│6 ╢│   │
  112. ├───┼───┼───┼───┤   ├───┼───┼───┼───┤   ├───┼───┼───┼───┤   ├───┼───┼───┼───┤
  113. │1 └│2 ┴│3 ┘│ + │   │1 ╚│2 ╩│3 ╝│ + │   │1 ╘│2 ╧│3 ╛│ + │   │1 ╙│2 ╨│3 ╜│ + │
  114. ├───┴───┼───┤DN││   ├───┴───┼───┤DN║│   ├───┴───┼───┤DN││   ├───┴───┼───┤DN║│
  115. │ 0 L ─ │.R─│   │   │ 0 L ═ │.R═│   │   │ 0 L ═ │.R═│   │   │ 0 L ─ │.R─│   │
  116. └───────┴───┴───┘   └───────┴───┴───┘   └───────┴───┴───┘   └───────┴───┴───┘
  117.  
  118.  
  119.  
  120.  
  121. ───────────────────────────────────────────────────────────────────────────────
  122.                                 BLOCK OPERATIONS
  123.  
  124. ALT-B selects the block function sub-menu.  Available block functions are PAINT,
  125. CUT, COPY and PASTE.  After selecting a function, the user is prompted to
  126. indicate the desired rectangular screen block to be operated on by moving the
  127. cursor first to the upper-left corner of the block and then to the lower-right
  128. corner of the block.   ESC will cancel the block function at any time.
  129.  
  130. The Pen is automatically placed in the UP position at the start of a block
  131. function.
  132.  
  133. SAVE is also a block function, although it is not part of the block sub-menu.
  134. The block marking procedure described above is followed to indicate the screen
  135. area to be saved.
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145. ───────────────────────────────────────────────────────────────────────────────
  146.                         LICENSE AGREEMENT and DISCLAIMER
  147.  
  148. This software and the included documentation is provided solely "as is".  The
  149. author hereby disclaims any and all warranties, either expressed or implied,
  150. including without limitation the warranties of merchantability and fitness of
  151. purpose.  In no event will the author be liable for any damages, incidential,
  152. consequential or otherwise, resulting from the use or mis-use of this software.
  153. In any event, the author's liability shall be limited to the originial software
  154. license purchase price.
  155.  
  156. ANSIBlk ver. 1.0 is provided for private personal use without payment of a
  157. license fee; however, ANSIBlk is not public domain software.  Legal ownership
  158. and all other legals rights pertaining to the software are reserved and retained
  159. by the author.  Later versions of the software may or may not enjoy similiar
  160. status. The software may be freely distributed provided that no fee of any kind
  161. is charged in connection with such distribution.  The only exception is
  162. electronic phone service connection fees.  This software may not be distributed
  163. in connection with or incorporated into any software or other product being
  164. distributed, demonstrated, sold or offered for sale without the expressed
  165. written permission of the author.  Anyone wishing to obtain such permission may
  166. contact the author at the address listed at the front of this documentation.
  167.  
  168. Comments, suggestions and criticisms are always welcomed.
  169.