Syntax
INT is_SetColorMode (HIDS hf, INT Mode)
Description
is_SetColorMode() sets the required color mode with which the image data is to be saved or displayed by the VGA board. For the first case it is important that, depending upon the color mode which is used, the allocated image memory is large enough. A 24 bit color image requires three times as much memory as an 8 bit monochrome image. When accessing the image data, it is important to know how the memory is arranged in each of the memory modes. Incorrect interpretation of the memory contents leads to incorrect results. With the direct transfer to the VGA card’s image memory, it is important to ensure that the display settings correspond to those of the FALCON/EAGLE’s color mode. Under certain circumstances the images can be displayed with either the incorrect colors or they can become so distorted that it is impossible to recognize what is actually being displayed. The higher the pixel depth of the transferred images, the more load on the PCI bus. It is always a good idea to select gray scale mode for monochrome images and display the image at 256 colors.
Parameters
hf |
Frame grabber handle |
Mode |
|
IS_SET_CM_RGB32 |
32 bit true color mode, R-G-B dummy |
IS_SET_CM_RGB24 |
24 bit true color mode; R-G-B |
IS_SET_CM_RGB16 |
Hi-color mode; 5 R - 6 G - 5 B |
IS_SET_CM_RGB15 |
Hi-color mode; 5 R - 5 G - 5 B |
IS_SET_CM_Y8 |
8 bit monochrome images |
IS_SET_CM_RGB8 |
8 bit color images; 2 R - 3 G - 2 B |
IS_SET_CM_YUV422_PLANAR |
YUV color images |
IS_GET_COLOR_MODE |
Returns the current setting |
Return value
Current setting when called with IS_GET_COLOR_MODE, else IS_SUCCESS, IS_NO_SUCCESS
