is_InitCamera

USB 2.0

USB 3.0

GigE

USB 2.0

USB 3.0

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.

Übergabeparameter

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 \| IS_USE_DEVICE_ID	Die Kamera wird über die Device-ID statt der Kamera-ID geöffnet. Zur Device-ID siehe is_GetCameraList().
*phCam \| IS_ALLOW_STARTER_FW_UPLOAD	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ät ist bereits angeschlossen.
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

•is_SetStarterFirmware()

Beispiel

//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#)

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.