THORLABS DCU223x User Manual

© 2013 Thorlabs GmbH
4 Programming (SDK)
297
4.3.71 is_RenderBitmap
USB 2.0
USB 3.0
-
Syntax
INT is_RenderBitmap (HIDS hCam, INT nMemID, HWND hwnd, INT nMode)
Description
Using is_RenderBitmap(), you can output an image from an image memory in the specified window. For the
display, Windows bitmap functionality is used. The image is displayed in the format you specified when allocating
the image memory.
The bitspixel parameter of the is_AllocImageMem() function defines the color depth and display type.
RGB16 and RGB15 require the same amount of memory but can be distinguished by the bitspixel parameter.
Attention
is_RenderBitmap() can render Y8 and RGB formats. For displaying YUV/YCbCr formats please use the
is_DirectRenderer() function (see also Color and memory formats ).
Input parameters
hCam
Camera handle
nMemID
ID of the image memory whose contents is to be
displayed
hwnd
Output window handle
nMode
IS_RENDER_NORMAL
The image is rendered normally. It will be displayed in
1:1 scale as stored in the image memory.
IS_RENDER_FIT_TO_WINDOW
The image size is adjusted to fit the output window.
IS_RENDER_DOWNSCALE_1_2
Displays the image at 50 % of its original size.
IS_RENDER_PLANAR_COLOR_RED
Renders the red color component of the planar format in
red.
IS_RENDER_PLANAR_COLOR_GREEN
Renders the green color component of the planar
format in green.
IS_RENDER_PLANAR_COLOR_BLUE
Renders the blue color component of the planar format
in blue.
IS_RENDER_PLANAR_MONO_RED
Renders the red color component of the planar format in
gray shades.
IS_RENDER_PLANAR_MONO_GREEN
Renders the green color component of the planar
format in gray shades.
IS_RENDER_PLANAR_MONO_BLUE
Renders the blue color component of the planar format
in gray shades.
The following options can be linked by a logical OR using the nMode parameter:
IS_RENDER_MIRROR_UPDOWN
Mirrors the displayed image along the horizontal axis.
Return values
IS_CANT_COMMUNICATE_WITH_DRIVER
Communication with the driver failed because no driver
has been loaded.
IS_CANT_OPEN_DEVICE
An attempt to initialize or select the camera failed (no
camera connected or initialization error).
IS_INVALID_CAMERA_HANDLE
Invalid camera handle
IS_INVALID_MEMORY_POINTER
Invalid pointer or invalid memory ID
IS_INVALID_PARAMETER
One of the submitted parameters is outside the valid
157
198 502

THORLABS DCU223x Specifications

General

Brand	THORLABS
Model	DCU223x
Category	Security Camera
Language	English