vxctops − convert VisionX image files to Postscript.

vxctops if=imagefile [s= | -s] [-i] [-b] [-l] [xp=] [yp=] [xs=] [ys=] [xo=] [yo=] [ft=] [sz=] [h=] [f=] [f2=] [fp=] [hp=] [-n] [-ep] [lf=] [pf=] [px=] [py=] [-img] of=outfile

Vxctops converts a standard VisionX V4 byte image to Postscript for printing on the laserwriter or encapsulated Postscript for inculsion in a document. Additionally, the user may specify a header string and up to two footer strings. The printed image may be annotated with text and/or encapsulated Postscript images.

input is limited to single grey-level images in byte, signed byte or bitplane format.

if=

is the VisionX image file

s=

is a float image scale factor. The default for this parameter is 3.0. This corresponds to 100 pixels per inch.

-b

render small image as pixel boxes (i.e. example and test images). The default box size is 8x8 points (8/72 inches). Use -s or s= to change the box size.

-s

causes the image to be auto-scaled to fill the page.

-l

selects landscape orientation for the image.

xp= yp=

moves the image with respect to the center of the page in inches. By default, the image is centered on the page.

xo= yo=

specify the origin, in pixels, of a sub-image to be printed.

xs= ys=

specify the size, in pixels, of a sub-image to be printed.

h=

is used to specify a header string. The default page header is the user name followed by the image file name.

f=

is used to specify a footer string. The default page footer is the first four lines of the VisionX title block contained within the image header. If a second footer line is required, the parameter f2= may be specified.

-n

supress printing of headers and footers.

hp=

is the position of the header, in inches, from the top of the page.

fp=

is the position of the footer, in inches from the bottom of the page.

ft=

specifies the font. Examples of alternative fonts are "Times-Italic", "Palatino-Roman", "Helvetica-Bold". (other fonts may be found on some UNIX systems in /usr/local/lib/ps) The default font used for headers and footers is "Times-Roman".

sz=

is point size of the font. The default font size is 12.0.

-ep

generate an encapsulated Postscript file.

-i

invert the image grey scale.

-g

generate a grid for use in page setup.

lf=

specifies a label file used to annotate images. The format of this file is :

<style1> x1 y1 "text1"
<style2> x2 y2 "text2"
.
.

<style> : is the font style for the label

R - Roman
I - Italic
B - Bold
X - draw box around label

x, y : is the center of label in inches from
the lower left corner of the page.

"text" : the label string

pf=

is an encapsulated Postscript file to be included as input. Typically this option is used to convert an eps file to a conventional ps file for printing. Use the px= and py= options decsribed below to locate the eps figure on the output page.

px= py=

is the position on the page in inches for the lower left corner of the encapsulated Postscript file.

-img

selects image coordinate system (inverted y axis)

R. J. Prokop