Herror ::change_format (
    Hobject Image,
    Hobject *ImagePart,
    const HTuple &Width,
    const HTuple &Height
)
HImage HImage::ChangeFormat (
    const HTuple &Width,
    const HTuple &Height
) const
HImageArray HImageArray::ChangeFormat (
    const HTuple &Width,
    const HTuple &Height
) const

Change image size.

The operator ::change_format increases or decreases the size of the input images to the indicated height or width, respectively. If the image is reduced parts are cut off at the ``right'' or ``lower'' edge of the image, respectively. If the image is enlarged the additional areas are set to 0. The definition domain includes all pixels of the new image. No zooming is carried out.


Parameters

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

ImagePart (output_object)
image(-array) -> Hobject * : HImage(Array)
Image with new format.

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

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


Possible Successors

::disp_image


Alternatives

::crop_part


See also

::zoom_image_size, ::zoom_image_factor


Module

Image / region / XLD management



Copyright © 1996-2002 MVTec Software GmbH