setPal
Top  Previous  Next

setPal ( integer Image [, 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
 
Image  
 
An integer between 1 and 116 specifying the frame number of the image to which the palette must be loaded. Values in the range of 100-116 correspond to hidden frames.  
 
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

grabIm(1)  
setPal(1,PAL_BESTFIT)