scale_image_maxscale_image_maxScaleImageMaxScaleImageMax (Operator)

Name

scale_image_maxscale_image_maxScaleImageMaxScaleImageMax — Maximum gray value spreading in the value range 0 to 255.

Signature

scale_image_max(Image : ImageScaleMax : : )

Herror scale_image_max(const Hobject Image, Hobject* ImageScaleMax)

Herror T_scale_image_max(const Hobject Image, Hobject* ImageScaleMax)

void ScaleImageMax(const HObject& Image, HObject* ImageScaleMax)

HImage HImage::ScaleImageMax() const

static void HOperatorSet.ScaleImageMax(HObject image, out HObject imageScaleMax)

HImage HImage.ScaleImageMax()

Description

The operator scale_image_maxscale_image_maxScaleImageMaxScaleImageMaxScaleImageMax calculates the minimum and maximum and scales the image to the maximum value range of a byte image. This way the dynamics (value range) is fully exploited. The number of different gray scales does not change, but in general the visual impression is enhanced. The gray values of images of the 'real'"real""real""real""real", 'int2'"int2""int2""int2""int2", 'uint2'"uint2""uint2""uint2""uint2", 'int4'"int4""int4""int4""int4", and 'int8'"int8""int8""int8""int8" type are scaled to the range 0 to 255 and returned as 'byte'"byte""byte""byte""byte" images.

Attention

The output always is an image of the type 'byte'"byte""byte""byte""byte".

Note that filter operators may return unexpected results if an image with a reduced domain is used as input. Please refer to the chapter Filters.

Execution Information

Parameters

ImageImageImageImageimage (input_object)  (multichannel-)image(-array) objectHImageHImageHobject (byte / int2 / uint2 / int4 / int8 / real)

Image to be scaled.

ImageScaleMaxImageScaleMaxImageScaleMaxImageScaleMaximageScaleMax (output_object)  image(-array) objectHImageHImageHobject * (byte)

contrast enhanced image.

Possible Successors

disp_imagedisp_imageDispImageDispImageDispImage

Alternatives

equ_histo_imageequ_histo_imageEquHistoImageEquHistoImageEquHistoImage, scale_imagescale_imageScaleImageScaleImageScaleImage, illuminateilluminateIlluminateIlluminateIlluminate, convert_image_typeconvert_image_typeConvertImageTypeConvertImageTypeConvertImageType

See also

min_max_graymin_max_grayMinMaxGrayMinMaxGrayMinMaxGray, gray_histogray_histoGrayHistoGrayHistoGrayHisto

Module

Foundation