История страницы
...
Process the image of the text document Version 1 (python)
Группа действийAction group: Robin OCR
Описание
Действие выполняет автоматическую обработку изображения текстового документа для улучшения его качества.
Иконка действия
Параметры действия
Входные параметры
Description
The action performs automatic image processing of a text document to improve its quality.
Action icon
Action parameters
Input parameters
- "Image" field - specify the image of acceptable format to be processed.
- "Page number" field - indicates the page number, if the submitted document is multi-page, for example
- Поле "Изображение" – указывается изображение допустимого формата, которое нужно обработать.
- Поле "Номер страницы" – указывается номер страницы, если поданный документ многостраничный, например, *.png.
- Поле "Предобработка яркости и контрастности" – указывается, необходимо ли проводить предобработку. Яркость и контрастность изображения будут исправлены в начале обработки. Если также отмечено поле "Постобработка яркости и контрастности", то по умолчанию будет использована постобработка.
- Поле "Исправить искажения" – указывается, необходимо ли исправить плоскостные искажения.
- Поле "Выровнять по горизонтали" – указывается, необходимо ли выровнять изображение по горизонтали.
- Поле "Постобработка яркости и контрастности" – указывается, необходимо ли проводить предобработку. Яркость и контрастность изображения будут исправлены в конце обработки. Если также отмечено поле "Постобработка яркости и контрастности", то по умолчанию будет использована постобработка.
- Поле "Путь к папке" – указывается путь, по которому необходимо сохранить обработанное изображение.
- Поле "Имя файла" – указывается новое имя для файла обработанного изображения.
- Поле "Формат" – указывается формат, в котором будет сохранено обработанное изображение.
- Поле "Перезаписать" – указывается, необходимо ли перезаписать файл в указанной папке.
Выходные параметры
- Результат - Путь к файлу изображения.
Настройки
- "Brightness and contrast preprocessing" field - indicates whether preprocessing is necessary or not. Brightness and contrast of the image will be corrected at the beginning of processing. If the "Brightness and contrast postprocessing" field is also checked, postprocessing will be used by default.
- "Correct distortions" field - indicates whether it is necessary to correct plane distortions.
- "Align horizontally" field - indicates whether it is necessary to align the image horizontally.
- "Brightness and contrast post-processing" field - indicates whether it is necessary to perform pre-processing. Brightness and contrast of the image will be corrected at the end of processing. If the "Brightness and contrast post-processing" field is also checked, postprocessing will be used by default.
- "Folder path" field - specifies the path where you want to save the processed image.
- "File name" field - specifies a new name for the processed image file.
- "Format" field - specifies the format in which the processed image will be saved.
- "Overwrite" field - indicates whether it is necessary to overwrite the file in the specified folder.
Output parameters
- Result - Path to the image file.
Settings
| Property | Description | Type | Filling example | Mandatory field |
|---|---|---|---|---|
| Parameters | ||||
| Image | The path to the image file of the document to be processed. | Robin.FilePath | Yes | |
| Page number | The page number of the file to be processed. If the field is not filled in, the processing will be applied to all pages of the file. If the image is not in tiff or tif format, the field will not be taken into account. | Robin.Numeric | No | |
| Brightness and contrast preprocessing | The page number of the file to be processedIf the value is «true», then the brightness and contrast of the image will be corrected at the beginning of processing. If the value of «Brightness and Contrast Postprocessing» is also «true», then postprocessing will be used by default. | Robin.Boolean | true | No |
| Correct distortions | If the value is «true», then all distortions in the plane will be corrected in the image. | Robin.Boolean | true | No |
| Align horizontally | If the value is «true», then the image will be aligned horizontally. | Robin.Boolean | true | No |
| Brightness and contrast post- processing | If the value is «true», then the brightness and contrast of the image will be corrected at the end of processing. If the value «Brightness and Contrast Preprocessing» is also true, then postprocessing will be used by default. | Robin.Boolean | true | No |
| Folder path | The path to the folder where the processed image file will be saved. If the field remains empty, the file will be saved in the source folder | |||
Свойство
Описание
Тип
Пример заполнения
Обязательность заполнения поля
Параметры
Изображение
Путь к файлу изображения документа, которое необходимо обработать. Допустимые расширения изображений: jpg, jpeg, jpe, ppm, bmp, dib, png, tif , tiff.
Robin.FilePath
C:\doc\img.png
Да
| . | Robin.FolderPath | C:\ |
| doc\ |
Имя файла
| img | No |
| File name | The name of the processed image file. If the field remains empty, the original file name will be saved |
| . | Robin.String |
| No |
Нет
Формат
Формат, в котором будет сохранен файл обработанного изображения. Если поле остается пустым, то файл сохраняется в том же формате, что и исходное изображение.
| Format | The format in which the processed image file will be saved. If the field remains empty, the file is saved in the same format as the original image |
| . | Robin.String |
| No |
Нет
Перезаписать
| Overwrite | If the value is «true» and an image file with the same name and extension exists in the specified folder, then the new file will overwrite it. If «false», the file will not be overwritten and the action will return an error. | Robin.Boolean | true |
| No |
| Results |
|---|
Результат
| Result | The path to the processed image file |
| . | Robin.FilePath |
C:\doc\img.png
Особые условия использования
Special conditions of use
- The action works correctly with document images.
- Valid image extensions
- Действие корректно работает с изображениями документов.
- Допустимые расширения изображений: jpg, jpeg, jpe, ppm, bmp, dib, png, tif , tiff. Если выбрано иное расширение, то действие выдаст ошибку. Описание ошибки: "Указано недопустимое расширение".
- Если изображение многостраничное, то пользователь может указать страницу, которою необходимо обработать. Если страница не указана, то обработка будет применена ко всему файлу. Если поданное изображение не многостраничное, то параметр "Номер страницы" игнорируется.
- Если указан неверный номер страницы файла, то действие выдаст ошибку. Описание ошибки: "Указана несуществующая страница документа.".
- Пользователь может поменять название и путь для сохранения обработанного изображения.
- Если пользователь не укажет имя файла, то сохранится исходное имя файла.
- Если пользователь не укажет путь к папке, то файл сохранится в исходной папке.
- Если пользователь укажет имя файла, но не укажет путь к папке, то файл будет сохранен с указанным именем в исходной папке.
- Если пользователь укажет путь к папке, но не укажет имя файла, то в указанной папке будет сохранен файл с исходным названием.
- Если пользователь не укажет имя файла и путь к папке, то необходимо заполнить "Перезаписать" = true для перезаписи существующего файла, иначе действие выдаст ошибку (прописана в пункте 12).
- Пользователь может указать новое расширение изображения, выбрав его из параметра "Формат". Если параметр не будет заполнен, то изображение сохранится в исходном расширении.
- Пользователь может переписать файл: если значение параметра перезаписи «true», и в указанной папке существует файл с таким же именем и расширением, то новый файл его перезапишет. Если «false», файл перезаписан не будет и действие выдаст ошибку. Описание ошибки: "Файл с указанным именем и расширением уже существует.".
- Параметры для обработки изображения: Предобработка яркости и контрастности, Исправить искажения, Выравнять по горизонтали, Постобработка яркости и контрастности.
- Предобработка меняет яркость и контрастность мягче, чем постобработка. Но предобработка может засветить границы изображения, которые необходимы для других параметров обработки изображения. Поэтому необходимо понимать, какие конкретно параметры обработки нужно применять к изображению. Если пользователь выберет постобработку и предобработку яркости и контрастности, то по умолчанию будет использована постобработка.
Пример использования
Задача
Существует изображение чека на рабочем столе, необходимо изменить яркость и контрастность изображения на значения: яркость - 50, контрастность 20.
Решение
Воспользоваться действием "Изменить яркость и контрастность".
Реализация
- Перенести действие ""Изменить яркость и контрастность" на рабочую область и настроить его параметры:
- Нажать на кнопку "Старт" в верхней панели.
Результат
Программный робот отработал успешно. Яркость и контрастность изображения изменена.
- If a different extension is selected, the action will generate an error. Error description: "An invalid extension is specified".
- If the image is multi-page, the user can specify the page to be processed. If no page is specified, the processing will be applied to the whole file. If the submitted image is not multi-page, the "Page number" parameter is ignored.
- If an invalid file page number is specified, the action will generate an error. Error description: "A nonexistent document page is specified.".
- The user can change the name and path to save the processed image.
- If the user does not specify a file name, the original file name will be saved.
- If the user does not specify a folder path, the file will be saved in the original folder.
- If the user specifies a file name but does not specify a folder path, the file will be saved with the specified name in the source folder.
- If the user specifies a folder path but does not specify a file name, the file will be saved with the original name in the specified folder.
- If the user does not specify a file name and folder path, "Overwrite" = true must be filled in to overwrite the existing file, otherwise the action will generate an error (prescribed in step 12).
The user can specify a new image extension by selecting it from the "Format" parameter. If the parameter is not filled in, the image will be saved in the original extension. - The user can overwrite a file: if the overwrite parameter is "true" and a file with the same name and extension exists in the specified folder, the new file will overwrite it. If "false", the file will not be overwritten and the action will generate an error. Error description: "A file with the specified name and extension already exists."
- Options for image processing: Brightness and contrast preprocessing, Correct distortions, Align horizontally, Brightness and contrast post-processing.
- Preprocessing changes brightness and contrast more gently than postprocessing. But pre-processing can illuminate image boundaries that are necessary for other image processing parameters. Therefore, it is necessary to understand which specific processing parameters to apply to the image. If the user selects post-processing and brightness and contrast pre-processing, post-processing will be used by default.
Example of use
Task
There is an image of a check on the desktop, you need to change the brightness and contrast of the image to the values: brightness - 50, contrast 20.
Solution
Use the "Change brightness and contrast" action.
Implementation
- Move the ""Change brightness and contrast" action to the workspace and set its parameters.
- Click on the "Start" button in the top panel.
Result
The program robot completed successfully. The brightness and contrast of the image has been changed.
Image after changing the brightness and contrastИзображение после изменения яркости и контрастности.
Обзор
Инструменты контента