1rsvg-convert(1) General Commands Manual rsvg-convert(1)
2
6 rsvg-convert - turn SVG files into raster images.
7
9 rsvg-convert [options] in.svg > out.png
10
12 Converts SVG images into PNG raster images, PDF, PS, or SVG vector
13 images, or dumps of Cairo XML or recording surfaces.
14 OPTIONS
16 -d --dpi-x number
17 Set the X resolution of the image in pixels per inch. RSVG's
18 current default is 90 DPI.
19 -p --dpi-y number
21 Set the Y resolution of the image in pixels per inch. RSVG's
22 current default is 90 DPI.
23 -x --x-zoom number
25 X Zoom factor, as a percentage. If unspecified, 1.0 is used as
26 the default.
27 -y --y-zoom number
29 Y Zoom factor, as a percentage. If unspecified, 1.0 is used as
30 the default.
31 -z --zoom number
33 Zoom factor, as a percentage. If unspecified, 1.0 is used as
34 the default.
35 -w --width integer
37 Specify how wide you wish the image to be. If unspecified, the
38 natural width of the image is used as the default.
39 -h --height integer
41 Specify how tall you wish the image to be. If unspecified, the
42 natural height of the image is used as the default.
43 -f --format [png, pdf, ps, eps, svg, xml, recording]
45 Specify the output format you wish the image to be saved in. If
46 unspecified, PNG is used as the default.
47 -o --output filename
49 Specify the output filename. If unspecified, outputs to stdout.
50 -i --export-id object-id
52 Allows to specify an SVG object that should be exported. If
53 unspecified, all objects will be exported.
54 -a --keep-aspect-ratio
56 Specify that the aspect ratio is to be preserved. If unspeci‐
57 fied, aspect ratio will not be preserved.
58 -b --background-color [black, white, #abccee, #aaa...]
60 Specify the background color. If unspecified, none is used as
61 the default.
62 -s --stylesheet filename
64 Filename of a CSS stylesheet.
65 -u --unlimited
67 The SVG parser has some guards designed to mitigate large CPU or
68 memory consumption in the face of malicious XML. It may also
69 refuse to resolve URIs used to embed image data. If you are
70 running into such issues when converting a SVG, this option
71 allows to turn off these guards.
72 --keep-image-data
74 Include the original, compressed images in the final output,
75 rather than uncompressed RGB data. This is the default behavior
76 for PDF and (E)PS output.
77 --no-keep-image-data
79 Do not include the original, compressed images but instead embed
80 uncompressed RGB date in PDF or (E)PS output. This will most
81 likely result in larger documents that are slower to read.
82 -v --version
84 Display what version of rsvg this is.
85
87 SOURCE_DATE_EPOCH
88 If the selected output format is PDF, this variable can be used
89 to control the CreationDate in the PDF file. This is useful for
90 reproducible output. The environment variable must be set to a
91 decimal number corresponding to a UNIX timestamp, defined as the
92 number of seconds, excluding leap seconds, since 01 Jan 1970
93 00:00:00 UTC. The specification for this can be found at
94 https://reproducible-builds.org/specs/source-date-epoch/
95
97 https://wiki.gnome.org/Projects/LibRsvg
98 http://www.w3.org/TR/SVG11/
100 http://www.gnome.org/
102
104 Dom Lachowicz (cinamod@hotmail.com), Caleb Moore (c.moore@stu‐
105 dent.unsw.edu.au), Federico Mena-Quintero (federico@gnome.org), and a
106 host of others.
107 rsvg-convert(1)