home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / print / textorps / txt2ps.doc < prev   
Text File  |  1994-02-04  |  9KB  |  173 lines
  1.          (C) Copyright IBM Corp. 1992, 1993
  2.  
  3. v2.15 has increased stack and buffer sizes for improved robustness
  4. with OS/2 2.1 32 bit graphics engine, minor changes, and new advice
  5. in the Extended Help provided by textorps.hlp for installation
  6. techniques and parameters which provide more robust operation
  7. with some drivers that insert printer-specific control strings
  8. in front of PostScript jobs causing them to be printed as text by
  9. TEXTorPS.  Please install the .hlp file and read the extended help.
  10.  
  11. TEXTorPS is an application program that can enhance the usability of
  12. OS/2 PostScript printers by permitting the user to leave the printer in
  13. PostScript mode and still print text sent to the printer spooler by
  14. applications which are not PostScript aware.  When TEXTorPS is running,
  15. PostScript printer jobs are undisturbed, but other text files are
  16. modified by the insertion of a PostScript program to interpret the job
  17. as ASCII text. The user may specify the font, typesize, line spacing,
  18. margins, orientation, page numbers and strings on each page.
  19.  
  20. The ASCII text mode which is supported is not the full PPDS
  21. datastream mode, and does not support graphics, control
  22. characters other than CR/LF, FF, TAB, SI , SO, DC2, DC4,
  23. esc-E, esc-F, and esc-:.  An attempt is made to print unsupported
  24. characters as blanks and ignore unsupported esc sequences, but
  25. esc sequences containing the character ctrl-D (hex 04) will
  26. cause the printout to fail.  Support of SI,SO is not identical
  27. to PPDS mode but may be acceptable.  The single and double rule
  28. characters are replaced by single rules and corners by blanks.
  29. The National Language Characters of codepage 850
  30. are available as an option.
  31.  
  32.  Starting TEXTorPS
  33.  
  34. TEXTorPS uses a character device monitor installed
  35. on any LPTn port device.  It optionally redirects
  36. output to a second printer device which may be on a LAN.
  37. Normally you want to install TEXTorPS
  38. using the command
  39.  
  40. TEXTORPS lpt1
  41.  
  42. If you want to install TEXTorPS for a printer on a LAN, say
  43. LPT3, you need to also define a printer (drag from the printer
  44. template in OS/2 2.0 and select PostScript driver) for a printer
  45. port for which there is no physical printer attached: say LPT2.
  46. Set the LPT2 printer as the default printer. In this case, the command is
  47.  
  48.  TEXTORPS lpt2 lpt3
  49.  
  50.  Now text and PostScript data sent to LPT2 will be redirected
  51. to lpt3 and text will be converted to PostScript.  You also need to issue
  52. NET USE LPT3 \\server\queue     for the lan printer, or equivalent.
  53.  
  54. Files dragged to the printer icon  may be selected to be
  55. "printer specific" to obtain the TEXTorPS formatting.
  56. The default system conversion to text is obtained by selecting
  57. "plain text" for the printer file contents.
  58.  
  59. Jobname (or dataset name if copy dsn lpt1 is used) is now
  60. working in OS/2 2.0.
  61.  
  62.  More information is available through the Help Menu
  63.  
  64. For help about any control on any window, select the control
  65. and press F1. Use the tab key to move to controls without
  66. activating them.
  67.  
  68.  Installing TEXTorPS
  69.  
  70. Unzip TXT2PS.ZIP using the command PKUNZIP TXT2PS.ZIP.
  71. Program parameters should be
  72. LPT1
  73. for a typical installation.
  74. In addition to copying TEXTORPS.EXE to a directory on the
  75. path, or installing it in a Program Group, you may want to
  76. consider automatic startup.  To be able to use the online
  77. help information, be sure to place
  78.  set HELP = c:\path in config.sys,
  79. where 'path' contains the directory in which TEXTORPS.HLP is
  80. installed, or copy TEXTORPS.HLP to C:\OS2\HELP
  81.  
  82. Be sure that a PostScript driver has been
  83. installed and connected to the logical port you will be
  84. using.  The correct driver name will probably start with PSCRIPT.
  85.  
  86. Start the program with the command syntax above; select margins if desired,
  87. minimize the window.
  88.  
  89. Software required: OS/2 2.0 or later with installed PSCRIPT driver
  90. Hardware required: Any PostScript printer.
  91.  
  92. Brief comments on options and dialog boxes:
  93.  
  94.  Best way to start program is with parameter   LPTn
  95.  where n is 1 or 2 depending on where your printer is attached.
  96.  Then select the Text Options submenu from the menu line.
  97.  
  98.    Margins - On this screen you can select the paper size and
  99.              text margins, also the paper orientation.  The paper.
  100.              length should always be larger than the width.  The
  101.              margins are the distances from the respective edges
  102.              of the paper for the body of printed text.  When in
  103.              landscape mode (sideways printing), the top margin
  104.              is the distance between the long side of the paper
  105.              and the top line of text (top, right etc. follow the
  106.              printing, not the paper).
  107.              Note for landscape mode it is NOT necessary to try
  108.              to place the printer in landscape mode.  On the other hand,
  109.              the paper size settings are not sent to the printer-
  110.              they are just used to decide where to print.  You should
  111.              set the printer paper size by hand when changing sizes.
  112.  
  113.    Font -    On this screen you can select the typeface and size
  114.              for text printing.  The typefaces shown are for the  IBM4019
  115.              and the PostScript FontCard.  The program
  116.              does not check that a fontcard is installed, invalid fonts
  117.              may result in Courier being used as default or in no output
  118.              if a software error results from a sufficiently invalid name.
  119.              Line spacing is 1.2 times type size so 10 pt type is printed
  120.              at 6 lines per inch.  The options Oblique/Italic and Bold
  121.              are not applicable to all fonts.
  122.              Symbol, for example, has no Italic form.  Italic will
  123.              be ignored in that case and no error message produced.
  124.              Similarly Helvetica Light will ignore the Bold option.
  125.              Type size is set by clicking on the desired number.
  126.              Click on the scrollbar arrows to see more values.  The
  127.              accepted range is 5 pts to 72 pts (72 pts= 1 inch or 25.4 mm).
  128.              Courier and its variants are the only non proportional
  129.              fonts and should be used if column alignment is critical.
  130.  
  131. Pagination-  On this screen you can specify one or two strings to be printed
  132.              in the upper or lower margins of each page, and an optional
  133.              page number.  The strings S1 and S2 are edit boxes accepting
  134.              a maximum of 32 characters.  Group boxes allow selection
  135.              of what is printed at each of 4 places on the page:
  136.              TC: O  S1    place String S1 at top center
  137.                  O  S2    place String S2 at top center
  138.                  O  N     place page number at top center
  139.                  O        place nothing at top center.
  140.  
  141.              TR: top right.  BC: bottom center   BR: bottom right.
  142.  
  143.              The type size box on this screen applies to all of these items
  144.              which are printed inside the left and right margins and
  145.              outside the top and bottom margins.  The centered strings
  146.              are centered between the margins, not on the paper. Note
  147.              that if you want vary large page numbers, for example, it
  148.              may be necessary to increase the top or bottom margin size.
  149.              The Save button on this screen is equivalent to the
  150.              Save Defaults submenu choice: it saves ALL options for future
  151.              default use.
  152.  
  153.    Save Defaults- Selecting this option will cause all settings: Font,
  154.              margins, paper orientation, page number instructions, etc
  155.              (but not the printer device name )
  156.              to be saved in the user.ini system file.  About 30 variables
  157.              are saved.  The first time this is done, considerable disk
  158.              activity is required as keys are added to the system file.
  159.              The application keyname is "TEXTORPS".  Once this has
  160.              been done, at all future loads of the program the default
  161.              values will override the command line information, except for
  162.              the printer device name.
  163.  
  164.  
  165. Beeping-     A two tone beep indicates that the character device
  166.              monitor thread was unable to open a monitor on the
  167.              specified device (port).  This usually means the first
  168.              parameter specified does not match a printer port.
  169.  
  170. Online Help  See the online Extended Help and Help Index for additional
  171.              information.  Press F1 after tabbing to any option for
  172.              more information specfic to that option.
  173.