Is_Renderbitmap - THORLABS DCU223x Operation Manual And Sdk

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
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()
Input parameters
hCam
nMemID
hwnd
nMode
IS_RENDER_NORMAL
IS_RENDER_FIT_TO_WINDOW
IS_RENDER_DOWNSCALE_1_2
IS_RENDER_PLANAR_COLOR_RED
IS_RENDER_PLANAR_COLOR_GREEN
IS_RENDER_PLANAR_COLOR_BLUE
IS_RENDER_PLANAR_MONO_RED
IS_RENDER_PLANAR_MONO_GREEN
IS_RENDER_PLANAR_MONO_BLUE
The following options can be linked by a logical OR using the nMode parameter:
IS_RENDER_MIRROR_UPDOWN
Return values
IS_CANT_COMMUNICATE_WITH_DRIVER
IS_CANT_OPEN_DEVICE
IS_INVALID_CAMERA_HANDLE
IS_INVALID_MEMORY_POINTER
IS_INVALID_PARAMETER
© 2013 Thorlabs GmbH
-
is_AllocImageMem()
function (see also Color and memory formats
198
function defines the color depth and display type.
157
).
502
Camera handle
ID of the image memory whose contents is to be
displayed
Output window handle
The image is rendered normally. It will be displayed in
1:1 scale as stored in the image memory.
The image size is adjusted to fit the output window.
Displays the image at 50 % of its original size.
Renders the red color component of the planar format in
red.
Renders the green color component of the planar
format in green.
Renders the blue color component of the planar format
in blue.
Renders the red color component of the planar format in
gray shades.
Renders the green color component of the planar
format in gray shades.
Renders the blue color component of the planar format
in gray shades.
Mirrors the displayed image along the horizontal axis.
Communication with the driver failed because no driver
has been loaded.
An attempt to initialize or select the camera failed (no
camera connected or initialization error).
Invalid camera handle
Invalid pointer or invalid memory ID
One of the submitted parameters is outside the valid
4 Programming (SDK)
297