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

  
 
  

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

NAME
     gplcpt  -	convert  GIMP  colour  palette (gpl) to GMT colour palette table
     (cpt).

SYNOPSIS
     gplcpt [-b rgb] [-f rgb] [-h] [-n rgb] [-o path] [-v] [-V] [-z]  [-4]  [-5]
	    [-6] [path]

DESCRIPTION
     The  gplcpt  program  converts  GIMP  colour palette (gpl) files to the GMT
     colour palette table (cpt) format. The output is a piecewise constant (step
     or discrete) gradient. One could use cptcont(1) program to convert the out-
     put to a continuous cpt file if so desired.

     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
     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  er-
	 ror 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 ver-
	 sion 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.

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

     -v, --verbose
	 Verbose operation.

     -V, --version
	 Version information.

     -z, --z-normalise
	 Normalise the z-values in the cpt output into the range 0/1 and  add  a
	 RANGE directive. This is the form used in GMT master files.

	 This option requires that output cpt version is at least 5.

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

AUTHOR
     J.J. Green

SEE ALSO
     cptcont(1).

cptutils 1.85			30 September 2025		       GPLCPT(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=gplcpt&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help