From 2efb767e21f2a7f6da4471ed67e45adf1b1acb8f Mon Sep 17 00:00:00 2001 From: Joseph Wright Date: Fri, 19 May 2017 12:53:14 +0100 Subject: [PATCH] Tidy up header for pdftex.def This is now the same as dvips.def. The long list of changes/interface options should be moved (if retained) to a proper documenation file. --- pdftex.def | 271 ++--------------------------------------------------- 1 file changed, 7 insertions(+), 264 deletions(-) diff --git a/pdftex.def b/pdftex.def index 76ebd37..6edacad 100644 --- a/pdftex.def +++ b/pdftex.def @@ -1,17 +1,7 @@ -\ProvidesFile{pdftex.def}[2017/01/12 v0.06k Graphics/color for pdfTeX] -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -%% -%% LaTeX Colour and Graphics support for PDFTeX -%% -%% License -%% ======= -%% -%% Copyright (C) 2000-2015 -%% David Carlisle, Sebastian Rahtz, Hans Hagen, -%% Heiko Oberdiek and Martin Schr\"oder -%% -%% 2016-2017 LaTeX3 project and Heiko Oberdiek -%% https://github.com/latex3/graphics-def/issues +%% pdftex.def Copyright (C) 2000-2015 David Carlisle, Sebastian Rahtz, +%% Hans Hagen, Heiko Oberdiek, +%% Martin Schr\"oder +%% Copyright (C) 2016-2016 Heiko Oberdiek, LaTeX3 Project %% %% This work may be distributed and/or modified under the %% conditions of the LaTeX Project Public License, either version 1.3c @@ -23,258 +13,11 @@ %% %% This work has the LPPL maintenance status `maintained'. %% -%% The Current Maintainers of this work are -%% LaTeX3 project and Heiko Oberdiek -%% -%% This work consists of the file pdftex.def. -%% -%% Usage -%% ===== -%% -%% It may be used by specifying the pdftex option to any of the -%% supported packages, for example: +%% The Current Maintainer of this work is the LaTeX3 Project. %% -%% \usepackage[pdftex]{graphicx} +%% https://github.com/latex3/graphics-def/issues %% -%% * pdfTeX determines the bounding box of the images by means of -%% itself. Therefore the bounding box options should not be used. -%% In this cases a warning is issued and viewport is used instead. -%% * Option "page" (graphicx) for selecting a page of a multipage -%% PDF document. -%% * \pagecolor is supported. \nopagecolor disables the page color. -%% * Option "quiet" (graphicx/experimental): log messages are suppressed. -%% * Option "resolution" (graphicx/experimental): this sets -%% \pdfimageresolution, see pdfTeX documentation. -%% * Option "print" (graphicx/experimental): specifies an alternate -%% print image (bitmaps only), see PDF specification. -%% * pdftex.def can be used under plain-TeX with miniltx support. -%% -%% "Experimental" means that these features can change or vanish -%% in later versions. -%% -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -% -% History -% ... -% 2000/04/20 v0.02s: -% * gray color model directly supported (HO). -% 2000/05/02 v0.02t: -% * \pagecolor supported (HO). -% 2000/05/12 v0.02u: -% * support for multipage pdf files, option `page' added (HO). -% 2000/05/31 v0.02v: -% * Option `page' is defined at begin document, -% if package `keyval' is loaded after `pdftex.def'. -% 2000/06/16 v0.03a: -% * Added Heiko to author list (DPC). -% 2000/08/31 v0.03b: -% * support for alternate print images: option `print' added (HO). -% * This feature is not supported by Ghostscript, xpdf, or AR3. -% * The images should have the same dimensions/resolution. -% * Two experimental options added (HO): -% * `quiet': log messages are suppressed. -% * `resolution': sets \pdfimageresolution. -% Because these options are not supported by graphicx, -% they have to be set after \usepackage{graphicx}, eg. -% \setkeys{Gin}{quiet,resolution=300} -% Option `quiet' (for pdftex) can be make known to graphic{s,x} -% with this line in graphics.cfg: -% \DeclareOption{quiet}{\let\Gin@log\@gobble} -% Caution: both options are experimental and can be -% change in next versions! -% * \pdfpage{width,height} are only set, if \paperwidth -% is defined (HO). -% 2000/09/04 v0.03c -% * Redefinition of `natwidth' and `natheight' \AtBeginDocument (HO). -% 2000/09/14 v0.03d -% * Fixes for `viewport' and `trim' (HO). -% * Clip support added for viewport and trim (HO). -% 2000/09/14 v0.03e -% * Options `bbllx', `bblly', `bburx', `bbury' disabled, -% option `bb' redirected with a warning to `viewport' (HO). -% 2000/11/10 v0.03f -% * Bug, that produces an error message, if package `graphics' -% is used (introduced in 0.03d), fixed: If \Gin@vllx is not -% defined (graphics), then clipping and the moves of options -% viewport/trim are silently disabled (HO). -% 2001/05/25 v0.03g -% * \pdfpagewidth and \pdfpageheight are not set to zero, -% if \paperwidth and \paperheight are not set (HO). -% 2001/09/01 v0.03h -% * Compatibilty for miniltx.tex, problems fixed: -% \@ifpackageloaded, \PackageWarning, \PackageWarningNoLine, -% \@currname. -% 2001/11/29 v0.03i -% * Problem with \if@inlabel (plain format) fixed. -% 2002/06/18 v0.03j -% * Contribution by P\'etiard Fran\c{c}ois : -% Improvement of \Ginclude@mps (support of viewport and clip). -% 2002/06/19 v0.03k -% * Correction by P\'etiard Fran\c{c}ois for \GPT@DoEndClip. -% 2005/06/15 v0.03l -% * \usebox patch fixed (\aftergroup part removed) (HO). -% 2005/06/20 v0.03m -% * .tif support is removed for pdfTeX >= 1.10a (HO). -% 2006/02/23 v0.03n -% * Compatibility for plain-TeX: file can be loaded multiple times; -% colorfix is not applied for undefined macros (HO). -% 2006/02/24 v0.03o -% * Catcode protections mainly because of babel's shorthands (HO). -% 2006/03/02 v0.03p -% * \pagecolor support for plain-TeX fixed (HO). -% 2006/05/17 v0.03q -% * Error message if ConTeXt's supp-pdf.tex is missing and -% support of MPS files is not available (Markus Kohm = MK, HO). -% 2006/06/06 v0.03r -% * \nopagecolor/\no@page@color added (HO). -% 2006/07/16 v0.03s (HO) -% * LPPL 1.3c. -% * A little usage. -% * Test for \MessageBreak changed (comp.text.tex, -% message id: <44baca88$0$10529$9b4e6d93@newsread4.arcor-online.net>). -% 2006/08/14 v0.03t (HO) -% * Extensions added: .jpeg, .JPG, .JPEG, .PNG, .PDF -% No variants for .tif, because TIFF support is no longer available. -% No need for uppercase variant of .mps. -% 2007/01/01 v0.04a (HO) -% * Support of color stack, introduced in pdfTeX 1.40.0. -% * Support of transform matrix commands of pdfTeX 1.40.0. -% * The argument for option `page' can be a register. -% 2007/01/02 v0.04b (HO) -% * Internal change: Switching of color stacks is easier by using -% \@pdfcolorstack for the stack number. Thus this command -% should be redefined, if someone wants to use another color stack -% (e.g. for footnotes). \main@pdfcolorstack should not be changed -% for this purpose. -% 2007/01/06 v0.04c (HO) -% * Support for JBIG2 added (pdfTeX 1.40.0). -% 2007/01/08 v0.04d (HO) -% * Bug fix: .mps forgotten for extension list if pdfTeX >= 1.40.0 -% * .jbig2 and .jb2 are not listed in the extension list -% if \pdfminorversion < 4. Thus \pdfminorversion should have -% the correct value, if pdftex.def is loaded. -% 2007/03/15 v0.04e (HO) -% * Missing comma in \Gin@extensions added (found by Reinhard Kotucha). -% 2007/04/06 v0.04f (HO) -% * Fix for \pagecolor, text before page color can lead to an invalid -% page stream. Therefore "page" is now used instead of "direct" -% as modifier for \pdfliteral. -% * Boolean option `resetcolor' added (pdfTeX >= 0.12n). -% The current color is used for PDF or MPS images, unless -% the images contain their own color settings. -% If option `resetcolor' is set to `true', then the current color -% is reset to \normalcolor during image inclusion. -% 2007/04/17 v0.04g (HO) -% * Small improvement of robustness of \pagecolor -% and using e-TeX if available. -% 2007/06/12 v0.04h (HO) -% * Fix for \pagecolor: v0.04f uses keyword `page' for \pdfliteral, -% but this keyword is not available before pdfTeX 1.30.0. -% 2007/12/04 v0.04i (HO) -% * Fatal error is avoided if image file does not exists. -% 2007/12/06 v0.04j (HO) -% * Option xmpfile added for adding metadata (experimental). -% 2008/07/16 v0.04k (HO) -% * \LoadMetaPostSpecialExtensions -% loads additional support for MetaPost images (transparency) -% by loading supp-mpe.tex and supp-mis.tex -% (method posted in comp.text.tex by Jeremy Lea). -% As side effect MetaPost images are put in separate objects -% and are not inlined in the page stream. -% Status: experimental. -% 2008/09/08 v0.04l (HO) -% * Adds an error message, if pdfTeX is called in DVI mode. -% * Aborts loading of the package with an error message, -% if pdfTeX is missing. -% 2009/08/25 v0.04m (HO) -% * Catcodes are preserved and initialized for loading of -% pdftex.def and ConTeXt's support files. -% * ConTeXt's support files have now the extension `.mkii' instead -% of `.tex'. -% 2010/02/14 v0.04n (HO) -% * \GPT@catcodes extended for xmlTeX (pdftex.def loads -% supp-pdf.mkii at begin document where xmlTeX's catcodes -% are already active). -% 2010/03/11 v0.04o (HO) -% * Ensure that \undefined is undefined during loading of -% ConTeXt files. -% 2010/03/12 v0.04p (HO) -% * \undefined is also undefined during conversion of MPS. -% 2010/04/14 v0.04q (HO) -% * Optimizations for rotating and scaling: -% * remove unnecessary identity transformations -% * numbers are normalized -% 2010/04/15 v0.04r (HO) -% * Fix for scale values without integer part. -% 2010/09/09 v0.05a (HO) -% * Option `pagebox' added for specifying the pdf page box -% of the included image. Values are `mediabox', `cropbox', -% `bleedbox', `trimbox' and `artbox'. Default is `cropbox'. (MS/HO) -% * Option `interpolate' added for bitmaps, see PDF specification. -% Values are `true' or `false', default is `false'. -% * Option `decodearray' added for bitmaps, see PDF specification, -% key /Decode of image dictionaries. The value for option -% `decodearray' is the value for /Decode without `[' and ']'. -% * Option `maskarray' added for bitmaps, see PDF specification, -% key /Mask of image dictionaries with array as value. -% The value of `maskarray' is the array value for /Mask -% without `[' and ']'. -% * Option `intent' added for the rendering intent of bitmap -% images, see PDF specification, key /Intent of image -% dictionaries. The value is a name without a leading slash, -% the standard names of the PDF specification: -% `AbsoluteColorimetric', `RelativeColorimetric', -% `Saturation', `Perceptual'. -% * Options `ocobjnum' and `ocobjref' are hooks for those who wants -% to work with optional content. The options can be used for both -% bitmap and PDF images and are unsupported for MPS. -% The optional content dictionary is given by an external -% object. Option `ocobjnum' expects the number of that object -% (e.g. \pdflastobj). It's a positive integer (greater than zero). -% Option `ocobjref' takes the full object reference -% (positive integer, followed by ` 0 R' in case of pdfTeX). -% Other drivers might support `ocobjref' as well, in case of -% PostScript/pdfmark drivers, the object is usually referenced by -% a name in curly braces. -% * Tiff support removed for driver versions between 1.10a and 1.30. -% 2010/09/14 v0.05b (HO) -% * Fix, \pagecolor got broken accidentally (in v0.05a). -% 2010/11/26 v0.05c (HO) -% * \stockwidth and \stockheight of class `memoir' respected. -% 2011/01/28 v0.05d (HO) -% * Patching trig.sty is improved by doing it earlier in some -% cases, e.g. if one of class `memoir', package `scrlfile' or -% package `filehook' is loaded. -% 2011/04/21 v0.06a (HO) -% * The use info on the screen goes with an information -% entry in the .log file that also tells the requested -% width (feature request of Axel Berger). -% * Use of packages `infwarerr' and `ltxcmds'. -% 2011/04/25 v0.06b (HO) -% * Fix in \GPT@NormalizeNumber. -% * Date fixed in \ProvidesFile. -% 2011/05/18 v0.06c (HO) -% * The ConTeXt support files `supp-pdf.*' and `supp-mpe.*' do -% not prevent reloading. Therefore `pdftex.def' only tries to load -% them if \convertMPtoPDF and \assignMPStransparency are not -% available. This fixes a compatibilty issue with class `combine'. -% 2011/05/27 v0.06d (HO) -% * Fix for v0.06a, package `ltxcmds' was not loaded in plain TeX. -% 2016/01/23 v0.6e (DPC) -% * Move EPS handler here from graphics.cfg -% 2016/06/04 v0.6f (DPC) -% * support graphcs/color option (no)setpagesize -% 2016/06/15 v0.6g (DPC) -% * typo -% 2016/06/17 v0.6h (DPC) -% * guards for contributed packages and plain TeX -% 2016/07/10 v0.6j (DPC) -% * don't set page size for non standard \mag -% 2017/01/12 v0.6k (DPC) -% * graphics options as viewport for graphics/4499 -% - - +\ProvidesFile{pdftex.def}[2017/01/12 v0.06k Graphics/color for pdfTeX] % Prefix of internal commands for this file `pdftex.def': % \GPT@ (Graphics bundle PdfTex driver)