Partilhar via

KSPROPERTY_CAMERACONTROL_EXTENDED_FACEDETECTION

  • Artigo

KSPROPERTY_CAMERACONTROL_EXTENDED_FACEDETECTION é uma ID de propriedade usada para ativar e desativar a detecção facial.

Tabela de resumo de uso

Escopo Control Tipo

Versão 1

Filtrar

Síncrono

Os sinalizadores a seguir podem ser colocados no KSCAMERA_EXTENDEDPROP_HEADER. Campo sinalizadores para controlar a detecção facial no driver. Por padrão, o driver deve ter FACEDETECTION_OFF.

#define KSCAMERA_EXTENDEDPROP_FACEDETECTION_OFF             0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_FACEDETECTION_PREVIEW         0x0000000000000001
#define KSCAMERA_EXTENDEDPROP_FACEDETECTION_VIDEO           0x0000000000000002
#define KSCAMERA_EXTENDEDPROP_FACEDETECTION_PHOTO           0x0000000000000004
#define KSCAMERA_EXTENDEDPROP_FACEDETECTION_BLINK           0x0000000000000008
#define KSCAMERA_EXTENDEDPROP_FACEDETECTION_SMILE           0x0000000000000010

Se o driver der suporte a esse controle, ele deverá dar suporte a FACEDETECTION_OFF e a qualquer um dos FACEDETECTION_PREVIEW, FACEDETECTION_VIDEO ou FACEDETECTION_PHOTO. O driver deve executar ainda mais a análise facial dominante e alimentar o rosto dominante para 3A diretamente quando a detecção facial estiver habilitada.

Se o driver não der suporte à detecção facial, o driver não deverá implementar esse controle.

A tabela a seguir descreve os recursos de sinalizador.

Sinalizador Descrição

KSCAMERA_EXTENDEDPROP_FACEDETECTION_OFF

Essa é uma funcionalidade obrigatória. Quando especificado, a detecção facial é desabilitada no driver.

KSCAMERA_EXTENDEDPROP_FACEDETECTION_PREVIEW

Essa é uma funcionalidade opcional. Quando especificado, a detecção facial é habilitada no driver e o driver deve fornecer as informações de detecção facial e o carimbo de data/hora associado, se houver suporte, como metadados por meio do pino de visualização. Esse sinalizador é mutuamente exclusivo com o sinalizador OFF e pode ser usado com os outros sinalizadores.

KSCAMERA_EXTENDEDPROP_FACEDETECTION_VIDEO

Essa funcionalidade é opcional. Quando especificado, a detecção facial é habilitada no driver e o driver que dá suporte a essa funcionalidade deve fornecer as informações de rosto e o carimbo de data/hora associado, se houver suporte, como metadados por meio do pino de vídeo. Esse sinalizador é mutuamente exclusivo com o sinalizador OFF e pode ser usado com os outros sinalizadores.

KSCAMERA_EXTENDEDPROP_FACEDETECTION_PHOTO

Essa funcionalidade é opcional. Quando especificado, a detecção facial é habilitada no driver e o driver que dá suporte a essa funcionalidade deve fornecer as informações de rosto e o carimbo de data/hora associado, se houver suporte, como metadados por meio do pino de foto. Esse sinalizador é mutuamente exclusivo com o sinalizador OFF e pode ser usado com os outros sinalizadores.

KSCAMERA_EXTENDEDPROP_FACEDETECTION_BLINK

Essa funcionalidade é opcional. Esse sinalizador só pode ser especificado quando sinalizadores PREVIEW, VIDEO e\ou PHOTO são especificados. Quando especificado, o driver que dá suporte a essa funcionalidade também deve fornecer as informações de piscar como metadados por meio do pino correspondente.

KSCAMERA_EXTENDEDPROP_FACEDETECTION_SMILE

Essa funcionalidade é opcional. Esse sinalizador só pode ser especificado quando sinalizadores PREVIEW, VIDEO e\ou PHOTO são especificados. Quando especificado, o driver que dá suporte a essa funcionalidade também deve fornecer as informações de sorriso como metadados por meio do pino correspondente.

Observação

O MFT0 deve anexar ainda mais as informações faciais como um MF_CAPTURE_METADATA_FACEROIS, o carimbo de data/hora como um MF_CAPTURE_METADATA_FACEROITIMESTAMPS e as informações de piscar e/ou sorrir como um MF_CAPTURE_METADATA_FACEROICHARACTERIZATIONS na amostra. Os recursos DE VISUALIZAÇÃO, VÍDEO e FOTO são opcionais. No entanto, pelo menos um dos recursos PREVIEW, VIDEO e PHOTO deverá ter suporte se esse controle tiver suporte.

A tabela a seguir contém as descrições e os requisitos para os campos de estrutura KSCAMERA_EXTENDEDPROP_HEADER ao usar o controle .

Membro Descrição

Versão

Isso deve ser 1.

PinId

Deve ser KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF).

Tamanho

Deve ser sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING).

Result

Indica os resultados do erro da última operação SET. Se nenhuma operação SET tiver ocorrido, ela deverá ser 0.

Funcionalidade

Deve ser um OR bit a bit dos sinalizadores KSCAMERA_EXTENDEDPROP_FACEDETECTION_* com suporte, conforme definido acima.

Flags

Este é um campo de leitura/gravação. Isso pode ser um pouco sábio OU dos sinalizadores KSCAMERA_EXTENDEDPROP_FACEDETECTION_OFF/PREVIEW/VIDEO/PHOTO definidos acima ou um pouco sábio OU de KSCAMERA_EXTENDEDPROP_FACEDETECTION_BLINK e/ou KSCAMERA_EXTENDEDPROP_FACEDETECTION_SMILE com qualquer combinação dos sinalizadores KSCAMERA_EXTENDEDPROP_FACEDETECTION_PREVIEW/VIDEO/PHOTO.

A tabela a seguir contém as descrições e os requisitos para os campos de estrutura KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING para a propriedade KSPROPERTY_CAMERACONTROL_EXTENDED_FACEDETECTION. Essa estrutura é definida em Ksmedia.h.

Membro Descrição

Mode

Não utilizado. Deve ser 0.

Min/Max/Step

Min/Max/Step contém o mínimo/máximo/incremento do número de rostos que o driver da câmera pode detectar ou pesquisar no qual Min deve ser >= 1 e Step deve ser 1. O driver deve retorná-los para operações GET.

VideoProc

Se FACEDETECTION_PREVIEW, FACEDETECTION_VIDEO ou FACEDETECTION_PHOTO forem especificados no campo Sinalizadores do KSCAMERA_EXTENDEDPROP_HEADER, VideoProc.Value.ul também deverá especificar o número máximo de rostos que o driver deve pesquisar.

Se FACEDETECTION_OFF for especificado, para operações SET, o campo VideoProc será ignorado.

Para operações GET, o driver deve retornar o número máximo de rostos que o driver está procurando no momento. Se a detecção facial for OFF, 0 deverá ser retornado.

Reservado

Isso não é utilizado. Isso deve ser ignorado pelo driver.

Comentários

Quando a detecção facial é ativada, a região facial de interesses (ROIs) pode ser consumida diretamente pelo driver para auxiliar o processamento 3A conforme necessário. Se algum ROIs especificado pelo usuário estiver configurado por meio de KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL ao mesmo tempo, os ROIs especificados pelo usuário terão precedência sobre os ROIs faciais detectados. Se os ROIs especificados pelo usuário forem limpos, os ROIs de detecção facial detectados entrarão em vigor.

Requisitos

parâmetro

 Ksmedia.h