SANE и scanimage: быстрое руководство по сканированию

Команды scanimage и их применение

SANE (Scanner Access Now Easy) — это API для управления сканерами и камерами в Unix-подобных системах. Главная утилита в командной строке — scanimage. Её удобно использовать для одиночных сканов, пакетной обработки через ADF и интеграции в скрипты.

Важно. Некоторые опции, которые вы увидите в выводе справки, относятся не к самому API, а к конкретному backend’у (драйверу) для вашего сканера. Поэтому поведение и набор параметров зависят от модели устройства.

Что вы получите из этой статьи

Быстрый старт: установка и базовые команды.
Управление устройствами и выбор формата вывода.
Пакетная обработка через ADF и подготовка под OCR.
Методика настройки качества сканов и отладки проблем.
Чеклисты для домашних пользователей, системных администраторов и архивистов.

Установка и первичная проверка

Установите SANE пакет через менеджер пакетов вашей системы. В Debian/Ubuntu это делается так:

sudo apt install sane

Команда установит сам API и утилиту scanimage. Также обычно устанавливаются фронтенды xscanimage, scanadf и xcam.

После установки проверьте справку и доступные опции:

scanimage -h

Если сканер не подключён или не обнаружен, вы увидите только общие опции API. Если устройство доступно, перед выводом всех опций утилита может задержаться — это время на опрос backend’а и формирование списка параметров.

Если вам нужны только опции устройства (backend), используйте:

scanimage -A

Примечание: в этом руководстве в примерах использована версия SANE 1.0.14-15. У вас версия может отличаться — команды общие, но названия опций у конкретных моделей могут меняться.

Базовые и простые команды

Самая простая команда для сканирования выглядит так:

scanimage > scan_out

По умолчанию вывод идёт в стандартный поток вывода и перенаправляется в файл scan_out. Формат по умолчанию — PNM; режим (например Lineart, Gray, Color) определяется сканером и его backend’ом.

Если сканер не найден, появится сообщение наподобие:

scanimage: no SANE devices found

И ещё информационное предупреждение о формате вывода:

Output format is not set, using pnm as a default.

Чтобы явно задать имя и формат файла, используйте опцию -o:

scanimage -o scan_out.png

SANE попытается выбрать формат по расширению. Можно также явно указать формат:

scanimage --format=tiff -o scan_out.tiff

Поиск и указание устройств

Список обнаруженных устройств покажет команда:

scanimage -L

Пример вывода для сканера Epson в сети и по USB:

device `epson2:net:192.168.1.26' is a Epson PID 08B8 flatbed scanner  
device `epson2:libusb:001:005' is a Epson PID 08B8 flatbed scanner

Адрес устройства после слова device (например epson2:net:192.168.1.26) можно использовать с опцией -d, чтобы явным образом указать, куда посылать команды:

scanimage -d epson2:net:192.168.1.26 -o scan_out.png

Или для USB:

scanimage -d epson2:libusb:001:005 -o scan_out.png

Важно: при переподключении USB в другой порт адрес libusb может измениться. Всегда перепроверьте scanimage -L.

Управление форматом и качеством

Чтобы задать разрешение, режим и источник (например подача через ADF), используйте опции, специфичные для backend’а. Общий пример:

scanimage --format=pnm -o scan_page.pnm --mode Lineart --resolution 300 --source Automatic

Примеры форматов:

PNM — часто используется для OCR-инструментов, которые принимают PNM.
TIFF — подходит для архивирования и последующей постобработки.
PNG/JPEG — удобны для изображений, где важен размер файла.

Если вы указываете формат через расширение (scan_out.tiff), SANE обычно угадует формат, но рекомендуется явно использовать –format при скриптовании.

Пакетная обработка и ADF

Для автоматической подачи страниц используется пакетная опция –batch. Пример для ADF, когда нужно создать файлы document-A-1.pnm, document-A-2.pnm и т.п.:

scanimage --batch=document-A-%d.pnm --format=pnm --batch-count=100 --mode Gray --resolution 300 --source Automatic

Пояснения:

–batch=document-A-%d.pnm — шаблон имени выходного файла с индексом %d.
–batch-count=100 — максимальное число страниц (можно задать меньше или опустить для сканирования до конца загрузчика).
–source Automatic — выбор источника подачи (ADF). Название может отличаться в зависимости от backend’а.

Замечание. Для успешного OCR часто требуется использовать более высокое разрешение (300–600 dpi) и режим Grayscale или Color в зависимости от качества исходных страниц.

Интеграция с OCR

SANE генерирует изображение. Чтобы получить текст, применяйте OCR-инструменты: tesseract, gocr, ocrad и другие. Пример с tesseract:

tesseract scan_page.png output_text -l eng

Если ваш OCR принимает только PNM, генерируйте PNM, как в предыдущем примере. Для архивирования и дальнейшей обработки предпочтительнее TIFF с многостраничными контейнерами.

Методика: пошаговый рабочий процесс для качественного сканирования

Подключите устройство и запустите scanimage -L. Убедитесь, что устройство обнаружено.
Откройте scanimage -h или scanimage -A, чтобы узнать доступные параметры backend’а.
Если планируете пакетное сканирование, проверьте лоток ADF на застревания и ориентацию бумаги.
Протестируйте скан одной страницы с желаемыми параметрами (–mode, –resolution, –source).
Оцените результат: резкость, контраст, артефакты. Отрегулируйте параметры.
Запустите пакетное сканирование. Контролируйте первые несколько страниц.
Примените OCR/обработку и сохраните финальные файлы.

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

Отладка и типичные проблемы

Important: перед любой отладкой убедитесь, что у вас есть права на устройство (обычно требуется членство в группе scanner или правильные udev-правила).

Проблема: scanimage не видит устройство.

Проверьте подключение USB/сеть.
Выполните scanimage -L. Если устройство не в списке, посмотрите вывод dmesg для USB-ошибок.
Для сетевых сканеров убедитесь, что они доступны по IP и портам, а firewall/avahi не блокирует обнаружение.

Проблема: медленный вывод справки при наличии устройства.

Это нормально: backend опрашивает устройство. Подождите.

Проблема: опция –source не распознаётся.

Набор опций зависит от backend’а. Запустите scanimage -A и изучите доступные параметры или обратитесь к документации производителя.

Проблема: качество OCR низкое.

Увеличьте разрешение до 300–600 dpi.
Переключитесь на Grayscale вместо Lineart для старых или шумных документов.
Выполните предобработку: обрезка, выравнивание, удаление фона.

Полезный шпаргалка (cheat sheet)

Установка: sudo apt install sane
Справка: scanimage -h
Список устройств: scanimage -L
Явное устройство: scanimage -d -o out.png
Явный формат: scanimage –format=tiff -o out.tiff
Batch (ADF): scanimage –batch=file-%d.tiff –batch-count=100 –source Automatic

Примеры из статьи (сохранены оригинальные команды)

sudo apt install sane
scanimage -h
scanimage -A
scanimage > scan_out
scanimage -o scan_out.png
scanimage -L
scanimage -d epson2:net:192.168.1.26 -o scan_out.png
scanimage --format=tiff -o scan_out.tiff
scanimage --batch=document-A-%d.pnm --format=pnm --batch-count=1 --mode Lineart --resolution 1200 --source Automatic

Вывод справки scanimage и доступные опции

Чеклисты по ролям

Домашний пользователь:

Убедиться, что сканер подключён и включён.
Выполнить scanimage -L.
Сканировать один лист в PNG или JPEG для просмотра: scanimage -o test.png.
При пакетной загрузке проверять первые 3–5 страниц.

Системный администратор / DevOps:

Установить sane и обеспечить корректные udev-правила.
Настроить права доступа для группы scanner.
Организовать сетевое обнаружение для сетевых сканеров (Avahi/Bonjour).
Автоматизировать бэкап сканов и логи.

Архивист / профессионал по цифровизации:

Использовать TIFF/Без потерь для долгосрочного хранения.
Протестировать разные режимы и разрешения на образце документов.
Документировать параметры сканирования для каждой коллекции.
Выполнять OCR и сохранять оригинал + текстовое представление.

Когда SANE/scanimage может не подойти

Очень старые или проприетарные сканеры без поддержки SANE.
Устройства со сложными функциями (специализированные презентационные сканеры) — возможно, потребуется собственное ПО производителя.
Для сканирования плёнок/слайдов могут понадобиться специализированные сканеры и драйверы.

Альтернативы: использовать графические фронтенды (xsane, simple-scan) или проприетарные утилиты производителя, если требуется GUI и специфичные функции.

Поток принятия решений (Mermaid)

flowchart TD
  A[Начало: есть сканер?] -->|Нет| B[Купить совместимый сканер или использовать прокси]
  A -->|Да| C[Подключить и проверить scanimage -L]
  C -->|Не обнаружен| D[Проверить USB/сеть, права, udev]
  C -->|Обнаружен| E{Нужен ADF?}
  E -->|Да| F[Использовать --source Automatic и --batch]
  E -->|Нет| G[Использовать одиночный скан: scanimage -o]
  F --> H{Нужен OCR?}
  G --> H
  H -->|Да| I[Сканировать в PNM/TIFF -> применить tesseract/gocr]
  H -->|Нет| J[Сохранять в TIFF/PNG для архива или мгновенного просмотра]

Краткое резюме

SANE и scanimage — удобный инструмент для автоматизированного сканирования в средах Linux/Unix. Они хорошо подходят для пакетной обработки через ADF, скриптования и интеграции с OCR. Однако набор доступных опций зависит от backend’а для вашей модели сканера — экспериментируйте и документируйте лучшие параметры для ваших задач.

Критерии приёмки:

Устройство отображается в выводе scanimage -L.
Первый тестовый скан соответствует минимальным требованиям качества (читаемость текста для OCR или визуальное соответствие для изображений).
При пакетной обработке ADF сдаёт не менее ожидаемого числа страниц без застреваний (или процесс автоматически логирует ошибки).

Итоговая рекомендация: начните со стандартных команд, протестируйте параметры backend’а для вашей модели, а затем автоматизируйте процесс с учётом требований к качеству и хранению.