clip_regionclip_regionClipRegionClipRegionclip_region剪裁区域（算子）
名称
clip_regionclip_regionClipRegionClipRegionclip_region — 将区域剪裁为矩形。
签名
Herror clip_region(const Hobject Region, Hobject* RegionClipped, const Hlong Row1, const Hlong Column1, const Hlong Row2, const Hlong Column2)
Herror T_clip_region(const Hobject Region, Hobject* RegionClipped, const Htuple Row1, const Htuple Column1, const Htuple Row2, const Htuple Column2)
描述
clip_regionclip_regionClipRegionClipRegionClipRegionclip_region 将输入区域剪裁为由四个控制参数指定的矩形。相较于调用 intersectionintersectionIntersectionIntersectionIntersectionintersection 并使用 gen_rectangle1gen_rectangle1GenRectangle1GenRectangle1GenRectangle1gen_rectangle1 生成的矩形，clip_regionclip_regionClipRegionClipRegionClipRegionclip_region 具有更高的效率。
执行信息
- 多线程类型：可重入（与非独占算子并行运行）。
- 多线程作用域：全局（可从任何线程调用）。
- 在元组级别上自动并行化。
参数
RegionRegionRegionRegionregionregion (输入对象) region(-array) → objectHRegionHObjectHRegionHobject
待剪裁的区域。
RegionClippedRegionClippedRegionClippedRegionClippedregionClippedregion_clipped (输出对象) region(-array) → objectHRegionHObjectHRegionHobject *
剪裁区域。
Row1Row1Row1Row1row1row_1 (输入控制) rectangle.origin.y → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
矩形左上角的行坐标。
默认值：
0
建议值：
0, 128, 200, 256
值范围：
Row1
Row1
Row1
Row1
row1
row_1
(lin)
Column1Column1Column1Column1column1column_1 (输入控制) rectangle.origin.x → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
矩形左上角的列坐标。
默认值：
0
建议值：
0, 128, 200, 256
值范围：
Column1
Column1
Column1
Column1
column1
column_1
(lin)
Row2Row2Row2Row2row2row_2 (输入控制) rectangle.corner.y → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
矩形右下角的行坐标。
默认值：
256
建议值：
128, 200, 256, 512
值范围：
0
≤
Row2
Row2
Row2
Row2
row2
row_2
≤
511 (lin)
最小增量：
1
建议增量：
10
Column2Column2Column2Column2column2column_2 (输入控制) rectangle.corner.x → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
矩形右下角的列坐标。
默认值：
256
建议值：
128, 200, 256, 512
值范围：
0
≤
Column2
Column2
Column2
Column2
column2
column_2
≤
511 (lin)
最小增量：
1
建议增量：
10
结果
clip_regionclip_regionClipRegionClipRegionClipRegionclip_region 在所有参数正确时返回 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
替代
intersectionintersectionIntersectionIntersectionIntersectionintersection,
gen_rectangle1gen_rectangle1GenRectangle1GenRectangle1GenRectangle1gen_rectangle1,
clip_region_relclip_region_relClipRegionRelClipRegionRelClipRegionRelclip_region_rel
模块
基础