dvisvgm - 云端在线

程序：

您的姓名

dvisvgm - 将 DVI 和 EPS 文件转换为基于 XML 的 SVG 格式

概要

dvisvgm [ 选项 ] 文件 [.dvi]

dvisvgm -E [ 选项 ] 文件 [.eps]

商品描述

命令行实用程序 dvisvgm 将 TeX/LaTeX 生成的 DVI 文件转换为
基于 XML 的可缩放矢量图形格式 SVG。 它支持经典的 DVI 格式 2 作为
以及格式 3（由 pTeX 在垂直模式下创建）和格式 5，也称为
XDV（由 XeTeX 创建）。 除了基本的 DVI 命令，dvisvgm 还评估许多
所谓 特价 这极大地扩展了 DVI 格式的功能。 为了更
详细概述，请参阅部分 支持 促销 联络一位教师

由于当前的 SVG 标准 1.1 未指定多页图形，因此 dvisvgm 创建
为每个 DVI 页面创建单独的 SVG 文件。 由于兼容性的原因，只有第一个
默认情况下转换页面。 为了选择不同的页面或任意页面
序列，使用选项 -p 这在下面描述。

SVG 是一种基于矢量的图形格式，因此 dvisvgm 尝试将字形转换为
所有使用字体的轮廓到可缩放的路径描述。 最快的方法是
从 PFB、TTF 或 OTF 格式的字体文件中提取路径信息。 如果 dvisvgm 是
能够找到这样的文件，它提取有关字形的所有必要的轮廓信息
从中。

然而，TeX 的字体描述的主要来源是 Metafont，它产生位图输出
（GF 文件）。 这就是为什么并非所有可获得的 TeX 字体都以可缩放格式提供的原因。 在
在这些情况下，dvisvgm 尝试通过跟踪字形位图来矢量化 Metafont 的输出。
结果并不像大多数（手动优化的）PFB 或 OTF 对应物那样完美，但是
在大多数情况下仍然非常好。

不带选项运行 dvisvgm 时 --无字体, 字体 元素（...) 被使用
将字体数据嵌入到 SVG 文件中。 不幸的是，只有少数 SVG 渲染支持
这些元素呢。 大多数网络浏览器和矢量图形应用程序不评估它们
正确，以便生成的图形的文本组件可能看起来很奇怪。 在
为了创建更兼容的 SVG 文件，命令行选项 --无字体 可以给
用普通图形路径替换字体元素。

配置

-一种， --全部追踪=[回扫]
此选项强制 dvisvgm 不仅追踪实际需要的字形，而且追踪所有的字形
DVI 文件中使用的所有位图字体。 由于跟踪结果存储在
字体缓存，所有以下 DVI 转换（无选项 --全部追踪) 这些地方
涉及字体，会快很多。 默认情况下，dvisvgm 只跟踪实际
需要的字形，并将它们添加到缓存中。 布尔选项 回扫 确定如何
处理已经存储在缓存中的字形。 默认情况下，会跳过这些字形。
设置参数 回扫 至 含 or true 强制 dvisvgm 跟踪相应的
位图再次。

备注
此选项仅在字体缓存处于活动状态时生效。 所以， --全部追踪
不能与选项结合使用 --缓存=无.

-b, --bbox=fmt
将生成的图形的边界框设置为指定格式。 参数
fmt 采用下面列出的格式说明符之一，或四个序列
逗号或空格分隔的长度值 x1, y1, x2 和 y2. 后者定义了两个
边界框的对角。 每个长度值由一个浮点数组成
数字和可选的长度单位（pt、bp、cm、mm、in 或 pc）。 如果单位是
省略，假定 TeX 点 (pt)。

也可以只给出一个长度值 l. 在这种情况下，最小边界
通过添加 (-l,-l) 到左上角和 (l,l）来的
右下角。

或者，支持以下格式说明符：

国际 DIN / ISO 纸 尺寸
An，Bn，Cn，Dn，其中 n 是一个非负整数，例如 A4 或 a4 代表 DIN/ISO A4
格式（210 毫米 × 297 毫米）。

北 美国人 纸 尺寸
发票、行政、法律、信件、分类帐

Special 边界 框 尺寸

DVI 存储在 DVI 文件中的页面大小
分钟 计算最小/最紧
边框
没有 未分配边界框

页 取向
DIN/ISO 和美国纸张尺寸的默认页面方向是 肖像,
即 宽度 < 高度. 追加 -景观 或者干脆 -l 到格式字符串
切换到 景观 模式 （宽度 > 高度）。 出于对称原因，您还可以
明确添加 -肖像 or -p 表示默认的纵向格式。 注意
这些后缀是大小字符串的一部分，而不是单独的选项。 于是，他们
必须直接跟在尺寸说明符之后，没有额外的空格。 此外，
方向后缀不能与 DVI, 分钟及 没有.

备注
附加选项 -b, --bbox 只影响边界框，不变换
页面内容。 因此，如果您选择横向格式，页面将不会
旋转。

-C， --缓存[=DIR]
为了加快位图字体的转换过程，dvisvgm 保存了中间
缓存文件中的转换信息。 默认情况下，这些文件存储在
$HOME/.dvisvgm/缓存。 如果您更喜欢不同的位置，请使用选项 --缓存 至
覆盖默认值。 此外，还可以禁用字体缓存
机制完全与选项 --缓存=无. 如果论据 DIR 被省略，dvisvgm
打印默认缓存目录的路径以及有关的更多信息
存储的字体。 此外，会删除过时和损坏的缓存文件。

-j, --剪辑连接
这个选项告诉 dvisvgm 自己计算剪切路径的交集，如果
必要的，而不是将此任务委托给 SVG 渲染器。 生成的 SVG 文件
更便携，因为一些 SVG 渲染器不支持剪辑的交叉点
由定义的路径 剪辑路径 包含一个的元素 剪辑路径 属性。

- 颜色
启用转换过程中打印的消息的彩色化。 颜色可以
通过环境变量自定义 DVISVGM_颜色. 请参阅环境部分
了解更多信息。

-和， --每股收益
如果给出此选项，则 dvisvgm 不需要 DVI，而是需要 EPS 输入文件，并且
尝试将其转换为 SVG。 为此，单 ps文件 特殊命令是
创建并转发到 PostScript 特殊处理程序。 此选项仅可用
如果 dvisvgm 是在启用 PostScript 支持的情况下构建的，并且需要 Ghostscript
可用的。 查看选项 --libgs 了解更多信息。

-e， - 精确的
如果给出这个选项，dvisvgm 会计算每个字符的精确边界框。
默认情况下，存储在字体的 TFM 文件中的值用于确定字形的
程度。 由于这些值旨在实现最佳字符放置并且
并非旨在表示确切的尺寸，它们不一定与
视觉字形的边界。 因此，一些字形的宽度和/或高度可能是
大于（或小于）各自的 TFM 值。 结果，这可能导致
在 SVG 图形的边界处剪切字符。 带选项 - 精确的 给定，
dvisvgm 分析每个字符的实际形状并得出一个通常紧密的
边界框。

-米， --字体映射=档名
加载和评估单个或多个字体映射文件。 这些文件需要
解析字体文件名和编码。 dvisvgm 不提供自己的地图文件，但
尝试读取 dvips 或 dvipdfm 附带的可用内容。 如果选项 --字体映射 is
省略，dvisvgm 查找默认映射文件 ps2pk.地图, dvipdfm.地图及
psfonts.map （按此顺序）。 否则，将使用列出的文件。 多个文件名
必须用逗号分隔，没有前导和/或尾随空格。 地图文件
按照给定的顺序进行评估。 默认情况下，重新定义的映射不会替换
以前的。 但是，每个文件名前面都可以有一个可选的模式说明符
(+, -或 =) 来改变这种行为：

+地图文件
只有给定映射文件中没有重新定义字体映射的那些条目才是
应用。 如果没有给出模式说明符，这也是默认模式。

-地图文件
确保没有使用给定映射文件中定义的任何字体映射，
即之前为指定字体定义的映射被删除。

=地图文件
应用映射文件中定义的所有映射。 之前定义的设置
替换相同的字体。

如果文件名序列中的第一个文件名前面是模式说明符，
dvisvgm 加载默认字体映射（见上文）并应用其他映射文件
然后。 否则，不会自动加载任何默认地图文件。

例子： --fontmap=myfile1.map,+myfile2.map 负载 myfile1.map 其次是
myfile2.map 其中所有的重新定义 myfile2.map 被忽略了。
--fontmap==myfile1.map,-myfile2.map 加载默认地图文件，然后
myfile1.map 和 myfile2.map 其中所有的重新定义 myfile1.map 更换
以前的条目。 之后，给出的字体的所有定义 myfile2.map
从字体映射树中删除。

有关地图文件格式和模式说明符的更多信息，请参阅
dvips 和 dvipdfm 的手册。

--梯度重叠
告诉 dvisvgm 在近似颜色渐变时创建重叠的网格段
填充（另见选项 --grad-段 以下）。 默认情况下，相邻段不
重叠但只像单独的瓷砖一样相互接触。 不幸的是，这种对齐方式
可能会导致段之间出现明显的间隙，因为背景会影响
如果 SVG 渲染器使用抗锯齿来创建段边界处的颜色
光滑的轮廓。 避免这种情况并创建无缝触摸颜色区域的一种方法
是扩大段，使它们延伸到其右侧和底部的区域
邻居。 由于后者绘制在重叠部分的顶部，可见
所有段的大小保持不变。 只是以前的差距消失为背景
现在完全被正确的颜色覆盖。 目前，dvisvgm 计算
为网格的每个补丁单独重叠段（补丁网格可能包括
相同类型的多个补丁）。 因此，仍然可能存在明显的差距
两个相邻补丁的接缝。

--grad-段=数
确定用于近似的每列和每行的最大段数
渐变颜色填充。 由于 SVG 1.1 只支持着色的一小部分
PostScript 中可用的算法，dvisvgm 通过细分来近似其中的一些
要填充为更小的单色段的区域。 这些细分市场中的每一个
获取它所覆盖区域的平均颜色。 因此，增加数量
段导致更小的单色区域，因此导致更好的
实际颜色渐变的近似值。 作为一个缺点，更多的段意味着更大的
SVG 文件，因为每个段都由一个单独的路径元素表示。

目前，dvisvgm 支持自由和格子形式的三角形补丁网格以及
Coons 和张量积补丁网格。 它们通过细分区域来近似
每个补丁到一个 n×n 较小段的网格。 每段的最大段数
可以使用选项更改列和行 --grad-段.

--grad-简化=三角洲
如果为近似渐变颜色填充而创建的段的大小低于
给定的 delta 值，dvisvgm 降低了它们的细节级别。 例如，贝塞尔
曲线由直线代替，三角形段组合成
四边形。 对于一个小的增量，这些简化通常不明显，但
减小生成的 SVG 文件的大小。

-H， - 帮帮我[=模式]
打印所有可用命令行选项的简短摘要。 可选的 模式
参数是 0 到 2 之间的整数值。它选择显示变量
帮助文本。 模式 0 列出了所有选项，分为带有节标题的类别。 这个
如果不带参数调用 dvisvgm，也是默认值。 模式 1 列出所有选项
按短选项名称排序，而模式 2 按长选项对行进行排序
名称。

- 保持
禁止删除由 Metafont 创建的临时文件（通常是 .gf、.tfm 和
。日志文件）。

--libgs=文件名
此选项仅在 Ghostscript 库未直接链接到
dvisvgm 以及是否在编译期间未完全禁用 PostScript 支持。 在
在这种情况下，dvisvgm 尝试在运行时动态加载共享 GS 库。 经过
默认情况下，它期望库的名称是 libgs.so.X（在类 Unix 系统上，其中 X
是库的 ABI 版本）或 gsdll32.dll/gsdll64.dll (Windows)。 选项
--libgs 可用于赋予不同的名称。 或者，也可以设置
环境变量中的 GS 库名称 库. 后者优先级较低
比命令行选项，即 dvisvgm 忽略变量 库 if --libgs 给出。

-L, --链接标记=样式
选择如何标记超链接区域的方法。 这 样式 论点可以采取其中之一
价值 没有, 框及 线，其中 框 是默认值，即绘制一个矩形
如果选项在链接区域周围 --链接标记 被省略。 风格论证 线 只是
绘制边界矩形的下边缘，和 没有 告诉 dvisvgm 不要添加任何
超链接的可见对象。 线条和框获取当前文本颜色
被选中。 为了应用不同的、恒定的颜色，冒号后跟颜色
说明符可以附加到样式字符串。 一种 颜色 说明符 是一个
表格的十六进制 RGB 值 #RRGGBB, 或 dvips 颜色名称
(http://en.wikibooks.org/wiki/LaTeX/Colors#The_68_standard_colors_known_to_dvips)。

此外，论证 样式 可以使用单个颜色说明符来突出显示链接
区域由填充该颜色的无框框组成。 可选的第二颜色说明符
用冒号分隔选择框架颜色。

例子： 盒子：红色 or 框：#ff0000 在链接区域周围绘制红色框。 黄色：蓝色
创建带有蓝色框架的黄色填充矩形。

-l, --list-特价
打印已注册的特殊处理程序列表并退出。 每个处理程序处理一组
属于同一类别的特殊语句。 在大多数情况下，类别
由特殊语句的前缀标识。 它通常是一个引导词
用冒号或空格与语句的其余部分分开，例如 颜色 or ps.

-M, --mag=因素
设置在跟踪前与 Metafont 调用结合应用的放大系数
字形。 该值越大，跟踪结果越好。 尽管如此，大
由于数字溢出，放大率值可能会导致 Metafont 算术错误。 所以，
请谨慎使用此选项。 默认设置通常会产生不错的结果。

--不合并
将每个单独的字符放在一个单独的 文本 元素对应 x 和 y
属性。 默认情况下，新 文本 or 跨度 仅当字符串开始时才创建元素
在与字符定义的常规位置不同的位置
提前值。

--no-mktexmf
禁止生成丢失的字体文件。 如果 dvisvgm 找不到字体文件
通过kpathsea查找机制，调用外部工具mktextfm或mktexmf
经过。 此选项禁用这些调用。

-n, --无字体[=变种]
如果给出此选项，则 dvisvgm 不会创建 SVG 字体 元素但使用 路径
反而。 生成的 SVG 文件往往更大，但同时也更多
与大多数尚不支持 SVG 字体的应用程序兼容。 可选的
论点 变种 选择如何通过路径替换字体的方法。 变体 0
创建 径 和 使用 元素。 变体 1 创建 径 仅元素。 选项 --无字体
暗示 --无样式.

-C， - 规模=sx[,sy]
水平缩放页面内容 sx 和垂直通过 sy. 这个选项是
相当于 -TSsx,sy.

-S， --无特价[=名称]
禁用对嵌入在 DVI 文件中的特殊命令的处理。 如果没有进一步
给定参数，所有特殊情况都将被忽略。 要有选择地禁用特价集，
一个可选的以逗号分隔的名称列表可以附加到此选项。 一种 姓名 is
引用预期特殊处理程序的唯一标识符。 选项 --list-特价
列出所有当前可用的处理程序及其名称。 所有不支持的特殊
语句被默默地忽略。

--无样式
默认情况下，dvisvgm 创建 CSS 样式和类属性来引用字体，因为
它比在每个文本中重复设置完整的字体信息更紧凑
元素。 但是，如果您更喜欢直接字体引用，则默认行为可以是
禁用选项 --无样式.

-o， - 输出=模式
设置输出文件的名称模式。 范围 模式 是一个字符串，可以
包含变量 %f, %p及 %P. %f 扩展为 DVI 文件的基本名称，
即没有后缀的文件名， %p 是当前页码，并且 %P 总数
DVI 文件中的页数。 百分号后给出的可选数字 (0-9)
指定要写入的最小位数。 如果一个特定的值是
更短，数字用前导零填充。 例子： %3p 强制使用 3 位数字
当前页码（001、002 等）。 没有明确的宽度说明符， %p 得到
相同的位数 %P.

如果您需要对编号进行更多控制，可以使用算术表达式作为
图案的一部分。 语法是 %(表达式) 哪里 表达式 可能包含添加，
具有共同优先级的减法、乘法和整数除法。 这
变量 p 和 P 包含当前页码和总页数，
分别。 例如， --output="%f-%(p-1)" 创建文件名，其中编号
从 0 而不是 1 开始。

默认模式是 %f-%p.svg 如果 DVI 文件包含多于一页，并且
%f.svg 除此以外。 这意味着，一个 DVI 文件 foo.dvi文件 被转换为 foo.svg if foo.dvi文件 is
单页文档。 否则，多个 SVG 文件 foo-01.svg, foo-02.svg等是
产生。 在 Windows 环境中，百分号表示取消引用的环境
变量，因此必须由第二个百分号保护，例如
--输出=%%f-%%p.

-p, - 页=范围
此选项设置要处理的页面。 范围 范围 由一个
单页码和/或页面范围的逗号分隔列表。 一个页面范围是一对
由连字符分隔的数字，例如 5-12。 因此，页面序列可能看起来像
这：2-4,6,9-12,15。 如果一个页面被多次提供或者页面是否被提供都没有关系
范围重叠。 dvisvgm 总是按升序提取页码，并且
只转换一次。 为了与以前的版本保持兼容，
默认页面序列是 1。因此 dvisvgm 只转换第一页而不是
整个文件以防万一 - 页 被省略。 通常，页面范围包括两个
表示要转换的第一页和最后一页的数字。 如果要转换
从第 1 页开始，或者如果它应该继续到最后一个 DVI 页，则第一个或
第二个范围号可以分别省略。 例子： --页面=-10 全部转换
页到第 10 页， --页面=10- 转换从第 10 页开始的所有页面。请
考虑到页面值不是指打印在页面上的页码。
相反，物理页数是预期的，其中第一页总是得到编号
1.

-d, - 精确=数字
指定应用于浮点属性的最大小数位数
值。 写入生成的 SVG 文件的所有属性值都被四舍五入
因此。 参数 数字 允许从 0 到 6 的整数值，其中 0 启用
自动选择有效小数位。 这也是默认值
如果不带选项调用 dvisvgm - 精确.

-P, - 进展[=延迟]
启用在耗时操作时显示的简单进度指示器，例如
处理 PostScript 特价商品。 在给定的延迟之前指示器没有出现
（以秒为单位）已经过去。 默认延迟值为 0.5 秒。

-r, --旋转=角度
将页面内容顺时针旋转 角度 围绕页面中心的度数。 这个
选项相当于 -TR角度.

-R, - 相对的
SVG 允许通过绝对和/或相对序列定义图形路径
命令，即每个命令都需要绝对坐标或坐标
相对于当前绘图位置。 默认情况下，dvisvgm 创建的路径由
绝对命令。 如果选项 - 相对的 给出，创建相关命令
相反，这在大多数情况下会略微减小 SVG 文件的大小。

-是的， --标准输出
不要将 SVG 输出写入文件，而是将其重定向到 标准输出.

-T, - 转变=命令
对 SVG 内容应用一系列转换。 每一次变换都是
由一个描述 命令 以大写字母开头，后跟一个列表
逗号分隔的参数。 支持以下转换命令：

T tx[,ty]
沿矢量方向平移（移动）页面 (tx,ty）。 如果 ty 省略， ty=0
假设。 预期单位长度 tx 和 ty 是 TeX 点 (1pt =
1/72.27 英寸）。 但是，定义了几个常数来简化单位
转换（见下文）。

S sx[,sy]
将页面水平缩放 sx 和垂直通过 sy。 如果 sy 省略， sy=sx
假设。

R 角度[,x,y]
将页面顺时针旋转 角度 点周围的度数 (x,y）。 如果可选
参数 x 和 y 省略，页面将围绕其中心旋转
取决于所选的页面格式。 When option -bnone 给定，旋转
中心是原点 (0,0)。

KX 角度
沿页面倾斜 x-轴由 角度 度。 争论 角度 可以拿任何
除 90+180 外的值k，其中 k 是一个整数。

KY 角度
沿页面倾斜 y-轴由 角度 度。 争论 角度 可以拿任何
除 90+180 外的值k，其中 k 是一个整数。

FH [y]
在通过点 (0,y）。 省略
可选参数导致 y=h/2，哪里 h 表示页面高度（见 预定义的
常数 下文）。

FV [x]
在垂直线通过点 (x,0)。 省略
可选参数导致 x=w/2，哪里 w 表示页面宽度（见 预定义的
常数 下文）。

M m1，...，m6
应用由 3×3 矩阵描述的变换
((m1,m2,m3），（m4,m5,m6),(0,0,1))，其中内部三元组表示行。

备注
选项的所有转换命令 -T, - 转变 按顺序应用
他们的外表。 多个命令可以选择用空格分隔。
在这种情况下，整个转换字符串必须用 double 括起来
引号。 所有参数都是浮点类型的表达式。 你可以
给出由运算符组合的普通数字或算术项 + （添加），
- （减法）， * （乘法）， / （部门）或 % （模）与公共
关联性和优先级规则。 也可以使用括号。

此外，还提供了一些预定义的常量：

ux 上部水平位置
在 TeX 点的左页角
单位
uy 左上角的垂直位置
以 TeX 点为单位的页面角
h 以 TeX 点为单位的页面高度
（0 的情况下 -bnone)
w 以 TeX 点为单位的页面宽度 (0
在壳体的 -bnone)

此外，您可以使用长度常量 pt, mm, cm 和 in，例如 2cm or
1.6in. 因此，选项 -TT1in，0R45 将页面内容向右移动 1 英寸，然后
之后将其围绕页面中心旋转 45 度。

对于单个转换，您还可以使用选项 -c, -t 和 -r。 注意
给出这些选项的顺序并不重要，即你不能
用它们来描述变换序列。 他们只是独立
常见转换的速记选项。

-t, - 翻译=tx[,ty]
沿矢量方向平移（移动）页面内容 (tx,ty）。 这个选项是
相当于 -TTtx,ty.

-v， --冗长=水平
控制 dvisvgm 运行期间打印的消息类型：

0 没有消息输出
1 仅错误消息
2 仅警告消息
4 仅供参考

备注
通过添加这些值，您可以组合类别。 默认级别为 7，
即打印所有消息。

-V, - 版[=扩展]
打印 dvisvgm 的版本并退出。 如果可选参数设置为 含是，
链接库的版本号也被打印出来。

-z - 压缩[=水平]
创建后缀为 .svgz 的压缩 SVG 文件。 可选参数指定
压缩级别。 有效值在 1 到 9 的范围内（默认值为 9）。
较大的值会导致更好的压缩结果，但需要更多的计算时间。

注意：
此选项不能与 -是的， --标准输出.

-Z - 飞涨[=因素]
乘以 宽度 和 高度 按参数的 SVG 根元素的属性 因素
同时保留图形的坐标系。 因此，大多数 SVG 查看器
相应地缩放图形。 如果给定负缩放系数，则 宽度 和
高度 属性被省略。

支持的 特价商品

dvisvgm 支持多组 特别 命令 可用于丰富 DVI 文件
具有附加功能，如颜色、图形和超链接。 专项评价
命令被委托给专门的处理程序。 每个处理程序负责所有特殊
相同命令集的语句，即以相同前缀开头的命令。 得到一个
实际提供的特殊处理程序列表，使用选项 --list-特价 （看上面）。 这个
部分概述了当前支持的特殊命令。

BGCOLOR
更改背景/页面颜色的特殊声明。 由于 SVG 1.1 没有
支持背景颜色，dvisvgm 将所选颜色的矩形插入到
生成的 SVG 文档。 此矩形的大小始终与选定的或
计算边界框。 此背景颜色命令是颜色特殊集的一部分
而是分开处理以便让用户将其关闭。 概述
命令语法，例如参见 dvips 的文档。

颜色
此命令集的语句提供更改文本/油漆颜色的说明。
例如，有关确切语法的概述，请参阅 dvips 的文档。

dvisvgm
dvisvgm 提供自己的一小部分特价商品。 下面的列表给出了一个简短的
概述。

dvisvgm:原始 文本
将任意字符序列添加到 SVG 文档的页面部分。
dvisvgm 不在这里执行任何验证，因此用户必须确保
生成的 SVG 仍然有效。 范围 文本 可能包含表达式 {？X},
{?y}及 {？颜色} 扩展到当前 x or y 坐标和当前
颜色，分别。 此外， {?nl} 扩展为换行符。

dvisvgm:rawdef 文本
这个命令类似于 dvisvgm:原始，但将原始文本放入
当前正在生成的 SVG 文档的部分。

dvisvgm：原始集 姓名 ... dvisvgm:endrawset
这对特殊符号标记了命名原始 SVG 定义的开始和结束
分段。 全部 dvisvgm:原始 和 dvisvgm:rawdef 附上特价 dvisvgm：原始集
和 dvisvgm:endrawset 不会立即评估，而是共同存储在
特定 姓名 供以后使用。 一旦定义，命名的片段就可以被引用
整个 DVI 文件由 dvisvgm：原始输入 （见下文）。 两个命令
dvisvgm：原始集 和 dvisvgm:endrawset 不得嵌套，即每次调用
dvisvgm：原始集 必须跟随相应的调用 dvisvgm:endrawset
在另一个之前 dvisvgm：原始集 可能导致。 此外，标识符 姓名 必须是唯一的
整个 DVI 文件。 使用 dvisvgm：原始集 多次与
同 姓名 导致警告消息。

dvisvgm：原始输入 姓名
插入先前存储在给定下的原始 SVG 片段 姓名。 dvisvgm
区分指定的片段 dvisvgm:原始 or
dvisvgm:rawdef，并以不同的方式处理它们：它插入所有 dvisvgm:原始 部分
每当 dvisvgm：原始输入 被称为，而 dvisvgm:rawdef 部分去
当前 SVG 文档的部分仅一次。

dvisvgm：img 宽度 高度 文件
在参考给定的当前图形位置创建一个图像元素
文件。 可以在此处使用 JPEG、PNG 和 SVG 图像。 但是，dvisvgm 不检查
文件格式或文件名后缀。 长度 宽度 和 高度 必须
以 TeX 点单位（1in = 72.27pt）作为普通浮点数给出。

dvisvgm:bbox 新的] 姓名
定义或重置名为的本地边界框 姓名. 名称可能包括
字母和数字。 在处理 DVI 页面时，dvisvgm 不断更新
（全局）当前页面的边界框以确定最小的
包含所有可见页面组件（字符、图像、绘图
元素等）除了全局边界框之外，用户还可以请求一个
任意数量的命名局部边界框。 一旦定义，这些框是
与从第一个字符开始的全局边界框一起更新
遵循定义。 因此，本地框可用于计算
页面部分的范围。 这对于生成 SVG 的场景很有用
文件进行后处理。 结合特殊的 dvisvgm:raw，宏 {?bbox
姓名} 扩展到四个值 x, y, w及 h （以空格分隔）指定
局部框的左上角坐标、宽度和高度 姓名.
如果框 姓名 之前未定义，所有四个值都为零。

dvisvgm:bbox 宽度 高度 [深度]
通过嵌入虚拟矩形更新当前页面的边界框 (x,
y, 宽度, 高度) 其中左下角位于当前 DVI
绘图位置（x,y）。 如果可选参数 深度 已指定，dvisvgm
嵌入第二个矩形 (x, y, 宽度- 深度）。 长度 宽度, 高度 和
深度 必须以 TeX 点单位（1in =
72.27 磅）。 根据虚拟矩形的大小和位置，此命令
要么放大整个边界框，要么保持原样。 这是不可能的
减少其范围。 这个特殊的应该结合使用 dvisvgm:原始 in
为了正确更新页面的视口。

dvisvgm:bbox [bs] x1 y1 x2 y2
这个 bbox 特殊版本的变体通过嵌入一个虚拟的来更新边界框
长方形 （x1,y1,x2,y2）。 点（x1,y1）和（x2,y2) 表示两条对角线
以 TeX 点为单位给出的矩形的角。

dvisvgm:bbox 使固定] x1 y1 x2 y2
bbox 特殊的这个变体将一个绝对（最终）边界框分配给
生成的 SVG。 执行此命令后，dvisvgm 不会进一步更改
边界框坐标，除了这个特殊的稍后再调用。 要点
(x1,y1）和（x2,y2) 表示 TeX 中给出的矩形的两个对角线
点单位。

以下 TeX 片段向输出添加了两个原始 SVG 元素并更新了
相应的边界框：

\special{dvisvgm:raw }
\特殊{dvisvgm:bbox 20 10 10}

\special{dvisvgm:raw }
\特殊{dvisvgm:bbox abs 10 200 100 250}

em
这些特价商品是由 Eberhard Mattes 在 emTeX 发行版中引入的。 他们
提供画线语句、嵌入MSP、PCX、BMP图像的说明
文件，以及两个 PCL 命令。 dvisvgm 只支持画线语句
并默默地忽略所有其他 em 特价。 命令语法的描述可以是
可以在 emTeX 附带的 DVI 驱动程序文档中找到（请参阅 CTAN）。

HTML
hyperref 规范定义了几种关于如何标记超链接区域的变体
在 DVI 文件中。 dvisvgm 支持创建的普通 HyperTeX 特殊结构
hyperref 包选项 超文本. 默认情况下，文档的所有链接区域都是
用矩形标记。 选项 --链接标记 允许改变这种行为。 见上文
更多细节。 HyperTeX specials 的语法和语义信息可以是
在 hyperref 手册中找到。

PDF格式
pdfTeX 和 dvipdfmx 引入了几个与生成相关的特殊命令
PDF 文件。 目前，只有他们两个， pdf：地图文件 和 pdf：地图线 由...支持
dvisvgm。 这些特殊功能允许在处理 DVI 期间修改字体映射树
文件。 例如，它们被 CTeX 使用。 dvisvgm 支持 dvips 和
dvipdfm 字体映射格式。 有关命令语法和语义的更多信息，
见文档 \pdf地图文件 在 pdfTeX 用户手册中。

ps
著名的 DVI 驱动程序 dvips 推出了自己的一套特价，以便嵌入
PostScript代码转成DVI文件，大大提高了DVI的能力
文件。 dvisvgm 的一个目标是完全评估所有 PostScript 片段并
尽可能多地将它们转换为 SVG。 与 dvips 相比，dvisvgm 使用
浮点运算来计算每个图形元素的精确位置，
即它不舍入坐标。 因此，相对位置
图形元素可能与 dvips 计算的元素略有不同。

由于 PostScript 是一种相当复杂的语言，因此 dvisvgm 不会尝试实现它的
自己的 PostScript 解释器，但依赖于 Ghostscript (http://ghostscript.com）。
如果 Ghostscript 库未链接到 dvisvgm 二进制文件，则会查找它并
在运行时动态加载。 在这种情况下，dvisvgm 会查找 库文件X on
类 Unix 系统（支持的 ABI 版本：7,8,9、XNUMX、XNUMX），以及 gsdll32.dll or gsdll64.dll
在 Windows 上。 您可以使用环境变量覆盖默认文件名 库 or
命令行选项 --libgs. 该库必须可通过 ld 搜索访问
路径 (*nix) 或 PATH 环境变量 (Windows)。 或者，绝对
可以指定文件路径。 如果找不到库，dvisvgm 将禁用
处理 PostScript 特价商品并打印警告消息。 使用选项
--list-特价 检查 PostScript 支持是否可用，即入口 ps is
当下。

PostScript 处理程序还识别和评估由
此 预览 带选项的包装 紧页. 如果数据存在于 DVI 文件中，
dvisvgm 相应地调整生成的 SVG 文件的边界框，并打印一个
以 TeX 点为单位显示框的宽度、高度和深度的消息。
特别是，深度值可用于将 SVG 图形与
例如，HTML 或 XSL-FO 文档中周围文本的基线。

主题图片
TPIC 特殊集定义了绘制简单几何对象的指令。 一些
LaTeX 包，如 eepic 和 tplot，使用这些特性来描述图形。

示例

dvisvgm 文件

转换第一页 文件.dvi 至 文件.svg.

dvisvgm -z 文件

转换第一页 文件.dvi 至 文件.svgz 默认压缩级别为 9。

dvisvgm -p5 -z3 -ba4-l -onewfile 文件

转换第五页 文件.dvi 至 新文件.svgz 压缩级别为 3。边界
框设置为横向格式的 DIN/ISO A4。

dvisvgm --transform="R20,w/3,2h/5 T1cm,1cm S2,3" 文件

转换第一页 文件.dvi 至 文件.svg 其中应用了三个转换。

环境

dvisvgm 使用 凯帕西 用于定位它打开的文件的库。 因此，
库文档中描述的环境变量会影响转换器。

如果 dvisvgm 在没有 Ghostscript 库的情况下链接，并且 PostScript 支持没有
被禁用，共享的 Ghostscript 库在运行时通过 dlopen() 查找。
环境变量 库 可用于指定库的路径和文件名。

dvisvgm 的预编译 Windows 版本需要 MiKTeX 2.9 的工作安装
或以上。 dvisvgm 不能与 MiKTeX 的便携版一起使用，因为它
依赖 MiKTeX 的 COM 接口，只能在本地安装中访问。 要启用
PostScript特价评测，原版Ghostscript DLL gsdll32.dll 必须
存在并可通过搜索路径访问。 64 位 Windows 版本需要 64 位
鬼脚本DLL gsdll64.dll. 两个 DLL 都带有相应的 Ghostscript 安装程序
可从 www.ghostscript.com 获得。

环境变量 DVISVGM_颜色 指定用于突出显示各种颜色的颜色
dvisvgm 消息输出的一部分。 它仅在选项时评估 - 颜色 给出。 这
价值 DVISVGM_颜色 是形式的冒号分隔条目列表 gg=BF，其中 gg
表示下面列出的颜色组指标之一，并且 BF 是两个十六进制数字
指定背景（第一位）和前景色/文本颜色（第二位）。 这
颜色值定义如下：0=黑色，1=红色，2=绿色，3=黄色，4=蓝色，5=洋红色，
6=青色，7=灰色，8=亮红色，9=亮绿色，A=亮黄色，B=亮蓝色，C=亮
品红色，D=亮青色，E=亮灰色，F=白色。 根据终端，颜色可能
不同。 除了更改文本和背景颜色之外，还可以
只更改其中一个：星号 (*) 代替十六进制数字表示
终端的默认文本或背景颜色。

列表中所有格式错误的条目都将被静默忽略。

er 错误消息

wn 警告信息

pn 关于页码的消息

ps 页面大小消息

fw 有关文件的信息
书面

sm 状态信息

tr 字形跟踪器的消息

pi 进度指示器

示例： 呃=01:pi=*5 设置错误消息的颜色（er) 到红色 (1) 黑色 (0），
进度指标（pi) 到青色 (5) 在默认背景 (*).

使用 onworks.net 服务在线使用 dvisvgm