clip_region_relclip_region_relClipRegionRelClipRegionRelclip_region_rel (算子)
名称
clip_region_relclip_region_relClipRegionRelClipRegionRelclip_region_rel — 相对于其最小的周围矩形剪裁一个区域。
签名
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)
描述
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.
These four parameters must contain numbers larger or equal to zero. If
all parameters are set to zero, the region remains unchanged.
执行信息
- 多线程类型：可重入（与非独占算子并行运行）。
- 多线程作用域：全局（可从任何线程调用）。
- 在元组级别上自动并行化。
参数
RegionRegionRegionRegionregionregion (输入对象) region(-array) → objectHRegionHObjectHRegionHobject
Regions to be clipped.
RegionClippedRegionClippedRegionClippedRegionClippedregionClippedregion_clipped (输出对象) region(-array) → objectHRegionHObjectHRegionHobject *
Clipped regions.
TopTopTopToptoptop (输入控制) 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 (输入控制) 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 (输入控制) 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 (输入控制) 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 在所有参数正确时返回 2 ( H_MSG_TRUE )。当输入为空（未指定区域）时则可设置行为通过 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>) 以及输入区域为空时可设置行为通过 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>)。如有必要，则抛出异常。
可能的前趋
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
模块
基础