crop_partcrop_partCropPartCropPart (Operator)

Name

crop_partcrop_partCropPartCropPart — Cut out one or more rectangular image areas.

Signature

crop_part(Image : ImagePart : Row, Column, Width, Height : )

Herror crop_part(const Hobject Image, Hobject* ImagePart, const Hlong Row, const Hlong Column, const Hlong Width, const Hlong Height)

Herror T_crop_part(const Hobject Image, Hobject* ImagePart, const Htuple Row, const Htuple Column, const Htuple Width, const Htuple Height)

void CropPart(const HObject& Image, HObject* ImagePart, const HTuple& Row, const HTuple& Column, const HTuple& Width, const HTuple& Height)

HImage HImage::CropPart(const HTuple& Row, const HTuple& Column, const HTuple& Width, const HTuple& Height) const

HImage HImage::CropPart(Hlong Row, Hlong Column, Hlong Width, Hlong Height) const

static void HOperatorSet.CropPart(HObject image, out HObject imagePart, HTuple row, HTuple column, HTuple width, HTuple height)

HImage HImage.CropPart(HTuple row, HTuple column, HTuple width, HTuple height)

HImage HImage.CropPart(int row, int column, int width, int height)

Description

The operator crop_partcrop_partCropPartCropPartCropPart cuts one or more rectangular area from each of the input images. The areas are indicated by rectangles, which are defined by the coordinates of their upper left corner and by their size. The upper left corners of the rectangles must be within the image. At the right side and at the bottom, the rectangles may exceed the image, but the domain of the output images is set so that only the part that can be derived from the input image is contained. If the rectangular areas fall completely within the image, then each of the resulting images has the size of its corresponding rectangle.

Execution Information

Parameters

ImageImageImageImageimage (input_object)  (multichannel-)image(-array) objectHImageHImageHobject (byte* / direction* / cyclic* / int1* / int2* / uint2* / int4* / int8 / real*) *allowed for compute devices

Input image.

ImagePartImagePartImagePartImagePartimagePart (output_object)  (multichannel-)image(-array) objectHImageHImageHobject * (byte* / direction* / cyclic* / int1* / int2* / uint2* / int4* / int8 / real*) *allowed for compute devices

Image area.

RowRowRowRowrow (input_control)  rectangle.origin.y(-array) HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Line index of upper left corner of image area.

Default value: 100

Suggested values: 10, 20, 50, 100, 200, 300, 500

Typical range of values: 0 ≤ Row Row Row Row row ≤ 1024

ColumnColumnColumnColumncolumn (input_control)  rectangle.origin.x(-array) HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Column index of upper left corner of image area.

Default value: 100

Suggested values: 10, 20, 50, 100, 200, 300, 500

Typical range of values: 0 ≤ Column Column Column Column column ≤ 1024

WidthWidthWidthWidthwidth (input_control)  rectangle.extent.x(-array) HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Width of new image.

Default value: 128

Suggested values: 32, 64, 128, 256, 512, 768

Typical range of values: 0 ≤ Width Width Width Width width ≤ 1024

HeightHeightHeightHeightheight (input_control)  rectangle.extent.y(-array) HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Height of new image.

Default value: 128

Suggested values: 32, 64, 128, 256, 512, 525

Typical range of values: 0 ≤ Height Height Height Height height ≤ 1024

Possible Successors

disp_imagedisp_imageDispImageDispImageDispImage

Alternatives

crop_rectangle1crop_rectangle1CropRectangle1CropRectangle1CropRectangle1, crop_domaincrop_domainCropDomainCropDomainCropDomain, change_formatchange_formatChangeFormatChangeFormatChangeFormat, reduce_domainreduce_domainReduceDomainReduceDomainReduceDomain

See also

zoom_image_sizezoom_image_sizeZoomImageSizeZoomImageSizeZoomImageSize, zoom_image_factorzoom_image_factorZoomImageFactorZoomImageFactorZoomImageFactor

Module

Foundation