Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
XYCPT(1)			 User commands			      XYCPT(1)

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

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

       The 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 -o option is not specified.

       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.

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

       -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 file
	   Write the output to file, rather than stdout.

       -r, --registration string
	   For discrete	(using the -d 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.

       J. J. Green


CPTUTILS		       9 September 2020			      XYCPT(1)


Want to link to this manual page? Use this URL:

home | help