1AVLCPT(1) User commands AVLCPT(1)
2
3
4
6 avlcpt - convert ArcView® Legend gradients to GMT colour palette tables
7
9 avlcpt [-b rgb] [-f rgb] [-h] [-l adjust] [-n rgb] [-o file]
10 [-p precision] [-u adjust] [-v] [-V] [file]
11
13 The avlcpt utility will extract a gradient from an ArcView Legend (avl)
14 file and write it to the GMT (Generic Mapping Tools) cpt format. Note
15 that not every avl file will contain a gradient, some just have
16 patterns.
17
18 The program will read from stdin if a file is not specified as the
19 final argument, and write to stdout if the -o option is not specified.
20
22 In the following, all rgb specifications should be of the form
23 red/green/blue where the colour components are integers in the range 0
24 to 255.
25
26 -b, --background rgb
27 Set the background colour of the output.
28
29 --backtrace-file path
30 Specify a file to which to write a formatted backtrace. The file
31 will only be created if there is a backtrace created, typically
32 when an error occurs.
33
34 --backtrace-format format
35 Specify the format of the backtrace written to the files specified
36 by --backtrace-file, one of plain, xml or json.
37
38 -f, --foreground rgb
39 Set the foreground colour of the output.
40
41 -h, --help
42 Brief help.
43
44 -l, --lower adjust
45 Decrease the lower limit on each segment by the specified amount.
46
47 -n, --nan rgb
48 Set the NaN (no data) colour of the output.
49
50 -o, --output file
51 Write the output to file, rather than stdout.
52
53 -p, --precision precision
54 Specify rounding. ArcView legends have a rather interesting
55 approach to height specification whereby colour ranges might be
56 0-49, 50-99, and so on. The cpt format requires that the end of one
57 segment be at the same as the start of the next, so some rounding
58 of the input will usually be required. The precision is specified
59 directly rather than by number of digits, so that -p10 will round
60 to the nearest 10 and so on.
61
62 -u, --upper adjust
63 Increase the upper limit on each segment by the specified amount.
64
65 -v, --verbose
66 Verbose operation.
67
68 -V, --version
69 Version information.
70
72 ArcView® is a trademark of Environmental Systems Research Institute,
73 Inc.
74
76 J. J. Green
77
79 GMT(1).
80
81
82
83CPTUTILS 9 September 2020 AVLCPT(1)