C++ класс для работы со сканером.

Автор: Rajiv Ramachandran

• Скачать демонстрашку - 11 Kb
• Скачать исходник - 56 Kb

  

  Компилятор: Visual C++

  ВНИМАНИЕ: Для запуска демонстрационного примера, необходимо, чтобы в системе была установлена TWAIN_32.DLL.

  Ниже приводится описание основных методов класса CTwain.

   

  CTwain(HWND hWnd= NULL)

• Конструктор

  hwnd не обязателен. Если всё-таки будет использовано не нулевое значение, то интерфейс Twain будет инициализирован с этим хэндлом.

~CTwain()

• Деструктор

InitTwain(HWND hWnd)

• Инициализация TWAIN

  Этот метод вызывается конструктором, если в него был передан хэндл. Иначе он будет вызван позже. Основная его задача, это загрузить Twain Dll и инициализировать её.

ReleaseTwain()

• Завершение работы с интерфейсом Twain

   

GetIdentity()

• Идентификация приложения

  Этот метод вызывается функцией InitTwain, чтобы заполнить структуру TW_IDENTITY. Эта структура описана в twain.h, а пример её заполнения можно посмотреть в CTwain::GetIdentity.

IsValidDriver()

• Возвращает true, если драйвер был загружен успешно

SourceSelected()

• Возвращает true в случае успешного выбора источника

SourceEnabled()

• Возвращает true, если источник доступен

  В понятии TWAIN это значит, что в данный момент идёт сканирование.

SelectDefaultSource()

• Выбирает дефолтовый источник для данной машины

SelectSource()

• Показывает диалоговое окошко выбора источника

Acquire(int numImages=1)

• Запускает процесс получения картинки

  Обычно при этом открывается диалоговое окошко с параметрами сканирования. Обычно процесс сканирования запускается из этого окна. numImages это количество изображений, которые необходимо получить приложению. Так же в качестве этого параметра можно задать TWCPP_ANYCOUNT для любого количества.

ProcessMessage(MSG msg)

• Обрабатывает сообщения от Twain

  Этот метод необходимо вызывать из цикла сообщений окна, который изначально передаётся в класс.

  ВНИМАНИЕ: В эту процедуру можно передавать все сообщения, однако, пока источник доступен, она будет игнорировать все не твэйновские сообщения.

ShouldTransfer(TW_IMAGEINFO& info)

Эта функция вызывается каждый раз, когда изображение отсканировано. Функция возвращает одно из следующих значений:

TWCPP_CANCELTHIS

Передача этой картинки прекращена

TWCPP_CANCELALL

Все передачи прекращены

TWCPP_DOTRANSFER

Можно продолжать передачу следующей картинки

По умолчанию возвращается TWCPP_DOTRANSFER.

CopyImage(HANDLE hBitmap,TW_IMAGEINFO& info)

Это чисто виртуальный метод, который вызывается каждый раз, когда картинка передана из TWAIN. How the image is to be used is upto the application.