home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d1xx / d174 / titlepage.lha / TitlePage / TitlePage.Doc < prev    next >
Text File  |  1989-02-04  |  6KB  |  136 lines
  1.               Titlepage - Title Page printing utility. 
  2.                      by Joel Swank 9-23-88
  3.  
  4.   Titlepage prints banner title pages for identifying listings. It uses 
  5. amiga fonts to build large headings that are printed across the page.
  6. Each pixel from a font character is represented by a printer character.
  7. Titlepage should work with any Amiga font except for reversed fonts (are 
  8. there any?). It generates standard Amiga printer escape sequences, so it 
  9. should work with any printer. It allows the printer to be set to a variety 
  10. of different modes. Some printers may not have all the different modes
  11. allowed for by the Amiga escape sequences, so all modes may not work on 
  12. all printers. Usage:
  13.  
  14.    titlepage [options] [strings] . . .
  15.  
  16.    The options set up the printer. The strings are printed in the most
  17. recently set options. Any number of options/strings combinations may
  18. be specified. They will be executed in order, left to right from the 
  19. command line.
  20.  
  21. Strings:
  22.  
  23.    These are groups of ASCII characters. Each group will be printed on
  24. a separate line. They may contain any character from 1 through 255.
  25. Some fonts have patterns for non-printing characters (ASCII 128 and
  26. up). Since these are difficult to put in a command line or text file, there
  27. is a special syntax to access these characters: Any character preceded by
  28. a '~' (tilde) will have 128 added to its ASCII value. To print a tilde
  29. specify two ('~~'). These patterns will be printed in their -128 character.
  30. To see what characters a font has, use the '-u' flag. Some fonts may
  31. also have patterns for non-printing characters less than 128. These
  32. may also be inserted in strings and will be printed in the letter 'O'.
  33.  
  34. Options:
  35.  
  36. -fxxxx  'xxxx' is the name of the font to use. Default is 'topaz'
  37.  
  38. -sxx    'xx' is the size of the font. Default is 8. The font and
  39.         size are submitted to OpenDiskFont() which selects the closest
  40.         match available.
  41.  
  42. -lxx    Set linesize to 'xx'. Default is 80. If condensed is selected
  43.         default is 132. If elite is selected, default is 96. If both
  44.         condensed and elite are selected, default is 160. If wide is
  45.         select the above defaults are halved. This number is used for
  46.         truncating lines and centering, when centering is requested.
  47.  
  48. -oxxxx  'xxxx' is the name of the file to receive the output. Default
  49.         is 'PRT:' (the Amiga print device). If 'xxxx' is omitted,
  50.         output is sent to stdout. This option must be specified before
  51.         any parameter that causes printing (any except a,h,t,f,s,u and l).
  52.  
  53. -axxxx  'xxxx' is the name of an alternate input file. The file may
  54.         contain any of these options and strings to print, separated
  55.         by space tab or newline. To put blanks in a string, enclose
  56.         it in quotes ("). To put quotes in a string precede it with
  57.         a backslash (\).
  58.  
  59. -nxx    Causes 'xx' newlines to be output immediately. If xx is omitted,
  60.         one newline is output.
  61.  
  62. -hx     Set the print character to 'x'. By default the print character is
  63. +h      the character being drawn. This can result in uneven darkness.
  64.         if '-hx' is specified, all printing will be done in this character.
  65.         '-h' alone or '+h' can be used to return to the default.
  66.  
  67. -p      Causes a formfeed to be output immediately.
  68.  
  69. -d      Causes the date and time to be output immediately. It is printed
  70.         in the currently selected printer mode (not banner).
  71.  
  72. The following options set and clear modes. A leading '-' sets
  73. the mode and a leading '+' clears it.
  74.  
  75. -t/+t   Causes all subsequent printing to be centered.
  76.  
  77. -e/+e   Set/clear elite.
  78.  
  79. -c/+c   Set/clear condensed.
  80.  
  81. -b/+b   Set/clear bold.
  82.  
  83. -q/+q   Set/clear NLQ.
  84.  
  85. -w/+w   Set/clear wide or enlarged.
  86.  
  87. -8/+8   Set/clear 8 lines per inch (6 lines per inch is the default).
  88.  
  89. -i/+i   Set/clear italics. This selects the printer's italics character
  90.         set and italicizes the font being printing. Italics takes more
  91.         print line space than standard characters.
  92.  
  93. -u/+u   Set/clear upper mode. Upper mode causes all characters in the
  94.         following string(s) to have 128 added to their value. This is
  95.         is for accessing the 'upper' characters contained in some fonts.
  96.  
  97. Notes:
  98.    Not all modes and combinations of modes will work for all printers.
  99. The default linesizes are set for a narrow printer. A wide printer can 
  100. print more characters in each mode. The actual number of characters 
  101. that a string can contain varys greatly depending on the font selected 
  102. and the mode the printer is in. You will have to experiment to see what 
  103. you get.
  104.  
  105. Limits:
  106.    Linesize may be from 20 to 1000. The fontname can be up to 95
  107. characters. Input filenames, lines in alternate files, and parameters
  108. can be up to 100 characters.
  109.  
  110. Examples:
  111.  
  112. titlepage -fruby -s15 -c -8 -n8 TitlePage -d -p
  113.  
  114.   Use the ruby15 font to print a header page for Titlepage in condensed,
  115. 8lpi, 8 lines from the top of the page, print the date and do a page eject.
  116.  
  117.  
  118. titlepage -fsapphire -s14 -c -e Sapphire
  119.  
  120.    Try the sapphire14 font in condensed, elite mode.
  121.  
  122.  
  123. titlepage -fruby -s15 -c -t Ruby -n3 -ftopaz -s11 Topaz11 
  124.  
  125.    Try the ruby15 font in condensed, centered, skip 3 lines and try the
  126. topaz11 font.
  127.  
  128.  
  129. titlepage -b GRONK +b -fruby -s15 -c -t Ruby -n3 -ftopaz -s11 Topaz11 
  130.  
  131.    Print GRONK in bold topaz8, then Ruby in ruby15, centered in condensed,
  132. then skip 3 lines and print Topaz11 in topaz11 font centered and condensed.
  133.  
  134. COPYRIGHT Notice:
  135.    This program is in the public domain, no rights reserved.
  136.