Compartilhar via


KSPROPERTY_CAMERACONTROL_TILT

Os clientes do modo de usuário usam a propriedade KSPROPERTY_CAMERACONTROL_TILT para obter ou definir a configuração de inclinação de uma câmera. Essa propriedade é opcional.

Tabela de Resumo de Uso

Obter Definir Destino Tipo de descritor de propriedade Tipo de valor da propriedade
Sim Sim Filtrar ou nó KSPROPERTY_CAMERACONTROL_S ou KSPROPERTY_CAMERACONTROL_NODE_S LONG

O valor da propriedade (dados de operação) é um LONG que especifica a configuração de inclinação de uma câmera. Esse valor é expresso em graus.

Valores positivos apontam o plano de geração de imagens para cima. Valores negativos apontam o plano de geração de imagens para baixo, conforme mostrado na ilustração a seguir.

ilustração mostrando valores de inclinação da câmera.

Cada minidriver de captura de vídeo que dá suporte a essa propriedade deve definir um intervalo e um valor padrão para essa propriedade. O intervalo do dispositivo deve -180 a +180. O valor padrão deve ser 0.

Cuidado

Ao escrever ou testar um aplicativo, você deve estar ciente de que, na prática, alguns drivers definem um intervalo personalizado de valores de inclinação e valores de etapa personalizados que podem não ser baseados em unidades típicas. Os drivers podem implementar o controle de inclinação física ou digitalmente.

Comentários

O membro Value da estrutura KSPROPERTY_CAMERACONTROL_S especifica a configuração de inclinação.

Para câmeras que usam a Plataforma DMFT para 3A com base no rosto, o controle Pan afeta a janela de saída da câmera. As coordenadas faciais produzidas pela Plataforma DMFT serão relativas a essa janela de saída modificada, portanto, a câmera é responsável por remapear as coordenadas ROI para o campo de exibição completo da câmera quando o campo de exibição atual é modificado pelo controle Pan. Dependendo de onde o campo de modificação de exibição ocorre, o mapeamento de coordenadas pode precisar ser bidirecional. Por exemplo, se o campo de modificação de exibição for implementado em um componente após o DMFT de Plataforma na cadeia de driver, as coordenadas ROI fornecidas pelo aplicativo precisarão ser mapeadas de volta para o campo de exibição completo antes de enviar para a câmera e as coordenadas ROI calculadas na Plataforma DMFT precisarão ser mapeadas para o campo de exibição modificado antes de serem enviadas para um aplicativo solicitando-as.

Requisitos

Cabeçalho: ksmedia.h (inclua Ksmedia.h)

Confira também

KSPROPERTY

KSPROPERTY_CAMERACONTROL_S