Scroll to navigation

r.what.color(1grass) Grass User's Manual r.what.color(1grass)

NAME

r.what.color - Queries colors for a raster map layer.

KEYWORDS

raster, querying

SYNOPSIS

r.what.color
 
r.what.color help
 
r.what.color [-i] input=string [value=float[, float,...]] [format=string] [-- verbose] [--quiet]

Flags:

-i
 
Read values from stdin
--verbose
 
Verbose module output
--quiet
 
Quiet module output

Parameters:

input=string
 
Name of existing raster map to query colors
value=float[,float,...]
 
Values to query colors for
format=string
 
Output format (printf-style)
 
Default: %d:%d:%d

DESCRIPTION

r.what.color outputs the color associated with user-specified category values in a raster input map.
Values may be specified either using the values= option, or by specifying the -i flag and passing the values on stdin, one per line.
For each value which is specified, a line of output will be generated consisting of the category value followed by the color, e.g.:
 
r.what.color input=elevation.dem value=1500
 
1500: 223:127:31
 
If the input map is an integer (CELL) map, the category will be written as an integer (no decimal point), otherwise it will be written in floating point format ( printf("%.15g") format).
If the lookup fails for a value, the color will be output as an asterisk, e.g.:
 
r.what.color input=elevation.dem value=9999
 
9999: *
 
If a value cannot be parsed, both the value and the color will be output as an asterisk, e.g.:
 
r.what.color input=elevation.dem value=bogus
 
*: *
 
The format can be changed using the format= option. The value should be a printf()-style format string containing three conversion specifiers for the red, green and blue values respectively, e.g.:
 
r.what.color input=elevation.dem value=1500 format='%02x:%02x:%02x'
 
1500: df:7f:1f
 
If your system supports the %m$ syntax, you can change the ordering of the components, e.g.:
 
r.what.color input=elevation.dem value=1500 format='%3$02x:%2$02x:%1$02x'
 
1500: 1f:7f:df
 
Common formats:
 
Tcl/Tk: format="#%02x%02x%02x"
WxPython: format='"#%02x%02x%02x"' or format='"(%d,%d,%d)"'

SEE ALSO

r.what

AUTHOR

Glynn Clements
Full index
© 2003-2014 GRASS Development Team
GRASS 6.4.4