is_RenderBitmap

uEye Kamera-Handbuch Version 4.92


is_RenderBitmap

Windows_Logo
Linux_Logo

USB 2.0

USB 3.0

GigE

-

Syntax

INT is_RenderBitmap (HIDS hCam, INT nMemID, HWND hwnd, INT nMode)

Beschreibung

Mit is_RenderBitmap() wird ein Bild aus einem Bildspeicher in dem angegebenen Fenster ausgegeben. Zur Darstellung werden Windows-Bitmapfunktionen verwendet. Die Darstellung erfolgt in dem Format, das beim Allozieren des Bildspeichers festgelegt wurde.

In der Funktion is_AllocImageMem() legt der Parameter bitspixel die Farbtiefe und die Darstellungsart fest. RGB16 und RGB15 benötigen denselben Speicherplatz, können aber anhand des Parameters bitspixel differenziert werden.

hint_attention

is_RenderBitmap() kann Y8- und RGB-Formate darstellen. Zur Darstellung YUV/YCbCr-Formaten muss die Funktion is_DirectRenderer() verwendet werden (siehe auch Farb- und Speicherformate).

Übergabeparameter

hCam

Handle auf Kamera

nMemID

ID des Bildspeichers, der angezeigt werden soll

hwnd

Fenster-Handle des Ausgabefensters

hint_info

Beachten Sie, dass das Rotieren des Bilds nur möglich ist, wenn der X- und Y-Offset den Wert 0 haben (siehe is_SetDisplayPos()). Außerdem kann das Bild nicht gespiegelt werden (IS_RENDER_MIRROR_UPDOWN). In diesem Fällen liefert die Funktion den Rückgabewert IS_NOT_SUPPORTED zurück.

Rückgabewert

IS_CANT_COMMUNICATE_WITH_DRIVER

Kommunikation mit dem Kameratreiber schlug fehl, weil kein Treiber geladen ist.

IS_CANT_OPEN_DEVICE

Ein Versuch die Kamera zu öffnen schlug fehl (Kamera nicht vorhanden oder Fehler beim Initialisieren).

IS_INVALID_CAMERA_HANDLE

Ungültiges Kamera-Handle

IS_INVALID_MEMORY_POINTER

Ungültiger Zeiger oder ungültige Speicher-ID

IS_INVALID_PARAMETER

Einer der übergebenen Parameter ist außerhalb des gültigen Bereichs, oder für diesen Sensor nicht unterstützt, bzw. in diesem Modus nicht zugänglich.

IS_IO_REQUEST_FAILED

Eine IO Anforderung des uEye Treibers schlug fehl. Eventuell passen die Versionen der Dateien ueye_api.dll (API) und ueye_usb.sys bzw. ueye_eth.sys (Treiber) nicht zusammen.

IS_NO_SUCCESS

Allgemeine Fehlermeldung

IS_NOT_SUPPORTED

Das verwendete Kameramodell unterstützt diese Funktion oder Einstellung nicht.

IS_SUCCESS

Funktion erfolgreich

Verwandte Funktionen

•is_AllocImageMem()

•is_SetColorMode()

•is_SetDisplayMode()

•is_DirectRenderer()

Beispiel 1

//Bild in Fenster einpassen und auf dem Kopf darstellen:
is_RenderBitmap (hCam, nMemID, hwnd, IS_RENDER_FIT_TO_WINDOW | IS_RENDER_MIRROR_UPDOWN);

Beispiel 2

/* Zeigt das Bild um 90 Grad gedreht an */
is_RenderBitmap(hCam, nMemId, hwnd, IS_RENDER_NORMAL | IS_RENDER_ROTATE_90);

Beispiel 3

/* Zeigt das Bild um 180 Grad gedreht an, der Display-Modus ist Fit-to-Window */
is_RenderBitmap(hCam, nMemId, hwnd, IS_RENDER_FIT_TO_WINDOW | IS_RENDER_ROTATE_180);

Beispiel 4

/* Zeigt das Bild um 270 Grad gedreht an, der Display-Modus ist um Faktor 2 skaliert */
is_RenderBitmap(hCam, nMemId, hwnd, IS_RENDER_DOWNSCALE_1_2 | IS_RENDER_ROTATE_270);

Beispielprogramme

•Simple Acquire (C++)

•Simple Live (C++)

Haben Sie Verbesserungshinweise? Senden Sie ein kurzes Feedback zu diesem Kapitel. Vielen Dank!
Bei technischen Fragen wenden Sie sich bitte an Ihren lokalen Händler oder nutzen Sie das Support-Formular auf unserer Internetseite.


© 2019 IDS Imaging Development Systems GmbH
https://de.ids-imaging.com