clip_region_relclip_region_relClipRegionRelClipRegionRelclip_region_rel (Operator)

名称

clip_region_relclip_region_relClipRegionRelClipRegionRelclip_region_rel — 相对于其最小的周围矩形剪裁一个区域。

签名

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

Herror clip_region_rel(const Hobject Region, Hobject* RegionClipped, const Hlong Top, const Hlong Bottom, const Hlong Left, const Hlong Right)

Herror T_clip_region_rel(const Hobject Region, Hobject* RegionClipped, const Htuple Top, const Htuple Bottom, const Htuple Left, const Htuple Right)

void ClipRegionRel(const HObject& Region, HObject* RegionClipped, const HTuple& Top, const HTuple& Bottom, const HTuple& Left, const HTuple& Right)

HRegion HRegion::ClipRegionRel(Hlong Top, Hlong Bottom, Hlong Left, Hlong Right) const

static void HOperatorSet.ClipRegionRel(HObject region, out HObject regionClipped, HTuple top, HTuple bottom, HTuple left, HTuple right)

HRegion HRegion.ClipRegionRel(int top, int bottom, int left, int right)

def clip_region_rel(region: HObject, top: int, bottom: int, left: int, right: int) -> HObject

描述

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.

Bottom = 0 Top = 10 Right = 20 Left = 10 Region RegionClipped
( 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.

执行信息

参数

RegionRegionRegionRegionregionregion (input_object)  region(-array) objectHRegionHObjectHRegionHobject

Regions to be clipped.

RegionClippedRegionClippedRegionClippedRegionClippedregionClippedregion_clipped (output_object)  region(-array) objectHRegionHObjectHRegionHobject *

Clipped regions.

TopTopTopToptoptop (input_control)  integer HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Number of rows clipped at the top.

默认值: 1

建议值: 0, 1, 2, 3, 4, 5, 7, 10, 20, 30, 50

值范围: 0 ≤ Top Top Top Top top top (lin)

最小增量: 1

建议增量: 1

BottomBottomBottomBottombottombottom (input_control)  integer HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Number of rows clipped at the bottom.

默认值: 1

建议值: 0, 1, 2, 3, 4, 5, 7, 10, 20, 30, 50

值范围: 0 ≤ Bottom Bottom Bottom Bottom bottom bottom (lin)

最小增量: 1

建议增量: 1

LeftLeftLeftLeftleftleft (input_control)  integer HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Number of columns clipped at the left.

默认值: 1

建议值: 0, 1, 2, 3, 4, 5, 7, 10, 20, 30, 50

值范围: 0 ≤ Left Left Left Left left left (lin)

最小增量: 1

建议增量: 1

RightRightRightRightrightright (input_control)  integer HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Number of columns clipped at the right.

默认值: 1

建议值: 0, 1, 2, 3, 4, 5, 7, 10, 20, 30, 50

值范围: 0 ≤ Right Right Right Right right right (lin)

最小增量: 1

建议增量: 1

结果

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.

可能的前置算子

thresholdthresholdThresholdThresholdThresholdthreshold, connectionconnectionConnectionConnectionConnectionconnection, regiongrowingregiongrowingRegiongrowingRegiongrowingRegiongrowingregiongrowing, pouringpouringPouringPouringPouringpouring

可能的后继算子

select_shapeselect_shapeSelectShapeSelectShapeSelectShapeselect_shape, disp_regiondisp_regionDispRegionDispRegionDispRegiondisp_region

替代算子

smallest_rectangle1smallest_rectangle1SmallestRectangle1SmallestRectangle1SmallestRectangle1smallest_rectangle1, intersectionintersectionIntersectionIntersectionIntersectionintersection, gen_rectangle1gen_rectangle1GenRectangle1GenRectangle1GenRectangle1gen_rectangle1, clip_regionclip_regionClipRegionClipRegionClipRegionclip_region

模块

Foundation