1rsvg-convert(1)             General Commands Manual            rsvg-convert(1)
2
3
4

NAME

6       rsvg-convert - turn SVG files into raster images.
7

SYNOPSIS

9       rsvg-convert [options] in.svg > out.png
10

DESCRIPTION

12       Converts  SVG  images  into  PNG  raster images, PDF, PS, or SVG vector
13       images, or dumps of Cairo XML or recording surfaces.
14
15   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
20       -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
24       -x --x-zoom number
25              X Zoom factor, as a percentage.  If unspecified, 1.0 is used  as
26              the default.
27
28       -y --y-zoom number
29              Y  Zoom factor, as a percentage.  If unspecified, 1.0 is used as
30              the default.
31
32       -z --zoom number
33              Zoom factor, as a percentage.  If unspecified, 1.0  is  used  as
34              the default.
35
36       -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
40       -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
44       -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
48       -o --output filename
49              Specify the output filename.  If unspecified, outputs to stdout.
50
51       -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
55       -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
59       -b --background-color [black, white, #abccee, #aaa...]
60              Specify the background color.  If unspecified, none is  used  as
61              the default.
62
63       -s --stylesheet filename
64              Filename of a CSS stylesheet.
65
66       -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
73       --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
78       --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
83       -v --version
84              Display what version of rsvg this is.
85

ENVIRONMENT VARIABLES

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

MORE INFORMATION

97       https://wiki.gnome.org/Projects/LibRsvg
98
99       http://www.w3.org/TR/SVG11/
100
101       http://www.gnome.org/
102

AUTHORS

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
108
109
110                                                               rsvg-convert(1)
Impressum