Home > C: Programming > Function Descriptions > History back  Previous chapter  Next chapter  Print  

is_SetDisplayMode

uEye Camera Manual Version 3.80

is_SetDisplayMode

Windows_Logo

Linux_Logo

USB 2.0

GigE

USB 2.0

GigE

Syntax

INT is_SetDisplayMode (HIDS hCam, INT Mode)

Description

Using is_SetDisplayMode(), you can set the way in which images will be displayed on the screen.

For live videos including overlays, you can use the Direct3D mode. This mode is not supported by all graphics cards. The graphics card must have sufficient extended memory because Direct3D mode requires additional memory up to the size needed for the current screen resolution.

For further information on the display modes of the uEye camera, see the How To Proceed: Image Display section.

Achtung

The Direct3D display mode is not available on Linux operating systems.

Hinweis

We recommend that you call the following functions exclusively from a single thread in order to avoid unpredictable behaviour of the application.

 

See also Programming: Thread Programming.

Input Parameters

hCam

Camera handle

Mode


IS_SET_DM_DIB

Captures an image in system memory (RAM). Using is_RenderBitmap(), you can define the image display(default).

IS_SET_DM_DIRECT3D

Image display in Direct3D mode

IS_SET_DM_DIRECT3D |
IS_SET_DM_MONO

Monochrome image display in Direct3D  mode

IS_SET_DM_DIRECT3D |
IS_SET_DM_BAYER

Raw Bayer format image display in Direct3D  mode

IS_GET_DISPLAY_MODE

Returns the current setting.

Achtung

The new Direct3D mode completely replaces the BackBuffer and Overlay Surface display modes from DirectDraw. It is advisable not to use these modes any longer (see also Obsolete Functions). To activate the obsolete modes, do the following:

Mode


IS_SET_DM_DIRECTDRAW |
IS_SET_DM_BACKBUFFER

Image display in DirectDraw BackBuffer mode

IS_SET_DM_DIRECTDRAW |
IS_SET_DM_ALLOW_OVERLAY

Image display in DirectDraw Overlay Surface mode

IS_SET_DM_ALLOW_SCALING

Real-time scaling in Overlay Surface mode

Return Values

IS_SUCCESS

Function executed successfully

IS_NO_SUCCESS

General error message

Current setting when used together with
IS_GET_DISPLAY_MODE


Related Functions

is_RenderBitmap()
is_SetColorMode()
is_DirectRenderer()

Code Sample


is_SetDisplayMode (hCam, Mode);

 

//Bitmap mode (images are digitized and stored in system memory):

Mode = IS_SET_DM_DIB

 

//Direct3D mode

Mode = IS_SET_DM_DIRECT3D


Suggestion for improvement? Send us your short Feedback on this chapter. Thank you very much!


© 2010 IDS Imaging Development Systems GmbH
http://www.ids-imaging.com