Herror ::zoom_image_factor (
    Hobject Image,
    Hobject *ImageZoomed,
    const HTuple &ScaleWidth,
    const HTuple &ScaleHeight,
    const HTuple &Interpolation
)
HImage HImage::ZoomImageFactor (
    const HTuple &ScaleWidth,
    const HTuple &ScaleHeight,
    const HTuple &Interpolation
) const
HImageArray HImageArray::ZoomImageFactor (
    const HTuple &ScaleWidth,
    const HTuple &ScaleHeight,
    const HTuple &Interpolation
) const

Zoom an image by a given factor.

::zoom_image_factor scales the image Image by a factor of ScaleWidth in width and a factor ScaleHeight in height. The parameter Interpolation determines the type of interpolation used (see ::affine_trans_image).


Parameters

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

ImageZoomed (output_object)
(multichannel-)image(-array) -> Hobject * : HImage(Array) ( byte / int2 )
Scaled image.

ScaleWidth (input_control)
extent.x -> HTuple.double
Scale factor for the width of the image.
Default value: 0.5
Suggested values: 0.25, 0.5, 1.5, 2.0
Typical range of values: 0.001 <= ScaleWidth <= 10.0
Minimum increment: 0.001
Recommended increment: 0.1

ScaleHeight (input_control)
extent.y -> HTuple.double
Scale factor for the height of the image.
Default value: 0.5
Suggested values: 0.25, 0.5, 1.5, 2.0
Typical range of values: 0.001 <= ScaleHeight <= 10.0
Minimum increment: 0.001
Recommended increment: 0.1

Interpolation (input_control)
string -> HTuple.char *
Type of interpolation.
Default value: 'constant'
List of values: 'none', 'constant', 'weighted'


Example
read_image(&Image,"affe");
disp_image(Image,WindowHandle);
zoom_image_factor(Image,&ZooImage,0,0.5,0.5);
disp_image(ZooImage,WindowHandle);

Alternatives

::zoom_image_factor, ::affine_trans_image, ::hom_mat2d_scale


See also

::hom_mat2d_scale, ::affine_trans_image


Module

Image filters



Copyright © 1996-2002 MVTec Software GmbH