.TH d.colortable 1grass "" "GRASS 6.4.2" "Grass User's Manual"
.SH NAME
\fI\fBd.colortable\fR\fR  - Displays the color table associated with a raster map layer.
.SH KEYWORDS
display, raster
.SH SYNOPSIS
\fBd.colortable\fR
.br
\fBd.colortable help\fR
.br
\fBd.colortable map\fR=\fIname\fR  [\fBcolor\fR=\fIstring\fR]   [\fBlines\fR=\fIinteger\fR]   [\fBcols\fR=\fIinteger\fR]   [--\fBverbose\fR]  [--\fBquiet\fR] 
.SS Parameters:
.IP "\fBmap\fR=\fIname\fR" 4m
.br
Name of raster map whose color table is to be displayed
.IP "\fBcolor\fR=\fIstring\fR" 4m
.br
Color of lines separating the colors of the color table
.br
Options: \fIred,orange,yellow,green,blue,indigo,violet,white,black,gray,brown,magenta,aqua,grey,cyan,purple\fR
.br
Default: \fIwhite\fR
.IP "\fBlines\fR=\fIinteger\fR" 4m
.br
Number of lines to appear in the color table
.br
Options: \fI1-1000\fR
.IP "\fBcols\fR=\fIinteger\fR" 4m
.br
Number of columns to appear in the color table
.br
Options: \fI1-1000\fR
.PP
.SH DESCRIPTION
The GRASS program \fId.colortable\fR 
is used to display the color table associated with a raster map layer in the 
active frame on the graphics monitor. The \fImap\fR name should be 
an available raster map layer in the user's current mapset search path 
and location. 
.PP
If the values of both \fIlines\fR and \fIcols\fR are
not specified by  the user, \fId.colortable\fR 
divides the active frame equally among the number of categories 
present in the named raster map layer. If one option is specified, 
the other is automatically set to accommodate all categories. 
If both are specified, as many categories as possible are displayed. 
.PP
If the user specifies the name of a map on the command line but does not 
specify the values of other parameters, parameter default values will be used. 
Alternately, if the user types simply \fId.colortable\fR on the command line 
without any program arguments, the program will prompt the user for parameter 
settings using the standard GRASS parser interface.
.SH EXAMPLE
The user running the command: 
\fBd.colortable map=\fR\fIsoils\fR 
\fBcolor=\fR\fIred\fR
\fBlines=\fR\fI1\fR
\fBcols=\fR\fI3\fR
.PP
would see the active graphics frame divided into three columns 
extending the full frame height. The lines dividing the color table 
associated with the \fIsoils\fR map would be displayed in red. 
The user would see, at most, only three of the colors from the \fIsoils\fR 
color table displayed in the active frame (because the user requested 
that this frame be divided into three sections).
.SH NOTES
If the user wishes to display the entire color table associated with 
a map, the user should either stipulate a number of lines (rows) and 
columns (cols) sufficient to accommodate the number of categories 
in the map's color table, or fail to assign values to one or both of 
\fIlines\fR and/or \fIcols\fR.
If the user runs \fId.colortable\fR using the default number of 
lines and columns (the full graphics frame), all categories from the 
map's color table will be displayed. However, if the user requests 
that the color table associated with a map which has 10 data categories 
be displayed in a graphics frame with only 3 lines (rows) and 2 columns 
(a total of six cells), 
only six of the ten map categories will be displayed. 
.PP
The user should run the GRASS program 
\fId.erase\fR between 
runs of \fId.colortable\fR to avoid confusion. 
.SH SEE ALSO
\fI
d.colors
.br
d.erase
.br
d.legend
.br
d.rast
.br
\fR
.SH AUTHOR
James Westervelt, U.S. Army Construction Engineering Research Laboratory
.PP
\fILast changed: $Date: 2011-11-08 12:29:50 +0100 (Tue, 08 Nov 2011) $\fR
.PP
Full index
.PP
© 2003-2011 GRASS Development Team