Базовое сканирование для сканеров пленки
Приложение WIA перечисляет элементы верхнего уровня в дереве элементов сканера, чтобы определить поддерживаемые функции сканера. Затем приложение использует элемент верхнего уровня в качестве источника сканирования. Например, элементы сканера с планшетами используются для сканирования из планшета, а элементы подателя — для сканирования из средства подачи документов.
Поведение программирования и сканирования элемента фильма почти идентично поведения элемента с планшетом.
Обычно приложение выполняет следующие операции при программе элемента пленки сканера, но не обязательно в таком порядке:
Перечисление элементов WIA верхнего уровня, поиск элементов WIA, помеченных флагом элемента WiaItemTypeProgrammableDataSource и параметром WIA_IPA_ITEM_CATEGORY WIA_CATEGORY_FILM.
Считайте допустимые значения для WIA_IPS_FILM_SCAN_MODE, чтобы проверка для параметров сканирования пленки. Этот параметр указывает на поддержку сканирования положительного изображения или отрицательного изображения (т. е. фотографического отрицательного изображения).
Выберите положительный или отрицательный источник света, задав свойство WIA_IPS_FILM_SCAN_MODE.
Прочтите текущие параметры лампы сканера и включите ее, если это необходимо, с помощью свойства WIA_IPS_LAMP (если оно поддерживается).
Чтение допустимых значений для WIA_IPA_TYMED и WIA_IPA_FORMAT.
Выберите окончательный формат данных, задав свойство WIA_IPA_FORMAT.
Выберите параметры изображения, например WIA_IPA_DEPTH, WIA_IPA_DATATYPE и WIA_IPA_BITS_PER_CHANNEL.
Выберите одну или многостраничную передачу файла (если поддерживается), задав свойство WIA_IPA_TYMED.
Перечисление дочерних элементов для поиска существующих кадров.
Прочтите элемент WIA_IPS_SUPPORTS_CHILD_ITEM_CREATION , чтобы определить, поддерживает ли сканер создание новых кадров.
Настройте существующие кадры элементов пленки или создайте новые кадры (в зависимости от поддержки создания кадра).
Прочтите свойство WIA_IPS_SUPPORTS_CHILD_ITEM_CREATION, чтобы определить, поддерживает ли элемент сканера пленки функцию получения специальной папки.
Выполните одну из следующих операций:
- Передача данных с помощью элемента сканера пленки WIA (не с помощью функции приобретения папок). Полная область сканирования пленки будет возвращена в виде одного изображения.
- Передача данных с помощью элемента сканера пленки WIA (с помощью функции получения папок). В приложение передаются только дочерние элементы сканера пленки WIA (т. е. кадры).
- Перейдите к каждому элементу кадра и передайте этот элемент WIA.
Драйвер обычно выполняет следующие операции при использовании для сканирования пленки сканера:
Вызовите IWiaMiniDrv::d rvValidateItemProperties и IWiaMiniDrv::d rvReadItemProperties. Драйвер WIA должен проверять все параметры свойств на этапе настройки свойств приложения.
Вызовите IWiaMiniDrv::d rvWriteItemProperties. Контекст элемента WIA, передаваемый в , принадлежит элементу сканера пленки или кадру элемента сканирования пленки, чтобы драйвер знал, что приложение намерено использовать модуль сканирования пленки сканера для сканирования. Некоторые сканеры используют свои планшеты для сканирования пленки. Сканер должен быть настроен для правильного освещения (на основе свойства WIA_IPS_FILM_SCAN_MODE) и изменения экстента для сканирования пленки.
Вызовите IWiaMiniDrv::d rvAcquireItemData. Контекст элемента WIA, передаваемый в , принадлежит элементу сканера пленки или кадру элемента сканирования пленки. Драйвер может легко определить, что приложение намерено сканировать, используя модуль сканирования пленки.
Запрограммируйте устройство и выполните сканирование из блока сканирования пленки с помощью текущих свойств элемента пленки (включая любые свойства дочернего кадра). Если драйвер WIA не находится в режиме сканирования пленки, он пытается переключиться в этот режим для сканирования. Приложение может переключаться только между отрицательным и положительным светом. Использование элемента сканера пленки для сканирования является контрактом между приложением и драйвером; они согласны с тем, что функция сканирования пленки сканера будет использоваться для передачи данных.
Свойства WIA, расположенные на элементе сканера пленки, должны использоваться драйвером в качестве параметров, применяемых к части сканирования пленки сканера перед сканированием. Приложение WIA всегда должно доверять заголовкам данных, возвращаемых драйвером WIA. Например, сканер определил, что он не может сканировать указанную ширину изображения и должен округить значение. Драйвер должен обновить заголовки изображений обновленными сведениями о ширине, чтобы приложение было правильно. Драйвер WIA всегда должен обновлять набор свойств WIA фактическими данными, возвращаемыми с устройства.