gen_gauss_pyramid ( Image : ImagePyramid : Mode, Scale : )

Calculating a Gauss pyramid.

The operator gen_gauss_pyramid calculates a pyramid of scaled down images. The scale by which the next image will be reduced is determined by the parameter Scale. For instance, a value of 0.5 for Scale will shorten the edge length of Image by 50. This is exactly equivalent to the "normal" pyramid.

The parameter Mode determines the way of averaging. For a more detailed description concerning this parameter see also image_transform__.

Please note that each level will be returned as an individual image, i.e. as one iconic objekt, with one matrix and its own domain. If a multichannel image is needed as a result, the procedure image_to_channels has to be used. A single level or more than one level can be selected by using select_obj respectively copy_obj.


Parameters

Image (input_object)
image -> object : byte
Input image.

ImagePyramid (output_object)
image-array -> object : byte
Output images.
Number of elements: ImagePyramid > Image

Mode (input_control)
integer -> integer
Kind of filtermask.
Default value: 2
List of values: 0, 1, 2

Scale (input_control)
real -> real
Factor for scaling down.
Default value: 0.5
Suggested values: 0.2, 0.3, 0.4, 0.5, 0.6
Range of values: 0.1 <= Scale <= 0.9
Minimum increment: 0.01
Recommended increment: 0.1
Restriction: (0.1 < Scale) && (Scale < 0.9)


Example
gen_gauss_pyramid(Image,Pyramid,2,0.5);
count_obj(Pyramid,&num);
for (i=1; i
Possible Successors

image_to_channels, count_obj, select_obj, copy_obj


Alternatives

zoom_image1, zoom_image2


See also

image_transform__



Copyright © 1996-1997 MVTec Software GmbH