ClassesClassesClassesClasses | | | | Operators

crop_domain_relcrop_domain_relCropDomainRelcrop_domain_relCropDomainRelCropDomainRel (Operator)

Name

crop_domain_relcrop_domain_relCropDomainRelcrop_domain_relCropDomainRelCropDomainRel — Cut out an image area relative to the domain.

Signature

crop_domain_rel(Image : ImagePart : Top, Left, Bottom, Right : )

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)

Herror crop_domain_rel(Hobject Image, Hobject* ImagePart, const HTuple& Top, const HTuple& Left, const HTuple& Bottom, const HTuple& Right)

HImage HImage::CropDomainRel(const HTuple& Top, const HTuple& Left, const HTuple& Bottom, const HTuple& Right) const

HImageArray HImageArray::CropDomainRel(const HTuple& Top, const HTuple& Left, const HTuple& Bottom, const HTuple& Right) const

void CropDomainRel(const HObject& Image, HObject* ImagePart, const HTuple& Top, const HTuple& Left, const HTuple& Bottom, const HTuple& Right)

HImage HImage::CropDomainRel(Hlong Top, Hlong Left, Hlong Bottom, Hlong Right) const

void HOperatorSetX.CropDomainRel(
[in] IHUntypedObjectX* Image, [out] IHUntypedObjectX*ImagePart, [in] VARIANT Top, [in] VARIANT Left, [in] VARIANT Bottom, [in] VARIANT Right)

IHImageX* HImageX.CropDomainRel(
[in] Hlong Top, [in] Hlong Left, [in] Hlong Bottom, [in] Hlong Right)

static void HOperatorSet.CropDomainRel(HObject image, out HObject imagePart, HTuple top, HTuple left, HTuple bottom, HTuple right)

HImage HImage.CropDomainRel(int top, int left, int bottom, int right)

Description

crop_domain_relcrop_domain_relCropDomainRelcrop_domain_relCropDomainRelCropDomainRel 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.

Parallelization

Parameters

ImageImageImageImageImageimage (input_object)  (multichannel-)image(-array) objectHImageHImageHImageHImageXHobject (byte / direction / cyclic / int1 / int2 / uint2 / int4 / real)

Input image.

ImagePartImagePartImagePartImagePartImagePartimagePart (output_object)  (multichannel-)image(-array) objectHImageHImageHImageHImageXHobject * (byte / direction / cyclic / int1 / int2 / uint2 / int4 / real)

Image area.

TopTopTopTopToptop (input_control)  integer HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Number of rows clipped at the top.

Default value: -1

Suggested values: -20, -10, -5, -3, -2, -1, 0, 1, 2, 3, 4, 5, 10, 20

LeftLeftLeftLeftLeftleft (input_control)  integer HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Number of columns clipped at the left.

Default value: -1

Suggested values: -20, -10, -5, -3, -2, -1, 0, 1, 2, 3, 4, 5, 10, 20

BottomBottomBottomBottomBottombottom (input_control)  integer HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Number of rows clipped at the bottom.

Default value: -1

Suggested values: -20, -10, -5, -3, -2, -1, 0, 1, 2, 3, 4, 5, 10, 20

RightRightRightRightRightright (input_control)  integer HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Number of columns clipped at the right.

Default value: -1

Suggested values: -20, -10, -5, -3, -2, -1, 0, 1, 2, 3, 4, 5, 10, 20

Result

crop_domain_relcrop_domain_relCropDomainRelcrop_domain_relCropDomainRelCropDomainRel 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>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("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>)set_system("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>). If necessary, an exception is raised.

Possible Predecessors

reduce_domainreduce_domainReduceDomainreduce_domainReduceDomainReduceDomain, thresholdthresholdThresholdthresholdThresholdThreshold, connectionconnectionConnectionconnectionConnectionConnection, regiongrowingregiongrowingRegiongrowingregiongrowingRegiongrowingRegiongrowing, pouringpouringPouringpouringPouringPouring

Alternatives

crop_domaincrop_domainCropDomaincrop_domainCropDomainCropDomain, crop_rectangle1crop_rectangle1CropRectangle1crop_rectangle1CropRectangle1CropRectangle1

See also

smallest_rectangle1smallest_rectangle1SmallestRectangle1smallest_rectangle1SmallestRectangle1SmallestRectangle1, intersectionintersectionIntersectionintersectionIntersectionIntersection, gen_rectangle1gen_rectangle1GenRectangle1gen_rectangle1GenRectangle1GenRectangle1, clip_regionclip_regionClipRegionclip_regionClipRegionClipRegion

Module

Foundation


ClassesClassesClassesClasses | | | | Operators