create_map_coloring

create_map_coloring
-name s_coloringName 
-type {HSV 
          [[ -startHue i_0to360 ][ -stopHue i_0to360 ] 
           [ -startSaturation i_0to255 ][ -stopSaturation i_0to255 ] 
           [ -startLuminance i_0to255 ][ -stopLuminance i_0to255 ] 
           [ -startValue f_value ][ -stopValue f_value ] ] 
     | threshold 
           [ -ranges {{f_startValue f_stopValue i_red i_green i_blue}…} ]}

Description

Creates map colorings to use when displaying color maps. Two types of color mapping are available: HSV and threshold.

HSV (Hue Saturation Value)
HSV color mapping represents color as a continuous change of hue, saturation and luminance (or brightness) as the data value increases. You specify the range for each of these color components. By default, the computed range of data values is mapped to each range of given components to determine the color for each map tile. You can optionally limit the range of data values to color.
- Hue specifies the color from red (0), through yellows, greens, blues, magenta and finally back to red (360), completing the color wheel.
- Saturation specifies the color intensity from gray (0) to vivid (255). For a consistent saturation level, specify the same values for start and stop saturation.
- Luminance chooses the color brightness from light (0) to dark (255). For consistent brightness, specify the same values for start and stop luminance.

Threshold
Threshold color mapping assigns a color, given by red, green and blue (RGB) components, for a range of data values. For more color detail, a greater number of ranges must be specified. The following is a sampling of colors with their RGB representations:

Color	Red	Green	Blue
Red	255	0	0
Magenta	255	0	255
Purple	125	0	255
Blue	0	0	255
Cyan	0	255	255
Green	0	255	0
Yellow	255	255	0
Orange	255	125	0
White	255	255	255

For example, three ranges are given in the following:

-ranges {50 60 255 0 0 60 70 0 255 0 70 80 0 0 255}

Data in the first range (50-60) are colored red (255 0 0), in the second range (60-70) green (0 255 0), and in the last range (70-80) blue (0 0 255). Data outside of the given ranges (0-50, 80 and above) will not be colored.

Use the Select Color form to assist you in choosing HSV and RGB settings. To access this form, right-click a layer or object name in the Layer Object Display Panel, then click the Red-Green-Blue color bars on the right hand side of the pop-up. The Select Color form appears. Change the HSV or RGB values on the right side of the form to see the color that is represented by the values chosen.

Arguments

`-name` s_coloringName	Specifies the name for the map coloring.
`-ranges` {{f_startValue f_stopValue i_red i_green i_blue}…}
	(For `-type` `threshold`) Specifies the coloring to use for a range of values. You must specify all five values for each range. One or more groupings of ranges can be given with the following five values in order:
	f_startValue	Specifies the start value for the range.
	f_stopValue	Specifies the stop value for the range.
	i_red	Specifies the red component for the color. This value must be in the range of 0 to 255.
	i_green	Specifies the green component for the color. This value must be in the range of 0 to 255.
	i_blue	Specifies the blue component for the color. This value must be in the range of 0 to 255.
`-startHue` i_0to360	(`HSV`) Used with `stopHue` to specify the range of colors for the data values. This value must be in the range of 0 to 360 and represents a color of the color wheel that begins with red (0), migrates through yellows, greens, blues, magenta and back to red (360). The default value is 240 (blue).
`-startLuminance` i_0to255
	(`HSV`) Used with `stopLuminance` to specify the range of brightness for the range of data values. Legal values are 0 to 255. The default value is 125.
`-startSaturation` i_0to255
	(`HSV`) Used with `stopSaturation` to specify the range of color intensity for the range of data values. Legal values are 0 to 255. The default value is 255.
`-startValue` f_value	(`HSV`) Used with `stopValue` to specify the range of data values to color. If this value is not given, the computed minimum value for the data is used.
`-stopHue` i_0to360	(`HSV`) Used with `startHue` to specify the range of colors for the range of data values. Legal values are 0 to 360. The default value is 0.
`-stopLuminance` i_0to255
	(`HSV` type) Used with `startLuminance` to specify the range of brightness for the range of data values. Legal values are 0 to 255. The default value is 125. The default value is 125.
`-stopSaturation` i_0to255
	(`HSV` type) Used with `startSaturation` to specify the range of saturation for the range of data values. Legal values are 0 to 255. The default value is 255.
`-stopValue` f_value	(`HSV`) Used with `startValue` to specify the range of data values to color. If this value is not given, the computed maximum value for the data is used.
`-type {HSV\|threshold}`	Specifies the type of color mapping to use.
	`HSV`	Represents coloring as a continuous change of hue, saturation and luminance (or brightness) as the data value increases.
	`threshold`	Assigns a color (given by red, green and blue components) for a range of data values. For more color detail, a greater number of ranges must be specified.

Examples

Two color maps, thermalMap and thermalMapBands, are predefined. The following examples illustrate how these would be set using create_map_coloring.

thermalMap
```
create_map_coloring -name thermalMap -type HSV -startHue 180 -stopHue 0 -startSaturation 125 -stopSaturation 255 -startLuminance 125 -stopLuminance 225
```
This HSV mapping colors tiles by linearly mapping the minimum and maximum values for tiles to the color map scale starting with blue (180) at the minimum value, through green, and to red (0) at the maximum value. Saturation (opacity) and luminance are scaled in a similar manner.
thermalMapBands
```
create_map_coloring -name thermalMapBands -type threshold -ranges {60 80 0 0 255 80 95 0 255 0 95 100 255 0 0}
```
This threshold mapping colors tiles with values of 60-80 in blue, values of 80-95 in green, and values of 95-100 in red. Tiles with values under 60 are not colored.

Virtuoso Space-based Router Command Reference
Product Version IC23.1, September 2023