crop_domain_relcrop_domain_relCropDomainRelCropDomainRelcrop_domain_rel (Operator)
名称
crop_domain_relcrop_domain_relCropDomainRelCropDomainRelcrop_domain_rel — 剪切相对于域的图像区域。
签名
Herror crop_domain_rel(const Hobject Image, Hobject* ImagePart, const Hlong Top, const Hlong Left, const Hlong Bottom, const Hlong Right)
Herror T_crop_domain_rel(const Hobject Image, Hobject* ImagePart, const Htuple Top, const Htuple Left, const Htuple Bottom, const Htuple Right)
描述
crop_domain_relcrop_domain_relCropDomainRelCropDomainRelCropDomainRelcrop_domain_rel cuts a rectangular area from the input
images. The area is determined by the surrounding rectangle of the
domain of the input image. The rectangle can be influenced by the
control parameters to modify at the top (TopTopTopToptoptop), at the left
(LeftLeftLeftLeftleftleft), at the bottom (BottomBottomBottomBottombottombottom), and at the right
(RightRightRightRightrightright). Positive values results in a smaller, negative
values in a larger size. If all parameters are set to zero, the
region remains unchanged.
执行信息
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Automatically parallelized on tuple level.
- Automatically parallelized on channel level.
参数
ImageImageImageImageimageimage (input_object) (multichannel-)image(-array) → objectHImageHObjectHImageHobject (byte / direction / cyclic / int1 / int2 / uint2 / int4 / real)
Input image.
ImagePartImagePartImagePartImagePartimagePartimage_part (output_object) (multichannel-)image(-array) → objectHImageHObjectHImageHobject * (byte / direction / cyclic / int1 / int2 / uint2 / int4 / real)
Image area.
TopTopTopToptoptop (input_control) integer → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Number of rows clipped at the top.
默认值:
-1
建议值:
-20, -10, -5, -3, -2, -1, 0, 1, 2, 3, 4, 5, 10, 20
LeftLeftLeftLeftleftleft (input_control) integer → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Number of columns clipped at the left.
默认值:
-1
建议值:
-20, -10, -5, -3, -2, -1, 0, 1, 2, 3, 4, 5, 10, 20
BottomBottomBottomBottombottombottom (input_control) integer → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Number of rows clipped at the bottom.
默认值:
-1
建议值:
-20, -10, -5, -3, -2, -1, 0, 1, 2, 3, 4, 5, 10, 20
RightRightRightRightrightright (input_control) integer → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Number of columns clipped at the right.
默认值:
-1
建议值:
-20, -10, -5, -3, -2, -1, 0, 1, 2, 3, 4, 5, 10, 20
结果
crop_domain_relcrop_domain_relCropDomainRelCropDomainRelCropDomainRelcrop_domain_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.
可能的前置算子
reduce_domainreduce_domainReduceDomainReduceDomainReduceDomainreduce_domain,
thresholdthresholdThresholdThresholdThresholdthreshold,
connectionconnectionConnectionConnectionConnectionconnection,
regiongrowingregiongrowingRegiongrowingRegiongrowingRegiongrowingregiongrowing,
pouringpouringPouringPouringPouringpouring
替代算子
crop_domaincrop_domainCropDomainCropDomainCropDomaincrop_domain,
crop_rectangle1crop_rectangle1CropRectangle1CropRectangle1CropRectangle1crop_rectangle1
另见
smallest_rectangle1smallest_rectangle1SmallestRectangle1SmallestRectangle1SmallestRectangle1smallest_rectangle1,
intersectionintersectionIntersectionIntersectionIntersectionintersection,
gen_rectangle1gen_rectangle1GenRectangle1GenRectangle1GenRectangle1gen_rectangle1,
clip_regionclip_regionClipRegionClipRegionClipRegionclip_region
模块
Foundation