diff options
Diffstat (limited to 'macros/latex/contrib/bxpdfver/README.md')
-rw-r--r-- | macros/latex/contrib/bxpdfver/README.md | 48 |
1 files changed, 37 insertions, 11 deletions
diff --git a/macros/latex/contrib/bxpdfver/README.md b/macros/latex/contrib/bxpdfver/README.md index 332b6215f1..1b78b5da1c 100644 --- a/macros/latex/contrib/bxpdfver/README.md +++ b/macros/latex/contrib/bxpdfver/README.md @@ -44,11 +44,16 @@ The available options are: * `noobjcompress`: Suppresses use of object streams. * `objcompress` (default): Does not suppress use of object streams. * Driver options: As below: + + When the new PDF management of LaTeX is activated, the package + will automatically switch to “latex-pdf” mode. You need not + give driver options. + When using a PDF-output engine, you need not give driver options since the appropriate one is auto-detected. + `dvipdfmx`: Uses dvipdfmx driver. + `nodvidriver`/`disabled`: Disables all functions of the package. NB. This option sets `lenient+` by default. + * `ignorepdfmanagement`: Avoids switching to “latex-pdf” mode, even + when the new PDF management of LaTeX is activated. * `lenient`: Turns the errors for unsupported features into warnings. * `lenient+`: Suppreseses the errors for unsupported features. * `nolenient`: Negation of `lenient(+)`. @@ -72,40 +77,61 @@ when it is already suppressed by other means. * `\preservepdfdestinations`: Stops shortening the PDF destination names and uses the original names given in the LaTeX documents. This is necessary for cross-document links to work correctly. + * `\setpdfpkresolution{<resolution>}`: Sets the resolution (in dpi) + of the PK fonts embedded in the PDF file. ### NOTE ON DRIVERS \ Drivers (engines) pdfTeX dvipdfmx - Features / LuaTeX / XeTeX others - --------------------------- --------- --------- ------ - \setpdfversion Yes Yes No - \suppresspdfcompression Yes Maybe(*2) No - \suppresspdfobjcompression Yes Maybe(*2) No + Features / LuaTeX / XeTeX latex-pdf + --------------------------- --------- --------- --------- + \setpdfversion Yes Yes Yes + \suppresspdfcompression Yes Maybe(*2) Yes(*4) + \suppresspdfobjcompression Yes Maybe(*2) Yes(*4) \setpdfdecimaldigits Yes Maybe(*2) No \preservepdfdestinations No-op(*1) Maybe(*2) No + \setpdfpkresolution Yes Maybe(*3) No 1. In pdfTeX and LuaTeX, PDF destination names are never shortened; that is, it can be thought as if `\preservepdfdestinations` were always in effect. 2. These features are available only when the version of (x)dvipdfmx - is 20160307 or later. Also shell escape must be accepted (with or - without restriction) so that `kpsewhich` and `extractbb` will be - allowed to run, because those programs are used in order to detect - the dvipdfmx version. + is 20160307 or later. + 3. These features are available only when the version of (x)dvipdfmx + is 20211016 or later. + 4. As for '\suppresspdfcompression' and '\suppresspdfobjcompression', + when one of them is executed, the other will be activated. It is + because l3pdf module does not support activating only one of them. + +On the detection of dvipdfmx version: + + * Shell escape must be accepted (with or without restriction) so that + `kpsewhich` and `extractbb` will be allowed to run, because those + programs are used in order to detect the dvipdfmx version. + * The detection process is slow, so the result is cached in the + auxiliary file (`.aux`). When the environment is changed, you need + to delete the auxiliary file. More notices: - * If you try to use unavailable features, an error will occur. + * If you try to use unavailable features, an error will occur. + NB. Option `lenient` turns the errors into warnings, and `lenient+` + completely suppresses the errors. * The package recognizes some “unsupported” driver options such as `dvips`; when such drivers are used, use of any feature will cause an error. - * The use of `nodvidriver` sets `lenient*` by default; use of any + * The use of `nodvidriver` sets `lenient+` by default; use of any feature will do nothing (nor issue an error). REVISION HISTORY ---------------- + * Version 0.8 ‹2024/08/03› + - Support some features even when the new PDF management of the + LaTeX kernel is activated (“latex-pdf” mode). + * Version 0.7 ‹2024/07/24› + - Support (officialy) `\setpdfpkresolution`. * Version 0.6 ‹2022/04/28› - Added the `lenient+` and `nolenient` options. * Version 0.5a ‹2021/02/14› |