dvips: psfile special
5.1.4 'psfile' special
----------------------
The basic special for file inclusion is as follows:
\special{psfile=FILENAME.ps [KEY=VALUE] ... }
This downloads the PostScript file 'FILENAME.ps' such that the current
point will be the origin of the PostScript coordinate system. The
optional KEY=VALUE assignments allow you to specify transformations on
the PostScript.
The possible KEYs are:
'hoffset'
The horizontal offset (default 0).
'voffset'
The vertical offset (default 0).
'hsize'
The horizontal clipping size (default 612).
'vsize'
The vertical clipping size (default 792).
'hscale'
The horizontal scaling factor, as a percentage (default 100).
'vscale'
The vertical scaling factor, as a percentage (default 100).
'angle'
The rotation, in degrees (default 0).
'clip'
Enable clipping to the bounding box (default disabled).
'llx, lly, urx, ury'
Bounding box of the included image, just as in a '%%BoundingBox'
comment. Values are in big points, and may be fractional.
'rhi, rwi'
Desired width and height of the resulting figure in the output, in
tenths of big points (720 to the inch); may be fractional.
If both 'rwi' and 'rhi' are nonzero, the picture is scaled,
possibly losing aspect ratio. If only one of 'rwi' and 'rhi' is
nonzero, the picture is scaled, preserving aspect ratio.
The offsets and sizes are given in PostScript units (big points).
Thus, for example:
\special{psfile=foo.ps hoffset=72 hscale=90 vscale=90}
will shift the graphics produced by file 'foo.ps' right by one inch and
will draw it at 0.9 times normal size. Offsets are given relative to
the point of the special command, and are unaffected by scaling or
rotation. Rotation is counterclockwise about the origin. The order of
operations is to rotate the figure, scale it, then offset it.
For compatibility with older PostScript drivers, it is possible to
change the units that 'hscale' and 'vscale' are given in. This can be
done by redefining '@scaleunit' in 'SDict' by a TeX command such as
\special{! /@scaleunit 1 def}
The '@scaleunit' variable, which is by default 100, is what 'hscale' and
'vscale' are divided by to yield an absolute scale factor.
Info Catalog
dvips: EPSF macros
dvips: PostScript figures
dvips: Dynamic creation of graphics