 |
 |
|---|---|
USB 2.0 USB 3.x 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.
|
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 |
|
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
//Bild in Fenster einpassen und auf dem Kopf darstellen:
is_RenderBitmap (hCam, nMemId, hwnd, IS_RENDER_FIT_TO_WINDOW | IS_RENDER_MIRROR_UPDOWN);
/* Zeigt das Bild um 90 Grad gedreht an */
is_RenderBitmap(hCam, nMemId, hwnd, IS_RENDER_NORMAL | IS_RENDER_ROTATE_90);
/* 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);
/* 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++)
