Please enable JavaScript to view this site.

IDS Software Suite 4.96.1

Windows_Logo
Linux_Logo

USB 2.0

USB 3.x

GigE

-

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.

hint_info

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

hint_info

Note that the rotation of the image is only possible if the X and Y offset are 0 (see is_SetDisplayPos()). In addition, the image cannot be mirrored (IS_RENDER_MIRROR_UPDOWN). In this case, the function returns IS_NOT_SUPPORTED.

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 range or is not supported for this sensor or is not available in this mode.

IS_IO_REQUEST_FAILED

An IO request from the uEye driver failed. Possibly the versions of the ueye_api.dll (API) and the driver file (ueye_usb.sys or ueye_eth.sys) do not match.

IS_NO_SUCCESS

General error message

IS_NOT_SUPPORTED

The camera model used here does not support this function or setting.

IS_SUCCESS

Function executed successfully

Related functions

is_AllocImageMem()

is_SetColorMode()

is_SetDisplayMode()

is_DirectRenderer()

Example 1

// Fit image to window and display it upside down:
is_RenderBitmap (hCam, nMemId, hwnd, IS_RENDER_FIT_TO_WINDOW | IS_RENDER_MIRROR_UPDOWN);

Example 2

/* Displays the image rotated clockwise 90 degrees */
is_RenderBitmap(hCam, nMemId, hwnd, IS_RENDER_NORMAL | IS_RENDER_ROTATE_90);

Example 3

/* Displays the image rotated clockwise 180 degrees, the display mode is fit-to-window */
is_RenderBitmap(hCam, nMemId, hwnd, IS_RENDER_FIT_TO_WINDOW | IS_RENDER_ROTATE_180);

Example 4

/* Displays the image rotated clockwise by 270 degrees, the display mode is scaled by factor 2 */
is_RenderBitmap(hCam, nMemId, hwnd, IS_RENDER_DOWNSCALE_1_2 | IS_RENDER_ROTATE_270);

Sample programs

SimpleAcquire (C++)

SimpleLive (C++)

© 2022 IDS Imaging Development Systems GmbH