Vorheriges Kapitel Zurück zur Kapitelübersicht Nächstes Kapitel Kapitel drucken

C: Programmierung > Funktionsbeschreibungen > is_FaceDetection

is_FaceDetection

uEye Kamera-Handbuch Version 4.92

is_FaceDetection

Windows_Logo
Linux_Logo

USB 3 uEye XC

USB 3 uEye XC

Syntax

INT is_FaceDetection (HIDS hCam, UINT nCommand, void *pParam, UINT nSizeOfParam)

Beschreibung

Mit is_FaceDetection() kann bei manchen uEye-Modellen die interne Gesichtsdetektion gesteuert werden.

Über den Übergabeparameter nCommand wird dabei der Funktionsmodus gewählt. Der Übergabeparameter pParam ist abhängig vom Funktionsmodus unterschiedlich belegt; bei Funktionen zum Setzen oder Rücklesen eines Wertes enthält pParam einen Zeiger auf eine Variable vom Typ UINT. Die Größe des Speicherbereichs, auf den pParam verweist, wird im Übergabeparameter nSizeOfParam angegeben.

hint_info

Diese Funktion wird derzeit nur vom Kameramodell UI-3013XC unterstützt.

Orientierung der Kamera

Um die Erkennungssicherheit bei um 90° gedrehter Kamera zu erhöhen, kann eine Orientierungsvorgabe (Suchwinkel) angegeben werden.

Auf dem Kopf stehende Gesichter werden nicht erkannt. Um auf dem Kopf stehende Gesichter erkennen zu können, muss die Kamera gedreht oder die Bildspiegelung mit is_SetRopEffect() eingeschaltet werden.

Auflösung der Gesichtsdetektion

Die Koordinaten für Position und Größe der erkannten Gesichter sind abhängig von der eingestellten Bildgröße. Die Koordinate (0,0) liegt in der oberen linken Ecke des Bildes.

Aktualisierung der Daten

Das Polling der Gesichtsdetektion ist auf einen Intervall von 500 ms beschränkt, um die Belastung bei der Datenübertragung gering zu halten.

hint_info

Bei der UI-3013XC ist die Gesichtsdetektion nur im Livebild-Modus aktiv nicht aber im Einzelbild-Modus.

Übergabeparameter

hCam

Handle auf Kamera

FDT_CMD_GET_CAPABILITIES

Gibt die von der Kamera unterstützten Funktionen zur Gesichtsdetektion zurück.

•pParam: Zeiger auf Bitmaske vom Typ UINT
In der Bitmaske werden die Statusflags aus FDT_CAPABILITY_FLAGS zurückgegeben.

•nSizeOfParam: 4

Gesichtsdetektion starten/stoppen

FDT_CMD_SET_ENABLE

Aktiviert die Gesichtsdetektion.

•pParam: NULL

•nSizeOfParam: 0

FDT_CMD_SET_DISABLE

Deaktiviert die Gesichtsdetektion.

•pParam: NULL

•nSizeOfParam: 0

FDT_CMD_GET_ENABLE

Gibt den Status der Gesichtsdetektion zurück (aktiviert/deaktiviert).

•pParam: Zeiger auf Variable vom Typ UINT
In der Bitmaske wird zurückgegeben:
0 = Gesichtsdetektion deaktiviert
1 = Gesichtsdetektion aktiviert

•nSizeOfParam: 4

Orientierungsvorgabe für die Gesichtsdetektion

FDT_CMD_SET_SEARCH_ANGLE

Setzt die Orientierungs-Vorgabe für die Gesichtsdetektion.

Es können Winkel von 0°, 90° und 270° (im Uhrzeigersinn) angegeben werden. Die Erkennung liefert dann nur solche Gesichter zurück, die der vorgegebenen Orientierung entsprechen. Diese Funktion ist beispielsweise geeignet, um die Treffsicherheit bei um 90° gedrehter Kameraposition zu erhöhen.

Um auf dem Kopf stehende Gesichter erkennen zu können, muss die Kamera gedreht oder die Bildspiegelung mit is_SetRopEffect() eingeschaltet werden.

•pParam: Zeiger auf Variable vom Typ UINT, in der der Winkel von 0, 90 oder 270 Grad übergeben wird.

•nSizeOfParam: 4

FDT_CMD_GET_SEARCH_ANGLE

Gibt die aktuelle Orientierungs-Vorgabe für die Gesichtsdetektion zurück.

Siehe auch Informationen zu FDT_CMD_SET_SEARCH_ANGLE

•pParam: Zeiger auf Variable vom Typ UINT, in der der Winkel von 0, 90 oder 270 Grad zurückgegeben wird.

•nSizeOfParam: 4

FDT_CMD_SET_SEARCH_ANGLE_ENABLE

Aktiviert die Orientierungs-Vorgabe für die Gesichtsdetektion.

•pParam: NULL

•nSizeOfParam: 0

FDT_CMD_SET_SEARCH_ANGLE_DISABLE

Deaktiviert die Orientierungs-Vorgabe für die Gesichtsdetektion.

•pParam: NULL

•nSizeOfParam: 0

FDT_CMD_GET_SEARCH_ANGLE_ENABLE

Gibt den Status der Orientierungs-Vorgabe für die Gesichtsdetektion zurück.

•pParam: NULL

•nSizeOfParam: 0

Erkannte Gesichter abfragen und markieren

FDT_CMD_GET_FACE_LIST

Gibt eine Liste mit Informationen zu erkannten Gesichtern zurück.

Die erkannten Gesichter werden der Größe nach geordnet ausgegeben.

Die Anzahl der Listenelemente kann mit FDT_CMD_GET_NUMBER_FACES abgefragt werden.

•pParam: Zeiger auf Liste vom Typ FDT_INFO_LIST

•nSizeOfParam: Größe der Liste
Größe von FDT_INFO_LIST + (Anzahl Gesichter - 1) * Größe von (FDT_INFO_EL)

FDT_CMD_GET_NUMBER_FACES

Gibt die aktuelle Anzahl erkannter Gesichter zurück.

•pParam: Zeiger auf Variable vom Typ UINT, in der die Anzahl erkannter Gesichter zurückgegeben wird.

•nSizeOfParam: 4

FDT_CMD_GET_MAX_NUM_FACES

Gibt die maximale Anzahl Gesichter zurück, die die Kamera erkennen kann.

•pParam: Zeiger auf Variable vom Typ UINT, in der die maximale Anzahl Gesichter zurückgegeben wird.

•nSizeOfParam: 4

FDT_CMD_SET_INFO_MAX_NUM_OVL

Setzt die maximale Anzahl Gesichter, die im Livebild als Overlay markiert werden.

Die erkannten Gesichter werden mit rechteckigen Rahmen im Bild hervorgehoben. Das größte erkannte Gesicht wird mit einem grünen, alle anderen mit einem weißen Rahmen markiert. Die Breite der Rahmenlinie kann über FDT_CMD_SET_INFO_OVL_LINE_WIDTH eingestellt werden.

•pParam: Zeiger auf Variable vom Typ UINT, in der die maximale Anzahl zu markierender Gesichter übergeben wird.

•nSizeOfParam: 4

FDT_CMD_GET_INFO_MAX_NUM_OVL

Gibt die maximale Anzahl Gesichter zurück, die im Livebild als Overlay markiert werden.

•pParam: Zeiger auf Variable vom Typ UINT, in der die maximale Anzahl zu markierender Gesichter zurückgegeben wird.

•nSizeOfParam: 4

FDT_CMD_SET_INFO_OVL_LINE_WIDTH

Setzt die Rahmenbreite für die Markierung erkannter Gesichter im Livebild.

•pParam: Zeiger auf Variable vom Typ UINT, in der die Rahmenbreite zu markierender Gesichter übergeben wird.

•nSizeOfParam: 4

FDT_CMD_GET_INFO_OVL_LINE_WIDTH

Gibt die Rahmenbreite für die Markierung erkannter Gesichter im Livebild zurück.

•pParam: Zeiger auf Variable vom Typ UINT, in der die Rahmenbreite zurückgegeben wird.

•nSizeOfParam: 4

pParam

Zeiger auf Funktionsparameter, der abhängig von nCommand unterschiedlich belegt ist.

nSizeOfParam

Größe des Speicherbereichs in Byte, auf den pParam verweist.

Statusflags aus FDT_CAPABILITY_FLAGS

FDT_CAP_SUPPORTED

Kamera unterstützt Gesichtsdetektion

FDT_CAP_SEARCH_ANGLE

Gesichtsdetektion unterstützt Vorgabe der Orientierung

FDT_CAP_SEARCH_AOI

Gesichtsdetektion unterstützt Vorgabe des Suchbereichs

FDT_CAP_INFO_POSX

Gesichtsdetektion unterstützt Ausgabe der X-Position eines Gesichts

FDT_CAP_INFO_POSY

Gesichtsdetektion unterstützt Ausgabe der Y-Position eines Gesichts

FDT_CAP_INFO_WIDTH

Gesichtsdetektion unterstützt Ausgabe der Breite eines Gesichts

FDT_CAP_INFO_HEIGHT

Gesichtsdetektion unterstützt Ausgabe der Höhe eines Gesichts

FDT_CAP_INFO_ANGLE

Gesichtsdetektion unterstützt Ausgabe der Orientierung eines Gesichts

FDT_CAP_INFO_POSTURE

Gesichtsdetektion unterstützt Ausgabe der Blickrichtung eines Gesichts

FDT_CAP_INFO_FACENUMBER

Gesichtsdetektion unterstützt Ausgabe der Anzahl erkannter Gesichter

FDT_CAP_INFO_OVL

Gesichtsdetektion unterstützt Markierung erkannter Gesichter als Bild-Overlay

FDT_CAP_INFO_NUM_OVL

Gesichtsdetektion unterstützt Setzen der max. Anzahl markierter Gesichter

FDT_CAP_INFO_OVL_LINEWIDTH

Gesichtsdetektion unterstützt Einstellung der Rahmenbreite der Markierung

Inhalt der Liste erkannter Gesichter FDT_INFO_LIST

UINT

nSizeOfListEntry

Muss mit der Größe eines Listenelements in Byte vorbelegt werden

UINT

nNumDetectedFaces

Gibt die Anzahl erkannter Gesichter zurück

UINT

nNumListElements

Muss mit der Anzahl von Listenelementen vorbelegt werden

UINT

nReserved[4]

Reserviert

FDT_INFO_EL

FaceEntry

Erstes Listenelement. Der Speicherbereich für weitere Listenelemente muss direkt an dieses Element anschließen.

Inhalt des Listenelements FDT_INFO_EL

INT

nFacePosX

X-Position des Gesichts (linke obere Ecke)

INT

nFacePosY

Y-Position des Gesichts (linke obere Ecke)

INT

nFaceWidth

Breite des Gesichts

INT

nFaceHeight

Höhe des Gesichts.

INT

nAngle

Orientierung des Gesichts:

0/90/270: Winkel in Grad (0° entspricht der 12-Uhr-Position)

-1: Undefiniert

UINT

nPosture

Blickrichtung des Gesichts, siehe Tabelle unten

0...8

UEYETIME

TimestampSystem

Struktur mit Zeitstempel-Informationen im Format der PC-Systemzeit, siehe is_GetImageInfo(). Die zeitliche Auflösung beträgt ca. 15 ms.

UINT64

nReserved

Reserviert

UINT

nReserved2[4]

Reserviert

Mögliche Werte für die Blickrichtung (Posture)

0

1

2
FaceDetect_Posture_0
FaceDetect_Posture_1
FaceDetect_Posture_2

3

4

5
FaceDetect_Posture_3
FaceDetect_Posture_4
FaceDetect_Posture_5

6

7

8
FaceDetect_Posture_6
FaceDetect_Posture_7
FaceDetect_Posture_8

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_CAPTURE_MODE

Die Funktion kann im aktuellen Betriebsmodus der Kamera (Freilaufend, Trigger oder Standby) nicht ausgeführt werden.

IS_INVALID_CAMERA_HANDLE

Ungültiges Kamera-Handle

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_OUT_OF_MEMORY

Es konnte kein Speicher alloziert werden.

IS_SUCCESS

Funktion erfolgreich

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