Is_Setdisplaymode - THORLABS DCU223x Operation Manual And Sdk

DCx Cameras

4.3.80 is_SetDisplayMode

USB 2.0
USB 3.0
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 or OpenGL mode. These modes are not supported by
all graphics cards. The graphics card must have sufficient extended memory because the overlay mode requires
additional memory up to the size needed for the current screen resolution.
For further information on the display modes of the DCx camera, see the
section.
Attention
The Direct3D display mode is not available on Linux operating systems.
Note
We recommend that you call the following functions exclusively from a single thread in order to avoid unpredictable
behaviour of the application.
is_InitCamera()
is_SetDisplayMode()
is_ExitCamera()
See also Programming: Thread programming
Input parameters
hCam
Mode
IS_SET_DM_DIB
IS_SET_DM_DIRECT3D
IS_SET_DM_DIRECT3D |
IS_SET_DM_MONO
IS_SET_DM_DIRECT3D |
IS_SET_DM_BAYER
IS_SET_DM_OPENGL
IS_SET_DM_OPENGL |
IS_SET_DM_MONO
IS_SET_DM_OPENGL |
IS_SET_DM_BAYER
IS_GET_DISPLAY_MODE
Attention
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 modes, do the following:
IS_SET_DM_DIRECTDRAW |
IS_SET_DM_BACKBUFFER
IS_SET_DM_DIRECTDRAW |
322
USB 2.0
USB 3.0
273
322
213
453
How to proceed: Image display
Camera handle
Captures an image in system memory (RAM). Using
is_RenderBitmap()
display (default).
Image display in Direct3D mode
Monochrome image display in Direct3D mode
Raw Bayer format image display in Direct3D mode
Image display in OpenGL mode
Monochrome image display in OpenGL mode
Raw Bayer format image display in OpenGL mode
Returns the current setting.
Obsolete functions
Image display in DirectDraw BackBuffer mode
Image display in DirectDraw Overlay Surface mode
, you can define the image
297
). To activate the
379
© 2013 Thorlabs GmbH
133