.TH PSSCALE l DATE
#ifdef SI
#define UNIT	cm
#define LEN_1	7.5
#define LEN_2	5
#define LEN_3	15
#define LEN_4	10
#define SCALE	\fB\-D\fP16.5/5/7.5/1.25
#else
#define UNIT	inch
#define LEN_1	3
#define LEN_2	0.5
#define LEN_3	6
#define LEN_4	4
#define SCALE	\fB\-D\fP6.5/2/3/0.5
#endif
.SH NAME
psscale \- Create grayscale or colorscale for maps
.SH SYNOPSIS
\fBpsscale\fP \fB\-C\fP\fIcpt_file\fP \fB\-D\fP\fIxpos/ypos/length/width[h]\fP 
[ \fB\-B\fP\fItickinfo\fP ] [ \fB\-F\fP\fIred/green/blue\fP ] 
[ \fB\-I\fP[\fImax_intens\fP] ] [ \fB\-K\fP ] [ \fB\-L\fP ] [ \fB\-N\fP\fIdpi\fP ] [ \fB\-O\fP ] [ \fB\-P\fP ] 
[ \fB\-U\fP[\fI/dx/dy/\fP][\fIlabel\fP] ] [ \fB\-V \fP ] [ \fB\-X\fP\fIx-shift\fP ] 
[ \fB\-Y\fP\fIy-shift\fP ] [ \fB\-Z\fP\fIzfile\fP ] [ \fB\-c\fP\fIcopies\fP ] [ \fB\-0\fP || \fB\-1\fP || \fB\-2\fP ]
.SH DESCRIPTION
\fBpsscale\fP plots grayscales or colorscales on maps.  Both horizontal and vertical scales
are supported.  For cpt_files with gradational colors (i.e., the lower and upper
boundary of an interval have different r/g/b values) \fBpsscale\fP will interpolate to give
a continuous scale.  Variations in intensity due to shading/illumination may be
displayed by setting the option \fB\-I\fP.  Colors may be spaced according to a linear
scale, all be equal size, or by providing a file with individual tile widths.
.TP
.B \-C
\fIcpt_file\fP is the color palette file to be used
By default all color changes are anotated.  To use a subset, add an extra column to the
cpt-file with a L, U, or B to anotate Lower, Upper, or Both color segment boundaries.
.TP
.B \-D
Defines the position of the center/top (for horizontal scale) or center/left (for
vertical scale) and the dimensions of the scale.  Append \fIh\fP to get a horizontal
scale [Default is vertical].
.SH OPTIONS
No space between the option flag and the associated arguments.
.TP
.B \-B
Here, only used to set the scale label, i.e., \fB\-B\fP:."Scale label:".  Note that since vertical labels will be plotted as a column
of individual characters, no octal escape characters imbedded in the label are allowed.
.TP
.B \-F
Sets the color used for Frame and annotations.  [Default is black]
.TP
.B \-I
Add illumination effects.  Optionally, set the range of intensities from
+ to - \fImax_intens\fP.  If not specify, 1.0 is used.  [Default is no illumination]
#include "explain_-K.txt"
.TP
.B \-L
Gives equal-sized color rectangles.  Default scales rectangles according to the
z-range in the cpt-file  (Also see \fB\-Z\fP).
.TP
.B \-N
Effective dots-per-inch for the rectangular image making up the color scale [50].
#include "explain_-O.txt"
#include "explain_-P.txt"
#include "explain_-U.txt"
#include "explain_-V.txt"
#include "explain_-XY.txt"
.TP
.B \-Z
File with colorbar-width in UNIT per color entry.  By default, width of entry is scaled
to color range, i.e., z = 0-100 gives twice the width as z = 100-150 (Also see \fB\-L\fP).
#include "explain_-c.txt"
.TP
.B \-0
Create the scale using the Adobe \fIPostScript\fP colorimage operator.  This is the
\fBGMT\fP default (which can be modified in the .gmtdefaults file).
.TP
.B \-1
Create the scale by plotting individually colored tiles.
.TP
.B \-2
Create the scale by color separation using three calls to image for later
processing by \fBpsto24\fP.
.SH EXAMPLES
To append a vertical colorscale (LEN_1 UNIT long; LEN_2 UNIT wide) to the right of a plot that is LEN_3 UNIT wide and LEN_4 UNIT
high, using illumination, try
.br
.sp
psscale SCALE \fB\-O \-C\fPcolors.cpt \fB\-I\fP \fB\-B\fP:.BATHYMETRY: >> map.ps
.SH SEE ALSO
gmt, makecpt, grd2cpt
#include "refs.i"
