ipfe.1

早期freebsd实现

\fB\-s\fR
(satisfy SIFS). Satisfy any sequenceInsertFile (SIF) references
encountered in the input stream. This entails replacing the SIF
reference with the actual tokens in the referenced file.
The algorithm used is dependent upon the SIF type as found in the
referenced file's header. If the referenced file is not found or
there is some error, such as an invalid header, the SIF
reference is preserved, unless the \fB\-r\fR (remove SIF
references) is also specified. The Interpress filename alias
mechanism is supported via the \fB\-a\fR option.
.TP
\fB\-S \fIscale-factor\fR
(Scale). Scale the image by \fIscale-factor\fR, which can have
the format 'n/d', where both n and d must be integers, or 'a.b'.
.TP
\fB\-X \fIX-offset:unit\fR
(xImageShift). Shift the image \fIoffset units\fR in the
x-direction, where \fIunit\fR may be none (default centimeters),
\fBc\fR (centimeters), \fBi\fR (inches), \fBp\fR (points), or
\fBP\fR(Picas). \fIOffset\fR may be a negative value. The
x-direction is independent of the \fB\-L\fR and \fB\-R\fR
options (i.e., the positive x-direction is still to the right
as the image is viewed, even if a rotation is applied).
.TP
\fB\-Y \fIY-offset:unit\fR
(yImageShift). Shift the image \fIoffset units\fR in the
y-direction, where \fIunit\fR may be none (default centimeters),
\fBc\fR (centimeters), \fBi\fR (inches), \fBp\fR (points), or
\fBP\fR(Picas). \fIOffset\fR may be a negative value. The
y-direction is independent of the \fB\-L\fR and \fB\-R\fR
options (i.e., the positive y-direction is still up as the
image is viewed, even if a rotation is applied).
.TP
\fIinfile \fR[ \fIpagerange\fR ]
Each \fIinfile\fR may have a \fIpagerange\fR specification for
selecting pages from the \fIinfile\fR to merge and/or overlay.
The \fIpagerange\fR specification must immediately follow the
corresponding \fIinfile\fR specification to which it applies,
as a separate option (i.e., it must not be quoted along with
\fIinfile\fR. For shell processing, however, the pagerange
specification itself may be quoted in order to use the brackets
and parentheses required by the syntax).
.IP
\fINote:\fR In the syntax below, pageNum refers to a count of
pageBodies (excluding the preamble) in the Interpress master,
and does not necessarily match the printed page numbers on the
output pages. See the references below for a definition and
discussion of pageBodies.
.IP
The syntax for the \fIpagerange\fR specification is given in the
following psuedo Backus-Naur Form:
.RS
.IP
pageRange	::= [pageSpec,...,endPageSpec]
.IP
pageSpec	::= pageNum | pageNum-pageNum |
.br
		      pageNum[overlaySpec][...]
.IP
endPageSpec	::= pageNum- | NULL
.IP
pageNum 	::= integer
.IP
overlaySpec	::= overlayFileName | overlayFileName:pageNum |
.br
		      overlayFileName(xOffset,yOffset) |
.br
		      overlayFileName:pageNum(xOffset,yOffset)
.RE
.sp 1
.IP
The syntax rules are:
.RS
.IP 1.
The \fIpageRange\fR specification must begin with a left bracket
and end with a right bracket ("[\fIpageRangeSpec\fR]").
.IP 2.
Pages are specified by an integer corresponding to a pageBody
count, in increasing order, through the master.
.IP 3.
A minus ("-") indicates a page range.
.IP
\fIExample:\fR [4-6] includes pages 4 through 6.
.IP 4.
A comma separates pages and page ranges.
.IP
\fIExample:\fR [4,6-9] includes pages 4 and 6 through 9.
.IP 5.
A minus ("-") appearing after the final page specification
includes all pages to the end of the master.
.IP
\fIExample:\fR [4,6,9-] includes pages 4, 6, and 9 through
the last page of the master.
.IP 6.
Immediately following a page specification, a left/right bracket
pair may enclose a filename to indicate an overlay
("[\fIoverlayfile\fR]"). The overlay may be an Interpress master
or an Interpress fragment. If the overlay is an Interpress master
containing more than one page, and no overlay pageNum is
specified, IPFE uses page 1 for the overlay. There may be
more than one overlay specification for a page specification,
each enclosed in a left/right bracket pair and immediately
following one another.
.IP
\fIExample:\fR [4[pic1][pic2]] includes page 4 and overlays
it with pic1 and pic2.
.IP 7.
Immediately following \fIoverlayfile\fR in an overlay
specification, a colon followed by an \fIoverlayPageNum\fR
selects a page from \fIoverlayfile\fR for the overlay
("[\fIoverlayfile\fR:\fIoverlayPageNum\fR]").
.IP
If \fIoverlayfile\fR is an Interpress fragment, or
\fIoverlayPageNum\fR doesn't exist, the overlay specification
is ignored.
.IP
\fIExample:\fR [4[pic1:2] includes page 4 and overlays it with
page 2 of pic1.
.IP 8.
Within an overlay specification, a left/right parenthesis pair
may enclose a \fIpage offset\fR to reposition the overlay page
("[\fIoverlayfile\fR(\fIxOffset,yOffset\fR)]" or
"[\fIoverlayfile\fR:\fIoverlayPageNum\fR(\fIxOffset,yOffset\fR)]").
.IP
The \fIpage offset\fR has the form \fIxOffset,yOffset\fR
and each offset has the form \fIvalue unit\fR. The comma between
the offsets is required, and there must be no space between
\fIvalue\fR and \fIunit\fR. Unit is one of the following: none
(default centimeters), c (centimeters), i (inches), p (points),
P (Picas). The origin is the bottom left corner of the page.
The positive x-direction is to the right, and the positive
y-direction is up. X/y-directions may be positive or negative.
.IP
\fIExample:\fR [4[pic1:2(2P,4P)][pic2(-3P,-1P)]] includes
page 4 and overlays it with page 2 of pic1, offset 2 Picas
to the right and 4 Picas up, and pic2, offset 3 Picas to the
left and 1 Pica down.
.RE
.sp 1
.IP
\fIExample\fR of using a \fIpagerange\fR specification:
.IP
	ipfe infile "[1,4-6,9[pic1],10-11,12[pic2:2(2P,4P)][pic3(-4P,-2P)],15-]"
.IP
which reads:
.RS
.IP
include page 1,
.IP
skip pages 2-3,
.IP
include pages 4-6,
.IP
skip pages 7-8,
.IP
include page 9 and overlay it with pic1 (with no offset),
.IP
include pages 10-11,
.IP
include page 12 and overlay it with page 2 of pic2
(offset 2 Picas to the right and 4 Picas up) and
pic3 (offset 4 Picas to the left and
2 Picas down),
.IP
skip pages 13-14,
.IP
include pages 15 through the end of the master.
.SH AUTHOR
Mark Rollins, Xerox Corporation, Webster Research Center, October 1985.
.SH SEE ALSO
Interpress Electronic Printing Standard, Version 3.0, Xerox Corporation,
January 1986, \s8XNSS\s10 048601
.br
Introduction to Interpress, Xerox Corporation, June 1983, \s8XSIG\s10 038404
.br
The address for obtaining these documents is:
.br
		Xerox Corporation
.br
		Printing Systems Administration Office
.br
		701 South Aviation Blvd.
.br
		El Segundo, CA  90245
.SH BUGS
IPFE assumes that SIF's and overlays are either valid Interpress
fragments or Interpress masters containing a single BEGIN/END block.
If an Interpress master containing nested blocks is attempted to be
used as either a SIF or an overlay, the result may be unpredictable.
The most likely error would be the erroneous inclusion of one or
more extraneous preambles.