[latex3-commits] [latex2e-public] r1495 - try to describe pdf page box options

[noreply at latex-project.org]

Author: carlisle
Date: 2017-06-04 11:06:19 +0200 (Sun, 04 Jun 2017)
New Revision: 1495

Modified:
   trunk/required/graphics/grfguide.tex
Log:
try to describe pdf page box options

Modified: trunk/required/graphics/grfguide.tex
===================================================================
--- trunk/required/graphics/grfguide.tex	2017-06-02 20:20:09 UTC (rev 1494)
+++ trunk/required/graphics/grfguide.tex	2017-06-04 09:06:19 UTC (rev 1495)
@@ -1,5 +1,5 @@
 %% grfguide.tex Copyright (C) 1994 1995 1996 1998 1999 David Carlisle
-%%              Copyright (C) 2005 2014 2016 David Carlisle, LaTeX3 Project
+%%              Copyright (C) 2005 2014 2016 2017 David Carlisle, LaTeX3 Project
 %%
 %% This file is part of the Standard LaTeX `Graphics Bundle'.
 %% It may be distributed under the terms of the LaTeX Project Public
@@ -190,7 +190,7 @@
 \begin{document}
 \title{Packages in the `graphics' bundle}
 \author{D. P. Carlisle \and The \LaTeX3 Project}
-\date{2016/12/23}
+\date{2017-06-01}
 
 \maketitle
 
@@ -664,6 +664,25 @@
  |%%HiResBoundingBox| lines rather than |%%BoundingBox|. It may be set
  to |false| to overrule a default setting of |true| set by the
  |hiresbb| package option.
+\item[pagebox]\NEWfeature{2017/06/01}
+PDF files do not have BoundingBox but may specify up to four predefined
+rectangles.
+
+|MediaBox|: the boundaries of the physical medium.
+|CropBox|: the region to which the contents of the page are to be
+  clipped when displayed.
+|BleedBox|: the region to which the contents of the
+ page should be clipped in production.
+|TrimBox|: the intended dimensions of the finished page.
+|ArtBox|: the extent of the page's meaningful content.
+
+The driver will set the image size based on |CropBox| if present,
+and then will use one of the others in a driver-defined order if not.
+|MediaBox| is always present.
+
+The |pagebox| key may be used to specify which bounding box specification to use,
+The value should be one of
+|mediabox|, |cropbox|, |bleedbox|, |trimbox|, |artbox|.
 \item[viewport]\NEWfeature{1995/06/01}
  The |viewport| key takes four arguments, just like
  |bb|. However in this case the values are taken relative to the
@@ -704,6 +723,12 @@
  should \emph{only} be used in conjunction with |type|. 
 \item[command] Specify any command to be applied to the file.  This
  should \emph{only} be used in conjunction with |type|.
+\item[quiet]\NEWfeature{2017/06/01}
+ Skip writing information to the log.
+\item[page]\NEWfeature{2017/06/01}
+Page of a multi-page PDF file. (by default the first page will be used.)
+\item[interpolate]\NEWfeature{2017/06/01}
+Enable/disable interpolation of bitmap images by the viewer.
 \end{description}
 
 For the keys specifying the original size (i.e,, the bounding box,