KSPROPERTY_CAMERACONTROL_EXTENDED_FACEDETECTION
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 |