summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2007-09-24 18:16:02 +0000
committerKarl Berry <karl@freefriends.org>2007-09-24 18:16:02 +0000
commita1415d0c3047a0f25e7b376c2c5c7e1a088872f8 (patch)
treeb8e17da088f208c6faf4cf95a09407f3c2b9828f
parent2391da074af15a2c907f92cbbd1ae6717e08e9bf (diff)
document llx/lly/urx/ury and rhi/rwi (rokicki, 5 Jul 2007 16:05:58)
git-svn-id: svn://tug.org/texlive/trunk@5029 c570f23f-e606-0410-a88d-b1316a301751
-rw-r--r--Build/source/texk/dvipsk/ChangeLog5
-rw-r--r--Build/source/texk/dvipsk/dvips.texi59
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@}