Gesichtserkennung
Instanz deklarieren
Wenn du einen Gesichtserkennung(FaceDetection)-Block zum Arbeitsbereich hinzufügst, wird im Python-Code automatisch die folgende Instanzdeklaration eingefügt:
face_detection = FaceDetection(0)
# wenn es mehrere Instanzen gibt
face_detection_1 = FaceDetection(1)Parameter
| Name | Art | Beschreibung | Bereich / Typ | Standardwert |
|---|---|---|---|---|
| index | Dropdown-Option | Instanznummer (beginnt bei 0) | ganze Zahl ≥ 0 | 0 |
Kamera festlegen
Legt die Kamera für die Gesichtserkennung fest.
Parameter
| Name | Art | Beschreibung | Bereich / Typ | Standardwert |
|---|---|---|---|---|
| unit | Dropdown-Option | Name des Kameragerätes | Kamerabezeichnung des Systems | - |
Python
face_detection = FaceDetection(0)
face_detection.device('')Gesichtsmodell laden
Lädt das trainierte Gesichtsmodell. Dieser Schritt ist zwingend nötig, um die Funktionen des Moduls „Gesichtserkennung" zu verwenden.
Parameter
| Name | Art | Beschreibung | Bereich / Typ | Standardwert |
|---|---|---|---|---|
| wait | Kontrollkästchen | Auf Abschluss des Ladens warten | TRUE / FALSE | TRUE |
Python
face_detection = FaceDetection(0)
face_detection.load_model(wait=True)Gesicht einmal erkennen
Findet das Gesicht im aktuellen Bild und markiert es genau einmal.
Parameter
(keine)
Python
face_detection = FaceDetection(0)
face_detection.detect_once()Kontinuierliche Gesichtserkennung starten / stoppen
Verfolgt das Gesicht im aktuellen Bild fortlaufend und markiert es auf dem Bildschirm.
Parameter
| Name | Art | Beschreibung | Bereich / Typ | Standardwert |
|---|---|---|---|---|
| unit | Dropdown-Option | Aktion | starten(start), stoppen(stop) | - |
Python
face_detection = FaceDetection(0)
# unit = "start"
face_detection.detect_continuous()
# unit = "stop"
face_detection.stop()Ergebnis anzeigen
Legt fest, ob das Ergebnis der Gesichtserkennung im Kamerabild angezeigt wird oder nicht.
Parameter
| Name | Art | Beschreibung | Bereich / Typ | Standardwert |
|---|---|---|---|---|
| on | Dropdown-Option | Anzeige ON / OFF | anzeigen(on=True), ausblenden(off=False) | TRUE |
Python
face_detection = FaceDetection(0)
face_detection.display(True)
face_detection.display(False)Position von Gesichtspartien
Gibt die Positionskoordinaten des Gesichts oder einer Gesichtspartie zurück.
Parameter
| Name | Art | Beschreibung | Bereich / Typ | Standardwert |
|---|---|---|---|---|
| unit | Dropdown-Option | Gesichtspartie | Gesicht(face), linkes Auge(left eye), rechtes Auge(right eye), linkes Ohr(left ear), rechtes Ohr(right ear), Nase(nose), Mund(mouth) | - |
| pos | Dropdown-Option | Art der Koordinate | x, y | - |
Python
face_detection = FaceDetection(0)
face_detection.face('x')
face_detection.left_eye('y')
face_detection.right_eye('x')
face_detection.left_ear('x')
face_detection.right_ear('y')
face_detection.nose('x')
face_detection.mouth('y')Gesichtsrechteck
Gibt Position und Größe des Rechtecks um den Gesichtsbereich zurück.
Parameter
| Name | Art | Beschreibung | Bereich / Typ | Standardwert |
|---|---|---|---|---|
| pos | Dropdown-Option | Angabe zum Rechteck | min. x-Position(min_x), max. x-Position(max_x), min. y-Position(min_y), max. y-Position(max_y), Breite(width), Höhe(height), Fläche(area) | - |
Python
face_detection = FaceDetection(0)
face_detection.face('min_x')
face_detection.face('width')
face_detection.face('area')Abstand zwischen zwei Partien
Gibt den Abstand zwischen zwei Gesichtspartien zurück.
Parameter
| Name | Art | Beschreibung | Bereich / Typ | Standardwert |
|---|---|---|---|---|
| unit1 | Dropdown-Option | erste Partie | face, left_eye, right_eye, left_ear, right_ear, nose, mouth | - |
| unit2 | Dropdown-Option | zweite Partie | face, left_eye, right_eye, left_ear, right_ear, nose, mouth | - |
| type | Dropdown-Option | Art des Abstands | Abstand (weggelassen oder None), horizontaler Abstand(horizontal), vertikaler Abstand(vertical) | None |
Python
face_detection = FaceDetection(0)
face_detection.get_distance('left_eye', 'right_eye') # Abstand
face_detection.get_distance('left_eye', 'right_eye', 'horizontal') # horizontaler Abstand
face_detection.get_distance('nose', 'mouth', 'vertical') # vertikaler AbstandLadezustand des Gesichtsmodells
Gibt den Ladezustand des Gesichtsmodells zurück.
Ist es noch nicht geladen, wird 0 zurückgegeben, während des Ladens 1 und nach dem Laden 2.
Parameter
(keine)
Python
face_detection = FaceDetection(0)
face_detection.model_state()Gesicht erkannt?
Ob ein Gesicht gefunden wurde
Parameter
(keine)
Python
face_detection = FaceDetection(0)
face_detection.detected()