home *** CD-ROM | disk | FTP | other *** search
/ Carousel Volume 2 #1 / carousel.iso / mactosh / unix / scribepi.sha / extract_top.hlp < prev    next >
Encoding:
Text File  |  1985-08-29  |  2.7 KB  |  64 lines
  1. Extract_top is a program for taking a portion of a MacPaint picture and
  2. converting it to a PostScript file that can be used with the @Picture command
  3. in Scribe.
  4.  
  5. The PostScript output generated by extract_top can be included in a Scribe
  6. file with a Scribe command like the following:
  7.  
  8.     @figure[
  9.     @picture(Size=3 inch, ScaleableLaser=[postscript_output.ps])
  10.     @caption(System Overview)
  11.     @tag(SysView)
  12.     ]
  13.  
  14. In this case, the file "postscript_output.ps" is included into the scribe
  15. file, and Scribe will leave 3 inches of column space for it.  The "Size"
  16. specified in the @Picture command should match the height given to
  17. extract_top with the "-h" option.  (Extract_top's default is 2 inches).
  18.  
  19. To upload a MacPaint file to the vax, you'll need to run MacTerminal on
  20. the mac, and use "macget -d filename" to upload the file.  (Macget will
  21. create "filename.data" on the vax).  See the man page for macget(1) for
  22. more information on uploading files.
  23.  
  24. Extract_top scales the macpaint picture to match the aspect ratio of the
  25. area extracted, and centers it within the Scribe text column (assumed to
  26. be 6.5 inches - i.e, 1" margins).  You can use the -c option to change
  27. the width of the column extract_top centers the picture in.  Normally
  28. the MacPaint image is placed at the bottom of the area Scribe allocates
  29. for it, you can use the -u option to slide it up a specified number of
  30. inches.
  31.  
  32. The upper left portion of the MacPaint page is extracted by extract_top, the
  33. rest of the image is ignored.  You can use the "Show Page" option in
  34. MacPaint's "Goodies" menu to move your image to the upper left part of the
  35. page.  By default, extract_top selects an area the size of the window
  36. displayed in MacPaint (416 x 240 pixels).  You can use the -s option to
  37. change this size.  Other useful sizes are 512x480 (a dithered frame buffer
  38. image) and 576x720 (a full MacPaint page).
  39.  
  40. Summary of extract_top options:
  41.  
  42.  
  43.     Option    Description                Default
  44.     ------    -----------                -------
  45.  
  46.     -f file     MacPaint file to get picture from    Read from stdin
  47.     -c XX    Set column width to center on (inches)  6.5 (Scribe's default)
  48.     -h XX    Height of the resulting macpaint image  2.0 inches
  49.     -s x y      Size (in pixels) of the area extracted    416 240 (M.P. window)
  50.     -P postfile PostScript preamble file to use.        ~mac/lw/scribe_pics/scribepic.ps
  51.     -u XX    Amount to slide MacPaint picture up    0.0 inches.
  52.  
  53. Examples:
  54.  
  55. To extract a MacPaint-window sized image into a PostScript file for 
  56. generating a 2" tall picture in Scribe:
  57.  
  58.     extract_top -f kloo_pic.data > kloo_pic.ps
  59.  
  60. To extract a full page MacPaint picture into a PostScript file for a 5.5"
  61. tall picture in Scribe:
  62.  
  63.     extract-top -f kloo_page.data -h 5.5 -s 576 720 > kloo_page.ps
  64.