EPSMAN
User Documentation






NAME
epsman - Manipulate an EPS file
VERSION
3.2-01
SYNOPSIS
epsman [option] input-file [@parameter-file] [option]
APPLICATIONS

Print EPS files standalone even if they do not have a showpage operator.

Position EPS graphics arbitrarily on a page.

Print letter paper with a graphic in one of the corners.

Make EPS graphics differing in size all the same size.

Print the bounding box of an EPS graphic.

APPLICATIONS

Epsman lets you scale, position, and otherwise manipulate a PostScript file that conforms to the Adobe conventions for Encapsulated PostScript.

In the professional version, PostScript user code can be added to the input file. This feature allows you to change the input files in many ways. For example, it could be used to mask a specific area of the graphic contained in an EPS file or to add page numbers.

PARAMETERS
input-file

The file specification of the file that EPSMAN should operate on.
@parameter-file (professional version only)

The file specification of the file that EPSMAN should read certain parameters from. Currently the following are available:

PrologFileSpecification={file-spec}

The file specification of a PostScript prolog file to load in the appropriate place in the output EPS file.

PrintAfterFileSpecification={file-spec}

The file specification of a file containing PostScript code which should be printed after the input graphic.

OPTIONS
-b[1|2]

Draw the bounding box of the graphic around it. Specify 1 for a normal line, 2 for a dashed line. The default is a normal line. The width of the bounding box is determined by the -w option. The default is 1 point.

The bounding box of a graphic should normally be the closest rectangle enclosing all non-white dots in the output. However, this is sometimes not the case in so far as creating programs consider whitespace as well.

-c[n]

The number of copies that should be printed of the graphic. By default, n is 1.

-C{rx,rx}

The center shift option lets you specify a shift towards the center of the display area in the selected unit of measure (see the -u option). The x and y shifts are specified separately. Naturally there is no shifting to the center with the -pC|CENTER option.

The number of copies that should be printed of the graphic. By default, n is 1.

-F{llx,lly,urx,ury}

The -F option specifies that a frame with rulers be drawn on the output display area with the lower left corner of the frame at llx and lly and the upper right corner at urx and ury.

The unit of measure of the given values are determined by the -u option.

-H

Display usage information including syntax and a list of all options with a description.

-i

Display information about the image on the screen during processing.

-m

Scale the graphic to the maximum size for the selected page/display size. This option is negatable.

Because EPSMAN knows about the size of the display area from the -S option (either implicitly or explicitly) it can differentiate between the maximum size suitable for portrait and for landscape printing.

-M{rx,ry}

The -M option allows shifting of the graphic to a position other than those that can be achieved using the -p option. Values can be positive or negative. The origin of the transformation matrix is in the upper left corner; this means that negative x values move the graphic towards the left and negative y values move the graphic towards the top.

Please note that this is different from the normal PostScript coordinate system which has its origin in the lower left corner.

-O[rx,ry]

Specifies the offset of the whole coordinate system from the lower left corner. This option is used to move the whole coordinate system so that output which would normally be printed in the non-printable area of the printer can be seen.

-o[file]

The -o option lets you specify an output file other than the default file EPSMAN.EPS. To print directly to the printer attached to your PC enter PRN as the file specification.

-p[POS]

Specifies the position at which the manipulated graphic should appear. The following keywords are valid:

C|CENTER

By default, the graphic is centered on the output medium

LL|UL|LR|UR

The graphic is positioned in either the lower left, or the upper left, or the lower right, or the upper right corner of the output medium.

-q

Inserts a PostScript quit operator at the end of the graphic so that the interpreter stops the job after printing the graphic.

This is useful when working with software interpreters like the GNU GhostScript software which would otherwise wait for more PostScript input. On normal PostScript printers a ^D is inserted to let the printer know that the print job is finished. Please note that some printers may consider a terminating ^D an error condition.

-r{n}

Reduce the size of the resultant graphic by n per cent. N must be a floating point number (e.g. 20.0 instead of 20).

-R{0,90,180,270}

The -R option lets you rotate the graphic contained in an EPS file by one of the shown degree values. Rotating is counterclockwise as in PostScript.

The selected rotation has an effect on the -m(aximum size) option. Because EPSMAN knows about the height and width of various paper and screen formats it can decide what the maximum displayable size of a graphic is for the respective orientation.

-s[r]

Scales the graphic by a real value of r. Default scaling is by a factor of 1.0 (unchanged size).

-S[size]

The -S option specifies the size of the output medium , which will normally be a screen or a sheet of paper. Valid keywords are A4, A3, 24x80 (for screens) and others as shown by EPSMAN -H. The CUSTOM keyword lets you specify your own format after the pattern WIDTHxHEIGHT, for example: -S10x10 would specify a display area (= sheet size) of 10 centimeters x 10 centimeters.

-u[uom]

Specifies the unit of measure (uom) assumed for the values to other options (see the -C and -M options). Valid units are CM, MM, INCH, PICA, and POINT.

-v

Switches on verbose mode which displays detailed processing information.

-w

Specifies the width in points of any lines to be drawn by EPSMAN. This applies to the -b option, for example.

RETURNS
0 if successful

1 if unsuccessful
MESSAGES
Self-explanatory.
EXAMPLES
epsman input.eps -m -r7.0

Maximize the size of the input file INPUT.EPS and reduce it again by 7.0 per cent. This produces a size that leaves a nice margin without any calculation on the user's part being necessary. The graphic is centered. The manipulated graphic is written to EPSMAN.EPS.

epsman input.eps -pLL -ooutput.eps

Produce a new file named OUTPUT.EPS with the graphic unchanged in size but move to the lower left corner of the output medium.

epsman input.eps -s0.5 -pUR -C1,1 -uMM -oLPT1 -q

Scale the graphic to half its original size and move it to the upper right corner of the output medium. After that shift it towards the center by 1 centimeter in both the x and the y directions. A command line like the one above might be used to print little pictures on letters. The output goes directly to the printer and the job is terminated by the -q (quit) option.

BUGS
None known.
WARNINGS
None.
LIMITATIONS
None known.
SEE ALSO
No similar tools known.
AUTHOR
Michael Walter
COPYRIGHT
Copyright (c) 1992 - 1998 Michael Walter