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

Cut out a rectangular image area.

The operator ::crop_part cuts a rectangular area from the input images. The area is indicated by a rectangle (upper left corner and size). The area must be within the image. The definition domain includes all pixels of the new image. The new image matrix has the size of a rectangle.


Parameters

Image (input_object)
(multichannel-)image(-array) -> Hobject: HImage(Array)
Input image.

ImagePart (output_object)
(multichannel-)image(-array) -> Hobject * : HImage(Array)
Image area.

Row (input_control)
rectangle.origin.y -> HTuple.long
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 <= 1024

Column (input_control)
rectangle.origin.x -> HTuple.long
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 <= 1024

Width (input_control)
rectangle.extent.x -> HTuple.long
Width of new image.
Default value: 128
Suggested values: 32, 64, 128, 256, 512, 768
Typical range of values: 0 <= Width <= 1024

Height (input_control)
rectangle.extent.y -> HTuple.long
Height of new image.
Default value: 128
Suggested values: 32, 64, 128, 256, 512, 525
Typical range of values: 0 <= Height <= 1024


Possible Successors

::disp_image


Alternatives

::crop_rectangle1, ::crop_domain, ::change_format, ::reduce_domain


See also

::zoom_image_size, ::zoom_image_factor


Module

Image / region / XLD management



Copyright © 1996-2002 MVTec Software GmbH