Поделиться через

Константы свойств устройства камеры

  • Статья

Аппаратные устройства приобретения образов Windows (WIA) имеют значения свойств, которые хранятся в реестре Windows. Дополнительные сведения см. в разделе Общие константы свойств устройств.

Следующие константы свойств устройства со связанными строками относятся к цифровым камерам. Префикс "WIA_DPC_" обозначает свойство устройства для камер и является соглашением об именовании, используемым в C/C++. В целях написания скриптов эти константы используют префикс CameraDevice и являются частью перечислимого типа WiaItemPropertyId . Соответствующее имя члена из перечисления скрипта отображается в круглых скобках рядом с именем константы C/C++ в следующем списке.

Примечание

WIA не поддерживает камеры в Windows Vista и более поздних версиях. Для этих версий Windows используйте API переносимых устройств Windows (WPD), описанный в пакете средств разработки драйверов Windows (DDK), для получения изображений с камер.

 

Констант/значение Описание
WIA_DPC_PICTURES_TAKEN
CameraDevicePicturesTaken
 Количество снимков, сделанных камерой. Мини-driver создает и поддерживает это свойство.
Тип: VT_I4, Доступ: только для чтения, Допустимые значения: WIA_PROP_NONE
WIA_DPC_PICTURES_REMAINING
CameraDevicePicturesRemaining
 Количество изображений, которые можно сделать, с учетом текущих параметров свойства. Если эти параметры изменяются и изменения влияют на размер изображений, создаваемых устройством камеры, мини-диск WIA должен обновить количество оставшихся изображений. Мини-driver создает и поддерживает это свойство.
Тип: VT_I4, Доступ: только для чтения, Допустимые значения: WIA_PROP_NONE
WIA_DPC_EXPOSURE_MODE
CameraDevice ExposureMode
 Указывает текущий режим экспозиции камеры. Приложение изменяет это свойство, чтобы управлять режимом экспозиции устройства камеры.
Тип: VT_I4, Доступ: чтение и запись, Допустимые значения: WIA_PROP_LIST
В следующей таблице содержится семь констант, допустимых с этим свойством.
Режим экспозиции Описание
EXPOSUREMODE_MANUAL Скорость затвора и диафрагма задаются пользователем.
EXPOSUREMODE_AUTO Скорость затвора и диафрагма автоматически задаются камерой.
EXPOSUREMODE_APERTURE_PRIORITY Диафрагма устанавливается пользователем, а камера автоматически устанавливает скорость затвора.
EXPOSUREMODE_SHUTTER_PRIORITY Скорость затвора устанавливается пользователем, а камера автоматически устанавливает диафрагму.
EXPOSUREMODE_PROGRAM_CREATIVE Скорость затвора и диафрагма автоматически задаются камерой, оптимизированной для все еще предметной области.
EXPOSUREMODE_PROGRAM_ACTION Скорость затвора и диафрагма автоматически задаются камерой, оптимизированной для сцен, содержащих быстрое движение.
EXPOSUREMODE_PORTRAIT Скорость затвора и диафрагма автоматически задаются камерой, оптимизированной для портретной фотографии.

 
WIA_DPC_EXPOSURE_COMP
CameraDevice ExposureComp

Позволяет настроить заданную точку автоматического управления экспозицией цифровой камеры. Например, нулевое значение не изменяет уровень автоматической экспозиции, заданный заводом. Единицы измерения находятся в "стопах", масштабируемых в 1000 раз, чтобы обеспечить дробные значения стопа. Значение 2000 соответствует двум остановкам больше экспозиции (в четыре раза больше энергии на датчике), что дает более яркие изображения. Параметр -1000 соответствует одной остановке меньше экспозиции (на половину энергии на датчике), что дает более темные изображения. Значения параметров находятся в единицах аддитивной системы фотографической экспозиции (APEX). Это свойство может быть выражено как список или диапазон значений. Это свойство обычно используется только в том случае, если для свойства WIA_DPC_EXPOSURE_MODE устройства задано значение EXPOSUREMODE_MANUAL.

Тип: VT_I4, Access: чтение и запись, допустимые значения: WIA_PROP_RANGE или WIA_PROP_LIST
WIA_DPC_EXPOSURE_TIME
CameraDevice ExposureTime

Соответствует скорости затвора в секундах, масштабируемых на 10 000. Как правило, устройство использует это свойство, только если свойству WIA_DPC_EXPOSURE_MODE присвоено значение EXPOSUREMODE_MANUAL или EXPOSUREMODE_SHUTTER_PRIORITY.

Тип: VT_I4, Access: чтение и запись, допустимые значения: WIA_PROP_RANGE или WIA_PROP_LIST
WIA_DPC_FNUMBER
CameraDeviceFNumber

Соответствует диафрагме объектива в единицах числа f-stop, масштабируемого на 100. Значение этого свойства обычно допустимо, только если свойству WIA_DPC_EXPOSURE_MODE присвоено значение EXPOSUREMODE_MANUAL или EXPOSUREMODE_APERTURE_PRIORITY.

Тип: VT_I4, Доступ: чтение и запись, Допустимые значения: WIA_PROP_LIST
WIA_DPC_FLASH_MODE
CameraDeviceFlashMode

Определяет текущий параметр режима вспышки для устройства камеры. Драйвер устройства перечисляет поддерживаемые значения этого свойства. Приложение записывает это свойство, чтобы задать режим флэш-памяти для устройства камеры.

Тип: VT_I4, Доступ: чтение и запись, Допустимые значения: WIA_PROP_LIST

В следующей таблице содержится шесть констант, допустимых с этим свойством.

Режим флэш-памяти Определение
FLASHMODE_AUTO Устройство камеры определяет правильные параметры вспышки.
FLASHMODE_FILL Устройство камеры настроено на вспышку независимо от текущих условий освещения.
FLASHMODE_OFF Устройство камеры настроено на то , чтобы не мигать для любого снимка.
FLASHMODE_REDEYE_AUTO Устройство камеры определяет правильные параметры вспышки с помощью уменьшения красных глаз, независимо от текущих условий освещения.
FLASHMODE_REDEYE_FILL Устройство камеры настроено для использования уменьшения красных глаз и вспышки независимо от текущих условий освещения.
FLASHMODE_EXTERNALSYNC Устройство камеры настроено для синхронизации с внешними устройствами флэш-памяти.

 
WIA_DPC_FOCUS_MODE
CameraDeviceFocusMode

Определяет текущий режим фокусировки для устройства камеры. Драйвер устройства перечисляет поддерживаемые значения этого свойства. Приложение записывает это свойство, чтобы задать режим фокусировки для устройства камеры.

Тип: VT_I4, Доступ: чтение и запись, Допустимые значения: WIA_PROP_LIST

В следующей таблице содержатся три константы, допустимые с этим свойством.

Режим фокусировки Описание
FOCUSMODE_MANUAL Устройство камеры настроено таким образом, чтобы разрешить пользователю фокусироваться вручную.
FOCUSMODE_AUTO Устройство камеры настроено для автоматической фокусировки.
FOCUSMODE_MACROAUTO Устройство камеры настроено для автоматической фокусировки с помощью параметров макросов ближнего диапазона.

 
WIA_DPC_FOCUS_MANUAL_DIST

Зарезервировано, не используйте.

Тип: VT_I4, Access: только для чтения, Допустимые значения: WIA_PROP_NONE
WIA_DPC_ZOOM_POSITION

Зарезервировано, не используйте.

Тип: VT_I4, Access: только для чтения, Допустимые значения: WIA_PROP_NONE
WIA_DPC_PAN_POSITION
CameraDevicePanPosition

Зарезервировано, не используйте.

Тип: VT_I4, Access: только для чтения, Допустимые значения: WIA_PROP_NONE
WIA_DPC_TILT_POSITION
CameraDeviceTiltPosition

Зарезервировано, не используйте.

Тип: VT_I4, Access: только для чтения, Допустимые значения: WIA_PROP_NONE
WIA_DPC_TIMER_MODE
CameraDeviceTimerMode

Зарезервировано, не используйте.

Тип: VT_I4, Access: только для чтения, Допустимые значения: WIA_PROP_NONE
WIA_DPC_TIMER_VALUE
CameraDeviceTimerValue

Зарезервировано, не используйте.

Тип: VT_I4, Access: только для чтения, Допустимые значения: WIA_PROP_NONE
WIA_DPC_POWER_MODE
CameraDevicePowerMode

Определяет текущий источник питания для устройства камеры. Приложение считывает это свойство, чтобы определить, какой источник питания использует камера.

Тип: VT_I4, Access: только для чтения, Допустимые значения: WIA_PROP_NONE

В следующей таблице содержатся две константы, допустимые с этим свойством.

Режим питания Описание
POWERMODE_LINE Устройство камеры работает на адаптере питания.
POWERMODE_BATTERY Устройство камеры работает от аккумулятора.

 
WIA_DPC_BATTERY_STATUS
CameraDeviceBatteryStatus

Процент заряда батареи, оставшийся для работы устройства камеры. Это значение должно быть целым числом от 0 до 100. Приложение считывает это свойство, чтобы определить оставшееся время работы батареи устройства камеры.

Тип: VT_I4, Access: только для чтения, Допустимые значения: WIA_PROP_NONE
WIA_DPC_THUMB_WIDTH
CameraDeviceThumbWidth

Ширина (в пикселях) эскиза изображения, используемого для новых захваченных изображений. Приложение считывает это значение, чтобы получить предполагаемый размер для отображения эскизов в пользовательском интерфейсе.

Тип: VT_I4, Access: чтение и запись (WIA_PROP_LIST) или Только чтение (WIA_PROP_NONE). Допустимые значения: WIA_PROP_LIST или WIA_PROP_NONE
WIA_DPC_THUMB_HEIGHT
CameraDeviceThumbHeight

Ширина (в пикселях) эскиза изображения, используемого для новых захваченных изображений. Приложение считывает это значение, чтобы получить предполагаемый размер для отображения эскизов в пользовательском интерфейсе.

Тип: VT_I4, Access: чтение и запись (WIA_PROP_LIST) или Только чтение (WIA_PROP_NONE). Допустимые значения: WIA_PROP_LIST или WIA_PROP_NONE
WIA_DPC_PICT_WIDTH
CameraDevicePictWidth

Ширина в пикселях, используемая для недавно захваченных изображений. Список допустимых значений для этого свойства имеет один-к-одному соответствие списку допустимых значений для свойства WIA_DPC_PICT_HEIGHT . Если отдельные ширина и высота являются линейно заданными и ортогональными друг с другом, они могут быть выражены в виде диапазона.

Тип: VT_I4, Access: чтение и запись, Допустимые значения: WIA_PROP_LIST или WIA_PROP_RANGE
WIA_DPC_PICT_HEIGHT
CameraDevicePictHeight

Высота в пикселях, используемая для новых захваченных изображений. Список допустимых значений для этого свойства соответствует одному со списком допустимых значений для свойства WIA_DPC_PICT_WIDTH . Если отдельные ширина и высота являются линейно заданными и ортогональными друг с другом, они могут быть выражены в виде диапазона.

Тип: VT_I4, Access: чтение и запись, Допустимые значения: WIA_PROP_LIST или WIA_PROP_RANGE
WIA_DPC_DIMENSION

Зарезервировано, не используйте.

Тип: VT_I4, Access: только для чтения, Допустимые значения: WIA_PROP_NONE
WIA_DPC_COMPRESSION_SETTING
CameraDeviceCompressionSetting

Предполагается быть приблизительно линейным по отношению к качеству воспринимаемого изображения в широком диапазоне содержимого сцены и содержать либо диапазон, либо список целых чисел. Меньшие целые числа используются для представления более низкого качества (т. е. максимального сжатия), в то время как большие целые числа используются для представления более высокого качества (то есть минимального сжатия). Все доступные параметры на устройстве относятся только к устройству и, следовательно, зависят от конкретного устройства.

Тип: VT_I4, Access: чтение и запись, Допустимые значения: WIA_PROP_LIST или WIA_PROP_RANGE
WIA_DPC_FOCUS_METERING

Зарезервировано, не используйте.

Тип: VT_I4, Access: только для чтения, Допустимые значения: WIA_PROP_NONE
WIA_DPC_TIMELAPSE_INTERVAL
CameraDeviceTimelapseInterval

Время (в миллисекундах) между записью образа в операции записи с временным интервалом.

Тип: VT_I4, Access: чтение и запись, Допустимые значения: WIA_PROP_NONE, WIA_PROP_LIST или WIA_PROP_RANGE
WIA_DPC_TIMELAPSE_NUMBER
CameraDeviceTimelapseNumber

Количество изображений, которые устройство пытается записать во время захвата за временной промежуток.

Тип: VT_I4, Access: чтение и запись, Допустимые значения: WIA_PROP_NONE, WIA_PROP_LIST или WIA_PROP_RANGE
WIA_DPC_BURST_INTERVAL
CameraDeviceBurstInterval

Время (в миллисекундах) между захватами образа во время операции ускорения.

Тип: VT_I4, Access: чтение и запись, Допустимые значения: WIA_PROP_NONE, WIA_PROP_LIST или WIA_PROP_RANGE
WIA_DPC_BURST_NUMBER
CameraDeviceBurstNumber

Количество изображений, которые устройство пытается записать во время операции ускорения.

Тип: VT_I4, Access: чтение и запись, Допустимые значения: WIA_PROP_NONE, WIA_PROP_LIST или WIA_PROP_RANGE
WIA_DPC_EFFECT_MODE
CameraDeviceEffectMode

Указывает специальный режим получения изображения камеры.

Тип: VT_I4, Access: чтение и запись, допустимые значения: WIA_PROP_LIST

В следующей таблице приведены три константы, допустимые для этого свойства.

Режим эффекта Описание
EFFECTMODE_STANDARD Захват изображения в стандартном режиме для камеры.
EFFECTMODE_BW Захват изображения в оттенках серого.
EFFECTMODE_SEPIA Запишите изображение сепии.

 
WIA_DPC_DIGITAL_ZOOM
CameraDeviceDigitalZoom

Эффективное соотношение масштаба полученного изображения цифровой камеры в 10 раз. Значение 10 соответствует отсутствию цифрового масштаба (1X), который является стандартным размером сцены, захваченной камерой. Значение 20 соответствует масштабу 2X, где одна четверть стандартного размера сцены фиксируется камерой.

Тип: VT_I4, Доступ: чтение и запись, Допустимые значения: WIA_PROP_LIST или WIA_PROP_RANGE
WIA_DPC_SHARPNESS
CameraDeviceSharpness

Воспринимаемая резкость захваченного изображения. Это свойство может использовать либо список значений, либо диапазон значений. Минимальное значение представляет наименьшую резкость, а максимальное значение — максимальную резкость. Обычно значение в середине диапазона представляет обычную или стандартную резкость.

Тип: VT_I4, Доступ: чтение и запись, Допустимые значения: WIA_PROP_LIST или WIA_PROP_RANGE
WIA_DPC_CONTRAST
CameraDeviceContrast

Воспринимаемая контрастность захваченного изображения. Это свойство может содержать список значений или диапазон значений. Минимальное поддерживаемое значение представляет наименьшее значение контрастности, а максимальное значение — наибольшую контрастность. Как правило, значение в середине диапазона представляет обычную или стандартную контрастность.

Тип: VT_I4, Доступ: чтение и запись, Допустимые значения: WIA_PROP_LIST или WIA_PROP_RANGE
WIA_DPC_CAPTURE_MODE
CameraDeviceCaptureMode

Задает режим захвата изображения.

Тип: VT_I4, Доступ: чтение и запись, Допустимые значения: WIA_PROP_LIST

В следующей таблице содержатся три константы, допустимые с этим свойством.

Режим записи Описание
CAPTUREMODE_NORMAL Обычный режим камеры.
CAPTUREMODE_BURST Быстро захватывайте несколько изображений в соответствии со значениями свойств WIA_DPC_BURST_NUMBER и WIA_DPC_BURST_INTERVAL .
CAPTUREMODE_TIMELAPSE Запишите несколько изображений последовательно, как определено свойствами WIA_DPC_TIMELAPSE_NUMBER и WIA_DPC_TIMELAPSE_INTERVAL .

 
WIA_DPC_CAPTURE_DELAY
CameraDeviceCaptureDelay

Значение, представляющее время задержки (в миллисекундах), которое должно быть вставлено между триггером отслеживания и фактическим запуском записи данных. Это свойство не предназначено для описания времени между кадрами для одноинициации, нескольких записей, таких как ускорение или временной промежуток, которые имеют отдельные свойства интервала WIA_DPC_BURST_INTERVAL и WIA_DPC_TIMELAPSE_INTERVAL. В таких случаях он по-прежнему служит начальной задержкой перед первым изображением в серии, независимо от времени между кадрами. Для отсутствия задержки предварительного ввода этому свойству должно быть присвоено значение 0.

Тип: VT_I4, Доступ: чтение и запись, Допустимые значения: WIA_PROP_LIST или WIA_PROP_RANGE
WIA_DPC_EXPOSURE_INDEX
CameraDevice ExposureIndex

Позволяет эмуляции параметров скорости пленки на цифровой камере. Параметры соответствуют обозначениям ISO (ASA/DIN). Как правило, устройство поддерживает дискретные перечисляемые значения, но возможен непрерывный контроль над диапазоном значений. Значение 0xFFFF соответствует параметру Автоматический ISO.

Тип: VT_I4, Доступ: чтение и запись, Допустимые значения: WIA_PROP_LIST или WIA_PROP_RANGE
WIA_DPC_EXPOSURE_METERING_MODE
CameraDevice ExposureMeteringMode

Указывает режим, используемый камерой для автоматической настройки параметров экспозиции.

Тип: VT_I4, Доступ: чтение и запись, Допустимые значения: WIA_PROP_LIST

Режим измерения экспозиции Описание
EXPOSUREMETERING_AVERAGE Установите экспозицию на основе среднего значения всей сцены.
EXPOSUREMETERING_CENTERWEIGHT Установите экспозицию на основе средневзвешенный показатель.
EXPOSUREMETERING_MULTISPOT Задайте экспозицию на основе шаблона multispot.
EXPOSUREMETERING_CENTERSPOT Установите экспозицию на основе центрального места.

 
WIA_DPC_FOCUS_METERING_MODE
CameraDeviceFocusMeteringMode

Указывает режим, используемый камерой для автоматической настройки фокуса.

Тип: VT_I4, Доступ: чтение и запись, Допустимые значения: WIA_PROP_LIST

В следующей таблице приведены две константы, допустимые для этого свойства.

Режим отслеживания фокусировки Описание
FOCUSMETERING_CENTERSPOT Настройте фокус на основе центрального места.
FOCUSMETERING_MULTISPOT Настройте фокус на основе шаблона multispot.

 
WIA_DPC_FOCUS_DISTANCE
CameraDeviceFocusDistance

Расстояние в миллиметрах между плоскостью захвата изображения цифровой камеры и точкой фокуса. Значение 0xFFFF соответствует значению более 655 метров.

Тип: VT_I4, Доступ: чтение и запись, Допустимые значения: WIA_PROP_LIST или WIA_PROP_RANGE
WIA_DPC_FOCAL_LENGTH
CameraDeviceFocalLength

Эквивалентная фокусная длина 35 мм. Значения этого свойства соответствуют фокусному расстоянию в миллиметрах, умноженному на 100. Фокусное расстояние определяет оптическое масштабирование.

Тип: VT_I4, Доступ: чтение и запись, Допустимые значения: WIA_PROP_NONE
WIA_DPC_RGB_GAIN
CameraDeviceRGBGain

Строка Юникода со значением NULL, представляющая красный, зеленый и синий признак, применяемый к данным изображения соответственно. Например, "4:25:50" представляет собой красный прирост 4, зеленый прирост 25, а синий выигрыш 50.

Тип: VT_BSTR, Access: чтение и запись, допустимые значения: WIA_PROP_NONE
WIA_DPC_WHITE_BALANCE
CameraDeviceWhiteBalance

Указывает, как цифровая камера взвешивает цветовые каналы.

Тип: VT_I4, Доступ: чтение и запись, Допустимые значения: WIA_PROP_LIST

Ниже приведен список возможных значений для этого свойства.

Баланс белого Описание
WHITEBALANCE_MANUAL Баланс белого задается непосредственно с помощью свойства WIA_DPC_RGB_GAIN .
WHITEBALANCE_AUTO Камера использует автоматический механизм для настройки баланса белого.
WHITEBALANCE_ONEPUSH_AUTO Камера определяет настройки баланса белого, когда пользователь нажимает кнопку захвата, указывая камеру на белую поверхность.
WHITEBALANCE_DAYLIGHT Камера устанавливает для баланса белого значение, подходящее для использования в условиях дневного света.
WHITEBALANCE_FLORESCENT Камера устанавливает для баланса белого значение, подходящее для использования с флуоресцентным источником света.
WHITEBALANCE_TUNGSTEN Камера задает для баланса белого значение, подходящее для использования с источником света вольфрама.
WHITEBALANCE_FLASH Камера устанавливает баланс белого в значение, подходящее для использования с электронной вспышкой.

 
WIA_DPC_UPLOAD_URL
CameraDeviceUploadURL

Описывает URL-адрес. Url-адрес, описанный в этом шаблоне, — это URL-адрес, на который можно отправлять изображения или объекты после их получения с устройства в соответствии с одним из следующих сценариев.

  • Приложение WIA считывает это свойство и позволяет пользователю автоматически отправлять изображения на URL-адрес.
  • Приложение задает URL-адрес, а другие устройства (киоски и т. д.) используют это свойство.

Microsoft Windows не отправляет образы самостоятельно.

Тип: VT_BSTR, Access: чтение и запись, допустимые значения: WIA_PROP_NONE
WIA_DPC_ARTIST
CameraDeviceArtist

Имя владельца (текущий пользователь) устройства. Устройство использует это свойство для заполнения поля Исполнитель на каждом изображении EXIF, которое оно записывает.

Тип: VT_BSTR, Access: чтение и запись, допустимые значения: WIA_PROP_NONE
WIA_DPC_COPYRIGHT_INFO
CameraDeviceCopyrightInfo

Уведомление об авторских правах. Устройство использует это свойство для заполнения поля "Авторские права" на каждом изображении EXIF, которое оно записывает.

Тип: VT_BSTR, Access: чтение и запись, допустимые значения: WIA_PROP_NONE

Требования

Требование Значение
Минимальная версия клиента
 Windows 2000 Professional, Windows XP [только классические приложения]
Минимальная версия сервера
 Windows Server 2003 [только классические приложения]
Заголовок
Wiadef.h