 |
 |
|---|---|
USB 2.0 USB 3.x GigE |
USB 2.0 USB 3.x GigE |
Syntax
INT is_InitCamera (HIDS* phCam, HWND hWnd)
Beschreibung
is_InitCamera() öffnet den Treiber und stellt die Verbindung zur Kamera her. In dieser Funktion wird nach erfolgreicher Initialisierung das Handle auf die Kamera vergeben. Alle nachfolgenden Funktionen benötigen dieses Handle als ersten Parameter.
Für die Bildausgabe mit Direct3D oder OpenGL kann ein Handle auf das Ausgabefenster übergeben werden.
|
Starter-Firmware bei GigE uEye Kameras Bei diesen Kameras wird die Initialisierung mit einer Fehlermeldung beendet, wenn die Starter-Firmware der Kamera mit dem installierten Treiber inkompatibel ist. Um die Kamera öffnen zu können, muss zunächst die passende Starter-Firmware in die Kamera geschrieben werden. Dies kann mit der Funktion is_InitCamera() über einen entsprechenden Parameter vorgenommen werden (siehe Tabelle Übergabeparameter). Die Aktualisierung der Firmware kann bis zu 20 Sekunden benötigen. Während dieser Zeit darf die Kamera nicht vom PC oder vom Stromnetz getrennt werden. Andernfalls kann es zur Fehlfunktion der Kamera kommen. Bei Kameramodellen GigE uEye SE/RE: Wenn die Kamera zuvor mit einer Treiberversion kleiner 3.40 geöffnet wurde, muss die Kamera-Firmware manuell über den IDS Kameramanager aktualisiert werden. Die automatische Aktualisierung der Firmware wird ab der Treiberversion 3.40 unterstützt. |
|
Hinweis zum Multikamerabetrieb Wenn mehrere Kameras parallel in einem System verwendet werden, sollte jeder Kamera eine eindeutige Kamera-ID zugewiesen werden. Um mit is_InitCamera() eine bestimmte Kamera zu öffnen, muss zuvor das Handle phCam mit der gewünschten Kamera-ID vorbelegt werden. Um ohne Kamera-ID die nächste freie Kamera zu öffnen, muss phCam mit 0 vorbelegt werden. |
phCam |
Zeiger auf den Handle der Kamera Der Inhalt des Zeigers hat beim Aufruf der Funktion folgende Bedeutung: •0: Die erste freie Kamera wird geöffnet •1-254: Die Kamera mit dieser Kamera-ID wird geöffnet |
*phCam | |
Die Kamera wird über die Device-ID statt der Kamera-ID geöffnet. Zur Device-ID siehe is_GetCameraList(). |
*phCam | |
Beim Öffnen der Kamera wird geprüft, ob die Kamera eine neuere Version der Starter Firmware benötigt. Falls dies der Fall ist, wird die neue Starter Firmware automatisch aktualisiert. Um Programme abwärtskompatibel zu halten, sollte is_InitCamera() immer erst ohne den Parameter IS_ALLOW_STARTER_FW_UPLOAD aufgerufen werden. Erst im Fehlerfall sollte der Aufruf mit diesem Parameter erfolgen (siehe Beispiel unten). |
hWnd |
Handle auf das Fenster, in dem das Direct3D- oder OpenGL-Bild dargestellt werden soll. Bei hWnd = NULL wird der DIB-Modus zur Bildausgabe verwendet. |
Rückgabewert
IS_ALL_DEVICES_BUSY |
Alle Kameras sind in Verwendung |
IS_BAD_STRUCTURE_SIZE |
Eine interne Struktur hat die falsche Größe. |
IS_CANT_ADD_TO_SEQUENCE |
Der Bildspeicher befindet sich bereits in der Sequenz und kann nicht doppelt hinzugefügt werden. |
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_CANT_OPEN_REGISTRY |
Fehler beim Öffnen eines Windows Registry Keys |
IS_CANT_READ_REGISTRY |
Fehler beim Lesen von Einstellungen aus der Windows Registry |
IS_CAPTURE_RUNNING |
Es läuft bereits eine Aufnahme, die zuerst beendet werden muss. |
IS_CRC_ERROR |
Beim Lesen der Einstellungen trat ein Problem mit der CRC-Fehlerkorrektur auf. |
IS_DEVICE_ALREADY_PAIRED |
Das Geräte wird bereits vom System verwendet oder wird von einem anderen System verwendet. (Kamera wurde geöffnet und ist zu einem Gerät "gepaired"). |
IS_DEVICE_NOT_COMPATIBLE |
Die Kamera ist nicht kompatibel zu den Treibern. |
IS_DR_CANNOT_CREATE_SURFACE |
Bild- oder Overlay-Surface konnten nicht angelegt werden. |
IS_DR_CANNOT_CREATE_TEXTURE |
Die Textur konnte nicht angelegt werden. |
IS_DR_CANNOT_CREATE_VERTEX_BUFFER |
Der Vertex-Puffer konnte nicht angelegt werden. |
IS_DR_DEVICE_OUT_OF_MEMORY |
Nicht genügend Grafikspeicher verfügbar. |
IS_DR_LIBRARY_NOT_FOUND |
Die DirectRenderer-Bibliothek konnte nicht gefunden werden. |
IS_ERROR_CPU_IDLE_STATES_CONFIGURATION |
Die Konfiguration des CPU-Ruhestands ist fehlgeschlagen. |
IS_FILE_WRITE_OPEN_ERROR |
Datei kann nicht zum Schreiben oder Lesen geöffnet werden. |
IS_INCOMPATIBLE_SETTING |
Die Funktion ist nicht möglich, da andere Einstellungen nicht kompatibel sind. |
IS_INVALID_BUFFER_SIZE |
Der Bildspeicher hat die falsche Größe um das Bild im gewünschten Format aufzunehmen. |
IS_INVALID_CAMERA_TYPE |
Kameratyp der .ini-Datei stimmt nicht mit dem aktuellen Kameramodell überein. |
IS_INVALID_CAPTURE_MODE |
Die Funktion kann im aktuellen Betriebsmodus der Kamera (Freilaufend, Trigger oder Standby) nicht ausgeführt werden. |
IS_INVALID_DEVICE_ID |
Die Device-ID ist ungültig. Gültige IDs beginnen bei 1 für USB-Kameras und bei 1001 für Gigabit-Ethernet-Kameras. |
IS_INVALID_EXPOSURE_TIME |
Diese Einstellung ist bei der aktuell eingestellten Belichtungszeit nicht möglich. |
IS_INVALID_CAMERA_HANDLE |
Ungültiges Kamera-Handle |
IS_INVALID_IP_CONFIGURATION |
Die Konfiguration der IP-Adresse ist ungültig. |
IS_INVALID_MEMORY_POINTER |
Ungültiger Zeiger oder ungültige Speicher-ID |
IS_INVALID_MODE |
Kamera im Standby, Funktion nicht erlaubt |
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_INVALID_PIXEL_CLOCK |
Diese Einstellung ist bei dem aktuell eingestellten Pixeltakt nicht möglich. |
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_NETWORK_CONFIGURATION_INVALID |
Die Konfiguration der Netzwerkkarte ist ungültig. |
IS_NETWORK_FRAME_SIZE_INCOMPATIBLE |
Die Bildgrößen-Einstellungen der Kamera sind nicht kompatibel zur PC-Netzwerkkarte. |
IS_NO_ACTIVE_IMG_MEM |
Kein aktivierter Bildspeicher vorhanden. Der Speicher muss mit der Funktion is_SetImageMem() aktiviert werden, oder es muss mit der Funktion is_AddToSequence() eine Sequenz aufgebaut werden. |
IS_NO_IMAGE_MEM_ALLOCATED |
Der Treiber konnte keinen Speicher reservieren. |
IS_NO_IR_FILTER |
Kein IR-Filter vorhanden |
IS_NO_SUCCESS |
Allgemeine Fehlermeldung |
IS_NOT_CALIBRATED |
Die Kamera enthält keine Kalibrierungsdaten. |
IS_NOT_SUPPORTED |
Das verwendete Kameramodell unterstützt diese Funktion oder Einstellung nicht. |
IS_NULL_POINTER |
Ungültiges Array |
IS_OUT_OF_MEMORY |
Es konnte kein Speicher alloziert werden. |
IS_SEQUENCE_BUF_ALREADY_LOCKED |
Der Speicher konnte nicht gelockt werden. Der Zeiger auf den Buffer ist ungültig. |
IS_STARTER_FW_UPLOAD_NEEDED |
Die Starter Firmware der Kamera ist mit dem Treiber inkompatibel und muss aktualisiert werden. |
IS_SUCCESS |
Funktion erfolgreich |
IS_SUBNET_MISMATCH |
Das Subnet der Kamera und der PC-Netzwerkkarte sind unterschiedlich. |
IS_SUBNETMASK_MISMATCH |
Die Subnet-Maske der Kamera und der PC-Netzwekkarte sind unterschiedlich. |
IS_TIMED_OUT |
Ein Timeout trat auf. Eine Bildaufnahme konnte nicht in der vorgeschriebenen Zeit beendet werden. |
IS_TRIGGER_ACTIVATED |
Die Funktion ist nicht möglich, da die Kamera auf ein Triggersignal wartet. |
Verwandte Funktionen
//Kamera mit ID 1 öffnen
HIDS hCam = 1;
INT nRet = is_InitCamera (&hCam, NULL);
if (nRet != IS_SUCCESS)
{
//Prüfen, ob eine GigE uEye SE neue Starter Firmware benötigt
if (nRet == IS_STARTER_FW_UPLOAD_NEEDED)
{
//Zeit für das Aktualisieren der Starter Firmware ermitteln
INT nTime;
is_GetDuration (hCam, IS_SE_STARTER_FW_UPLOAD, &nTime);
/*
... z. B. Fortschrittsbalken in separatem Thread anzeigen lassen
*/
//Beim Initialisieren neue Starter Firmware hochladen
hCam = hCam | IS_ALLOW_STARTER_FW_UPLOAD;
nRet = is_InitCamera (&hCam, NULL);
/*
Fortschrittsbalken beenden
*/
}
}
Beispielprogramme
•uEye Multiple Camera Scan (C++)
•uEye Console (C++)
•uEye C# Demo (C#)
