<?xml version="1.0"?>
<!-- *********************************************************************
** options.xml                                                          **
**                                                                      **
** This file is part of dvisvgm - a fast DVI to SVG converter           **
** Copyright (C) 2005-2025 Martin Gieseking <martin.gieseking@uos.de>   **
**                                                                      **
** This program is free software; you can redistribute it and/or        **
** modify it under the terms of the GNU General Public License as       **
** published by the Free Software Foundation; either version 3 of       **
** the License, or (at your option) any later version.                  **
**                                                                      **
** This program is distributed in the hope that it will be useful, but  **
** WITHOUT ANY WARRANTY; without even the implied warranty of           **
** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the         **
** GNU General Public License for more details.                         **
**                                                                      **
** You should have received a copy of the GNU General Public License    **
** along with this program; if not, see <http://www.gnu.org/licenses/>. **
***********************************************************************-->
<!DOCTYPE cmdline SYSTEM "options.dtd">

<cmdline class="CommandLine">
  <program>
    <usage>[options] dvifile</usage>
    <usage>--eps [options] epsfile</usage>
    <usage>--pdf [options] pdffile</usage>
    <description>This program converts DVI files, as created by TeX/LaTeX, as well as\nEPS and PDF files to the XML-based scalable vector graphics format SVG.</description>
    <copyright>Copyright (C) 2005-2025 Martin Gieseking &lt;martin.gieseking@uos.de></copyright>
  </program>
  <options>
    <section title="Input options">
      <option long="page" short="p">
        <arg type="string" name="ranges" default="1"/>
        <description>choose page(s) to convert</description>
      </option>
      <option long="fontmap" short="m">
        <arg type="string" name="filenames"/>
        <description>evaluate (additional) font map files</description>
      </option>
      <option long="eps" short="E" if="!defined(DISABLE_GS)">
        <description>convert EPS file to SVG</description>
      </option>
      <option long="pdf" short="P" if="!defined(DISABLE_GS)">
        <description>convert PDF file to SVG</description>
      </option>
      <option long="stdin">
        <description>read input file from stdin</description>
      </option>
    </section>
    <section title="SVG output options">
      <option long="bbox" short="b">
        <arg type="string" name="size" default="min"/>
        <description>set size of bounding box</description>
      </option>
      <option long="bitmap-format" short="B" if="!defined(DISABLE_GS)">
        <arg type="string" name="fmt" default="jpeg"/>
        <description>set format used to embed PS/EPS bitmaps</description>
      </option>
      <option long="clipjoin" short="j" if="!defined(DISABLE_GS)">
        <description>compute intersection of clipping paths</description>
      </option>
      <option long="colornames">
        <description>prefer color names to RGB values if possible</description>
      </option>
      <option long="comments">
        <description>add comments with additional information</description>
      </option>
      <option long="currentcolor">
        <arg type="string" name="color" default="#000" optional="yes"/>
        <description>replace given color with 'currentColor'</description>
      </option>
      <option long="embed-bitmaps">
        <description>prevent references to external bitmap files</description>
      </option>
      <option long="font-format" short="f" if="!defined(DISABLE_WOFF)">
        <arg type="string" name="format" default="svg"/>
        <description>set file format of embedded fonts</description>
      </option>
      <option long="grad-overlap" if="!defined(DISABLE_GS)">
        <description>create overlapping color gradient segments</description>
      </option>
      <option long="grad-segments" if="!defined(DISABLE_GS)">
        <arg type="int" name="number" default="20"/>
        <description>number of color gradient segments per row</description>
      </option>
      <option long="grad-simplify" if="!defined(DISABLE_GS)">
        <arg type="double" name="delta" default="0.05"/>
        <description>reduce level of detail for small segments</description>
      </option>
      <option long="linkmark" short="L">
        <arg type="string" name="style" default="box"/>
        <description>select how to mark hyperlinked areas</description>
      </option>
      <option long="optimize" short="O">
        <arg name="modules" type="string" default="all" optional="yes"/>
        <description>perform several SVG optimizations</description>
      </option>
      <option long="output" short="o">
        <arg type="string" name="pattern"/>
        <description>set name pattern of output files</description>
      </option>
      <option long="precision" short="d">
        <arg type="int" name="number" default="0"/>
        <description>set number of decimal points (0-6)</description>
      </option>
      <option long="relative" short="R">
        <description>create relative path commands</description>
      </option>
      <option long="stdout" short="s">
        <description>write SVG output to stdout</description>
      </option>
      <option long="tmpdir">
        <arg type="string" name="path" optional="yes"/>
        <description>set/print the directory for temporary files</description>
      </option>
      <option long="no-fonts" short="n">
        <arg type="int" name="variant" default="0" optional="yes"/>
        <description>draw glyphs by using path elements</description>
      </option>
      <option long="no-merge">
        <description>don't merge adjacent text elements</description>
      </option>
      <option long="no-styles">
        <description>don't use CSS styles to reference fonts</description>
      </option>
      <option long="zip" short="z">
        <arg type="int" name="level" default="9" optional="yes"/>
        <description>create compressed .svgz file</description>
      </option>
    </section>
    <section title="SVG transformations">
      <option long="rotate" short="r">
        <arg type="double" name="angle"/>
        <description>rotate page content clockwise</description>
      </option>
      <option long="scale" short="c">
        <arg type="string" name="sx[,sy]"/>
        <description>scale page content</description>
      </option>
      <option long="translate" short="t">
        <arg type="string" name="tx[,ty]"/>
        <description>shift page content</description>
      </option>
      <option long="transform" short="T">
        <arg type="string" name="commands"/>
        <description>transform page content</description>
      </option>
      <option long="zoom" short="Z">
        <arg type="double" name="factor" default="1.0"/>
        <description>zoom page content</description>
      </option>
    </section>
    <section title="Processing options">
      <option long="cache" short="C">
        <arg type="string" name="dir" optional="yes"/>
        <description>set/print path of cache directory</description>
      </option>
      <option long="debug-glyphs" if="defined(TTFDEBUG)">
        <description>create PS files for all glyphs converted to TTF</description>
      </option>
      <option long="exact-bbox" short="e">
        <description>compute exact glyph bounding boxes</description>
      </option>
      <option long="keep">
        <description>keep temporary files</description>
      </option>
      <option long="libgs" if="!defined(HAVE_LIBGS) &amp;&amp; !defined(DISABLE_GS)">
        <arg name="filename" type="string"/>
        <description>set name of Ghostscript shared library</description>
      </option>
      <option long="mag" short="M">
        <arg type="double" name="factor" default="4"/>
        <description>magnification of Metafont output</description>
      </option>
      <option long="no-mktexmf">
        <description>don't try to create missing fonts</description>
      </option>
      <option long="no-specials" short="S">
        <arg type="string" name="prefixes" optional="yes"/>
        <description>don't process [selected] specials</description>
      </option>
      <option long="page-hashes" short="H">
        <arg type="string" name="params" optional="yes" default="xxh64"/>
        <description>activate usage of page hashes</description>
      </option>
      <option long="trace-all" short="a">
        <arg name="retrace" type="bool" optional="yes" default="false"/>
        <description>trace all glyphs of bitmap fonts</description>
      </option>
    </section>
    <section title="Message options">
      <option long="color">
        <description>colorize messages</description>
      </option>
      <option long="help" short="h">
        <arg name="mode" type="int" optional="yes" default="0"/>
        <description>print this summary of options and exit</description>
      </option>
      <option long="list-specials" short="l">
        <description>print supported special sets and exit</description>
      </option>
      <option long="message">
        <arg name="text" type="string"/>
        <description>print message text after writing an SVG file</description>
      </option>
      <option long="progress">
        <arg name="delay" type="double" optional="yes" default="0.5"/>
        <description>enable progress indicator</description>
      </option>
      <option long="verbosity" short="v">
        <arg type="unsigned" name="level" default="15"/>
        <description>set verbosity level (0-15)</description>
      </option>
      <option long="version" short="V">
        <arg type="bool" name="extended" optional="yes" default="false"/>
        <description>print version and exit</description>
      </option>
    </section>
  </options>
</cmdline>
