svgx (1) - Linux Man Pages
svgx: extract gradients from SVG files.
svgx - extract gradients from SVG files.
svgx [-a] [-b
rgb] [-f rgb] [-g geometry] [-h] [-l] [-n rgb] [-o file] [-p] [-s name] [-t type] [-T rgb] [-v] [-V] file
There are 4 modes of operation: The default is to extract the first gradient found in the file, or one can specify -l to list the names of all gradients in the file; -s to extract the gradient with the specified name or -a to extract all of the gradients.
The output format is specified by the -t option as listed below (in fact there are several aliases for each format: jgd for psp, gimp for ggr, and so on). The svgcpt, svggimp, svggpt, svgcss3, svgpsp, svgpov, svgpng, svgsao and svgsvg programs are wrappers around svgx which use the -t switch to specify output type.
Atypically, the input SVG file is a mandatory argument. The program will write to stdout if the -o option is not specified except when -a has been specified: then files will be produced (with names taken from those of the gradients).
In the following, all rgb specifications should be of the form red/green/blue where the colour components are integers in the range 0 to 255.
- Extract all gradients, which will have filenames derived from the gradient names. If this option is used then the argument of the -o option will be interpreted as the output directory.
-b, --background rgb
Set the background colour of cpt output.
Note that this only modifies the "background" field in the output cpt file, it does not affect the transparency (see the -T option in that regard).
-f, --foreground rgb
- Set the foreground colour of cpt output.
-g, --geometry widthxheight
- Specify the size of the PNG image or SVG preview in pixels.
- Brief help.
- List the names of all gradients in the file.
-n, --nan rgb
- Set the NaN (no data) colour of cpt output.
-o, --output path
Write the output to
path, rather than
If the -a option is specified then the path argument must be a directory (which exists) and the output files will be written into this directory.
- Include a preview in the SVG output. See also the --geometry option.
- Do not create files which break limits of the format specification. In particular, do not create POV-Ray headers with more than 255 stops.
-s, --select name
- Extract the gradient with the specified name, see the -l output for a list of possible values.
-t, --type format
- Set the output format, which should be one of cpt, css3, ggr, gpt, psp, pov, png, sao or svg.
-T, --transparency rgb
- When converting to a format which does not support transparency, replace the transparency with the specified rgb colour.
- Verbose operation.
- Version information.
Inspect an SVG file for gradients:
svgx -v -l old.svg
Extract the gradient "Sunny Road" from the same SVG file, converting the result to cpt: (note that the gradient name needs to be quoted)
svgx -v -t cpt -s "Sunny Road" -o sunny_road.cpt old.svg
Extract all of the svg gradients from the file kittens.svg and give each of them a preview:
svgx -v -t svg -a -p kittens.svg