Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
QGSSVG(1)			  User commands 		       QGSSVG(1)

NAME
     qgssvg - convert QGIS colour-ramps to SVG gradients.

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

DESCRIPTION
     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 con-
     verted 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: version 2
     preset ramps will be skipped.

OPTIONS
     --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 er-
	 ror 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 custom XML which should be fairly easy to  generate,  see
	 the output of --comments-write for examples.

     --comments-write path
	 Write the comments in the input to the specified path.

     --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 ver-
	 sion 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.

     -2, --svg2
	 SVG  output  is version 2.0 of the format. Note that version 2.0 is not
	 yet completed and browser support is minimal.

EXAMPLE
     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

AUTHOR
     J.J. Green

SEE ALSO
     svgx(1)

cptutils 1.85			30 September 2025		       QGSSVG(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=qgssvg&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help