rasterizer(1) SVG conversion

SYNOPSIS

rasterizer [options] files

DESCRIPTION

Rasterizer is a program to convert SVG files to various formats, namely PNG, JPEG and PDF.

OPTIONS

-d <dir|file>
output directory. If there is a single input file, this can be a file.
-m <mimeType>
output mime type. Should be one of image/jpg, image/jpeg, image/jpe, image/png, image/tiff or application/pdf.

-w <width>
output width. This is a floating point value.
-h <height>
output height. This is a floating point value.
-maxw <width>
Maximum output width. This is a floating point value.
-maxh <height>
Maximum output height. This is a floating point value.
-a <area>
output area. The format for <area> is x,y,w,h, where x, y, w and h are floating point values.
-bg <color>
output color. The format for <color> is a.r.g.b, where a, r, g and b are integer values.
-cssMedia <media>
CSS media type for which the source SVG files should be converted.
-cssAlternate <alternate>
CSS alternate stylesheet to use when converting the source SVG files.
-cssUser <userStylesheet>
CSS user stylesheet URI to apply to converted SVG documents in addition to any other referened or embeded stylesheets.
-font-family <defaultFontFamily>
Value used as a default when no font-family value is specified.
-lang <userLanguage>
User language to use when converting SVG documents.
-q <quality>
Quality for the output image. This is only relevant for the image/jpeg mime type.
-indexed (1|2|4|8)
Reduces the image to given number of bits per pixel using an adaptive pallete, resulting in an Indexed image. This is currently only supported for PNG conversion.
-dpi <resolution>
Resolution for the ouptut image.
-validate
Controls whether the source SVG files should be validated.
-onload
Controls if the source SVG files must be rasterize after dispatching the 'onload' event.
-scriptSecurityOff removes any security check on the scripts running
as a result of dispatching the onload event.
-anyScriptOrigin controls whether scripts can be loaded from
any location. By default, scripts can only be loaded from
the same location as the document referencing them.
-scripts <listOfAllowedScripts> List of script types (i.e.,
values for the type attribute in the <script> tag) which should be loaded.
-d <dir|file>
output directory. If there is a single input file, this can be a file.
-m <mimeType>
output mime type.
-w <width>
output width. This is a floating point value.
-h <height>
output height. This is a floating point value.
-maxw <width>
Maximum output width. This is a floating point value.
-maxh <height>
Maximum output height. This is a floating point value.
-a <area>
output area. The format for <area> is x,y,w,h, where x, y, w and h are floating point values.
-bg <color>
output color. The format for <color> is a.r.g.b, where a, r, g and b are integer values.
-cssMedia <media>
CSS media type for which the source SVG files should be converted.
-cssAlternate <alternate>
CSS alternate stylesheet to use when converting the source SVG files.
-cssUser <userStylesheet>
CSS user stylesheet URI to apply to converted SVG documents in addition to any other referened or embeded stylesheets.
-font-family <defaultFontFamily>
Value used as a default when no font-family value is specified.
-lang <userLanguage>
User language to use when converting SVG documents.
-q <quality>
Quality for the output image. This is only relevant for the image/jpeg mime type.
-indexed (1|2|4|8)
Reduces the image to given number of bits per pixel using an adaptive pallete, resulting in an Indexed image. This is currently only supported for PNG conversion.
-dpi <resolution>
Resolution for the ouptut image.
-validate
Controls whether the source SVG files should be validated.
-onload
Controls if the source SVG files must be rasterize after dispatching the 'onload' event.
-scriptSecurityOff
removes any security check on the scripts running as a result of dispatching the onload event. Always enabled, as in most cases, rasterizer just fails to run without this option. See -scriptSecurityOn

-scriptSecurityOn
If this is the first argument on the command-line, turn security back on. You'll most likely be hit by the possible bug mentioned below.

-anyScriptOrigin
controls whether scripts can be loaded from any location. By default, scripts can only be loaded from the same location as the document referencing them.
-scripts <listOfAllowedScripts>
List of script types (i.e., values for the type attribute in the <script> tag) which should be loaded.

BUGS

If rasterizer fails with an error in the spirit of:

Exception in thread "main" java.security.AccessControlException: access denied (java.util.PropertyPermission java.security.policy write)
        at java.security.AccessControlContext.checkPermission(AccessControlContext.java:323)
        at java.security.AccessController.checkPermission(AccessController.java:546)
        at java.lang.SecurityManager.checkPermission(SecurityManager.java:532)
        at java.lang.System.setProperty(System.java:727)

Run it with the -scriptSecurityOff option on. It seems in some cases the security design is slighlty too strong. This might become the default some day.

JAVA-WRAPPERS NOTE

This program is a shell script wrapper based on java-wrappers(7). You therefore benefit from several features; please see the java-wrappers(7) manual page for more information about them.

AUTHORS

rasterizer is part of batik, written by the Apache Software Foundation.

This manual page was written by Vincent Fourmond <[email protected]> for the Debian Project, but may be used by others.