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
|
BXdvidriver Package
===================
LaTeX: To specify a driver option effective only in DVI output
This single-function package enables authors to specify a global
driver option (dvips, dvipdfmx, etc) which is applied only when the
engine outputs a DVI file. It is useful to create special document-
templates that can be compiled in both PDF-mode and DVI-mode.
### System requirement
* TeX format: LaTeX.
* TeX engine: Anything.
* Dependent packages:
- ifpdf, ifluatex, ifxetex, ifvtex
- pdftexcmds
### Installation
- `*.sty` → $TEXMF/tex/latex/BXdvidriver
### License
This package is distributed under the MIT License.
The bxdvidriver Package
-----------------------
### Package Loading
\usepackage[<option>,...]{bxdvidriver}
The available options are described hereafter.
#### Driver options
The following driver options are available:
dvips,xdvi,dvipdf,dvipdfm,dvipdfmx,dvipsone
dviwindo,oztex,textures,pctexps,pctex32
Suppose the document begins with:
\documentclass[a4paper]{article}
\usepackage[dvipdfmx]{bxdvidriver}
\usepackage{graphicx,color}
If the document is compiled with pdflatex (or xelatex, lualatex), then
the package does nothing and the driver option `dvipdfmx` is simply
ignored.
However, if the document is compiled with latex (or any other engine
that outputs DVI files), then the package adds the given driver option
`dvipdfmx` to the global option list, and makes the settings effectively
the same as the following:
\documentclass[a4paper,dvipdfmx]{article}
\usepackage{graphicx,color}
The driver option is globally in effect, and thus the packages graphicx
and color will choose the driver for dvipdfmx.
*Note.* Some care must be taken when the document class itself has some
driver-dependent behavior. In that case, simply loading bxdvidriver
after `\documentclass` would leave its driver option unapplied to the
document class. Instead, you must load the bxdvidriver package *before*
`\documentclass` with `\RequirePackage` command.
\RequirePackage[dvipdfmx]{bxdvidriver}
\documentclass[a4paper]{some-fancy-class}
\usepackage{graphicx,color}
#### Other options
This package is essentially single-function, but as side effect it also
checks some integrity on driver settings:
* whether (at most) one driver option is given;
* whether the driver matches the (PDF-output) engine;
* whether (at most) one graphics driver is loaded.
By default, an error is issued when any check fails. But the behavior
can be changed by options.
* `check` (default): Check failure issues an error.
* `nocheck`: Check failure does not issue an error.
### Usage
This package offers no user commands or environments. All the settings
are done by package options.
Revision History
----------------
* Version 0.2a ‹2017/02/13›
- Bug fix.
* Version 0.2 ‹2016/03/26›
- The first public version.
--------------------
Takayuki YATO (aka. "ZR")
https://github.com/zr-tex8r
|
