Обработать изображение текстового документа Версия 2 (Python)

Группа действий: Robin OCR


Описание

Действие выполняет автоматическую обработку изображения текстового документа для улучшения его качества

Иконка действия

Параметры и их настройка

Свойство

Описание

Тип

Пример заполнения

Обязательность заполнения поля

Параметры

Изображение

Путь к файлу изображения документа, которое необходимо обработать. Допустимые расширения изображений: jpg, jpeg, jpe, ppm, bmp, dib, png, tif , tiff

Robin.FilePath

C:\doc\img.png

Да

Номер страницыНомер страницы файла, которую необходимо обработать. Если поле не заполнено, то обработка будет применена ко всем страницам файла. Если изображение не в формате tiff или tif, то поле учитываться не будетRobin.Numeric3
Предобработка яркости и контрастностиЕсли значение "true", то яркость и контрастность изображения будут исправлены в начале обработки. Если значение "Постобработка яркости и контрастности" тоже "true", то по умолчанию будет использована постобработкаRobin.Booleantrue
Исправить искаженияЕсли значение "true", то в изображении исправятся все искажения в плоскостиRobin.Booleantrue
Выровнять по горизонталиЕсли значение "true", то изображение будет выровнено по горизонталиRobin.Booleantrue
Постобработка яркости и контрастности"Если значение "true", то яркость и контрастность изображения будут исправлены в конце обработки. Если значение "Предобработка яркости и контрастности" тоже true, то по умолчанию будет использована постобработкаRobin.Booleantrue
Путь к папкеПуть к папке, в которую будет сохранен файл обработанного изображения. Если поле останется пустым, то файл сохранится в исходной папкеRobin.FolderPathC:\docs\images

Имя файла

Название файла обработанного изображения. Если поле останется пустым, то сохранится исходное имя файла

Robin.String

new_image

Нет

Формат

Формат, в котором будет сохранен файл обработанного изображения. Если поле остается пустым, то файл сохраняется в том же формате, что и исходное изображение

Выпадающий список. Элементы списка: jpg, jpeg, jpe, ppm, bmp, dib, png, tif, tiff

Robin.String

jpg

Нет

Перезаписать

Если значение «true», и в указанной папке существует файл изображения с таким же именем и расширением, то новый файл его перезапишет. Если «false», файл перезаписан не будет и действие вернет ошибку

Robin.Boolean

true

Нет

Результаты

Результат

Путь к файлу изображения

Robin.FilePath

C:\doc\img.png


Особые условия использования 

  1. Действие корректно работает с изображениями документов.
  2. Допустимые расширения изображений: jpg, jpeg, jpe, ppm, bmp, dib, png, tif , tiff. Если выбрано иное расширение, то действие выдаст ошибку. Описание ошибки: "Указано недопустимое расширение".
  3. Если изображение многостраничное, то пользователь может указать страницу, которою необходимо обработать. Если страница не указана, то обработка будет применена ко всему файлу. Если поданное изображение не многостраничное, то параметр "Номер страницы" игнорируется.
  4. Если указан неверный номер страницы файла, то действие выдаст ошибку. Описание ошибки: "Указана несуществующая страница документа.".
  5. Пользователь может поменять название и путь для сохранения обработанного изображения.
  6. Если пользователь не укажет имя файла, то сохранится исходное имя файла.
  7. Если пользователь не укажет путь к папке, то файл сохранится в исходной папке.
  8. Если пользователь укажет имя файла, но не укажет путь к папке, то файл будет сохранен с указанным именем в исходной папке.
  9. Если пользователь укажет путь к папке, но не укажет имя файла, то в указанной папке будет сохранен файл с исходным названием.
  10. Если пользователь не укажет имя файла и путь к папке, то необходимо заполнить "Перезаписать" = true для перезаписи существующего файла, иначе действие выдаст ошибку (прописана в пункте 12).
  11. Пользователь может указать новое расширение изображения, выбрав его из параметра "Формат". Если параметр не будет заполнен, то изображение сохранится в исходном расширении.
  12. Пользователь может переписать файл: если значение параметра перезаписи «true», и в указанной папке существует файл с таким же именем и расширением, то новый файл его перезапишет. Если «false», файл перезаписан не будет и действие выдаст ошибку. Описание ошибки: "Файл с указанным именем и расширением уже существует.".
  13. Параметры для обработки изображения: Предобработка яркости и контрастности, Исправить искажения, Выравнять по горизонтали, Постобработка яркости и контрастности.
  14. Предобработка меняет яркость и контрастность мягче, чем постобработка. Но предобработка может засветить границы изображения, которые необходимы для других параметров обработки изображения. Поэтому необходимо понимать, какие конкретно параметры обработки нужно применять к изображению. Если пользователь выберет постобработку и предобработку яркости и контрастности, то по умолчанию будет использована постобработка.

Пример использования 

Задача

Существует изображение чека на рабочем столе, необходимо изменить яркость и контрастность изображения на значения: яркость - 50, контрастность 20.

Решение

Воспользоваться действием "Изменить яркость и контрастность". 

Реализация

  1. Перенести действие ""Изменить яркость и контрастность" на рабочую область и настроить его параметры:

  2. Нажать на кнопку "Старт" в верхней панели. 

Результат

Программный робот отработал успешно. Яркость и контрастность изображения изменена.

Изображение после изменения яркости и контрастности.

  • Нет меток