Section:

Command-Line Summary for PDF2SVG

sh

1Usage: pdf2svg [<options>] file...
2
3OPTIONS:
4
5 --file... arg A list of folders and/or file names to
6 process.
7
8 -o [ --output ] arg The output folder used to store modified
9 files. By default, the current working
10 folder will be used to store converted
11 files.
12
13 --subfolders Process all subfolders.
14
15 --prefix arg The prefix for the output image file.
16 The output filename will be constructed
17 by concatenating the prefix string, the
18 page number,and the appropriate
19 extension (e.g. myfile_01.svg,
20 myfile_02.svg, etc).The prefix option
21 should be used only for conversion of
22 individual documents. By default, each
23 input filename will be used as a prefix.
24
25 --digits arg The number of digits used in the page
26 counter portion of the output filename.
27
28 --omit_dtd Removes the DTD declaration at the top
29 of SVG file.
30
31 -a [ --pages ] arg (=-) Specifies the list of pages to convert.
32 By default, all pages are converted.
33
34 --svgz Compress output SVG files using SVGZ. By
35 default, generated SVG output is not
36 compressed.
37
38 -i [ --embedimages ] Embeds all images. By default, all
39 images are saved as external files.
40
41 -f [ --embedfonts ] Write the fonts needed by an SVG file
42 directly into the SVG file itself. By
43 default, fonts are written into separate
44 files that are shared by the SVG page
45 files.
46
47 --nofonts Disables conversion of font data to SVG.
48 By default, all available fonts are
49 converted to SVG.
50
51 --nounicode Disables mapping of text to public
52 Unicode region. Instead text will be
53 converted using a custom encoding. By
54 default, all text is mapped to Unicode.
55
56 --noglyphhex Removes hex escape strings for the
57 unicode attribute of glyph. This is
58 useful when using the --nounicode option
59 and the resulting SVG will be displayed
60 in a web browser as it prevents
61 mismapping of charcodes to glyphs. This
62 option is only applied when fonts are
63 embeded.
64
65 --preserve_fontnames Use the font/font-family naming scheme
66 as obtained from the source file.
67
68 --svgfonts Use SVG fonts instead of Opentype fonts.
69
70 --flatten arg (=fast) Used to reduce some PDF content to a
71 simple background image. While
72 flattening tries to preserve vector
73 text, some text might be flattened,
74 especially in simple mode.
75 off, disable flattening.
76 fast, will convert content deemed
77 complex to a background image, while
78 trying to preserve vector text, and
79 keeping file size down.
80 simple, reduces the PDF to two layers;
81 a RGB background image layer and an
82 overlapping vector text layer.
83 By default, fast is used for conversion.
84
85 --flatten_threshold arg (=default) For conversions that use --flatten
86 [simple|fast]. Used to control how
87 precise or relaxed text flattening is.
88 Some text can be preserved (not
89 flattened to image) at the expense that
90 the output might not be exactly the same
91 as the input.
92 very_strict, render (flatten) any text
93 that is clipped or occluded.
94 strict, render text that are
95 marginally clipped or occluded.
96 default, render text that are somewhat
97 clipped or occluded.
98 keep_most, only render text that are
99 seriously clipped or occluded.
100 keep_all, only render text that are
101 completely occluded, or used as a
102 clipping path.
103
104 -d [ --flatten_dpi ] arg (=140) For conversions to .xps, .xod, .html or
105 .epub only. The output resolution, from
106 1 to 1000, in Dots Per Inch (DPI) at
107 which to render elements which cannot be
108 directly converted. The higher the DPI,
109 the larger the image.
110
111 --flatten_max_pixels arg (=10000000) For conversions to .xod, .pdf (with
112 flattening), .html or .epub. Specifies
113 the maximum image size in pixels.
114 -b [ --box ] arg (=crop) Specifies the page box/region to use for
115 clipping. Possible values are:
116 media
117 crop
118 trim
119 bleed
120 art
121 The default is page crop region.
122
123 -c [ --crop ] arg User definable crop box to be used as a
124 top level clip region in the output SVG.
125 By default, the clip region is identical
126 to currently selected page 'box'.
127
128 --noclip Disables page clipping. Any content
129 outside of page boundaries will be
130 visible. By default, all pages are
131 clipped.
132
133 --noannots Disables conversion of form fields and
134 annotations.
135
136 --op arg (=pdfx) Specifies if overprint simulation is
137 used. Overprint is a device dependent
138 feature and the results will vary
139 depending on the output color space and
140 supported colorants (i.e. CMYK,
141 CMYK+spot, RGB, etc). Possible values
142 are:
143 off, overprint is turned off
144 on, overprint is turned on
145 pdfx, overprint is turned on only for
146 PDF/X files
147 By default, pdfx is used.
148
149 --noxmldoc Disables generation of the XML wrapper
150 document.
151
152 --thumbsize arg (=400) The maximum dimension of thumbnail image
153 in pixels. Default is 400.
154
155 --squarethumbs Generates square thumbs, whose
156 dimensions are <thumbsize> x
157 <thumbsize>.
158
159 --nothumbs Disables generation of thumbnail images.
160
161 --individual_char_placement Some viewers do not support the default
162 text positioning correctly. This option
163 works around this issue to place text
164 correctly, but produces verbose output.
165 This option will override
166 --remove_char_placement.
167
168 --remove_char_placement Disable the output of character
169 positions. This will produce slightly
170 smaller output files than the default
171 setting, but many viewers do not support
172 the output correctly.
173
174 --config arg Load xml file to configure font
175 substitution for missing fonts. By
176 default, tries to load the file
177 "config.xml" in the current working
178 directory.
179
180 --noprompt Disables any user input. By default, the
181 application will ask for a valid
182 password if the password is incorrect.
183
184 -p [ --pass ] arg The password for secured PDF files. Not
185 required if the input document is not
186 secured using the 'open' password.
187
188 --extension arg (=.pdf) The default file extension used to
189 process PDF documents. The default
190 extension is ".pdf".
191
192 --verb arg (=1) Set the opt.m_verbosity level to 'arg'
193 (0-2).
194
195 -v [ --version ] Print the version information.
196
197 -h [ --help ] Print a listing of available options.
198
199
200
201Examples:
202 pdf2svg -o test_out/ex1 "Apryse PDF2SVG User Manual.pdf"
203 pdf2svg -o test_out/ex2 --svgz --nothumbs --noxmldoc -i .
204 pdf2svg -o test_out/ex3 -p mypass secret.pdf
205 pdf2svg -o test_out/ex4 --verb 3 --digits 6 -i --pages odd --svgz --noclip box .
206 pdf2svg -o test_out/ex5 --verb 3 --embedimages --pages 1 --svgz --box media .

Did you find this helpful?

Trial setup questions?

Ask experts on Discord

Need other help?

Contact Support

Pricing or product questions?

Contact Sales