Scroll to navigation

rsvg-convert(1) General Commands Manual rsvg-convert(1)

NAME

rsvg-convert - turn SVG files into raster images.

SYNOPSIS

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

DESCRIPTION

Converts SVG images into PNG raster images, PDF, PS, or SVG vector images, or dumps of Cairo XML or recording surfaces.

OPTIONS

-d --dpi-x number
Set the X resolution of the image in pixels per inch. RSVG's current default is 90 DPI.
-p --dpi-y number
Set the Y resolution of the image in pixels per inch. RSVG's current default is 90 DPI.
-x --x-zoom number
X Zoom factor, as a percentage. If unspecified, 1.0 is used as the default.
-y --y-zoom number
Y Zoom factor, as a percentage. If unspecified, 1.0 is used as the default.
-z --zoom number
Zoom factor, as a percentage. If unspecified, 1.0 is used as the default.
-w --width integer
Specify how wide you wish the image to be. If unspecified, the natural width of the image is used as the default.
-h --height integer
Specify how tall you wish the image to be. If unspecified, the natural height of the image is used as the default.
-f --format [png, pdf, ps, svg, xml, recording]
Specify the output format you wish the image to be saved in. If unspecified, PNG is used as the default.
-o --output filename
Specify the output filename. If unspecified, outputs to stdout.
-a --keep-aspect-ratio
Specify that the aspect ratio is to be preserved. If unspecified, aspect ratio will not be preserved.
-b --background-color [black, white, #abccee, #aaa...]
Specify the background color. If unspecified, none is used as the default.
--base-uri uri
Specify the base URI for SVG files. If unspecified, none is used as the default.
-v --version
Display what version of rsvg this is.

ENVIRONMENT VARIABLES

SOURCE_DATE_EPOCH
If the selected output format is PDF, this variable can be used to control the CreationDate in the PDF file. This is useful for reproducible output. The environment variable must be set to a decimal number corresponding to a UNIX timestamp, defined as the number of seconds, excluding leap seconds, since 01 Jan 1970 00:00:00 UTC. The specification for this can be found at https://reproducible-builds.org/specs/source-date-epoch/

MORE INFORMATION

https://wiki.gnome.org/Projects/LibRsvg

http://www.w3.org/TR/SVG11/

http://www.gnome.org/

AUTHORS

Dom Lachowicz (cinamod@hotmail.com), Caleb Moore (c.moore@student.unsw.edu.au), Federico Mena-Quintero (federico@gnome.org), and a host of others.