Detecção facial detalhada

Declarar a instância

Se acrescentares um bloco de Detecção facial detalhada detalhada(DetailedFaceDetection) à área de trabalho, no código Python é inserida automaticamente a declaração de instância seguinte:

detailed_face_detection = DetailedFaceDetection(0)
# se existirem várias instâncias
detailed_face_detection_1 = DetailedFaceDetection(1)

Parâmetros

Nome	Tipo	Descrição	Intervalo / Tipo	Valor predefinido
index	Opção de lista	Número da instância (começa em 0)	inteiro ≥ 0	0

Definir a câmara

Define a câmara para a deteção facial detalhada.

Parâmetros

Nome	Tipo	Descrição	Intervalo / Tipo	Valor predefinido
unit	Opção de lista	Nome do dispositivo de câmara	Etiqueta de câmara do sistema	-

Python

detailed_face_detection = DetailedFaceDetection(0)

detailed_face_detection.device('')

Carregar o modelo facial

Carrega o modelo facial treinado. Este passo é indispensável para usar as funções do módulo «Detecção facial detalhada».

Parâmetros

Nome	Tipo	Descrição	Intervalo / Tipo	Valor predefinido
wait	Caixa de verificação	Aguardar que o carregamento termine	TRUE / FALSE	TRUE

Python

detailed_face_detection = DetailedFaceDetection(0)

detailed_face_detection.load_model(wait=True)

Detetar rosto uma vez

Procura o rosto na imagem atual e marca-o exatamente uma vez.

Parâmetros

(nenhum)

Python

detailed_face_detection = DetailedFaceDetection(0)

detailed_face_detection.detect_once()

Iniciar / parar a deteção contínua de rosto

Segue o rosto na imagem atual continuamente e marca-o no ecrã.

Parâmetros

Nome	Tipo	Descrição	Intervalo / Tipo	Valor predefinido
unit	Opção de lista	Ação	iniciar(start), parar(stop)	-

Python

detailed_face_detection = DetailedFaceDetection(0)

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

Mostrar o resultado

Determina se o resultado da deteção facial é mostrado na imagem da câmara ou não.

Parâmetros

Nome	Tipo	Descrição	Intervalo / Tipo	Valor predefinido
on	Opção de lista	Visualização ON / OFF	mostrar(on=True), ocultar(off=False)	TRUE

Python

detailed_face_detection = DetailedFaceDetection(0)

detailed_face_detection.display(True)
detailed_face_detection.display(False)

Coordenada das partes do rosto

Devolve a coordenada de cada parte do rosto.

Parâmetros

Nome	Tipo	Descrição	Intervalo / Tipo	Valor predefinido
unit	Opção de lista	Parte do rosto	rosto(face), olho esquerdo(left eye), olho direito(right eye), boca(mouth), nariz(nose), lábio superior(upper lip), lábio inferior(lower lip), canto esquerdo da boca(left lip), canto direito da boca(right lip), pupila esquerda(left pupil), pupila direita(right pupil)	-
pos	Opção de lista	Coordenada	x, y	-

Python

detailed_face_detection = DetailedFaceDetection(0)

detailed_face_detection.face('x')
detailed_face_detection.left_eye('y')
detailed_face_detection.upper_lip('x')
detailed_face_detection.right_pupil('y')

Retângulo das partes do rosto

Devolve a posição e o tamanho do retângulo que envolve uma parte do rosto.

Parâmetros

Nome	Tipo	Descrição	Intervalo / Tipo	Valor predefinido
unit	Opção de lista	Parte do rosto	rosto(face), olho esquerdo(left eye), olho direito(right eye), boca(mouth)	-
pos	Opção de lista	Dado do retângulo	posição x mín.(min_x), posição x máx.(max_x), posição y mín.(min_y), posição y máx.(max_y), largura(width), altura(height), área(area)	-

Python

detailed_face_detection = DetailedFaceDetection(0)

detailed_face_detection.face('min_x')
detailed_face_detection.left_eye('area')

Distância entre duas partes

Devolve a distância entre duas partes do rosto.

Parâmetros

Nome	Tipo	Descrição	Intervalo / Tipo	Valor predefinido
unit1	Opção de lista	Primeira parte	Nome de uma parte do rosto	-
unit2	Opção de lista	Segunda parte	Nome de uma parte do rosto	-
type	Opção de lista	Tipo de distância	distância (omitido ou None), distância horizontal(horizontal), distância vertical(vertical)	None

Python

detailed_face_detection = DetailedFaceDetection(0)

detailed_face_detection.get_distance('left_eye', 'right_eye')  # distância
detailed_face_detection.get_distance('left_pupil', 'right_pupil', 'horizontal')  # distância horizontal
detailed_face_detection.get_distance('upper_lip', 'lower_lip', 'vertical')  # distância vertical

Estado de carregamento do modelo facial

Devolve o estado de carregamento do modelo facial.
Se ainda não estiver carregado, devolve 0; durante o carregamento, 1; depois de carregado, 2.

Parâmetros

(nenhum)

Python

detailed_face_detection = DetailedFaceDetection(0)

detailed_face_detection.model_state()

Rosto detetado?

Se foi encontrado um rosto

Parâmetros

(nenhum)

Python

detailed_face_detection = DetailedFaceDetection(0)

detailed_face_detection.detected()