(optional) If only one variable is specified, it must be a 2D array (or equivalent expression) containing 3-by-n or n-by-3 elements, where n is the number of color values to use when initializing the color table.
Starts a VDA Tool used for editing the image and plot color tables used in other VDA Tools.
(optional) If only one variable is specified, it must be a 2D array (or equivalent expression) containing 3-by-n or n-by-3 elements, where n is the number of color values to use when initializing the color table.
NOTE: If three variables are specified, all three must be 1D arrays of equal length or equivalent expressions. The input variables are used as a triplet to specify the three components of the color table: (red, green, blue) for the RGB model; (hue, saturation, value) for the HSV model; or (hue, lightness, saturation) for the HLS model. See the Discussion for the ranges of these variables.
(optional) A 1D array or equivalent expression used with both var1 and var3 that is of the same length as var1 and var3. The array contains the number of color values to use for the second component of the color model when initializing the color table.var3
(optional) A 1D array or equivalent expression used with both var1 and var2 that is of the same length as var1 and var2. The array contains the number of color values to use for the third component of the color model when initializing the color table.
The index of a predefined color map to load when the color table is initialized. This color map is loaded before the input variables, if any, are written into the color map.Hls
If set, the HLS color system (hue, lightness, saturation) is used, instead of the default (RGB) color system.Hsv
If set, the HSV color system (hue, saturation, value) is used, instead of the default (RGB) color system.Image
If set, the image color table is displayed.
NOTE: If neither Image nor Plot is specified, both color tables are displayed.
If used, specifies the relationship of the WzColorEdit Tool to the widget ID of the parent shell. Otherwise, a new top level shell is created for the tool.Plot
If set, the plot color table is displayed.Position
Specifies the x and y (horizontal and vertical) coordinates in pixels for the starting location of the upper-left corner of the VDA Tool window. Range
A 1D array specifying the range of colors to display. This array contains four elements:
[image_start_color, image_end_color, plot_start_color, plot_end_color].If the range is not specified, the IMAGE_RANGE and PLOT_RANGE global variables are used.
Restore
A data structure that has been saved in the Tools Manager with the TmSaveTools function. This keyword is reserved for internal use; it is not to be used at the command line (see Discussion).Template
If specified, the contents of the named template are restored.
wavedir
/lib/vdatools/wzcoloredit.pro wavedir:[LIB.VDATOOLS]WZCOLOREDIT.PRO
wavedir\lib\vdatools\wzcoloredit.pro
wavedir is the main PV-WAVE directory. The ranges of the input variables depend on the type of color system that is specified. The components of each color system can have specific ranges of values, shown in the following table.
| Color System Component | Input Variable Range |
|---|---|
| r, g, b | 0 - 255 |
| hue | 0 - 360 |
| saturation, lightness, value | 0 - 1.0 |
Using a menu bar selection, you can pick from a number of predefined system color tables, or create and save your own custom color tables. As you make selections and/or changes to those selections all other VDA Tools that are running are updated, so you can see the results of your color edits immediately after making them.
The editing capabilities included in this VDA Tool let you change a single cell or a range of cells at the same time. Changes to a single cell can be made using control area sliders, or a color wheel dialog box. Changes to a range of color table cells are made by applying a ramp function between two specified color table indices. The ramp method can be linear, logarithmic, or exponential.
NOTE: If the beginning index you specify for the ramp function is larger than the ending index, the VDA Tool ignores the index order when applying the ramp.
WAVE prompt.
hue = [0, 30, 60, 90, 120, 150, 180, 210, 240, 270, 300, 330] saturation = FLTARR(12) saturation(*) = 1.0 value = saturation
WzColorEdit, hue, saturation, value, /Hsv
