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 通过消除靠近 RegionRegionRegionRegionregionregion 最小包围矩形的部分来缩小
RegionRegionRegionRegionregionregion。具体而言，这意味着 RegionRegionRegionRegionregionregion 被剪裁为一个小于或等于最小包围矩形的矩形。最终剪裁后的区域将通过
RegionClippedRegionClippedRegionClippedRegionClippedregionClippedregion_clipped 返回。
RegionRegionRegionRegionregionregion 的剪裁矩形由缩减顶部、底部、左侧和右侧的最小轴平行矩形确定，缩减量分别取自 TopTopTopToptoptop、BottomBottomBottomBottombottombottom、LeftLeftLeftLeftleftleft 和 RightRightRightRightrightright 的数值。
这四个参数必须包含大于或等于零的数值。若所有参数均设为零，则区域保持不变。
执行信息
- 多线程类型：可重入（与非独占算子并行运行）。
- 多线程作用域：全局（可从任何线程调用）。
- 在元组级别上自动并行化。
参数
RegionRegionRegionRegionregionregion (输入对象) region(-array) → objectHRegionHObjectHRegionHobject
待剪裁的区域。
RegionClippedRegionClippedRegionClippedRegionClippedregionClippedregion_clipped (输出对象) region(-array) → objectHRegionHObjectHRegionHobject *
剪裁区域。
TopTopTopToptoptop (输入控制) integer → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
顶部剪裁的行数。
默认值：
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)
底部剪裁的行数。
默认值：
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)
左侧剪裁的列数。
默认值：
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)
右侧剪裁的列数。
默认值：
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
模块
基础