HALCON Website / HALCON Operator Reference / Image / Format
ClassesClassesClassesClasses | | | | Operators

crop_partcrop_partCropPartcrop_partCropPartCropPart (Operator)

Name

crop_partcrop_partCropPartcrop_partCropPartCropPart — Cut out a rectangular image area.

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)

Herror crop_part(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

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

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

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

void HOperatorSetX.CropPart(
[in] IHUntypedObjectX* Image, [out] IHUntypedObjectX** ImagePart, [in] VARIANT Row, [in] VARIANT Column, [in] VARIANT Width, [in] VARIANT Height)

IHImageX* HImageX.CropPart(
[in] Hlong Row, [in] Hlong Column, [in] Hlong Width, [in] Hlong Height)

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

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

Description

The operator crop_partcrop_partCropPartcrop_partCropPartCropPart cuts a rectangular area from the input images. The area is indicated by a rectangle, which is defined by the coordinates of it's upper left corner and by it's size. The upper left corner of the rectangle must be within the image. At the right side and at the bottom, the rectangle may exceed the image, but the domain of the output image is set so that only the part that can be derived from the input image is contained. If the rectangular area lies completely within the image, the new image matrix has the size of the rectangular area.

Parallelization

Parameters

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

Input image.

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

Image area.

RowRowRowRowRowrow (input_control)  rectangle.origin.y → HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (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 row ≤ 1024

ColumnColumnColumnColumnColumncolumn (input_control)  rectangle.origin.x → HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (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 column ≤ 1024

WidthWidthWidthWidthWidthwidth (input_control)  rectangle.extent.x → HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (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 width ≤ 1024

HeightHeightHeightHeightHeightheight (input_control)  rectangle.extent.y → HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (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 height ≤ 1024

Possible Successors

disp_imagedisp_imageDispImagedisp_imageDispImageDispImage

Alternatives

crop_rectangle1crop_rectangle1CropRectangle1crop_rectangle1CropRectangle1CropRectangle1, crop_domaincrop_domainCropDomaincrop_domainCropDomainCropDomain, change_formatchange_formatChangeFormatchange_formatChangeFormatChangeFormat, reduce_domainreduce_domainReduceDomainreduce_domainReduceDomainReduceDomain

See also

zoom_image_sizezoom_image_sizeZoomImageSizezoom_image_sizeZoomImageSizeZoomImageSize, zoom_image_factorzoom_image_factorZoomImageFactorzoom_image_factorZoomImageFactorZoomImageFactor

Module

Foundation

ClassesClassesClassesClasses | | | | Operators
HALCON Operator Reference 11.0.5 Copyright © 1996-2015 MVTec Software GmbH