Обрезать изображение

Активность выполняет обрезку изображения на основе координат, полученных от сервера распознавания (тип обрезки “Поля”), либо указанных пользователем (тип обрезки “Прямоугольники”). Позволяет извлекать конкретные области документа (текстовые блоки, печати, подписи и др.), а также произвольные прямоугольные области, для последующей обработки или анализа.

Перед началом работы

Установите в Студии библиотеку Primo.AI.Server.

Свойства

Символ * указывает на обязательность заполнения свойства. Описание общих свойств см. в разделе Свойства элемента.

Вывод

1. Обрезанные изображения [List<String>] - Пути к сохраненным файлам (формат: <класс>_<confidence>.jpg). Пример: “signature_0.987.jpg”.
2. Обрезанные области [List<FieldCropsExtractorResult>] - Метаданные обрезанных областей.

Обработка

1. Изображение [String] - Путь к исходному файлу с изображением (JPG/JPEG/PNG).
2. Путь для сохранения [String] - Путь к директории для сохранения обрезанных изображений.
3. Тип обрезки [Primo.AI.Server.Model.CropType] - Тип обрезки. Доступны два значения: Поля и Прямоугольники. При выборе типа “Поля” для обрезки изображения будут автоматически использоваться поля, полученные на этапе распознавания. При выборе режима “Прямоугольники” для обрезки будут использоваться прямоугольники, заданные в свойстве Прямоугольники.

Нарезка по полям

1. Лимит для поля [int] - Максимальное количество обрезок для одного типа поля (≥1). Пример: 2.
2. Наименования полей [List<String>] - Список полей для обрезки (если пусто - обрабатываются все).
3. Отступ по горизонтали [int] - На сколько пикселей расширить область по X (≥0). Пример: 10. Расширит область на 10px влево и вправо.
4. Отступ по вертикали [int] - На сколько пикселей расширить область по Y (≥0). Пример: 5. Расширит область на 5px вверх и вниз.
5. Результат распознавания [Primo.AI.Server.Model.InferenceResultContent] - Файл JSON с данными распознавания (поля, координаты, confidence).

Нарезка по прямоугольникам

1. Прямоугольники* [List<System.Drawing.Rectangle>] - Прямоугольники для обрезки. Координаты в формате (X, Y, Width, Height).

Структура FieldCrop

Свойства:

1. FieldType [String] - Тип распознанного поля. Пример: "signature".
2. CropArea [System.Drawing.Rectangle] - Координаты в формате (X, Y, Width, Height). Пример: {X=100, Y=200, Width=80, Height=40}.

Структура FieldCropsExtractorResult

Свойства:

1. IsFound [Boolean] - Флаг успешности поиска.
2. Items [Systems.Collections.Generic.IReadOnlyCollection<Primo.AI.Server.Tools.SmartOcr.FieldCrop>] - Элементы поиска.