![]() |
![]()
| ![]() |
![]()
NAMExycpt - generate GMT colour palette table (cpt) files from column data. SYNOPSISxycpt [-b rgb] [-d] [-f rgb] [-h] [-n rgb] [-o path] [-r registration] [-u] [-v] [-V] [-4] [-5] [-6] [path] DESCRIPTIONThe xycpt program generates discrete or continuous cpt files from simple input describing sample values of the colour (or greyscale) range. The input consists of 1–4 columns. For 2 and 4 columns, the first column is interpreted as a (double) z value, for 1 and 3 the z value is taken implicitly. For 1 and 2 columns the final column will be taken as a greyscale value. For 3 and 4, the last 3 columns are taken as RGB values. 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. OPTIONSIn 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. -b, --background rgb Set the background colour of the output.
--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-generate Create a comment with summary data (the date of creation,
name and version of the cptutils package) in the output file.
--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. -d, --discrete Output a discrete cpt file, the default is
continuous.
-f, --foreground rgb Set the foreground colour of the output.
-h, --help Brief help.
-n, --nan rgb Set the NaN (no data) colour of the output.
-o, --output path Write the output to path, rather than
stdout.
-r, --registration string For discrete (using the --discrete option)
conversion, specifies upper, middle or lower registration
of the data value. For the upper and lower types the final
(respectively the first) colour is omitted from the output; only the z value
is used. For middle registration all the colours appear in the
output.
-u, --unit Colour values are specified as floating point numbers in
the range 0–1 rather than as integers in the range 0–255.
-v, --verbose Verbose operation.
-V, --version Version information.
-4, --gmt4 Use GMT 4 conventions when writing the cpt output: the
colour-model code is uppercase, and the colours are separated by spaces.
This is incompatible with the -5 and -6 options of course. At present this option is the default, but that will change at some point. So specify this option if your use of the output depends on the GMT 4 layout (consumed by a custom parser, for example). -5, --gmt5 Use GMT 5 conventions when writing the cpt output: the
colour-model code is lowercase, and the colours are separated by a solidus for
RGB, CMYK, by a dash for HSV.
This is incompatible with the -4 and -6 options of course. -6, --gmt6 As the -5 option, but allows the HARD_HINGE
and SOFT_HINGE directives in place of the explicit HINGE =
directive.
This is incompatible with the -4 and -5 options of course. AUTHORJ.J. Green
|