Constantes de propriedade do dispositivo de câmera
Os dispositivos de hardware WIA (Aquisição de Imagens do Windows) têm valores de propriedade armazenados no Registro do Windows. Para obter mais informações, confira Constantes comuns de propriedade do dispositivo.
As seguintes constantes de propriedade do dispositivo, com suas cadeias de caracteres associadas, são específicas para câmeras digitais. O prefixo "WIA_DPC_" indica uma Propriedade de Dispositivo para Câmeras e é a convenção de nomenclatura usada em C/C++. Para fins de script, essas constantes usam o prefixo "CameraDevice" e fazem parte do tipo enumerado WiaItemPropertyId . O nome do membro correspondente dessa enumeração de script aparece entre parênteses ao lado do nome da constante C/C++ na lista a seguir.
Observação
O WIA não dá suporte a câmeras no Windows Vista ou posterior. Para essas versões do Windows, use a API do Dispositivo Portátil do Windows (WPD) descrita no DDK (Kit de Desenvolvimento de Driver do Windows) para adquirir imagens de câmeras.
| Constante/valor | Descrição | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
O número de fotos que a câmera tirou. O minidriver cria e mantém essa propriedade. Tipo: VT_I4, Access: Somente Leitura, Valores válidos: WIA_PROP_NONE |
||||||||||||||||
|
O número de imagens que podem ser tiradas, considerando as configurações de propriedade atuais. Se essas configurações forem alteradas e as alterações afetarem o tamanho das imagens que o dispositivo de câmera produz, o minidriver WIA deverá atualizar o número de imagens restantes. O minidriver cria e mantém essa propriedade. Tipo: VT_I4, Access: Somente Leitura, Valores válidos: WIA_PROP_NONE |
||||||||||||||||
|
Indica o modo de exposição atual da câmera. Um aplicativo altera essa propriedade para controlar o modo de exposição do dispositivo de câmera. Tipo: VT_I4, Access: Leitura/Gravação, Valores válidos: WIA_PROP_LIST A tabela a seguir tem as sete constantes que são válidas com essa propriedade.
|
||||||||||||||||
|
Permite o ajuste do ponto de conjunto do controle de exposição automática da câmera digital. Por exemplo, uma configuração de zero não altera o nível de exposição automática definido de fábrica. As unidades estão em "paradas" que são dimensionadas por um fator de 1000, para permitir valores de parada fracionária. Uma configuração de 2000 corresponde a duas paradas mais exposição (quatro vezes mais energia no sensor), gerando imagens mais brilhantes. Uma configuração de -1000 corresponde a uma parada menos exposição (metade da energia no sensor) gerando imagens mais escuras. Os valores de configuração estão em unidades APEX (Sistema Aditivo de Exposição Fotográfica). Essa propriedade pode ser expressa como uma lista ou um intervalo de valores. Normalmente, essa propriedade é usada somente quando o dispositivo tem a propriedade WIA_DPC_EXPOSURE_MODE definida como EXPOSUREMODE_MANUAL. Tipo: VT_I4, Access: Leitura/Gravação, Valores válidos: WIA_PROP_RANGE ou WIA_PROP_LIST |
||||||||||||||||
|
Corresponde à velocidade do obturador, em segundos que são dimensionados em 10.000. Normalmente, o dispositivo usa essa propriedade somente quando a propriedade WIA_DPC_EXPOSURE_MODE é definida como EXPOSUREMODE_MANUAL ou EXPOSUREMODE_SHUTTER_PRIORITY. Tipo: VT_I4, Access: Leitura/Gravação, Valores válidos: WIA_PROP_RANGE ou WIA_PROP_LIST |
||||||||||||||||
|
Corresponde à abertura da lente, em unidades do número f-stop dimensionado em 100. A configuração dessa propriedade normalmente é válida somente quando a propriedade WIA_DPC_EXPOSURE_MODE é definida como EXPOSUREMODE_MANUAL ou EXPOSUREMODE_APERTURE_PRIORITY. Tipo: VT_I4, Access: Leitura/Gravação, Valores válidos: WIA_PROP_LIST |
||||||||||||||||
|
Define a configuração do modo flash atual para o dispositivo de câmera. O driver do dispositivo enumera os valores com suporte dessa propriedade. Um aplicativo grava essa propriedade para definir o modo flash para o dispositivo de câmera. Tipo: VT_I4, Access: Leitura/Gravação, Valores válidos: WIA_PROP_LIST A tabela a seguir tem as seis constantes que são válidas com essa propriedade.
|
||||||||||||||||
|
Define a configuração do modo de foco atual para o dispositivo de câmera. O driver do dispositivo enumera os valores com suporte dessa propriedade. Um aplicativo grava essa propriedade para definir o modo de foco para o dispositivo de câmera. Tipo: VT_I4, Access: Leitura/Gravação, Valores válidos: WIA_PROP_LIST A tabela a seguir tem as três constantes que são válidas com essa propriedade.
|
||||||||||||||||
|
Reservado, não use. Tipo: VT_I4, Access: Somente Leitura, Valores válidos: WIA_PROP_NONE |
||||||||||||||||
|
Reservado, não use. Tipo: VT_I4, Access: Somente Leitura, Valores válidos: WIA_PROP_NONE |
||||||||||||||||
|
Reservado, não use. Tipo: VT_I4, Access: Somente Leitura, Valores válidos: WIA_PROP_NONE |
||||||||||||||||
|
Reservado, não use. Tipo: VT_I4, Access: Somente Leitura, Valores válidos: WIA_PROP_NONE |
||||||||||||||||
|
Reservado, não use. Tipo: VT_I4, Access: Somente Leitura, Valores válidos: WIA_PROP_NONE |
||||||||||||||||
|
Reservado, não use. Tipo: VT_I4, Access: Somente Leitura, Valores válidos: WIA_PROP_NONE |
||||||||||||||||
|
Define a fonte de alimentação atual para o dispositivo de câmera. Um aplicativo lê essa propriedade para determinar qual fonte de energia a câmera está usando. Tipo: VT_I4, Access: Somente Leitura, Valores válidos: WIA_PROP_NONE A tabela a seguir tem as duas constantes que são válidas com essa propriedade.
|
||||||||||||||||
|
A porcentagem de energia da bateria que resta para operar o dispositivo de câmera. Esse valor deve ser um inteiro de 0 a 100. Um aplicativo lê essa propriedade para determinar a duração restante da bateria do dispositivo de câmera. Tipo: VT_I4, Access: Somente Leitura, Valores válidos: WIA_PROP_NONE |
||||||||||||||||
|
A largura, em pixels, de uma imagem em miniatura a ser usada para imagens recém-capturadas. Um aplicativo lê esse valor para obter um tamanho estimado para exibir miniaturas em sua interface do usuário. Tipo: VT_I4, Access: Leitura/Gravação (WIA_PROP_LIST) ou Somente Leitura (WIA_PROP_NONE), Valores válidos: WIA_PROP_LIST ou WIA_PROP_NONE |
||||||||||||||||
|
A largura, em pixels, de uma imagem em miniatura a ser usada para imagens recém-capturadas. Um aplicativo lê esse valor para obter um tamanho estimado para exibir miniaturas em sua interface do usuário. Tipo: VT_I4, Access: Leitura/Gravação (WIA_PROP_LIST) ou Somente Leitura (WIA_PROP_NONE), Valores válidos: WIA_PROP_LIST ou WIA_PROP_NONE |
||||||||||||||||
|
A largura em pixels a ser usada para imagens recém-capturadas. A lista de valores válidos para essa propriedade tem uma correspondência um-para-um para a lista de valores válidos para a propriedade WIA_DPC_PICT_HEIGHT . Se a largura e a altura individuais forem linearmente configuráveis e ortogonais entre si, elas poderão ser expressas como um intervalo. Tipo: VT_I4, Access: Leitura/Gravação, Valores válidos: WIA_PROP_LIST ou WIA_PROP_RANGE |
||||||||||||||||
|
A altura em pixels a ser usada para imagens recém-capturadas. A lista de valores válidos para essa propriedade tem uma correspondência um-para-um com a lista de valores válidos para a propriedade WIA_DPC_PICT_WIDTH . Se a largura e a altura individuais forem linearmente configuráveis e ortogonais entre si, elas poderão ser expressas como um intervalo. Tipo: VT_I4, Access: Leitura/Gravação, Valores válidos: WIA_PROP_LIST ou WIA_PROP_RANGE |
||||||||||||||||
|
Reservado, não use. Tipo: VT_I4, Access: Somente Leitura, Valores válidos: WIA_PROP_NONE |
||||||||||||||||
|
Destinado a ser aproximadamente linear em relação à qualidade da imagem percebida em uma ampla gama de conteúdo de cena e contém um intervalo ou uma lista de inteiros. Inteiros menores são usados para representar uma qualidade mais baixa (ou seja, compactação máxima), enquanto inteiros maiores são usados para representar maior qualidade (ou seja, compactação mínima). Todas as configurações disponíveis em um dispositivo são relativas apenas a esse dispositivo e, portanto, são específicas do dispositivo. Tipo: VT_I4, Access: Leitura/Gravação, Valores válidos: WIA_PROP_LIST ou WIA_PROP_RANGE |
||||||||||||||||
|
Reservado, não use. Tipo: VT_I4, Access: Somente Leitura, Valores válidos: WIA_PROP_NONE |
||||||||||||||||
|
O tempo, em milissegundos, entre capturas de imagem em uma operação de captura de lapso de tempo. Tipo: VT_I4, Access: Leitura/Gravação, Valores válidos: WIA_PROP_NONE, WIA_PROP_LIST ou WIA_PROP_RANGE |
||||||||||||||||
|
O número de imagens que o dispositivo tenta capturar durante uma captura de lapso de tempo. Tipo: VT_I4, Access: Leitura/Gravação, Valores válidos: WIA_PROP_NONE, WIA_PROP_LIST ou WIA_PROP_RANGE |
||||||||||||||||
|
O tempo, em milissegundos, entre capturas de imagem durante uma operação de intermitência. Tipo: VT_I4, Access: Leitura/Gravação, Valores válidos: WIA_PROP_NONE, WIA_PROP_LIST ou WIA_PROP_RANGE |
||||||||||||||||
|
O número de imagens que o dispositivo tenta capturar durante uma operação de intermitência. Tipo: VT_I4, Access: Leitura/Gravação, Valores válidos: WIA_PROP_NONE, WIA_PROP_LIST ou WIA_PROP_RANGE |
||||||||||||||||
|
Especifica o modo especial de aquisição de imagem da câmera. Tipo: VT_I4, Access: Leitura/Gravação, Valores válidos: WIA_PROP_LIST A tabela a seguir tem as três constantes que são válidas com essa propriedade.
|
||||||||||||||||
|
A taxa de zoom efetiva da imagem adquirida da câmera digital, dimensionada por um fator de 10. Um valor de 10 corresponde à ausência de zoom digital (1X), que é o tamanho da cena padrão capturado pela câmera. Um valor de 20 corresponde a um zoom 2X, em que um quarto do tamanho da cena padrão é capturado pela câmera. Tipo: VT_I4, Access: Leitura/Gravação, Valores válidos: WIA_PROP_LIST ou WIA_PROP_RANGE |
||||||||||||||||
|
A nitidez percebida de uma imagem capturada. Essa propriedade pode usar uma lista de valores ou um intervalo de valores. O valor mínimo representa a menor quantidade de nitidez, enquanto o valor máximo representa a nitidez máxima. Normalmente, um valor no meio do intervalo representa nitidez normal ou padrão. Tipo: VT_I4, Access: Leitura/Gravação, Valores válidos: WIA_PROP_LIST ou WIA_PROP_RANGE |
||||||||||||||||
|
O contraste percebido de uma imagem capturada. Essa propriedade pode conter uma lista de valores ou um intervalo de valores. O valor mínimo com suporte representa a menor quantidade de contraste, enquanto o valor máximo representa o maior contraste. Normalmente, um valor no meio do intervalo representa contraste normal ou padrão. Tipo: VT_I4, Access: Leitura/Gravação, Valores válidos: WIA_PROP_LIST ou WIA_PROP_RANGE |
||||||||||||||||
|
Define o modo de captura de imagem. Tipo: VT_I4, Access: Leitura/Gravação, Valores válidos: WIA_PROP_LIST A tabela a seguir tem as três constantes que são válidas com essa propriedade.
|
||||||||||||||||
|
O valor que representa a quantidade de atraso de tempo, em milissegundos, que deve ser inserido entre o gatilho de captura e a inicialização real da captura de dados. Essa propriedade não se destina a ser usada para descrever o tempo entre os quadros de iniciação única, várias capturas, como intermitência ou lapso de tempo, que têm propriedades de intervalo separadas WIA_DPC_BURST_INTERVAL e WIA_DPC_TIMELAPSE_INTERVAL. Nesses casos, ele ainda serve como um atraso inicial antes que a primeira imagem da série seja capturada, independentemente do tempo entre os quadros. Para nenhum atraso de pré-inicialidade, essa propriedade deve ser definida como zero. Tipo: VT_I4, Access: Leitura/Gravação, Valores válidos: WIA_PROP_LIST ou WIA_PROP_RANGE |
||||||||||||||||
|
Permite a emulação de configurações de velocidade de filme em uma câmera digital. As configurações correspondem às designações ISO (ASA/DIN). Normalmente, um dispositivo dá suporte a valores enumerados discretos, mas o controle contínuo sobre um intervalo de valores é possível. Um valor de 0xFFFF corresponde à configuração ISO automática. Tipo: VT_I4, Access: Leitura/Gravação, Valores válidos: WIA_PROP_LIST ou WIA_PROP_RANGE |
||||||||||||||||
|
Especifica o modo que a câmera usa para ajustar automaticamente a configuração de exposição. Tipo: VT_I4, Access: Leitura/Gravação, Valores válidos: WIA_PROP_LIST
|
||||||||||||||||
|
Especifica o modo que a câmera usa para ajustar automaticamente o foco. Tipo: VT_I4, Access: Leitura/Gravação, Valores válidos: WIA_PROP_LIST A tabela a seguir tem as duas constantes que são válidas com essa propriedade.
|
||||||||||||||||
|
A distância, em milímetros, entre o plano de captura de imagem da câmera digital e o ponto de foco. Um valor de 0xFFFF corresponde a uma configuração maior que 655 metros. Tipo: VT_I4, Access: Leitura/Gravação, Valores válidos: WIA_PROP_LIST ou WIA_PROP_RANGE |
||||||||||||||||
|
O comprimento focal equivalente a 35mm. Os valores dessa propriedade correspondem ao comprimento focal em milímetros multiplicado por 100. O comprimento focal determina o zoom óptico. Tipo: VT_I4, Access: Leitura/Gravação, Valores válidos: WIA_PROP_NONE |
||||||||||||||||
|
Uma cadeia de caracteres Unicode terminada em nulo que representa o ganho vermelho, verde e azul aplicado aos dados de imagem, respectivamente. Por exemplo, "4:25:50" representa um ganho vermelho de 4, um ganho verde de 25 e um ganho azul de 50. Tipo: VT_BSTR, Access: Leitura/Gravação, Valores válidos: WIA_PROP_NONE |
||||||||||||||||
|
Especifica como a câmera digital pondera os canais de cores. Tipo: VT_I4, Access: Leitura/Gravação, Valores válidos: WIA_PROP_LIST Veja a seguir uma lista de valores possíveis para essa propriedade.
|
||||||||||||||||
|
Descreve uma URL. A URL descrita por essa proropertia é aquela em que imagens ou objetos, depois de adquiridos do dispositivo, podem ser carregados para , de acordo com um dos cenários a seguir.
O Microsoft Windows não carrega imagens por si só. Tipo: VT_BSTR, Access: Leitura/Gravação, Valores válidos: WIA_PROP_NONE |
||||||||||||||||
|
O nome do proprietário ( que é o usuário atual) do dispositivo. O dispositivo usa essa propriedade para preencher o campo Artista em cada imagem EXIF que captura. Tipo: VT_BSTR, Access: Leitura/Gravação, Valores válidos: WIA_PROP_NONE |
||||||||||||||||
|
A notificação de direitos autorais. O dispositivo usa essa propriedade para preencher o campo Direitos Autorais em cada imagem EXIF que captura. Tipo: VT_BSTR, Access: Leitura/Gravação, Valores válidos: WIA_PROP_NONE |
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows Server 2003 [somente aplicativos da área de trabalho] |
| Cabeçalho |
|