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.
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 |
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
// Fit image to window and display it upside down:
is_RenderBitmap (hCam, nMemId, hwnd, IS_RENDER_FIT_TO_WINDOW | IS_RENDER_MIRROR_UPDOWN);
/* Displays the image rotated clockwise 90 degrees */
is_RenderBitmap(hCam, nMemId, hwnd, IS_RENDER_NORMAL | IS_RENDER_ROTATE_90);
/* 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);
/* 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++)