Dieses Kapitel zeigt Ihnen die wichtigsten Funktionen der uEye-API, um Ihre uEye Kamera in eigenen Anwendungen einzubinden. Umfassende Listen der API-Funktionen nach Aufgaben gegliedert finden Sie im Kapitel Vorgehensweise.

Die mitgelieferten C++-Programmierbeispiele uEye SimpleLive und uEye SimpleAcquire veranschaulichen die genannten Schritte.

Zum Einbinden der benötigten Dateien (uEye-API und Header) siehe Abschnitt Programmierhinweise.

Öffnen Sie die Kamera

Verbinden Sie Ihre uEye Kamera mit dem PC (Installation und Anschluss). Wenn Sie eine GigE uEye Kamera verwenden, müssen Sie dieser zuvor im IDS Kameramanager eine IP-Adresse zuweisen. Siehe auch Anschluss einer GigE uEye Kamera.

Mit der Funktion is_InitCamera() wird die uEye Kamera geöffnet. Die Kamera bekommt dabei ein eindeutiges Handle zugewiesen, damit sie bei weiteren Funktionsaufrufen gezielt angesprochen werden kann (siehe Vorbereiten der Aufnahme).

Wählen Sie einen Darstellungsmodus

Zur Darstellung der Kamerabilder am PC stellt die uEye-API verschiedene Modi zur Verfügung (siehe Bilddarstellung auswählen). Um unter Windows mit wenig Aufwand ein Livebild anzuzeigen, eignet sich am besten der Direct3D-Modus. Unter Linux kann hierfür der OpenGL-Modus verwendet werden.

Der Direct3D-Modus hat den Vorteil, dass keine eigenen Bildspeicher angelegt werden müssen und die Bilderfassung vom Treiber selbst abgewickelt wird. Rufen Sie is_SetDisplayMode() auf, um den Darstellungsmodus auszuwählen. Über is_DirectRenderer() lässt sich der Direct3D-Modus dann weiter konfigurieren.

Für Fortgeschrittene: Wenn Sie direkt auf die Bilddaten zugreifen möchten, wählen Sie den Bitmap (DIB)-Modus. Um den DIB-Modus verwenden zu können, müssen Sie zunächst mit is_AllocImageMem() einen oder mehrere Speicher anlegen, diese ggf. einer Speichersequenz hinzufügen und dann jeweils einen Speicher mit is_SetImageMem() aktiv setzen. Damit das Bild auf dem Bildschirm dargestellt wird, muss nach jedem abgeschlossenen Bildeinzug die Funktion is_RenderBitmap() aufgerufen werden. Wann jeweils ein Bild für die Anzeige zur Verfügung steht, lässt sich über Events oder Messages ermitteln.

Nehmen Sie Bilder auf

Es ist sehr leicht, mit der uEye Kamera ein Livebild aufzunehmen (siehe Bilder aufnehmen). Rufen Sie einfach die Funktion is_CaptureVideo() auf, und die Kamera zieht mit der voreingestellten Bildrate ein Livebild ein. Wenn Sie stattdessen einzelne Bilder einziehen möchten, verwenden Sie die Funktion is_FreezeVideo(). Natürlich können Sie mit jeder uEye Kamera auch getriggerte Bildaufnahmen machen. Aktivieren Sie dazu vor dem Bildeinzug mit is_SetExternalTrigger() den gewünschten Modus.

Passen Sie Bildrate, Helligkeit und Farben an

Um beispielsweise die Bildrate zu ändern, verwenden Sie is_SetFrameRate(). Mit is_SetColorMode() stellen Sie den Farbmodus ein. Die Helligkeit des Bildes steuern Sie über die Belichtungszeit mit is_Exposure(). Eine Automatische Regelung für die Bildhelligkeit und andere Parameter lässt sich über is_SetAutoParameter() aktivieren (siehe Kameraparameter einstellen).

Wenn Sie eine Farbkamera verwenden, sollten Sie die Farbkorrektur einschalten, um kräftige Farben für die Darstellung am Bildschirm zu erhalten (is_SetColorCorrection()). Um eine Farbkamera auf das Umgebungslicht abzustimmen, ist es sehr wichtig, einen Weißabgleich durchzuführen. Dazu rufen Sie ebenfalls die Funktion is_SetAutoParameter() auf.

Speichern Sie ein Bild ab

Mit der Funktion is_ImageFile() kann das aktuelle Bild als BMP- oder JPEG-Datei abgespeichert werden (siehe Bilder und Videos speichern). Um ein bestimmtes Bild abzuspeichern, eignet sich der Einzelbildeinzug besser als die Livebildfunktion.

Schließen Sie die Kamera

Wenn Sie ihr Programm beenden möchten, schließen Sie die Kamera über is_ExitCamera(). Die Kamera und der dafür angelegte Speicher werden dabei automatisch wieder freigegeben. Die zuvor eingestellten Kameraparameter werden allerdings verworfen. Wenn Sie bestimmte Einstellungen speichern möchten, können Sie dies mit der Funktion is_ParameterSet() tun. Über die gleiche Funktion können Sie die Einstellungen beim nächsten Programmstart leicht wieder geladen werden.