NAME

cptsvg - convert GMT colour palette tables (cpt) to SVG gradients.

SYNOPSIS

cptsvg [-g geometry] [-h] [-o path] [-p] [-v] [-V] [-2] [path]

DESCRIPTION

The cptsvg utility converts the colour palette table (cpt) files used by GMT to the gradients in the Scalar Vector Graphics (SVG) format.

The program will read from stdin if a file is not specified as the final argument, and write to stdout if the --output option is not specified.

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 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 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 version of the cptutils package) in the output file.

-g, --geometry widthxheight

Specify the size of the SVG preview in pixels.

-h, --help

Brief help.

--hinge-active

If the input cpt has a SOFT_HINGE directive, then activate that hinge (resulting in independent scaling of the two halves of the gradient either side of the hinge).

If the input does not have such a directive, then this option has no effect.

-o, --output path

Write the output to path, rather than stdout.

-p, --preview

Include a preview in the SVG output. See also the --geometry option.

-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

Create an SVG file from CPT:

cptsvg -v -o foo.svg foo.cpt

AUTHOR

J.J. Green