Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

...

Обработать изображение текстового документа / Process the image of the text document

Группа действий: Распознавание текста 

Действие позволяет изменить яркость и контрастность изображения.

Robin OCR

...

Описание

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

Иконка


Параметры действия 

  • Поле "Изображение" –  
  • Поле "Номер страницы" – 
  • Поле "Предобработка яркости и контрастности" – 
  • Поле "Исправить искажения" – 
  • Поле "Выровнять по горизонтали" – 
  • Поле "Постобработка яркости и контрастности" – 
  • Поле "Путь к папке" – 
  • Поле "Имя файла" – 
  • Поле "Формат" – 
  • Поле "Перезаписать" – 

Настройки 

...


Процент изменения яркости изображения в диапазоне от -100% до 100%Процент изменения контрастности изображения в диапазоне от -100% до 100%"NumericПапка документ Если остается сохраняется

Свойство

Описание

Тип

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

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

Параметры

Изображение

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

Robin.ImageFilePath

C:\doc\img.png

Да

Яркость

Номер страницыНомер страницы файла, которую необходимо обработать. Если поле не заполнено, то обработка будет применена ко всем страницам файла. Если изображение не в формате tiff или tif, то поле учитываться не будет.Robin.Numeric

Нет

Контрастность

3
Предобработка яркости и контрастностиЕсли значение "true", то яркость и контрастность изображения будут исправлены в начале обработки. Если значение "Постобработка яркости и контрастности" тоже "true", то по умолчанию будет использована постобработка.Robin.Booleantrue
Исправить искаженияЕсли значение "true", то в изображении исправятся все искажения в плоскости.Robin.Boolean

Нет

Имя файла

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

Robin.String

Нет

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

Имя файла

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

Robin.FolderPathString

new_image

Нет

Формат

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

Выпадающий список. Элементы списка: 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 - изменение контрастности

...

  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. 

...