cptsvg - Man Page

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

Synopsis

cptsvg [-g geometry] [-h] [-o path] [-p] [-v] [-V] [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 simply a plain text multi-line document without any comment delimiters (those will be added by the program)​.

--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​.

Example

Create an SVG file from CPT:

cptsvg -v -o foo​.svg foo​.cpt

Author

J​.J​. Green

Info

9 July 2024 cptutils 1.82 User commands