Russian (Русский) - Change language

Гипотезы всех типов элементов

Гипотеза элемента может быть найденной или ненайденной. Найденная гипотеза содержит один или несколько объектов изображения или их фрагментов (исключение составляет элемент White Gap, который может не содержать ни одного объекта изображения).

Найденная гипотеза простого элемента на изображении всегда представляет собой связный регион. Гипотезы элементов типа White Gap, Separator, Barcode всегда представлены одним прямоугольником.

Если гипотеза строится на основе множества найденных объектов изображения, например, гипотеза элемента Paragraph, то регион гипотезы строится на основе массива прямоугольников найденных объектов. Сформированный таким образом регион можно получить при помощи метода Region гипотезы. При показе региона гипотезы на изображении, а также при формировании блока на основе гипотезы элемента, края региона не огибают в точности каждый из прямоугольников объектов изображения. Вместо этого границы области несколько сглаживаются в целях облегчения визуального восприятия региона. Сформированный таким образом регион можно получить при помощи метода SimplifiedRegion гипотезы. С помощью методов Region и SimplifiedRegion можно получить сформированный регион как в разделе Advanced pre-search relations на вкладке Advanced (при описании области поиска элемента), так и в поле Region expression при описании свойств блока на основе уже найденных элементов.

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

Границы Left, Top, Right, Bottom любой гипотезы представляют собой интервал. У найденной гипотезы каждый из этих интервалов является вырожденным, т.е. Left.Start = Left.End, Top.Start = Top.End и т.д. У ненайденной гипотезы интервалы сторон совпадают с соответствующими интервалами ее области поиска.

Обращение к сформированным гипотезам и их свойствам в коде в соответствующих диалогах свойств элементов и блоков дает дополнительные возможности по настройке гибкого описания. Доступ к гипотезам элементов осуществляется через имена элементов. В случае обращения к гипотезе текущего элемента в разделе Advanced Post-search relations доступ к ее свойствам может происходить с использованием только названия свойства, исключая имя самого элемента.

Обращение к гипотезе элемента, а также всем ее свойствам, происходит в режиме read-only. Обращение к гипотезам элементов доступно в разделах Advanced Pre-search relations и Advanced Post-search relations на вкладке Advanced в диалогах свойств элементов и Region expression в диалоге свойств блока. При этом в разделе Advanced Pre-search relations можно обращаться к сформированным гипотезам (и их свойствам) всех элементов, лежащих выше данного в дереве элементов, в разделе Advanced Post-search relations доступны сформированные гипотезы всех вышележащих элементов и гипотеза данного элемента, в разделе Region expression свойств блока доступны гипотезы (и их свойства) всех элементов.

В таблице приведены свойства, доступные у гипотез элементов любого типа.

Определение Описание
Logic IsNull() Является ли гипотеза нулевой (если элемент не найден, свойство IsNull гипотезы равно True).
Logic IsFound() Является ли гипотеза ненулевой (элемент найден, свойство IsNull гипотезы равно False). Равносильно not IsNull.
XInterval Left() Левая граница гипотезы, горизонтальный интервал в глобальных координатах
YInterval Top() Верхняя граница гипотезы, вертикальный интервал в глобальных координатах
XInterval Right() Правая граница гипотезы, горизонтальный интервал в глобальных координатах
YInterval Bottom() Нижняя граница гипотезы, вертикальный интервал в глобальных координатах
XInterval XCenter() Абсцисса центра гипотезы, горизонтальный интервал в глобальных координатах
YInterval YCenter() Ордината центра гипотезы, вертикальный интервал в глобальных координатах
DistInterval Width() Ширина гипотезы, интервал расстояний в глобальных координатах
DistInterval Height() Высота гипотезы, интервал расстояний в глобальных координатах
FuzzyRect FuzzyRect() Нечеткий прямоугольник гипотезы в глобальных координатах
Rect Rect() Описывающий прямоугольник гипотезы в глобальных координатах. Совпадает с внешним прямоугольником нечеткого прямоугольника гипотезы.
Region Region() Регион гипотезы в глобальных координатах.
Region SimplifiedRegion() Регион гипотезы в глобальных координатах, упрощенный для улучшения визуального восприятия.
ImageObjectSet Set() Объекты изображения, попавшие в состав гипотезы
ImageObjectSet ExcludeSet() Объекты изображения, попавшие в область изображения, исключенную из области поиска гипотезы методами типа Exclude
RectArray Rects() Массив прямоугольников, входящих в состав гипотезы. Для большинства элементов совпадает с массивом прямоугольников найденных объектов. Для элементов White Gap. Region.айденные объекты отсутствуют
Int HypothesesCount()

Число гипотез, которые есть в области поиска для данного элемента.

Внимание! Функцию можно использовать только в случае, если допустимое минимальное и максимальное число страниц документа равно 1, т.е. найденный документ заведомо одностраничный. При использовании этой функций в рамках многостраничного документа, при наложении гибкого описания возникнет ошибка.

PageInterval Pages() Диапазон страниц, на котором находится гипотеза
PageArea PageAreaGlobal( Int PageNumber ) Возвращает часть гипотезы, расположенную на данной странице в глобальных координатах
PageArea PageAreaLocal( Int PageNumber ) Возвращает часть гипотезы, расположенную на данной странице в локальных координатах страницы

Пример обращения к свойствам гипотезы

Сравнение методов Region Region() и Region SimplifiedRegion()

10.11.2020 12:08:08


Please leave your feedback about this article