is_RenderBitmap

USB 2.0

USB 3.0

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.

Achtung

is_RenderBitmap() can render Y8 and RGB formats. For displaying YUV/YCbCr formats please use the is_DirectRenderer() function.

Input parameters

hCam

Camera handle

nMemID

ID of the image memory whose contents is to be displayed

hwnd

Output window handle

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_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 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_SUCCESS	Function executed successfully

Related functions

Example

Fit image to window and display it upside down:

is_RenderBitmap (hCam, nMemID, hwnd, IS_RENDER_FIT_TO_WINDOW | IS_RENDER_MIRROR_UPDOWN);

Sample programs

•SimpleAcquire (C++)

•SimpleLive (C++)

Suggestion for improvement? Send us your short Feedback on this chapter. Thank you very much!

For technical questions please contact you local distributor or use the support form on our website.

Home > C: Programming > Function descriptions >	History back Previous chapter Next chapter Print
is_RenderBitmap