Skip to content

Rilevamento del volto ​

Dichiarare l'istanza ​

Se aggiungi un blocco di Rilevamento del volto (FaceDetection) all'area di lavoro, nel codice Python viene inserita automaticamente la dichiarazione di istanza seguente:

python
face_detection = FaceDetection(0)
# se ci sono più istanze
face_detection_1 = FaceDetection(1)

Parametri ​

NomeTipoDescrizioneIntervallo / TipoValore predefinito
indexOpzione di elencoNumero dell'istanza (parte da 0)intero maggiore o uguale a 00

Scegliere la fotocamera ​

Imposta la fotocamera per il rilevamento del volto.

device

Parametri ​

NomeTipoDescrizioneIntervallo / TipoValore predefinito
unitOpzione di elencoNome della fotocameraetichette delle fotocamere del sistema-

Python ​

python
face_detection = FaceDetection(0)

face_detection.device('')

Caricare il modello ​

Carica il modello del volto addestrato. Questa operazione è indispensabile per poter usare le funzioni del modulo «Rilevamento del volto».

load_model

Parametri ​

NomeTipoDescrizioneIntervallo / TipoValore predefinito
waitCasella di controlloSe aspettare la fine del caricamentoTRUE / FALSETRUE

Python ​

python
face_detection = FaceDetection(0)

face_detection.load_model(wait=True)

Rilevare una volta ​

Cerca il volto presente nell'immagine attuale e lo mostra una volta sola.

detect_once

Parametri ​

(nessuno)

Python ​

python
face_detection = FaceDetection(0)

face_detection.detect_once()

Avviare / arrestare il rilevamento continuo ​

Segue in continuo il volto presente nell'immagine attuale e lo mostra sullo schermo.

detect_continuous

Parametri ​

NomeTipoDescrizioneIntervallo / TipoValore predefinito
unitOpzione di elencoAzioneavvia(start), arresta(stop)-

Python ​

python
face_detection = FaceDetection(0)

# unit = "start"
face_detection.detect_continuous()
# unit = "stop"
face_detection.stop()

Mostrare il risultato del rilevamento ​

Decide se mostrare o no il risultato del rilevamento del volto sull'immagine della fotocamera.

display

Parametri ​

NomeTipoDescrizioneIntervallo / TipoValore predefinito
onOpzione di elencoVisualizzazione ON / OFFmostra(on=True), nascondi(off=False)TRUE

Python ​

python
face_detection = FaceDetection(0)

face_detection.display(True)
face_detection.display(False)

Posizione di una parte del volto ​

Restituisce le coordinate della posizione del volto o di una sua parte.

face_data

Parametri ​

NomeTipoDescrizioneIntervallo / TipoValore predefinito
unitOpzione di elencoParte del voltovolto(face), occhio sinistro(left eye), occhio destro(right eye), orecchio sinistro(left ear), orecchio destro(right ear), naso(nose), bocca(mouth)-
posOpzione di elencoTipo di coordinatax, y-

Python ​

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')

Informazioni sul rettangolo del volto ​

Restituisce la posizione e le dimensioni del rettangolo dell'area del volto.

face_square

Parametri ​

NomeTipoDescrizioneIntervallo / TipoValore predefinito
posOpzione di elencoInformazione sul rettangoloposizione 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 ​

python
face_detection = FaceDetection(0)

face_detection.face('min_x')
face_detection.face('width')
face_detection.face('area')

Distanza tra due parti ​

Restituisce la distanza tra due parti del volto.

distance

Parametri ​

NomeTipoDescrizioneIntervallo / TipoValore predefinito
unit1Opzione di elencoPrima parteface, left_eye, right_eye, left_ear, right_ear, nose, mouth-
unit2Opzione di elencoSeconda parteface, left_eye, right_eye, left_ear, right_ear, nose, mouth-
typeOpzione di elencoTipo di distanzadistanza(omesso o None), distanza orizzontale(horizontal), distanza verticale(vertical)None

Python ​

python
face_detection = FaceDetection(0)

face_detection.get_distance('left_eye', 'right_eye')  # distanza
face_detection.get_distance('left_eye', 'right_eye', 'horizontal')  # distanza orizzontale
face_detection.get_distance('nose', 'mouth', 'vertical')  # distanza verticale

Stato 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.

model_state

Parametri ​

(nessuno)

Python ​

python
face_detection = FaceDetection(0)

face_detection.model_state()

Se il volto è rilevato ​

Se il volto è stato trovato

detected

Parametri ​

(nessuno)

Python ​

python
face_detection = FaceDetection(0)

face_detection.detected()