Nearest Functions

Nearest functions in FlexiLayout (NearestX, NearestY, Nearest by interval, page edge, or hypothesis) that select the hypothesis closest to a reference.

Nearest functions tell the program that, other things being equal, it must select the hypothesis that is nearest to a certain element or point on the image that is specified by the parameters of the Nearest function. In the Search Conditions section of the element, you can use only one Nearest function. After the function is applied, only one hypotheses from a group of several hypotheses is selected. The selection occurs when hypotheses are being generated for the element, i.e. before the code entered in the Hypotheses Evaluation section is executed.

Nearest functions can be used to select hypotheses for any kind of elements except Groups and Repeating Groups.

Function	Description
Void NearestX( XCoordinate x )	Selects the hypothesis nearest to the vertical line which goes through the point ( x, 0 ). Example: The code below specifies that the sought element is horizontally nearest to the right boundary of the ElementName element. NearestX: ElementName.Right.Start;
Void NearestY( YCoordinate y )	Selects the hypothesis nearest to the horizontal line which goes through the point ( 0, y ). Example: The code below specifies that the sought element is vertically nearest to the top boundary of the ElementName element. NearestY: ElementName.Top.Start;
Void Nearest( XInterval x, YInterval y )	Selects the hypothesis nearest to the rectangle Rect( x.Start, y.Start, x.End, y.End ). Example: The code below specifies that the sought element is closest to the center of the ElementName element. Nearest: ElementName.XCenter, ElementName.YCenter; The code below specifies that the sought element is closest to the center of the page. Nearest: Page(1).RectGlobal.XCenter, Page(1).RectGlobal.YCenter;
Void Nearest( PageEdge )	Selects the hypothesis on each page of the document that is nearest to one of the page edges - top, bottom, right or left. Note: If several hypotheses are at the same distance from the specified boundary, several hypotheses may be selected. Example: To specify that the current element is closest to the bottom edge of the page, write. Nearest: PageBottom;
Void Nearest( Hypothesis hyp )	Selects the hypothesis nearest to the fuzzy rectangle hyp.Rect. Example: The code below specifies that the sought element is closest to the ElementName element. Nearest: ElementName;
Void Nearest( HypothesisInstances )	Selects the hypothesis closest to the set of hypothesis for the specified Repeating Group element.