Expressão facial
Declarar a instância
Se acrescentares um bloco de Expressão facial(FaceExpression) à área de trabalho, no código Python é inserida automaticamente a declaração de instância seguinte:
face_expression = FaceExpression(0)
# se existirem várias instâncias
face_expression_1 = FaceExpression(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 o reconhecimento de idade, género e expressão facial.

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
face_expression = FaceExpression(0)
face_expression.device('')Carregar o modelo de expressão facial
Carrega os modelos treinados de idade, género e expressão facial. Este passo é indispensável para usar as funções do módulo «Expressão facial».

Parâmetros
| Nome | Tipo | Descrição | Intervalo / Tipo | Valor predefinido |
|---|---|---|---|---|
| wait | Caixa de verificação | Aguardar que o carregamento termine | TRUE / FALSE | TRUE |
Python
face_expression = FaceExpression(0)
face_expression.load_model(wait=True)Detetar uma vez
Analisa o rosto na imagem atual e mostra exatamente uma vez os valores estimados de idade, género e expressão facial.

Parâmetros
(nenhum)
Python
face_expression = FaceExpression(0)
face_expression.detect_once()Iniciar / parar a deteção contínua
Analisa o rosto na imagem atual continuamente e mostra no ecrã os valores estimados de idade, género e expressão facial.

Parâmetros
| Nome | Tipo | Descrição | Intervalo / Tipo | Valor predefinido |
|---|---|---|---|---|
| unit | Opção de lista | Ação | iniciar(start), parar(stop) | - |
Python
face_expression = FaceExpression(0)
# unit = "start"
face_expression.detect_continuous()
# unit = "stop"
face_expression.stop()Mostrar o resultado
Determina se o resultado do reconhecimento de idade, género e expressã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
face_expression = FaceExpression(0)
face_expression.display(True)
face_expression.display(False)Idade
A idade

Parâmetros
(nenhum)
Python
face_expression = FaceExpression(0)
face_expression.age()Género
O género

Parâmetros
(nenhum)
Python
face_expression = FaceExpression(0)
face_expression.gender()Expressão facial
A expressão facial

Parâmetros
(nenhum)
Python
face_expression = FaceExpression(0)
face_expression.expression()Género detetado?
Se o género foi reconhecido

Parâmetros
(nenhum)
Python
face_expression = FaceExpression(0)
face_expression.gender_detected()O género é ~ ?
Devolve como verdadeiro(True) / falso(False) se o género reconhecido corresponde ao valor indicado.

Parâmetros
| Nome | Tipo | Descrição | Intervalo / Tipo | Valor predefinido |
|---|---|---|---|---|
| unit | Opção de lista | Género | masculino(male), feminino(female) | - |
Python
face_expression = FaceExpression(0)
face_expression.is_gender('male')
face_expression.is_gender('female')Confiança do género
A probabilidade (confiança) do género escolhido

Parâmetros
| Nome | Tipo | Descrição | Intervalo / Tipo | Valor predefinido |
|---|---|---|---|---|
| unit | Opção de lista | Género | masculino(male), feminino(female) | - |
Python
face_expression = FaceExpression(0)
face_expression.gender_confidence('male')
face_expression.gender_confidence('female')Expressão facial detetada?
Se a expressão facial foi reconhecida

Parâmetros
(nenhum)
Python
face_expression = FaceExpression(0)
face_expression.expression_detected()A expressão facial é ~ ?
Devolve como verdadeiro(True) / falso(False) se a expressão facial reconhecida corresponde ao valor indicado.

Parâmetros
| Nome | Tipo | Descrição | Intervalo / Tipo | Valor predefinido |
|---|---|---|---|---|
| unit | Opção de lista | Expressão facial | zangado(angry), enojado(disgusted), assustado(fearful), feliz(happy), neutro(neutral), triste(sad), surpreendido(surprised) | - |
Python
face_expression = FaceExpression(0)
face_expression.is_expression('happy')
face_expression.is_expression('sad')Confiança da expressão facial
A probabilidade (confiança) da expressão facial escolhida

Parâmetros
| Nome | Tipo | Descrição | Intervalo / Tipo | Valor predefinido |
|---|---|---|---|---|
| unit | Opção de lista | Expressão facial | angry, disgusted, fearful, happy, neutral, sad, surprised | - |
Python
face_expression = FaceExpression(0)
face_expression.expression_confidence('happy')
face_expression.expression_confidence('angry')Estado de carregamento do modelo
Devolve o estado de carregamento dos modelos de idade, género e expressão facial.
Se ainda não estiver carregado, devolve 0; durante o carregamento, 1; depois de carregado, 2.

Parâmetros
(nenhum)
Python
face_expression = FaceExpression(0)
face_expression.model_state()