home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: WPS_PM / WPS_PM.zip / fs13.zip / ReadMe.txt < prev    next >
Text File  |  1997-10-27  |  8KB  |  192 lines
  1. ==============================================================================
  2.                               ___  ____    ______  
  3.                              / _ \/ ___|  / /___ \ 
  4.                             | | | \___ \ / /  __) |
  5.                             | |_| |___) / /  / __/ 
  6.                              \___/|____/_/  |_____|
  7.                                                    
  8.                             _____ _       _      _   
  9.                            |  ___(_) __ _| | ___| |_ 
  10.                            | |_  | |/ _` | |/ _ \ __|
  11.                            |  _| | | (_| | |  __/ |_ 
  12.                            |_|   |_|\__, |_|\___|\__|
  13.                                     |___/            
  14.                       __  __            _     _            
  15.                      |  \/  | __ _  ___| |__ (_)_ __   ___ 
  16.                      | |\/| |/ _` |/ __| '_ \| | '_ \ / _ \
  17.                      | |  | | (_| | (__| | | | | | | |  __/
  18.                      |_|  |_|\__,_|\___|_| |_|_|_| |_|\___|  Version 1.3
  19.  
  20.  
  21.                       by Gregory Spath
  22.                          gspath@epix.net
  23.                          http://www.epix.net/~gspath
  24.                          Wease on the IRC
  25.  
  26. ==============================================================================
  27.  
  28. Hello, and thank you for trying The Figlet Machine!  I have put a lot of work 
  29. into this fun little program, and hope you enjoy using it as much as I enjoyed 
  30. writing it!  Please read this file before using the program for information 
  31. about installating and using it.
  32.  
  33.  
  34.  
  35. SHAREWARE NOTICE:
  36. -----------------
  37. This program is shareware.  It is free to try and play with for a reasonable 
  38. amount of time.  If you find it useful, entertaining, or find yourself liking my
  39. coding efforts, please register!  Pricing information and licensing is located 
  40. in the last section of this file, REGISTERING FIGSHELL.
  41.  
  42.  
  43.  
  44. WHAT IS THE OS/2 FIGLET MACHINE?
  45. --------------------------------
  46. FIGSHELL is a fun and easy OS/2 Presentation Manager interface to the popular 
  47. FIGLET program written by Glenn Chappell and Ian Chai.  FIGLET is used 
  48. to create impressive lettering quickly and easily. Figshell puts a fast and easy
  49. to use interface on the OS/2 version of Figlet.
  50.  
  51.  
  52.  
  53. WHAT DO I NEED TO RUN FIGSHELL?
  54. -------------------------------
  55. FIGSHELL is only a shell for the FIGLET program.  You will need to Compile 
  56. FIGLET for OS/2, or Download a version of FIGLET compiled for OS/2.  You will 
  57. also get the most use out of the program if you have a good collection of fonts.
  58.                                                            
  59. You can download an OS/2 Native version of Figlet from:
  60.     
  61.     ftp://ftp.nicoh.com/pub/figlet/program/os2/
  62.  
  63. A good collection of fonts for use with FIGLET is located at:
  64.     
  65.     ftp://ftp.nicoh.com/pub/figlet/fonts/
  66.     (be sure to check out the 'contributed' directory!)
  67.  
  68. I may also keep fonts and the OS/2 executable at my web site,
  69.     
  70.     http://www.epix.net/~gspath
  71.  
  72. at a later time.
  73.  
  74.  
  75.  
  76. USING FIGSHELL:
  77. ---------------
  78. To run Figshell for OS/2, simply unzip all files to a single directory. You can 
  79. then create a desktop object for the program, or simply type 'figshell' on the 
  80. command line to run the program.  The very first time the program is run, it 
  81. will prompt you for the location of 'FIGLET.EXE' and the location of your figlet
  82. fonts.  You must type the DIRECTORY ONLY for these locations.  FIGSHELL 
  83. requires that your main FIGLET program be OS/2 native, and that it is named 
  84. FIGLET.EXE.  All font files must end in the extension FLF.
  85.  
  86. After entering the locations of the executable and fonts, FIGSHELL will 
  87. automatically poll the font directory for a list of Figlet fonts.  This way, you
  88. can keep adding fonts, and FIGSHELL will always be aware of them, with no 
  89. configuration changes to the program necessary!  If you add a font while running
  90. figshell, simply bring up the configure, set font path dialogue, and click OK. 
  91. The new font list will be automatically generated.
  92.  
  93. The rest of the interface is very straightforward.  There is help text at the 
  94. bottom of the window that explains what each object in the main FIGSHELL window 
  95. does.
  96.  
  97.  
  98. CONFIGURATION:
  99. --------------
  100. FIGSHELL will keep track of the following settings automatically and load those 
  101. settings the next time the program is run (Registered Version Only)
  102.  
  103.      FIGLET.EXE location
  104.      location of fonts
  105.      Preview colors (see next section for info on modifying these)
  106.      Output colors  (see next section for info on modifying these)
  107.      Figlet Font to use
  108.      Width
  109.      Justification
  110.      IRC Attributes
  111.      translation strings
  112.      REXX and DOS output options
  113.  
  114.  
  115. HINTS AND TIPS:
  116. ---------------
  117. *In a later version of this program, I plan to include Right Mouse button support 
  118. for settings like the colors for the output and preview window.  Until then, 
  119. you can STILL customize your FIGSHELL colors.  Here's how:
  120.       - Open the OS/2 Solid Color Pallette.
  121.       - To change the Background color, Drag the desired color with the right 
  122.         mouse button to the font preview or output window
  123.       - To change the Foreground color, Hold the <Control> key down while 
  124.         dragging the desired color to the font preview or output window.
  125.       - If you have registered FIGSHELL, these settings are saved and loaded the
  126.         next time you run the program.
  127.  
  128. *As an incentive to register the program, I have disabled the ability to load 
  129. settings (this will be obvious each time you run the program) and have also 
  130. disabled the 'To Clipboard' button.  Everything else functions normally.  You do
  131. not need the 'To Clipboard' button to copy your output to the clipboard.  You 
  132. can achieve this by selecting the output text with the mouse, and then pressing 
  133. <Control>-<Insert>.  The 'To Clipboard' button is faster, and much easier, 
  134. though, so please register! :)
  135.  
  136.  
  137. REGISTERING FIGSHELL:
  138. ---------------------
  139. *Why register?
  140.  
  141. Registration will allow you to save all of the configuration options for figshell.
  142. In addition, the <to Clipboard> button will be enabled.  Other than these two 
  143. incentives to register, the program functions normally.
  144.  
  145. Your support will also help me create more programs, and support this program in 
  146. the future.
  147.  
  148. *How to register
  149.  
  150. Print the file (or create your own with the same information) REGISTER.FRM  
  151. And fill it out.  Send the form with a Check or Money Order to:
  152.  
  153.           Gregory Spath
  154.           708 Hanover Manor, #D108
  155.           Carlisle, PA  17013
  156.  
  157. After receiving your order, I will Email a special registration number to you
  158. that will unlock all of FIGSHELL's features.  If you do not have an Email address, 
  159. I will send this number via normal mail at no charge to you.
  160.  
  161. *Entering your registration number
  162.  
  163. After you receive your registration number, use the menu to select the Enter 
  164. Registration Number option.  A dialogue will pop up prompting you for your 
  165. registration number.  Type in the number that was sent to you.  The next time you 
  166. run FIGSHELL, it will remember all of the settings as described in the 
  167. CONFIGURATION section of this document.
  168.  
  169.  
  170. Future Releases
  171. ---------------
  172.  
  173.  - Registered users need only register once.  All updates to the program are FREE
  174.  - I will soon be releasing REXX scripts for Gammatech IRC which will closely 
  175.    integrate FIGSHELL with GTIRC...Please don't abuse these and get yourself 
  176.    banned from a channel :)  (oh yeah....I also have a cool set of REXX scripts 
  177.    I have written for Gammatch IRC, so check them out, if you'd like.
  178.    They are on my web site, http://www.epix.net/~gspath)
  179.  - Right Mouse button support for object settings
  180.  - Quick Render Option to automatically generate one line of FIGLET output when
  181.    the <Enter> key is hit while in the 'Text to Convert' box.
  182.  - Clean up of the Config Menu, integrating it into a settings notebook
  183.  - Different colors for IRC output?
  184.  - ANSI Animation Effects / Colors?
  185.  - Any kewl suggestions that users make!
  186.  
  187.  
  188. Thank you for trying FIGSHELL.  If you have problems, suggestions, or questions,
  189. please contact me at gspath@epix.net, or look me up on the IRC.  I usually go by
  190. the nick, Wease.
  191.  
  192. -- Greg Spath, Author of FIGSHELL.