## Please enable JavaScript to view this site.

# FALCON/EAGLE user manual 4.62

- Zoom window out
- Larger text | Smaller text
- Hide page header
- Show expanding text
- Print topic
- Send mail feedback
- Copy topic URL

is_SetColorMode | Scroll Previous Top Next More

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

© 2020 IDS Imaging Development Systems GmbH