Extract_top is a program for taking a portion of a MacPaint picture and
converting it to a PostScript file that can be used with the @Picture command
in Scribe.

The PostScript output generated by extract_top can be included in a Scribe
file with a Scribe command like the following:

	@figure[
	@picture(Size=3 inch, ScaleableLaser=[postscript_output.ps])
	@caption(System Overview)
	@tag(SysView)
	]

In this case, the file "postscript_output.ps" is included into the scribe
file, and Scribe will leave 3 inches of column space for it.  The "Size"
specified in the @Picture command should match the height given to
extract_top with the "-h" option.  (Extract_top's default is 2 inches).

To upload a MacPaint file to the vax, you'll need to run MacTerminal on
the mac, and use "macget -d filename" to upload the file.  (Macget will
create "filename.data" on the vax).  See the man page for macget(1) for
more information on uploading files.

Extract_top scales the macpaint picture to match the aspect ratio of the
area extracted, and centers it within the Scribe text column (assumed to
be 6.5 inches - i.e, 1" margins).  You can use the -c option to change
the width of the column extract_top centers the picture in.  Normally
the MacPaint image is placed at the bottom of the area Scribe allocates
for it, you can use the -u option to slide it up a specified number of
inches.

The upper left portion of the MacPaint page is extracted by extract_top, the
rest of the image is ignored.  You can use the "Show Page" option in
MacPaint's "Goodies" menu to move your image to the upper left part of the
page.  By default, extract_top selects an area the size of the window
displayed in MacPaint (416 x 240 pixels).  You can use the -s option to
change this size.  Other useful sizes are 512x480 (a dithered frame buffer
image) and 576x720 (a full MacPaint page).

Summary of extract_top options:


    Option	Description				Default
    ------	-----------				-------

    -f file 	MacPaint file to get picture from	Read from stdin
    -c XX	Set column width to center on (inches)  6.5 (Scribe's default)
    -h XX	Height of the resulting macpaint image  2.0 inches
    -s x y      Size (in pixels) of the area extracted	416 240 (M.P. window)
    -P postfile PostScript preamble file to use.        ~mac/lw/scribe_pics/scribepic.ps
    -u XX	Amount to slide MacPaint picture up	0.0 inches.

Examples:

To extract a MacPaint-window sized image into a PostScript file for 
generating a 2" tall picture in Scribe:

	extract_top -f kloo_pic.data > kloo_pic.ps

To extract a full page MacPaint picture into a PostScript file for a 5.5"
tall picture in Scribe:

	extract-top -f kloo_page.data -h 5.5 -s 576 720 > kloo_page.ps
