Обработать изображение текстового документа Версия 2 (Python)
Группа действий: Robin OCR
Описание
Действие выполняет автоматическую обработку изображения текстового документа для улучшения его качества
Иконка действия
Параметры и их настройка
Свойство | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
Параметры | ||||
Изображение | Путь к файлу изображения документа, которое необходимо обработать. Допустимые расширения изображений: jpg, jpeg, jpe, ppm, bmp, dib, png, tif , tiff | Robin.FilePath | C:\doc\img.png | Да |
Номер страницы | Номер страницы файла, которую необходимо обработать. Если поле не заполнено, то обработка будет применена ко всем страницам файла. Если изображение не в формате tiff или tif, то поле учитываться не будет | Robin.Numeric | 3 | |
Предобработка яркости и контрастности | Если значение "true", то яркость и контрастность изображения будут исправлены в начале обработки. Если значение "Постобработка яркости и контрастности" тоже "true", то по умолчанию будет использована постобработка | Robin.Boolean | true | |
Исправить искажения | Если значение "true", то в изображении исправятся все искажения в плоскости | Robin.Boolean | true | |
Выровнять по горизонтали | Если значение "true", то изображение будет выровнено по горизонтали | Robin.Boolean | true | |
Постобработка яркости и контрастности" | Если значение "true", то яркость и контрастность изображения будут исправлены в конце обработки. Если значение "Предобработка яркости и контрастности" тоже true, то по умолчанию будет использована постобработка | Robin.Boolean | true | |
Путь к папке | Путь к папке, в которую будет сохранен файл обработанного изображения. Если поле останется пустым, то файл сохранится в исходной папке | Robin.FolderPath | C:\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 |
Особые условия использования
- Действие корректно работает с изображениями документов.
- Допустимые расширения изображений: jpg, jpeg, jpe, ppm, bmp, dib, png, tif , tiff. Если выбрано иное расширение, то действие выдаст ошибку. Описание ошибки: "Указано недопустимое расширение".
- Если изображение многостраничное, то пользователь может указать страницу, которою необходимо обработать. Если страница не указана, то обработка будет применена ко всему файлу. Если поданное изображение не многостраничное, то параметр "Номер страницы" игнорируется.
- Если указан неверный номер страницы файла, то действие выдаст ошибку. Описание ошибки: "Указана несуществующая страница документа.".
- Пользователь может поменять название и путь для сохранения обработанного изображения.
- Если пользователь не укажет имя файла, то сохранится исходное имя файла.
- Если пользователь не укажет путь к папке, то файл сохранится в исходной папке.
- Если пользователь укажет имя файла, но не укажет путь к папке, то файл будет сохранен с указанным именем в исходной папке.
- Если пользователь укажет путь к папке, но не укажет имя файла, то в указанной папке будет сохранен файл с исходным названием.
- Если пользователь не укажет имя файла и путь к папке, то необходимо заполнить "Перезаписать" = true для перезаписи существующего файла, иначе действие выдаст ошибку (прописана в пункте 12).
- Пользователь может указать новое расширение изображения, выбрав его из параметра "Формат". Если параметр не будет заполнен, то изображение сохранится в исходном расширении.
- Пользователь может переписать файл: если значение параметра перезаписи «true», и в указанной папке существует файл с таким же именем и расширением, то новый файл его перезапишет. Если «false», файл перезаписан не будет и действие выдаст ошибку. Описание ошибки: "Файл с указанным именем и расширением уже существует.".
- Параметры для обработки изображения: Предобработка яркости и контрастности, Исправить искажения, Выравнять по горизонтали, Постобработка яркости и контрастности.
- Предобработка меняет яркость и контрастность мягче, чем постобработка. Но предобработка может засветить границы изображения, которые необходимы для других параметров обработки изображения. Поэтому необходимо понимать, какие конкретно параметры обработки нужно применять к изображению. Если пользователь выберет постобработку и предобработку яркости и контрастности, то по умолчанию будет использована постобработка.
Пример использования
Задача
Существует изображение чека на рабочем столе, необходимо изменить яркость и контрастность изображения на значения: яркость - 50, контрастность 20.
Решение
Воспользоваться действием "Изменить яркость и контрастность".
Реализация
- Перенести действие ""Изменить яркость и контрастность" на рабочую область и настроить его параметры:
- Нажать на кнопку "Старт" в верхней панели.
Результат
Программный робот отработал успешно. Яркость и контрастность изображения изменена.
Изображение после изменения яркости и контрастности.