Some test text!

Discord Logo

Chat with us

PDFTron is now Apryse, learn more here.

Cli / Guides / Options



PDFTron is now Apryse, learn more here.

Command-Line Summary for PDF2SVG

Usage: pdf2svg [<options>] file...


  --file... arg                        A list of folders and/or file names to

  -o [ --output ] arg                  The output folder used to store modified
                                       files. By default, the current working
                                       folder will be used to store converted

  --subfolders                         Process all subfolders.

  --prefix arg                         The prefix for the output image file.
                                       The output filename will be constructed
                                       by concatenating the prefix string, the
                                       page number,and the appropriate
                                       extension (e.g. myfile_01.svg,
                                       myfile_02.svg, etc).The prefix option
                                       should be used only for conversion of
                                       individual documents. By default, each
                                       input filename will be used as a prefix.

  --digits arg                         The number of digits used in the page
                                       counter portion of the output filename.

  --omit_dtd                           Removes the DTD declaration at the top
                                       of SVG file.

  -a [ --pages ] arg (=-)              Specifies the list of pages to convert.
                                       By default, all pages are converted.

  --svgz                               Compress output SVG files using SVGZ. By
                                       default, generated SVG output is not

  -i [ --embedimages ]                 Embeds all images. By default, all
                                       images are saved as external files.

  -f [ --embedfonts ]                  Write the fonts needed by an SVG file
                                       directly into the SVG file itself. By
                                       default, fonts are written into separate
                                       files that are shared by the SVG page

  --nofonts                            Disables conversion of font data to SVG.
                                       By default, all available fonts are
                                       converted to SVG.

  --nounicode                          Disables mapping of text to public
                                       Unicode region. Instead text will be
                                       converted using a custom encoding. By
                                       default, all text is mapped to Unicode.

  --noglyphhex                         Removes hex escape strings for the
                                       unicode attribute of glyph. This is
                                       useful when using the --nounicode option
                                       and the resulting SVG will be displayed
                                       in a web browser as it prevents
                                       mismapping of charcodes to glyphs. This
                                       option is only applied when fonts are

  --preserve_fontnames                 Use the font/font-family naming scheme
                                       as obtained from the source file.

  --svgfonts                           Use SVG fonts instead of Opentype fonts.

  --flatten arg (=fast)                Used to reduce some PDF content to a
                                       simple background image. While
                                       flattening tries to preserve vector
                                       text, some text might be flattened,
                                       especially in simple mode.
                                         off, disable flattening.
                                         fast, will convert content deemed
                                        complex to a background image, while
                                        trying to preserve vector text, and
                                        keeping file size down.
                                         simple, reduces the PDF to two layers;
                                        a RGB background image layer and an
                                        overlapping vector text layer.
                                       By default, fast is used for conversion.

  --flatten_threshold arg (=default)   For conversions that use --flatten
                                       [simple|fast]. Used to control how
                                       precise or relaxed text flattening is.
                                       Some text can be preserved (not
                                       flattened to image) at the expense that
                                       the output might not be exactly the same
                                       as the input.
                                         very_strict, render (flatten) any text
                                        that is clipped or occluded.
                                         strict, render text that are
                                        marginally clipped or occluded.
                                         default, render text that are somewhat
                                        clipped or occluded.
                                         keep_most, only render text that are
                                        seriously clipped or occluded.
                                         keep_all, only render text that are
                                        completely occluded, or used as a
                                        clipping path.

  -d [ --flatten_dpi ] arg (=140)      For conversions to .xps, .xod, .html or
                                       .epub only. The output resolution, from
                                       1 to 1000, in Dots Per Inch (DPI) at
                                       which to render elements which cannot be
                                       directly converted. The higher the DPI,
                                       the larger the image.

  --flatten_max_pixels arg (=10000000) For conversions to .xod, .pdf (with
                                       flattening), .html or .epub. Specifies
                                       the maximum image size in pixels.
  -b [ --box ] arg (=crop)             Specifies the page box/region to use for
                                       clipping. Possible values are:
                                       The default is page crop region.

  -c [ --crop ] arg                    User definable crop box to be used as a
                                       top level clip region in the output SVG.
                                       By default, the clip region is identical
                                       to currently selected page 'box'.

  --noclip                             Disables page clipping. Any content
                                       outside of page boundaries will be
                                       visible. By default, all pages are

  --noannots                           Disables conversion of form fields and

  --op arg (=pdfx)                     Specifies if overprint simulation is
                                       used. Overprint is a device dependent
                                       feature and the results will vary
                                       depending on the output color space and
                                       supported colorants (i.e. CMYK,
                                       CMYK+spot, RGB, etc). Possible values
                                         off, overprint is turned off
                                         on, overprint is turned on
                                         pdfx, overprint is turned on only for
                                        PDF/X files
                                       By default, pdfx is used.

  --noxmldoc                           Disables generation of the XML wrapper

  --thumbsize arg (=400)               The maximum dimension of thumbnail image
                                       in pixels. Default is 400.

  --squarethumbs                       Generates square thumbs, whose
                                       dimensions are <thumbsize> x

  --nothumbs                           Disables generation of thumbnail images.

  --individual_char_placement          Some viewers do not support the default
                                       text positioning correctly.  This option
                                       works around this issue to place text
                                       correctly, but produces verbose output.
                                       This option will override

  --remove_char_placement              Disable the output of character
                                       positions.  This will produce slightly
                                       smaller output files than the default
                                       setting, but many viewers do not support
                                       the output correctly.

  --config arg                         Load xml file to configure font
                                       substitution for missing fonts. By
                                       default, tries to load the file
                                       "config.xml" in the current working

  --noprompt                           Disables any user input. By default, the
                                       application will ask for a valid
                                       password if the password is incorrect.

  -p [ --pass ] arg                    The password for secured PDF files. Not
                                       required if the input document is not
                                       secured using the 'open' password.

  --extension arg (=.pdf)              The default file extension used to
                                       process PDF documents. The default
                                       extension is ".pdf".

  --verb arg (=1)                      Set the opt.m_verbosity level to 'arg'

  -v [ --version ]                     Print the version information.

  -h [ --help ]                        Print a listing of available options.

 pdf2svg -o test_out/ex1 "Apryse PDF2SVG User Manual.pdf"
 pdf2svg -o test_out/ex2 --svgz --nothumbs --noxmldoc -i .
 pdf2svg -o test_out/ex3 -p mypass secret.pdf
 pdf2svg -o test_out/ex4 --verb 3 --digits 6 -i --pages odd --svgz --noclip box .
 pdf2svg -o test_out/ex5 --verb 3 --embedimages --pages 1 --svgz --box media .

Get the answers you need: Support