© 2013 Thorlabs GmbH
4 Programming (SDK)
297
4.3.71 is_RenderBitmap
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
ID of the image memory whose contents is to be
displayed
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.
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:
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.
An attempt to initialize or select the camera failed (no
camera connected or initialization error).
IS_INVALID_MEMORY_POINTER
Invalid pointer or invalid memory ID
One of the submitted parameters is outside the valid
157
198 502