Herror ::crop_rectangle1 (
    Hobject Image,
    Hobject *ImagePart,
    const HTuple &Row1,
    const HTuple &Column1,
    const HTuple &Row2,
    const HTuple &Column2
)
HImage HImage::CropRectangle1 (
    const HTuple &Row1,
    const HTuple &Column1,
    const HTuple &Row2,
    const HTuple &Column2
) const
HImageArray HImageArray::CropRectangle1 (
    const HTuple &Row1,
    const HTuple &Column1,
    const HTuple &Row2,
    const HTuple &Column2
) const

Cut out a rectangular image area.

The operator ::crop_rectangle1 cuts a rectangular area from the input images. The area is indicated by a rectangle (upper left and lower right corner). 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.

Row1 (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 <= Row1 <= 1024

Column1 (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 <= Column1 <= 1024

Row2 (input_control)
rectangle.corner.y -> HTuple.long
Line index of lower right corner of image area.
Default value: 200
Suggested values: 10, 20, 50, 100, 200, 300, 500
Typical range of values: 0 <= Row2 <= 1024

Column2 (input_control)
rectangle.corner.x -> HTuple.long
Column index of lower right corner of image area.
Default value: 200
Suggested values: 10, 20, 50, 100, 200, 300, 500
Typical range of values: 0 <= Column2 <= 1024


Possible Successors

::disp_image


Alternatives

::crop_part, ::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