dvisvgm(1) Manual Page

Sets the bounding box of the generated graphic to the specified format. The argument fmt is argument a case-insensitive string that denotes the paper size. Following size names are supported:

Option -b, --bbox-format only affects the bounding box and doesn't transform the page content. Hence if you choose a landscape format the page won't be rotated.

Scales page content horizontally by sx and vertically by sy. This option is equivalent to -TSsx,sy.

To speed up the conversion process of bitmap fonts, dvisvgm saves intermediate conversion information in cache files. By default, these files are stored in $HOME/.dvisvgm. If you prefer a different location use option --cache to overwrite the default. Furthermore, it is also possible to disable the font caching mechanism completely with option --cache=none. The variant --cache=? prints the default cache directory and exits the program.

Prints a list of registered special handlers and exits. Each handler processes a set of special statements belonging to the same category. The categories are identified by the prefix of the special statements. It's usually a leading word separated from the rest of the statement by a colon or a blank, e.g. color or ps.

Sets the map file that is used to look up font names and encodings. dvisvgm doesn't provide its own map file but tries to use available ones coming with dvips or dvipdfm. If option -m is not given dvisvgm looks for ps2pk.map, dvipdfm.map, and psfonts.map (in this order). Without further options, the file specified by option -m will be used instead of the default maps. If you want dvisgvm to load the given file additionally to the default maps, add a leading + to the file/path, e.g. --map-file=+myfonts.map. For further information about the file format see the manuals of dvips and dvipdfm.

Sets the maginfication factor used for Metafont calls prior tracing the glyphs. The larger this value the better the tracing results. Nevertheless large magnification values can cause Metafont arithmetic errors due to number overflows. So use this option with care. The default setting usually produces nice results.

If this option is given, dvisvgm doesn't create font elements but uses paths instead. The resulting SVG file is usually bigger but concurrently more compatible with most applications that don't support SVG fonts yet. This option implies --no-styles.

Disable processing of special commands that are embedded in the DVI file. If no further parameter is given, all specials are ignored. To selectively disable sets of specials, an optional comma-separated list of names can be appended to this option. A name is a unique identifier referencing a special handler. Option --list-specials lists all currently available handlers and their names. All unsupported special statements are silently ignored.

By default, dvisvgm uses CSS styles and class attributes to reference fonts because it's more compact than repeatedly set the complete font information in each text element. However, if you prefer direct font references, the default behavior can be disabled with option --no-styles.

Suppresses the generation of missing font files. If dvisvgm can't find a font file through the kpathsea lookup mechanism, it calls the external tools mktextfm or mktexmf by default. This option disables these calls.

Sets the name of the output file.

With this option you can choose the page to be processed. Please consider that the parameter of this option denotes the actual page count and not the number printed on that page. This is because the latter can be ambiguous, i.e. different pages may have the same page number (e.g. in cases where multiple DVI files have been merged). If this option is omitted, the first page will be selected.

Rotates page content clockwise by angle degrees around the page center. This option is equivalent to -TRangle.

Don't write output to a file but redirect it to stdout.

This option forces dvisvgm not to trace just the actually needed glyphs but to trace all glyphs of the bitmap fonts used in a DVI file. Since the tracing results are stored in the font cache, all following conversions (without option --trace-all) of DVI files using these fonts will be much faster. By default, only the actually referenced glyphs are traced and added to the cache during a DVI conversion.

This option only takes affect if font caching is active. Thus, --trace-all cannot be combined with option --cache=none.

Translates (moves) page content in direction of vector (tx,ty). This option is equivalent to -TTtx,ty.

Applies a sequence of transformations to the SVG content. Each transformation is described by a command that begins with a capital letter followed by a list of comma-separated parameters. Following transformation commands are supported:

All transformation commands of option -T, --transform are applied in the order of their appearance. Multiple commands can optionally be separated by spaces. In this case the whole transformation string has to be enclosed in double quotes. All parameters are expressions of floating point type. You can either give plain numbers or arithmetic terms combined by the operators + (addition), - (substraction), * (multiplication), / (division) or % (modulo) with common associativity and precedence rules. Parentheses may be used as well. Additionally, some pre-defined constants are provided: ux horizontal position of upper left page corner in TeX point units uy vertical position of upper left page corner in TeX point units h page height in TeX point units (0 in case of -bnone) w page width in TeX point units (0 in case of -bnone) Furthermore, you can use the length constants pt, mm, cm and in, e.g. 2cm or 1.6in. Thus, option -TT1in,0R45 moves the page content 1 inch to the right and rotates it by 45 degrees around the page center afterwards. For single transformations you can also use options -c, -t and -r. Note that the order in which these options are given is not significant, i.e. you can't use them to describe transformation sequences. They are simply independent shorthand options for common transformations.

Controls the type of messages printed during a dvisvgm run:

By adding these values you can combine the categories. The default level is 7, i.e. all messages are printed.

Creates a compressed SVG file with suffix .svgz. The optional argument specifies the compression level. Valid values are in the range of 1 to 9 (default is 9). Larger values cause better compression results but take more computation time.

This option cannot be combined with -s, --stdout.

Special statement for changing the background/page color. Since SVG 1.1 doesn't support background colors, dvisvgm inserts a rectangle of the chosen color. In the current version, this rectangle always gets the size of the minimal bounding box.

Statements of this command set provide instructions to change the text/paint color. For an overview of the exact syntax, see the documentation of dvips, for instance.

dvisvgm offers its own small set of specials. The following list gives a brief overview.

These specials were introduced with the emTeX distribution by Eberhard Mattes. They provide line drawing statements, instructions for embedding MSP, PCX, and BMP image files, as well as two PCL commands. dvisvgm supports only the line drawing statements, all other em specials are silently ignored. A description of the command syntax can be found in the DVI driver documentation coming with emTeX (see CTAN).

The TPIC special set defines instructions for drawing simple geometric objects. Some LaTeX packages, like eepic and tplot, use these specials to describe graphics.