home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Source Code 1993 July / THE_SOURCE_CODE_CD_ROM.iso / languages / perl / scripts-osu / up / README < prev    next >
Encoding:
Text File  |  1993-07-14  |  3.2 KB  |  72 lines
  1.             Up, a PostScript print utility
  2.         hacked together with a two-by-four by J Greely
  3.              (jgreely@cis.ohio-state.edu)
  4.  
  5.  
  6. This package allows you to print conforming PS files n-up, with the
  7. scaling, rotation, and page positioning code kept in a readable
  8. configuration file.  It has successfully been used on the output of
  9. ptroff, enscript, psdit (all from Adobe's TranScript package), and the
  10. Adobe documentation supplied with NeXT release 1.0, and should work on
  11. any file that obeys the rules the way I assume (note: it does not
  12. currently work with any known dvi-to-PS converter; I'm making some
  13. changes to make it work with dvips 4.2 (available for anonymous ftp at
  14. labrea.stanford.edu), but they're not done yet).  The major feature is
  15. the ability to create your own layouts, with arbitrary scaling,
  16. translations, and rotations.  The output can be fed back through, for
  17. further reduction/destruction.
  18.  
  19.   Warning: if you don't have Larry Wall's Perl language installed,
  20. this utility will be useless to you.  It's not hard (ok, trivial) to
  21. convert it to Nawk or C, and I'll probably get around to it soon, but
  22. for now you need Perl (version 3.0).  Debates on the merits of Perl as
  23. a programming language are discouraged by the author.  If Perl is not
  24. located in /usr/bin, you'll need to change the first line of each
  25. executable.
  26.  
  27.   To use, unpack the shar file somewhere, edit the top of Makefile to
  28. indicate where things should go, and type "make install". It will
  29. install several symlinks to the script, as well as a general
  30. configuration file, which can be overridden by the user.
  31.  
  32.   Currently, it installs links to print 2, 4, 6, and 16 pages per
  33. sheet, and the supplied configuration file has sample layouts for
  34. doing (among others) 8-up, 4-up in greeting-card positions, 10-up in a
  35. shrinking spiral, and more.  4up and 16up simply scale the page by .5
  36. and .25, respectively (white lie; read my excuse in the config file).
  37. 2up and 6up are rotated, and the page positioning is given below:
  38.  
  39.             +-----+-----+   +---+---+---+
  40.                     |     |     |   | 1 | 2 | 3 |
  41.                     |  1  |  2  |   +---+---+---+
  42.                     |     |     |   | 4 | 5 | 6 |
  43.                     +-----+-----+   +---+---+---+
  44.  
  45.  
  46.   Note to NeXT users: both Preview and Yap can be used to preview
  47. output under release 1.0.  Previous versions wouldn't work quite
  48. right.
  49.  
  50.   Note to people in general: after I finished writing this, someone
  51. told me of at least one other n-up utility.  The one I've seen works
  52. by what might be called elegant PostScript hacking, but I think mine
  53. solves a different problem.
  54.  
  55.   Bugs, suggestions, offers of money and sacrifices, and anything
  56. interesting done with this package will be cheerfully accepted.
  57. Despite rumors to the contrary, I am *not* a black hole for e-mail.
  58.  
  59.  
  60. Additional utilities supplied:
  61.  
  62. parr    - Page ARRanger.  For arbitrary reordering of pages in a
  63.       conforming PS file.  Switches are provided to automatically
  64.       do signature-order printing for two-up, left-to-right
  65.       layouts ("up -n pup").  Pages can be printed more than once
  66.       or not at all, and blank pages may be inserted anywhere.
  67.  
  68. makeup    - generates numbered test pages, for debugging new layouts
  69.  
  70. --
  71. J Greely (jgreely@cis.ohio-state.edu; osu-cis!jgreely), 89/10/23
  72.