MAGICPRINT

Section: User Commands (1)
Updated: DECEMBER 5, 1991
Index Return to Main Contents

NAME

magicprint - display images as halftones with footnote on a Postscript device

SYNOPSIS

magicprint
          [-h imageheight] [-w imagewidth] [-p [#]] [-c] [-d]
          [-F font] [-S fontsize] [-t string] [-T] [-H] [-X[#]] [-s] [-P #]
          [-v "string"] [-V ["string"]] [-b frame#] [-n frames] [-o #] [-g #]
          [-f screenfrequency] [-l] [-m] [-r #]
          [-a screenangle] [<] imagefile | lpr [-Pprinter]

DESCRIPTION

magicprint converts an image sequence to postscript commands for output as a halftone screen. The input image can be one of the following types:
HIPS, FITS, GIF, ICC, JPEG, PICT, PNM, RLE, SUN-raster, and TIFF

The -h and -w flags specify the output halftone dimensions in inches. They default to an aspect ratio equal to that of the images, and if none is specified, so that the maximum dimension is 6 inches.
The screen can be either a circle screen (the default) or a line screen (-l).
The screen frequency (in screen cells per inch) is set by -f; the screen angle in degrees is set by -a. The defaults are 60 cells per inch and 45 degrees. These defaults provide 25 gray levels. Gray levels are mapped linearly to percent of dots painted. Any filters can be used to modify the mapping prior to this. This filter works for byte and bit-packed (MSBFIRST) images.

MORE OPTIONS

Capital letters are usually used for texts and lower case letters are used for the image.

-t string: lets you add a footnote to your image.
-T: will automatically place all items on the command line into the title string.
-V: has both the -t and -T functions but prints the string vertically on the right side of the page.
-v: same as -t but prints the string on the right side of an image vertically.
-H: prints all header information below the image.
-X[#]: same as the -H option and also draws a box frame. The default of the box width is the same as the image width. You can specify the box width by specifying a number touching the -X .
-d: prints history and desciption below images.
-F FONT: used to specify the font for note. (default = NewCenturySchlbk-Bold)
-S: used for changing font size. (default 10)
-P title-position: used to set the height where the string will be printed from the bottom of page. The default place is 1/5 inch below the image.
-B: will place the string at the bottom of the page instead of at the bottom of the image.
-c: used to center the image on the page. The default action is to place the image at the top of the page.
-p [image_top_postion]: change image top position. If no further # is specified, the -p option will set the image top position to 1.5 inch below the top of a page.
-s: paper size (height, default = 11').
-g #: add # of spaces between the box and the image (in printer pixels).
-b frame_number: begin output at the given frame #.
-n frames: The number of frames you want to print. If you specify more frames than are available in the input sequence, magicprint will print all frames until the final frame. The default is 1.
-m: prints the image upside down.
-r angle: rotates the image counterclockwise (use a negative number for clockwise rotation).
-o frame# offset: First frame # offset. This option is used for some input images which have been preprocessed by some tools not starting at the first frame. This option is just for printing the footnote, and will not effect image printing.

For versatec (VT) printers, it is better to use the -p option and test it before formal printing unless you are very sure VT works well; use -h 10.2 or less since the VT printer usually has a narrow printing size.

AUTHOR

Jin Guojun - 12/10/90

This document was created by man2html, using the manual pages.
Time: 01:24:55 GMT, December 05, 2024