setVideoPal

setVideoPal ( [ integer Palette =0] )

Use this function to apply one of the predefined palettes to the Video window. Equivalent to selecting the corresponding palette from the shortcut menu of the Video window.

Parameters

Palette

An enumerated integer that describes the palette to be applied. Must be one of the following values:

PAL_GRAY=0 – applies the standard 256-level grayscale palette.

PAL_INVERSE=1 – applies the inverted 256-level grayscale palette. The video will be displayed in the negative format.

PAL_SATURATED=2 – applies the grayscale palette with colorized upper entries. The saturated palette allows the user to control the dynamic range of the video signal by bringing it slightly below the saturation level of the video camera or video amplifier.

PAL_ISODENSE=3 – applies a 256-level grayscale palette, each 8-th entry of which is colorized. The isodense palette allows the user to clearly see transitions between different levels of intensities as isolines on a topographic map.

PAL_RAINBOW=4 – applies a color palette where the entries are evenly distributed along the Hue axis. This allows for assigning different color pigments to different levels of intensity.

PAL_SPECTRA=5 – applies a color palette where the entries are distributed along the Hue and Luminance axes. That allows for assigning different color pigments to different levels of intensity while preserving the luminance scale.

PAL_MULTI=6 – applies the multiphase color palette. Entries in the multiphase palette are at opposite ends of the color model so even small changes in gray levels are highlighted.

PAL_RANDOM=7 – applies the random color palette whose entries are filled with random values.

PAL_BESTFIT=8 – applies the best-fit grayscale palette to provide the maximum contrast between the darkest and brightest pixels.

Default value: PAL_GRAY

Error flags

ERR_OK

The flag set if successful.

ERR_FAILED

The flag set if failed.

Example

The following set of statements displays the Video window with the saturated palette allowing the user to adjust the video just below the saturation level before the image is captured:

showVideo()

setVideoPal(PAL_SATURATE)

Print "Adjust the light source intensity and gain level,"

Print "so that the red color just barely shows up on video"

Input "Press Enter when ready"

grabIm (1)

showVideo(FALSE)