1XYCPT(1)                         User commands                        XYCPT(1)
2
3
4

NAME

6       xycpt - generate GMT colour palette table (cpt) files from column data.
7

SYNOPSIS

9       xycpt [-b rgb] [-d] [-f rgb] [-h] [-n rgb] [-o file] [-r registration]
10             [-u] [-v] [-V] [file]
11

DESCRIPTION

13       The xycpt program generates discrete or continuous cpt files from
14       simple input describing sample values of the colour (or greyscale)
15       range. The input consists of 1–4 columns. For 2 and 4 columns, the
16       first column is interpreted as a (double) z value, for 1 and 3 the z
17       value is taken implicitly. For 1 and 2 columns the final column will be
18       taken as a greyscale value. For 3 and 4, the last 3 columns are taken
19       as RGB values.
20
21       The program will read from stdin if a file is not specified as the
22       final argument, and write to stdout if the -o option is not specified.
23

OPTIONS

25       In the following, all rgb specifications should be of the form
26       red/green/blue where the colour components are integers in the range 0
27       to 255.
28
29       -b, --background rgb
30           Set the background colour of the output.
31
32       --backtrace-file path
33           Specify a file to which to write a formatted backtrace. The file
34           will only be created if there is a backtrace created, typically
35           when an error occurs.
36
37       --backtrace-format format
38           Specify the format of the backtrace written to the files specified
39           by --backtrace-file, one of plain, xml or json.
40
41       -d, --discrete
42           Output a discrete cpt file, the default is continuous.
43
44       -f, --foreground rgb
45           Set the foreground colour of the output.
46
47       -h, --help
48           Brief help.
49
50       -n, --nan rgb
51           Set the NaN (no data) colour of the output.
52
53       -o, --output file
54           Write the output to file, rather than stdout.
55
56       -r, --registration string
57           For discrete (using the -d option) conversion, specifies upper,
58           middle or lower registration of the data value. For the upper and
59           lower types the final (respectively the first) colour is omitted
60           from the output; only the z value is used. For middle registration
61           all the colours appear in the output.
62
63       -u, --unit
64           Colour values are specified as floating point numbers in the range
65           0–1 rather than as integers in the range 0–255.
66
67       -v, --verbose
68           Verbose operation.
69
70       -V, --version
71           Version information.
72

AUTHOR

74       J. J. Green
75

SEE ALSO

77       GMT(1).
78
79
80
81CPTUTILS                          8 July 2020                         XYCPT(1)
Impressum