Skip to content

scale_image_maxScaleImageMaxScaleImageMaxscale_image_maxscale_image_max🔗

Short description🔗

scale_image_maxScaleImageMaxScaleImageMaxscale_image_maxscale_image_max — Maximum gray value spreading in the value range 00 to 255255.

Signature🔗

scale_image_max( image Image, out image ImageScaleMax )void ScaleImageMax( const HObject& Image, HObject* ImageScaleMax )static void HOperatorSet.ScaleImageMax( HObject image, out HObject imageScaleMax )def scale_image_max( image: HObject ) -> HObject

Herror scale_image_max( const Hobject Image, Hobject* ImageScaleMax )

Herror T_scale_image_max( const Hobject Image, Hobject* ImageScaleMax )

HImage HImage::ScaleImageMax( ) const

HImage HImage.ScaleImageMax( )

Description🔗

The operator scale_image_maxScaleImageMax 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", 'int2'"int2", 'uint2'"uint2", 'int4'"int4", and 'int8'"int8" type are scaled to the range 00 to 255255 and returned as 'byte'"byte" images.

Attention🔗

The output always is an image of the type '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🔗

Execution information
  • Multithreading type: reentrant (runs in parallel with non-exclusive operators).

  • Multithreading scope: global (may be called from any thread).

  • Automatically parallelized on tuple level.

  • Automatically parallelized on channel level.

Parameters🔗

Imageimageimage (input_object) (multichannel-)image(-array) → object (byte / int2 / uint2 / int4 / int8 / real)HObject (byte / int2 / uint2 / int4 / int8 / real)HImage (byte / int2 / uint2 / int4 / int8 / real)HObject (byte / int2 / uint2 / int4 / int8 / real)Hobject (byte / int2 / uint2 / int4 / int8 / real)

Image to be scaled.

ImageScaleMaximageScaleMaximage_scale_max (output_object) image(-array) → object (byte)HObject (byte)HImage (byte)HObject (byte)Hobject * (byte)

contrast enhanced image.

Combinations with other operators🔗

Combinations

Possible successors

disp_imageDispImage

Alternatives

equ_histo_imageEquHistoImage, equ_histo_image_rectEquHistoImageRect, scale_imageScaleImage, illuminateIlluminate, convert_image_typeConvertImageType

See also

min_max_grayMinMaxGray, gray_histoGrayHisto

Module🔗

Foundation