scale_image_maxscale_image_maxScaleImageMaxScaleImageMaxscale_image_max (Operator)
Name
scale_image_maxscale_image_maxScaleImageMaxScaleImageMaxscale_image_max
— Maximum gray value spreading in the value range
0 to 255.
Signature
def scale_image_max(image: HObject) -> HObject
Description
The operator scale_image_maxscale_image_maxScaleImageMaxScaleImageMaxScaleImageMaxscale_image_max
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""real", 'int2'"int2""int2""int2""int2""int2",
'uint2'"uint2""uint2""uint2""uint2""uint2", 'int4'"int4""int4""int4""int4""int4", and 'int8'"int8""int8""int8""int8""int8" type
are scaled to the range 0 to 255
and returned as 'byte'"byte""byte""byte""byte""byte" images.
Attention
The output always is an image of the type 'byte'"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
- 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
ImageImageImageImageimageimage
(input_object) (multichannel-)image(-array) →
objectHImageHObjectHImageHobject (byte / int2 / uint2 / int4 / int8 / real)
Image to be scaled.
ImageScaleMaxImageScaleMaxImageScaleMaxImageScaleMaximageScaleMaximage_scale_max
(output_object) image(-array) →
objectHImageHObjectHImageHobject * (byte)
contrast enhanced image.
Possible Successors
disp_imagedisp_imageDispImageDispImageDispImagedisp_image
Alternatives
equ_histo_imageequ_histo_imageEquHistoImageEquHistoImageEquHistoImageequ_histo_image
,
scale_imagescale_imageScaleImageScaleImageScaleImagescale_image
,
illuminateilluminateIlluminateIlluminateIlluminateilluminate
,
convert_image_typeconvert_image_typeConvertImageTypeConvertImageTypeConvertImageTypeconvert_image_type
See also
min_max_graymin_max_grayMinMaxGrayMinMaxGrayMinMaxGraymin_max_gray
,
gray_histogray_histoGrayHistoGrayHistoGrayHistogray_histo
Module
Foundation