loadPal
Top  Previous  Next

laodPal ( integer Image, string File )

Use this function to load an existing palette from a palette file to a palettized or grayscale image.

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.  
 
File  
 
A string containing the name of an ImageWarp palette file.  
 
Error flags

ERR_OK  
 
The flag set if successful.  
 
ERR_FAILED  
 
The flag set if failed.  
 
ERR_NOTFOUND  
 
The flag set if the file was not found.  
 
ERR_BADFORMAT  
 
The flag set if file was not recognized as an ImageWarp palette file.  
 
Example

This set of statements continuously grabs an image into a hidden frame #1, loads the "hex" palette from ImageWarp's Palette folder and copies the resulting pseudo-colored image to a frame #1 for the live display.  
setCurDir("samples")  
do  
 grabIm (1)  
 loadPal(100,"..\PALETTES\HEX.PAL",i)  
 duplicate (100,1)  
loop  
 
Remark

This function cannot be applied to a true color image.