TVLCT

The TVLCT procedure loads the display color translation tables from the specified variables. Although IDL uses the RGB color system internally, color tables can be specified to TVLCT using any of the following color systems: RGB (Red, Green, Blue), HLS (Hue, Lightness, Saturation), and HSV (Hue, Saturation, Value). Alpha values may also be used when using the second form of the command. The type and meaning of each argument is dependent upon the color system selected, as described below. Color arguments can be either scalar or vector expressions. If no color-system keywords are present, the RGB color system is used. See Image Display Routines for a more complete explanation of color systems.

Calling Sequence

TVLCT, V 1 , V 2 , V 3 [, Start]

or

TVLCT, V [, Start]

Arguments

TVLCT will accept either three n -element vectors ( V 1 , V 2 , and V 3 ) or a single n by 3 array ( V ) as an argument. The vectors (or columns of the array) have different meanings depending on the color system chosen. If an array V is specified, V [*,0] is the same as V 1 , V [*,1] is the same as V 2 , V [*,2] is the same as V 3 . In the description below, we assume that three vectors, V 1 , V 2 , and V 3 are specified.

The V 1 , V 2 , and V 3 arguments have different meanings depending upon which color system they represent.

R, G, B Color System

The parameters V 1 , V 2 , and V 3 contain the Red, Green, and Blue values, respectively. Values are interpreted as integers in the range 0 (lowest intensity) to 255 (highest intensity). The parameters can be scalars or vectors of up to 256 elements. By default, the three arguments are assumed to be R, G, and B values.

H, L, S Color System

Parameters V 1 , V 2 , and V 3 contain the Hue, Lightness, and Saturation values respectively. All parameters are floating-point. Hue is expressed in degrees and is reduced modulo 360. V 2 (lightness) and V 3 (saturation) and can range from 0 to 1.0. Set the HLS keyword to have the arguments interpreted this way.

H, S, V Color System

Parameters V 1 , V 2 , and V 3 contain values for Hue, Saturation, and Value (similar to intensity). All parameters are floating-point. Hue is in degrees. The Saturation and Value can range from 0 to 1.0. Set the HSV keyword to have the arguments interpreted this way.

Start

An integer value that specifies the starting point in the color translation table into which the color intensities are loaded. If this argument is not specified, a value of zero is used, causing the tables to be loaded starting at the first element of the translation tables.

Keywords

GET

Set this keyword to return the RGB values from the internal color tables into the V 1 , V 2 , and V 3 parameters. For example, the statements:

TVLCT, H, S, V, /HSV

TVLCT, R, G, B, /GET

load a color table based in the HSV system, and then read the equivalent RGB values into the variables R, G, and B.

HLS

Set this keyword to indicate that the parameters specify color using the HLS color system.

HSV

Set this keyword to indicate that the parameters specify color using the HSV color system.

Example

R = BYTSCL(SIN(FINDGEN(256))) ; Create a set of R, G, and B colormap vectors.

G = BYTSCL(COS(FINDGEN(256)))

B = BINDGEN(256)

TVLCT, R, G, B ; Load these vectors into the color table.

TVSCL, DIST(400) ; Display an image to see the effect of the new color table.

See Also

LOADCT , XLOADCT , XPALETTE