home *** CD-ROM | disk | FTP | other *** search
/ 17 Bit Software 2: Collection B / 17Bit_Collection_B.iso / files / 1280.dms / in.adf / ANSIPT20 / ansi.doc < prev    next >
Encoding:
Text File  |  1978-01-01  |  8.3 KB  |  150 lines
  1.  
  2.  
  3.                                                                   
  4.        B                                                         B 
  5.        y                                                         y 
  6.                                                                   
  7.        S                                                         S 
  8.        t                                                         t 
  9.        e                                                         e 
  10.        v                                                         v 
  11.        e                                                         e 
  12.                                                                   
  13.        T                                                         T 
  14.        i                                                         i 
  15.        b                                                         b 
  16.        b                                                         b 
  17.        e     The world's first Text-Oriented Paint Program!      e 
  18.        t                                                         t 
  19.        t                                                         t 
  20.                                                                   
  21.  
  22.  
  23. AnsiPaint 1.0 Documentation.
  24.  
  25. I like to think this is a really neat program.  I've heard there may be
  26. something like this available for the PC, but I've never seen it (I'm not
  27. basing this on any other program).
  28.  
  29. How it works:  
  30.  
  31. AnsiPaint lets you create ONE screen of text, including ANSI backgrounds,
  32. any embellishment (underline, boldface, etc), using any background or
  33. foreground colour.  The program itself uses the same pallette as another
  34. program by myself, "CommPlX", a terminal program designed for use on
  35. American People/Link.  You'll see why later.
  36.  
  37.  
  38. TO ENTER TEXT:
  39.  
  40. Just click the mouse where you like and start typing.
  41. The program is always in overstrike mode - a limitation that will
  42. disappear in a later version.  The reason for this is basically the same 
  43. reason that DPaint doesn't scroll things when you're inserting text - Text 
  44. is meant to be done after the artwork itself (if that makes any sense).
  45.  
  46. Note that if you do do your text first, any of the drawing functions
  47. will change the background colour of the text but will not change the
  48. text itself.
  49.  
  50. TO DRAW:  
  51.  
  52. Select the background colour you want to use from the menu.  (Drawing
  53. always happens in the background colour).  Then, hold down the shift
  54. key and hit the left mouse button to start drawing.  
  55.  
  56. IMPORTANT NOTE:  AnsiPaint will let you draw all the way across the
  57. screen.  Depending on where your text is to be displayed, this might
  58. NOT be a good idea - remember the CLI window is typically only
  59. 78 characters wide, and if you are going to send your creation
  60. via some online service (especially during conference mode where
  61. your own name will be to the left side of anything drawn), Take care
  62. to stay within bounds.
  63.  
  64. TO DRAW A BOX:
  65.  
  66. Just drag out a box any time.  It will be done in the background pen
  67. and will not erase any text inside the box.  (currently, the only way
  68. to erase the screen is to quit).
  69.  
  70. SAVING/LOADING:
  71.  
  72. Because of the way ANSI works, once you create the output file,
  73. AnsiPaint won't let you reload it to change it.  If you think that
  74. someday you might want to change what you've created, you should
  75. create an "Intermediate" file, which will be 8204 bytes long, using
  76. the appropriate menu option.  This file can be reloaded for later
  77. editing.
  78.  
  79. Once you've created the ANSI output file, that's it - you can type
  80. it, you can combine it with other text (using a text editor, or
  81. the AmigaDOS Join command), lots of other possibilities.
  82.  
  83. IMPORTANT NOTE:
  84.  
  85. If you are going to create files here that are to be read from the
  86. CLI, you cannot use more than the first four colours.  This is because
  87. the Workbench screen only has 4 colours, and someone might not
  88. be happy if you go beyond that.
  89.  
  90. A general rule of thumb is that colours 0 and 1 (Black and White) are
  91. the primary colours.  Colour 2 is supposed to be a dim colour, and
  92. colour 3 is a lighter colour - if you draw with this in mind (ie, if
  93. you need to do shading, use colour 2), your creations should look
  94. okay with anybody's preferences.
  95.  
  96. APPLICATIONS:
  97.  
  98.  - For creating headers on readme files, like I've done with this
  99.    one.  This is REAL simple:  Create your text, then create the
  100.    Ansi file to go on top of it, and just type 
  101.    "Join Header Document as Result" and this will join the two files
  102.    "Header" and "Document" as "Result".  
  103.  
  104.  - For creating BBS menus.  Depending on what BBS you use you might
  105.    have a fair bit of editing to do to these.  8-)
  106.  
  107.  - Title Screens or Login Screens or Logout screens on BBS's.
  108.    The files this thing creates can be used directly as say the
  109.    Login.txt file for a BBSPC system.
  110.  
  111.  
  112. COMMPLX:
  113.  
  114. AnsiPaint can create standard ANSI output, and it can also create output
  115. in "CommPlX" format.  CommPlX is a program that lets you substitute 
  116. 2-character keystrokes for many ANSI attribute-modification sequences.
  117. You can, for instance, create a screen in CommPlX and send it via
  118. the Ascii SEND command in CommPlX into a conference on People/Link.
  119. (Note that you have to have your character send speed set really slow,
  120. or else the 1 second delay between any 2 lines on Plink will eat
  121. some of your text).  Also, remember that when you are in conference,
  122. the left side of the screen shows your name - if your name is 5 characters
  123. long, then you have 9 less characters to work with - keep this in mind.
  124.  
  125. To get a CommPlX file output, do what you would normally do to create
  126. an ANSI output file - but make sure the first character of the file's 
  127. name (as shown in the Filename string gadget at the bottom of the 
  128. file requester) is the character '!'.  So, writing to RAM:Hello would
  129. give you an ANSI file, but RAM:!Hello would give you a CommPlX file.
  130.  
  131.  
  132. DISTRIBUTION:
  133.  
  134. AnsiPaint is being released as FreeWare.  FreeWare is like ShareWare except
  135. that I don't want any money for it.  (Just buy my BBS when it comes out).
  136. AnsiPaint can be distributed wherever PD software is welcome, but cannot
  137. be included on any commercial software without written permission by
  138. yours truly.
  139.  
  140.     Steve Tibbett
  141.     2710 Saratoga Pl. #1108
  142.     Gloucester, ON
  143.     Canada K1T 1Z2
  144.     
  145.     BBS: 613-731-5316
  146.     Plink ID: STEVEX
  147.     Bix ID: s.tibbett
  148.         
  149.  
  150.