clip_region_relclip_region_relClipRegionRelClipRegionRelclip_region_rel (Operator)

Name

clip_region_relclip_region_relClipRegionRelClipRegionRelclip_region_rel — Clip a region relative to its smallest surrounding rectangle.

Signature

clip_region_rel(Region : RegionClipped : Top, Bottom, Left, Right : )

Description

clip_region_relclip_region_relClipRegionRelClipRegionRelClipRegionRelclip_region_rel reduces the RegionRegionRegionRegionregionregion by eliminating parts close to the smallest surrounding rectangle of the RegionRegionRegionRegionregionregion. Specifically this means that the RegionRegionRegionRegionregionregion is clipped to a rectangle that is smaller than or equal to the smallest surrounding rectangle. The resulting clipped region is returned in RegionClippedRegionClippedRegionClippedRegionClippedregionClippedregion_clipped.

The rectangle to which the RegionRegionRegionRegionregionregion is clipped is determined by reducing the smallest surrounding axis-parallel rectangle at the top, bottom, left, and right side by the values given in TopTopTopToptoptop, BottomBottomBottomBottombottombottom, LeftLeftLeftLeftleftleft, and RightRightRightRightrightright, respectively.


( 1)	( 2)

Region with smallest surrounding rectangle (1) and clipped region (2).

These four parameters must contain numbers larger or equal to zero. If all parameters are set to zero, the region remains unchanged.

Execution Information

Multithreading type: reentrant (runs in parallel with non-exclusive operators).
Multithreading scope: global (may be called from any thread).
Automatically parallelized on tuple level.

Parameters

RegionRegionRegionRegionregionregion (input_object) region(-array) → object

Regions to be clipped.

RegionClippedRegionClippedRegionClippedRegionClippedregionClippedregion_clipped (output_object) region(-array) → object

Clipped regions.

TopTopTopToptoptop (input_control) integer → (integer)

Number of rows clipped at the top.

Default: 1

Suggested values: 0, 1, 2, 3, 4, 5, 7, 10, 20, 30, 50

Value range: 0 ≤ Top Top Top Top top top (lin)

Minimum increment: 1

Recommended increment: 1

BottomBottomBottomBottombottombottom (input_control) integer → (integer)

Number of rows clipped at the bottom.

Default: 1

Suggested values: 0, 1, 2, 3, 4, 5, 7, 10, 20, 30, 50

Value range: 0 ≤ Bottom Bottom Bottom Bottom bottom bottom (lin)

Minimum increment: 1

Recommended increment: 1

LeftLeftLeftLeftleftleft (input_control) integer → (integer)

Number of columns clipped at the left.

Default: 1

Suggested values: 0, 1, 2, 3, 4, 5, 7, 10, 20, 30, 50

Value range: 0 ≤ Left Left Left Left left left (lin)

Minimum increment: 1

Recommended increment: 1

RightRightRightRightrightright (input_control) integer → (integer)

Number of columns clipped at the right.

Default: 1

Suggested values: 0, 1, 2, 3, 4, 5, 7, 10, 20, 30, 50

Value range: 0 ≤ Right Right Right Right right right (lin)

Minimum increment: 1

Recommended increment: 1

Result

clip_region_relclip_region_relClipRegionRelClipRegionRelClipRegionRelclip_region_rel returns 2 ( H_MSG_TRUE) if all parameters are correct. The behavior in case of empty input (no regions given) can be set via set_system('no_object_result',<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>) and the behavior in case of an empty input region via set_system('empty_region_result',<Result>)set_system("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)set_system("empty_region_result",<Result>). If necessary, an exception is raised.

Possible Predecessors

thresholdthresholdThresholdThresholdThresholdthreshold, connectionconnectionConnectionConnectionConnectionconnection, regiongrowingregiongrowingRegiongrowingRegiongrowingRegiongrowingregiongrowing, pouringpouringPouringPouringPouringpouring

Possible Successors

select_shapeselect_shapeSelectShapeSelectShapeSelectShapeselect_shape, disp_regiondisp_regionDispRegionDispRegionDispRegiondisp_region

Alternatives

smallest_rectangle1smallest_rectangle1SmallestRectangle1SmallestRectangle1SmallestRectangle1smallest_rectangle1, intersectionintersectionIntersectionIntersectionIntersectionintersection, gen_rectangle1gen_rectangle1GenRectangle1GenRectangle1GenRectangle1gen_rectangle1, clip_regionclip_regionClipRegionClipRegionClipRegionclip_region

Module

Foundation

Operators