HALCON Reference Manual 10.0.2
Table of Contents / Image / Format ClassesClassesClasses | | | Operators

crop_partcrop_partcrop_partCropPartCropPart (Operator)

Name

crop_partcrop_partcrop_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 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_partcrop_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

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

Input image.

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

Image area.

RowRowRowRowrow (input_control)  rectangle.origin.y → HTupleHTupleVARIANTHtuple (integer) (int / long) (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 ≤ 1024

ColumnColumnColumnColumncolumn (input_control)  rectangle.origin.x → HTupleHTupleVARIANTHtuple (integer) (int / long) (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 ≤ 1024

WidthWidthWidthWidthwidth (input_control)  rectangle.extent.x → HTupleHTupleVARIANTHtuple (integer) (int / long) (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 ≤ 1024

HeightHeightHeightHeightheight (input_control)  rectangle.extent.y → HTupleHTupleVARIANTHtuple (integer) (int / long) (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 ≤ 1024

Possible Successors

disp_imagedisp_imagedisp_imageDispImageDispImage

Alternatives

crop_rectangle1crop_rectangle1crop_rectangle1CropRectangle1CropRectangle1, crop_domaincrop_domaincrop_domainCropDomainCropDomain, change_formatchange_formatchange_formatChangeFormatChangeFormat, reduce_domainreduce_domainreduce_domainReduceDomainReduceDomain

See also

zoom_image_sizezoom_image_sizezoom_image_sizeZoomImageSizeZoomImageSize, zoom_image_factorzoom_image_factorzoom_image_factorZoomImageFactorZoomImageFactor

Module

Foundation

Table of Contents / Image / Format ClassesClassesClasses | | | Operators
HALCON Reference Manual 10.0.2 Copyright © 1996-2011 MVTec Software GmbH