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

is_RenderBitmap

uEye Camera Manual Version 3.80

is_RenderBitmap

Windows_Logo

Linux_Logo

USB 2.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

nMode


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.

The following options can be linked by a logical OR using the nMode parameter:


IS_RENDER_MIRROR_UPDOWN

Mirrors the displayed image along the horizontal axis.

Return Values

IS_SUCCESS

Function executed successfully

IS_NO_SUCCESS

General error message

Related Functions

is_AllocImageMem()
is_SetColorMode()
is_SetDisplayMode()
is_DirectRenderer()

Code Sample

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!


© 2010 IDS Imaging Development Systems GmbH
http://www.ids-imaging.com