История страницы
...
Обработать изображение текстового документа Версия 2 (Python)
Группа действий: Распознавание текста
Действие позволяет изменить яркость и контрастность изображения.
...
Robin OCR
...
Описание
Действие выполняет автоматическую обработку изображения текстового документа для улучшения его качества
Иконка действия
Параметры и их настройка
Свойство | Описание | Тип | Пример заполнения | Обязательность заполнения поля | |||||||||
Параметры | |||||||||||||
Изображение | Путь к файлу изображения . Поддерживаемые форматы: jpgдокумента, которое необходимо обработать. Допустимые расширения изображений: jpg, jpeg, jpe, ppm, bmp, dib, png, tif , tiff, sr, ras. | Robin.ImageFilePath | C:\doc\img.png | Да | Яркость | ||||||||
| Номер страницы | Номер страницы файла, которую необходимо обработать. Если поле не заполнено, то обработка будет применена ко всем страницам файла. Если изображение не в формате tiff или tif, то поле учитываться не будет | Процент изменения яркости изображения в диапазоне от -100% до 100%.Robin.Numeric | Нет | Контрастность | Процент изменения контрастности изображения в диапазоне от -100% до 100%". | Robin.Numeric | Нет | 3 | |||||
| Предобработка яркости и контрастности | Если значение "true", то яркость и контрастность изображения будут исправлены в начале обработки. Если значение "Постобработка яркости и контрастности" тоже "true", то по умолчанию будет использована постобработка | Robin.Boolean | true | ||||||||||
| Исправить искажения | Если значение "true", то в изображении исправятся все искажения в плоскости | Robin.Boolean | true | ||||||||||
| Выровнять по горизонтали | Если значение "true", то изображение будет выровнено по горизонтали | Robin.Boolean | true | ||||||||||
| Постобработка яркости и контрастности" | Если значение "true", то яркость и контрастность изображения будут исправлены в конце обработки. Если значение "Предобработка яркости и контрастности" тоже true, то по умолчанию будет использована постобработка | Robin.Boolean | true | ||||||||||
| Путь к папке | Имя файла | Название нового документа (без расширения), который будет создан. Если поле остается пустым, то файл сохраняется с тем же именем, который имел исходный файл. | Robin.String | Нет | ПапкаПуть к папке, в которую будет сохранен | документфайл обработанного изображения. | ЕслиЕсли поле | остаетсяостанется пустым, то файл | сохраняетсясохранится в исходной папке | Robin.FolderPath | C:\docs\images | ||
Имя файла | Название файла обработанного изображения. Если поле останется пустым, то сохранится исходное имя файла | Robin.String | new_image той же папке, в которой был открыт исходный файл.Robin.FolderPath | Нет | |||||||||
Формат | Выпадающий список из возможных форматов. Формат, в котором будет сохранен документ. Если котором будет сохранен файл обработанного изображения. Если поле остается пустым, то файл сохраняется в том же формате, который имел исходный файл.что и исходное изображение Выпадающий список. Элементы списка: jpg, jpeg, jpe, ppm, bmp, dib, png, tif, tiff | Robin.String | jpg | Нет | |||||||||
Перезаписать | Если значение равно True«true», и в указанной папке существует файл изображения с таким же именем и расширением, то новый файл его перезапишет. Если False«false», файл перезаписан не будет и действие вернет ошибку. | Robin.Boolean | true | Нет | |||||||||
| Результаты | |||||||||||||
Результат | Путь к файлу изображения. | Robin.ImageFilePath | C:\doc\img.png | ||||||||||
Особые условия
...
- Если поля "Папка", "Имя файла" не заполнены, то изменения применяются к поданному на вход изображению.
- Если заполнено поле "Папка" и не заполнено "Имя файла", то изменения сохраняются в указанную папку, имя файла остается без изменений.
- Если заполнено поле "Имя файла" и не заполнено "Папка", то изменения сохраняются в ту же папку, откуда был взят файл, но с новым именем файла.
Робот вернет ошибку, если:
- на вход подается не изображение;
- выбран диапазон не от -100% до 100%;
- указанного названия папки не существует;
- указанное название файла уже существует.
Как именно влияют на изображение изменение яркости и контрастности. Если переводить буквально: -100 превратит показатель в 0, а +100% только увеличит в 2 раза.
https://mass-images.pro/ru/batch/tpl/brightness - изменение яркости
https://mass-images.pro/ru/batch/tpl/contrast - изменение контрастности
+100 яркости тут превращает изображение в белое, а контрастность -100 - в серо
Пример использования
использования
- Действие корректно работает с изображениями документов.
- Допустимые расширения изображений: jpg, jpeg, jpe, ppm, bmp, dib, png, tif , tiff. Если выбрано иное расширение, то действие выдаст ошибку. Описание ошибки: "Указано недопустимое расширение".
- Если изображение многостраничное, то пользователь может указать страницу, которою необходимо обработать. Если страница не указана, то обработка будет применена ко всему файлу. Если поданное изображение не многостраничное, то параметр "Номер страницы" игнорируется.
- Если указан неверный номер страницы файла, то действие выдаст ошибку. Описание ошибки: "Указана несуществующая страница документа.".
- Пользователь может поменять название и путь для сохранения обработанного изображения.
- Если пользователь не укажет имя файла, то сохранится исходное имя файла.
- Если пользователь не укажет путь к папке, то файл сохранится в исходной папке.
- Если пользователь укажет имя файла, но не укажет путь к папке, то файл будет сохранен с указанным именем в исходной папке.
- Если пользователь укажет путь к папке, но не укажет имя файла, то в указанной папке будет сохранен файл с исходным названием.
- Если пользователь не укажет имя файла и путь к папке, то необходимо заполнить "Перезаписать" = true для перезаписи существующего файла, иначе действие выдаст ошибку (прописана в пункте 12).
- Пользователь может указать новое расширение изображения, выбрав его из параметра "Формат". Если параметр не будет заполнен, то изображение сохранится в исходном расширении.
- Пользователь может переписать файл: если значение параметра перезаписи «true», и в указанной папке существует файл с таким же именем и расширением, то новый файл его перезапишет. Если «false», файл перезаписан не будет и действие выдаст ошибку. Описание ошибки: "Файл с указанным именем и расширением уже существует.".
- Параметры для обработки изображения: Предобработка яркости и контрастности, Исправить искажения, Выравнять по горизонтали, Постобработка яркости и контрастности.
- Предобработка меняет яркость и контрастность мягче, чем постобработка. Но предобработка может засветить границы изображения, которые необходимы для других параметров обработки изображения. Поэтому необходимо понимать, какие конкретно параметры обработки нужно применять к изображению. Если пользователь выберет постобработку и предобработку яркости и контрастности, то по умолчанию будет использована постобработка.
Пример использования
Задача
Существует Задача: существует изображение чека на рабочем столе, необходимо изменить яркость и контрастность изображения на значения: яркость - 50, контрастность 20. 
Решение
Воспользоваться : воспользоваться действием "Изменить яркость и контрастность".
Реализация
...
- Перенести действие ""Изменить яркость и контрастность" на рабочую область и настроить его параметры:
- Нажать на кнопку "Старт" в верхней панели.
Результат
...
Программный робот отработал успешно. Яркость и контрастность изображения изменена. 
Изображение после изменения яркости и контрастности. 
Обзор
Инструменты контента