home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / ttf_text.zip / read.me < prev    next >
Text File  |  1999-03-17  |  4KB  |  103 lines
  1. 15 March 1999.  Michal Necasek  (mike@mendelu.cz)
  2.                 Daniel Hellerstein (danielh@econ.ag.gov)
  3.  
  4.        TTF_text: Create text-banners from TTF fonts.
  5.  
  6. TTF_text is a free, OS/2 REXX program that will create text banners 
  7. (using printable characters).
  8.  
  9. What's special about TTF_text is that the pattern for the banner
  10. characters is specified using a TTF font name, and point size,
  11. provided by the user.  Thus, any TTF font you obtain can 
  12. be used as the template for a banner, and the banner can
  13. be just about any size.
  14.  
  15. 1) Installing TTF_text.
  16.  
  17.   a) After obtaining TTF_text, unzip it to an empty temporary directory.
  18.   b) Copy RXTTF.DLL to someplace in your LIBPATH (say, x:\OS2\DLL).
  19.   c) You can copy TTF_TEXT.CMD to your favorite directory.
  20.   d) To assist in demonstrating TTF_text, you can also copy BISQUE.TTF 
  21.      to this directory.
  22.  
  23.  
  24. 2) Configuring TTF_text
  25.   
  26.    TTF_text does NOT require additional configuration; but you might want to 
  27.    set a few parameters. These are in the ttf_text.cmd file (it's a REXX 
  28.    program) which you can edit with your favorite text editor (for example,
  29.    the EPM editor that ships with OS/2).
  30.  
  31.    The parameters are well explained in the file. The more important ones are:
  32.  
  33.   Use_filler_message: instead of a single foreground character, you can use
  34.                       a "message" as the foreground character(s)
  35.  
  36.   Filler_message: the message to use (if user_filler_message is enabled)
  37.  
  38.   Default_ttfdir: the default "ttf-fonts root directory". TTF_text will look
  39.                   for ttf fonts here, as well as in the current directory
  40.  
  41.   Outfile: default output file (only used in "prompted" mode). Or, set this
  42.           to blank to output to stdout (the screen).
  43.  
  44.  
  45.  
  46. 3) Using TTF_text
  47.  
  48. You can run it just by entering TTF_TEXT at an OS/2 prompt.
  49. You will then prompted for the ttf font-file, the point size, 
  50. the message, and whether to use landscape or portrait orientation.
  51. The banner will then be written to the "outfile", or to the screen.
  52.  
  53. Alternatively, you can provide values on the command line, using the
  54. syntax:
  55.    ttf_text  ttf_file psize landscape message
  56. where:
  57.   ttf_file : the BISQUE.TTF file (a .TTF extension is added, if necessary)
  58.    psize  :  the point size
  59.  landscape : portrait orientation. Use 1 for landscape orientation.
  60.    message : the text to convert into a banner
  61.  
  62. For example:
  63.   D:\APPS>ttf_text bisque 12 0 Hello
  64.  
  65. Since "command line mode" always writes to stdout, one useful trick is to 
  66. redirect the output to a file (using "> file.out"). For example:
  67.   D:\APPS>ttf_text d:\fonts\times.ttfe 26 1 Happy Birthday! > bday.lst
  68.  
  69.  
  70.  
  71. 4) Notes
  72.  
  73.  * Caution: 
  74.       if you get wierd characters ($,[, etc.) in your prompts, it means
  75.       you don't have ANSI support installed. See the description of 
  76.       the use_ansi parameter (in TTF_TEXT.CMD) for the details.
  77.  * TTF_text is based on the RxTTF library. 
  78.    Those interested in using this procedure should look for RXTTF
  79.    on hobbes.nmsu.edu.
  80.  * TTF_text is in the public domain. Use it at your own risk.
  81.  * The "bisque" font, included as an example, is freeware from:
  82.        http://members.xoom.com/acidfonts/t.htm
  83.  * The "outfile" is appended to -- which makes it easy to to
  84.    create rows of big-text characters (by running ttf_text several
  85.    times in a row)
  86.  * In contrast, redirected output (using > file.ext) will overwrite 
  87.    a preexisting file.
  88.  
  89.  
  90. 5) Known bugs
  91.  * Some ttf fonts don't work
  92.  * At some point sizes, and for some fonts, characters might overlap
  93.  * Occassionally the last several columnns will be clipped; adding a space
  94.    at the end of the message usually cures that.
  95.  
  96. 6) Future modifications
  97.  
  98.   None planned, but who knows? 
  99.   If someone wants to write a PM interface, the code is in the public domain (look for
  100.   RXTTF.ZIP, on hobbes.nmsu.edu, for details on the rxttf_image procedure).
  101.  
  102.  
  103.