qgssvg - Man Page

qgssvg [-h] [-o path] [-v] [-V] path

The qgssvg program converts QGIS colour-ramps to the SVG format. Unlike most of the other file formats handled by the cptutils package, QGIS ramps may contain multiple gradients and all of the input gradients will be converted to gradients in the output file. One can then use svgx(1) to extract single gradients and/or convert them to other formats.

Atypically, the path to the input QGIS colour ramp is required, but the program will write to stdout if the --output option is not specified.

At present, only colour-ramps of type gradient can be converted (so version 2 preset ramps will be skipped), similarly those gradients which have the discrete attribute set true, but this restriction will hopefully be lifted in a later version.

--backtrace-file path

Specify a file to which to write a formatted backtrace. The file will only be created if there is a backtrace created, typically when an error occurs.

--backtrace-format format

Specify the format of the backtrace written to the files specified by --backtrace-file, one of plain, xml or json.

--comments-read path

Read the comments from the specified path and add them to the output gradient.

The format is simply a plain text multi-line document without any comment delimiters (those will be added by the program).

--comments-retain

Use the comments in the input file as the comments for the output file.

--comments-generate

Create a comment with summary data (the date of creation, name and version of the cptutils package) in the output file.

-h,  --help

Brief help.

-o,  --output path

Write the output to path, rather than stdout.

-v,  --verbose

Verbose operation.

-V,  --version

Version information.

Convert a QGIS colour-ramp, foo.qgs, to a set of GIMP gradients:

qgssvg -v -o tmp.svg foo.qgs
svggimp -v -a tmp.svg

J.J. Green

svgx(1)