Rilevamento dettagliato del volto
Dichiarare l'istanza
Se aggiungi un blocco di Rilevamento dettagliato del volto (DetailedFaceDetection) all'area di lavoro, nel codice Python viene inserita automaticamente la dichiarazione di istanza seguente:
detailed_face_detection = DetailedDetailedFaceDetection(0)
# se ci sono più istanze
detailed_face_detection_1 = DetailedDetailedFaceDetection(1)Parametri
| Nome | Tipo | Descrizione | Intervallo / Tipo | Valore predefinito |
|---|---|---|---|---|
| index | Opzione di elenco | Numero dell'istanza (parte da 0) | intero maggiore o uguale a 0 | 0 |
Scegliere la fotocamera
Imposta la fotocamera per il rilevamento del volto.

Parametri
| Nome | Tipo | Descrizione | Intervallo / Tipo | Valore predefinito |
|---|---|---|---|---|
| unit | Opzione di elenco | Nome della fotocamera | etichette delle fotocamere del sistema | - |
Python
detailed_face_detection = DetailedDetailedFaceDetection(0)
detailed_face_detection.device('')Caricare il modello
Carica il modello del viso addestrato. Questa operazione è indispensabile per poter usare le funzioni del modulo «Rilevamento dettagliato del volto».

Parametri
| Nome | Tipo | Descrizione | Intervallo / Tipo | Valore predefinito |
|---|---|---|---|---|
| wait | Casella di controllo | Se aspettare la fine del caricamento | TRUE / FALSE | TRUE |
Python
detailed_face_detection = DetailedDetailedFaceDetection(0)
detailed_face_detection.load_model(wait=True)Rilevare una volta
Cerca il viso presente nell'immagine attuale e lo mostra una volta sola.

Parametri
(nessuno)
Python
detailed_face_detection = DetailedDetailedFaceDetection(0)
detailed_face_detection.detect_once()Avviare / arrestare il rilevamento continuo
Segue in continuo il volto presente nell'immagine attuale e lo mostra sullo schermo.

Parametri
| Nome | Tipo | Descrizione | Intervallo / Tipo | Valore predefinito |
|---|---|---|---|---|
| unit | Opzione di elenco | Azione | avvia(start), arresta(stop) | - |
Python
detailed_face_detection = DetailedDetailedFaceDetection(0)
# unit = "start"
detailed_face_detection.detect_continuous()
# unit = "stop"
detailed_face_detection.stop()Mostrare il risultato del rilevamento
Decide se mostrare o no il risultato del rilevamento del volto sull'immagine della fotocamera.

Parametri
| Nome | Tipo | Descrizione | Intervallo / Tipo | Valore predefinito |
|---|---|---|---|---|
| on | Opzione di elenco | Visualizzazione ON / OFF | mostra(on=True), nascondi(off=False) | TRUE |
Python
detailed_face_detection = DetailedDetailedFaceDetection(0)
detailed_face_detection.display(True)
detailed_face_detection.display(False)Coordinate di una parte del volto
Restituisce le coordinate di ogni parte del volto.

Parametri
| Nome | Tipo | Descrizione | Intervallo / Tipo | Valore predefinito |
|---|---|---|---|---|
| unit | Opzione di elenco | Parte del volto | viso(face), occhio sinistro(left eye), occhio destro(right eye), bocca(mouth), naso(nose), labbro superiore(upper lip), labbro inferiore(lower lip), angolo sinistro della bocca(left lip), angolo destro della bocca(right lip), pupilla sinistra(left pupil), pupilla destra(right pupil) | - |
| pos | Opzione di elenco | Coordinata | x, y | - |
Python
detailed_face_detection = DetailedDetailedFaceDetection(0)
detailed_face_detection.face('x')
detailed_face_detection.left_eye('y')
detailed_face_detection.upper_lip('x')
detailed_face_detection.right_pupil('y')Informazioni sul rettangolo di una parte del volto
Restituisce la posizione e le dimensioni del rettangolo dell'area di ogni parte del volto.

Parametri
| Nome | Tipo | Descrizione | Intervallo / Tipo | Valore predefinito |
|---|---|---|---|---|
| unit | Opzione di elenco | Parte del volto | viso(face), occhio sinistro(left eye), occhio destro(right eye), bocca(mouth) | - |
| pos | Opzione di elenco | Informazione sul rettangolo | posizione x min(min_x), posizione x max(max_x), posizione y min(min_y), posizione y max(max_y), larghezza(width), altezza(height), area(area) | - |
Python
detailed_face_detection = DetailedDetailedFaceDetection(0)
detailed_face_detection.face('min_x')
detailed_face_detection.left_eye('area')Distanza tra due parti
Restituisce la distanza tra due parti del volto.

Parametri
| Nome | Tipo | Descrizione | Intervallo / Tipo | Valore predefinito |
|---|---|---|---|---|
| unit1 | Opzione di elenco | Prima parte | nome di una parte del volto | - |
| unit2 | Opzione di elenco | Seconda parte | nome di una parte del volto | - |
| type | Opzione di elenco | Tipo di distanza | distanza(omesso o None), distanza orizzontale(horizontal), distanza verticale(vertical) | None |
Python
detailed_face_detection = DetailedDetailedFaceDetection(0)
detailed_face_detection.get_distance('left_eye', 'right_eye') # distanza
detailed_face_detection.get_distance('left_pupil', 'right_pupil', 'horizontal') # distanza orizzontale
detailed_face_detection.get_distance('upper_lip', 'lower_lip', 'vertical') # distanza verticaleStato del modello
Restituisce lo stato di caricamento del modello del volto.
Restituisce 0 se non è ancora stato caricato, 1 se il caricamento è in corso e 2 se il caricamento è finito.

Parametri
(nessuno)
Python
detailed_face_detection = DetailedDetailedFaceDetection(0)
detailed_face_detection.model_state()Se il volto è rilevato
Se il volto è stato trovato

Parametri
(nessuno)
Python
detailed_face_detection = DetailedDetailedFaceDetection(0)
detailed_face_detection.detected()