Operator Reference

HALCON Operator Reference / Filters / Enhancement
ClassesClasses | | Operators

scale_image_maxscale_image_maxScaleImageMaxScaleImageMaxscale_image_max (Operator)

scale_image_maxscale_image_maxScaleImageMaxScaleImageMaxscale_image_max — 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()

def scale_image_max(image: HObject) -> HObject

Description

The operator scale_image_maxscale_image_maxScaleImageMaxScaleImageMaxscale_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", '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

  • 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

ImageImageImageimageimage (input_object)  (multichannel-)image(-array) → objectHImageHObjectHObjectHobject (byte / int2 / uint2 / int4 / int8 / real)

Image to be scaled.

ImageScaleMaxImageScaleMaxImageScaleMaximageScaleMaximage_scale_max (output_object)  image(-array) → objectHImageHObjectHObjectHobject * (byte)

contrast enhanced image.

Possible Successors

disp_imagedisp_imageDispImageDispImagedisp_image

Alternatives

equ_histo_imageequ_histo_imageEquHistoImageEquHistoImageequ_histo_image, equ_histo_image_rectequ_histo_image_rectEquHistoImageRectEquHistoImageRectequ_histo_image_rect, scale_imagescale_imageScaleImageScaleImagescale_image, illuminateilluminateIlluminateIlluminateilluminate, convert_image_typeconvert_image_typeConvertImageTypeConvertImageTypeconvert_image_type

See also

min_max_graymin_max_grayMinMaxGrayMinMaxGraymin_max_gray, gray_histogray_histoGrayHistoGrayHistogray_histo

Module

Foundation

ClassesClasses | | Operators