diff options
| -rw-r--r-- | Build/source/texk/dvipsk/ChangeLog | 5 | ||||
| -rw-r--r-- | Build/source/texk/dvipsk/dvips.texi | 59 |
2 files changed, 50 insertions, 14 deletions
diff --git a/Build/source/texk/dvipsk/ChangeLog b/Build/source/texk/dvipsk/ChangeLog index 835728c9559..ecb9cc76da2 100644 --- a/Build/source/texk/dvipsk/ChangeLog +++ b/Build/source/texk/dvipsk/ChangeLog @@ -1,3 +1,8 @@ +2007-09-24 Karl Berry <karl@tug.org> + + * dvips.texi (psfile special): document llx/lly/urx/ury, based on + a description from Tom R. + 2007-08-28 Karl Berry <karl@tug.org> * dvips.h: clarify license (again). diff --git a/Build/source/texk/dvipsk/dvips.texi b/Build/source/texk/dvipsk/dvips.texi index 8e371c82f9e..486ba6a0814 100644 --- a/Build/source/texk/dvipsk/dvips.texi +++ b/Build/source/texk/dvipsk/dvips.texi @@ -3,7 +3,7 @@ @settitle Dvips: A DVI-to-PostScript translator @set version 5.96dev -@set month-year June 2007 +@set month-year September 2007 @copying This manual documents Dvips version @value{version} @@ -2266,29 +2266,60 @@ specify transformations on the PostScript. The possible @var{key}s are: @table @samp - @item hoffset -The horizontal offset (default 0) +@opindex hoffset @r{(@samp{psfile} special option)} +The horizontal offset (default 0). + @item voffset -The vertical offset (default 0) +@opindex voffset @r{(@samp{psfile} special option)} +The vertical offset (default 0). + @item hsize -The horizontal clipping size (default 612) +@opindex hsize @r{(@samp{psfile} special option)} +The horizontal clipping size (default 612). + @item vsize -The vertical clipping size (default 792) +@opindex vsize @r{(@samp{psfile} special option)} +The vertical clipping size (default 792). + @item hscale -The horizontal scaling factor (default 100) +@opindex hscale @r{(@samp{psfile} special option)} +The horizontal scaling factor, as a percentage (default 100). + @item vscale -The vertical scaling factor (default 100) +@opindex vscale @r{(@samp{psfile} special option)} +The vertical scaling factor, as a percentage (default 100). + @item angle -The rotation (default 0) +@opindex angle @r{(@samp{psfile} special option)} +The rotation, in degrees (default 0). + @item clip -Enable clipping to the bounding box +@opindex clip @r{(@samp{psfile} special option)} +Enable clipping to the bounding box (default disabled). + +@item llx, lly, urx, ury +@opindex llx @r{(@samp{psfile} special option)} +@opindex lly @r{(@samp{psfile} special option)} +@opindex urx @r{(@samp{psfile} special option)} +@opindex ury @r{(@samp{psfile} special option)} +Bounding box of the included image, just as in a @code{%%BoundingBox} +comment. Values are in big points, and may be fractional. + +@item rhi, rwi +@opindex rhi @r{(@samp{psfile} special option)} +@opindex rwi @r{(@samp{psfile} special option)} +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 @code{rwi} and @code{rhi} are nonzero, the picture is scaled, +possibly losing aspect ratio. If only one of @code{rwi} and +@code{rhi} is nonzero, the picture is scaled, preserving aspect ratio. + @end table -The dimension parameters are all given in PostScript units. -The @samp{hscale} and @samp{vscale} are given in non-dimensioned percentage -units, and the rotation value is specified in degrees. -Thus +The offsets and sizes are given in PostScript units (big points). +Thus, for example: @example \special@{psfile=foo.ps hoffset=72 hscale=90 vscale=90@} |