1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
|
BXpdfver Package
================
LaTeX: To specify the version and compression level of output PDF files
This package enables users to specify in their sources the following
settings on the PDF document to output:
* PDF version (1.4, 1.5 etc.);
* whether or not to compress streams;
* whether or not to use object streams.
* precision of decimal numbers used in PDF commands
* whether or not to preserve (not shorten) PDF destination names
### SYSTEM REQUIREMENT
* TeX format: LaTeX.
* TeX engine: pdfTeX, XeTeX, LuaTeX, and any DVI-output engines.
* DVI-ware (in DVI mode): dvipdfmx.
* Required packages:
- atbegshi (when using dvipdfmx driver)
### INSTALLATION
- `*.sty` → $TEXMF/tex/latex/BXpdfver
### LICENSE
This package is distributed under the MIT license.
bxpdfver package
----------------
### PACKAGE LOADING
\usepackage[<option>,...]{bxpdfver}
The available options are:
* `1.4`, `1.5`, `1.6`, `1.7` or `2.0`: Sets PDF version.
* `nocompress`: Suppresses stream compression.
* `compress` (default): Does not suppress stream compression.
* `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(+)`.
Note that the options `compress` and `objcompress` mean that this
package *does not suppress* a feature. They do not reactivate a feature
when it is already suppressed by other means.
### USAGE
* `\setpdfversion{<version>}`: Sets PDF version.
Here `<version>` is either one of the following:
+ `1.4`, `1.5`, `1.6`, `1.7` or `2.0`; the version itself.
+ the name of a PDF file; the version is set equal to that of
the given file.
* `\suppresspdfcompression`: Suppresses stream compression.
* `\suppresspdfobjcompression`: Suppresses use of object streams.
* `\setpdfdecimaldigits{<precision>}`: Sets the precision (the number
of digits after decimal points) of the decimal numbers that appear
in PDF command sequences.
* `\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 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.
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.
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
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›
- Adjustment for the new version of hyperref.
* Version 0.5 ‹2020/04/19›
- Suuport PDF version value `2.0`.
* Version 0.4 ‹2017/02/11›
- Add `\setpdfdecimaldigits` and `\preservepdfdestinations`.
* Version 0.3 ‹2016/08/11›
- Supported all features on dvipdfmx/XeTeX.
* Version 0.2b ‹2016/08/10›
- Added the `lenient` option.
- Supported the newer version of LuaTeX.
* Version 0.2a ‹2015/08/05›
- Minor fix.
* Version 0.2 ‹2014/07/04›
- First public version.
--------------------
Takayuki YATO (aka. "ZR")
https://github.com/zr-tex8r
|