1d.colors(1) Grass User's Manual d.colors(1)
2
6 d.colors - Allows the user to interactively change the color table of
7 a raster map layer displayed on the graphics monitor.
8
10 display
11
13 d.colors
14 d.colors help
15 d.colors map=string [--verbose] [--quiet]
16 Parameters:
18 map=string
19 Name of raster map
20
22 d.colors - Allows the user to interactively change the color table of
23 a raster map layer displayed on the graphics monitor.
24
26 display
27
29 d.colors
30 d.colors help
31 d.colors map=string
32 Parameters:
34 map=string
35 Name of raster map
36
38 A color table file associates specific colors with the categories of a
39 raster map layer. The user can change these map category color assign‐
40 ments (i.e., change the map's color table) interactively, by first dis‐
41 playing the raster map to the graphics monitor and then running the
42 program d.colors.
43 Any color changes made using d.colors will not immediately be shown on
45 the graphics display; however, any color changes saved will still alter
46 the map's color table and will appear next time the raster map layer is
47 redisplayed (see d.colortable).
48 The user must first display the relevant raster map layer to the active
50 frame on the graphics monitor (e.g., using d.rast) before running
51 d.colors. The user can then either enter the name of the raster map
52 layer whose color table is to be changed on the command line (e.g., by
53 typing: d.colors map=soils), or type d.colors without program argu‐
54 ments. If the user simply types d.colors without program arguments on
55 the command line, d.colors will ask the user to enter the name of an
56 existing raster map layer using the standard GRASS interface.
57 In either case, the user is then presented with the d.colors command
59 menu, shown below. This menu is the same as the category and color
60 changing portion of the d.display menu. The d.colors commands are
61 listed beneath the Category Pointer Movement, Color Modification,
62 Replotting Screen, and Quitting sections below. Commands are invoked
63 by typing in the single-key response shown to the left below. (Longer
64 descriptions of these commands appear to the right.) Results from
65 invoking these commands will be reflected in the Category and Category
66 Number sections of the d.colors screen. On the d.colors screen menu,
67 commands appear in the right half of the screen, and the current status
68 of categories appears in the left half of the screen.
69 CATEGORIES
70 0 No Data
71 1 (Category 1 description)
72 2 (Category 2 description)
73 . ....
74 . ....
75 CATEGORY NUMBER:
76 RED 0 0%
77 GREEN 0 0%
78 BLUE 0 0%
79 Shift Incr: 10 3%
80 CATEGORY POINTER MOVEMENT
81 D/d down (cats) Move pointer to next category
82 U/u up (cats) Move pointer to previous category
83 COLOR MODIFICATIONS
84 R/r RED Increase/decrease RED intensity
85 G/g GREEN Increase/decrease GREEN intensity
86 B/b BLUE Increase/decrease BLUE intensity
87 I/i increment Increase/decrease increment
88 (of intensity shift)
89 h highlight Highlight current color
90 +/- shift colors Shift entire color table (up/down)
91 c save color Save color table
92 t toggle table Toggle to different color table
93 REPLOTTING SCREEN
94 * Replot screen Replots the screen
95 QUITTING
96 Q quit Quits program
97 Changing categories - The keys "d, D, u," and "U" are used to move to
98 a different category. The lower case letters move up, u, and down, d,
99 the category list one category at a time. The upper case letters move
100 10 categories at a time for fast movement. The cursor does wrap between
101 the first and last categories. The current category is noted on the
102 text screen with an arrow, and is indicated on the graphics screen by a
103 box around the current color.
104 Changing colors - The color associated with the current category can be
106 changed with the "R, r, G, g, B," and b keys. The upper case letters
107 increase the intensities of red R, green G, and blue B for the current
108 category; the lower case letters decrease the intensities of these same
109 colors for the current category. Video devices make all the colors of
110 the spectrum by mixing red, green, and blue. For those accustomed to
111 red, yellow, and blue being the primary colors, this can be confusing.
112 For starters, yellow is made by mixing red and green. The intensities
113 are listed on the text screen in as percentages.
114 Keys I and i increase and decrease the percentage change that each key‐
116 stroke of one of the color keys (R, r, G, g, B, b) causes in its
117 respective color. The increase increment is initially set to 10%.
118 Thus, pressing the R key would will increase the red component of the
119 current category by 10%.
120 Highlight - The h key toggles between the current category color and
122 the current highlight color. This color is initially black but can be
123 modified as above while in highlight mode. Blinking can be accomplished
124 by repeatedly striking the h key. When changing to different categories
125 using the movement keys as described above, while in highlight mode the
126 category colors will be always left showing their actual colors. Only
127 one category is highlighted at any one time.
128 Saving the current color table - Pressing the c key will save the cur‐
130 rent color table as you have modified it. This table will then be used
131 next time you display or paint this raster map layer.
132 Color table toggle - Different types of color tables are suitable for
134 different raster map layers. The key t flips between the following
135 color tables: red, green, blue color ramp; gray scale; smooth changing
136 color wave; random colors; and the saved color table.
137 Color table shift - The entire table is shifted up and down using the +
139 and - keys.
140 Quitting the d.colors program - Pressing the Q key will cause you to
142 quit the d.colors program. If colors have been modified but not saved,
143 d.colors will ask:
144 Colors changed
145 Save the changes? (y/n)
146 The user should type in y to save changes, or n to not save changes,
147 before quitting the program. If the user types n, the program will
148 ask:
149 Quit anyway? (y/n)
150
153 The map whose color table is to be altered with d.colors must already
154 be on display in the active display frame on the graphics monitor
155 before d.colors is run. This can be done using the command d.rast
156 map=name (where name is a raster map layer whose color table the user
157 wishes to alter).
158 Some color monitors may not support the full range of colors required
160 to display all of the map's categories listed in the map's color table.
161 However, regardless of whether the user can see the color changes he is
162 effecting to a map's color table, any changes to a map's color table
163 made with d.colors that are saved will appear in the map's color table.
164
166 d.colortable
167 d.rast
168 r.colors
169
171 James Westervelt, U.S. Army Construction Engineering Research Labora‐
172 tory
173 Last changed: $Date: 2007-04-11 15:45:53 +0200 (Wed, 11 Apr 2007) $
175 Help Index
177GRASS 6.3.0 d.colors(1)