illuminateilluminateilluminateIlluminateIlluminate (Operator)

Name

illuminateilluminateilluminateIlluminateIlluminate — Illuminate image.

Signature

Description

The operator illuminateilluminateilluminateIlluminateIlluminate enhances contrast. Very dark parts of the image are “illuminated” more strongly, very light ones are “darkened”. If orig is the original gray value and mean is the corresponding gray value of the low pass filtered image detected via the operators mean_imagemean_imagemean_imageMeanImageMeanImage and filter size MaskHeightMaskHeightMaskHeightMaskHeightmaskHeight x MaskWidthMaskWidthMaskWidthMaskWidthmaskWidth. For byte-images val equals 127, for int2-images and uint2-images val equals the median value. The resulting gray value is new:

             new = round ( (val - mean) * Factor + orig ).

   Height Width  Factor
   ---------------------
    40     40     0.55
   100    100     0.7
   150    150     0.8

Parallelization

• 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.
• Automatically parallelized on internal data level.

Parameters

read_image(Image,'fabrik')
disp_image(Image,WindowHandle)
illuminate(Image,Better,40,40,0.55)
disp_image(Better,WindowHandle)

read_image(&Image,"fabrik");
disp_image(Image,WindowHandle);
illuminate(Image,&Better,40,40,0.55);
disp_image(Better,WindowHandle); 

read_image(Image,'fabrik')
disp_image(Image,WindowHandle)
illuminate(Image,Better,40,40,0.55)
disp_image(Better,WindowHandle)

read_image(Image,'fabrik')
disp_image(Image,WindowHandle)
illuminate(Image,Better,40,40,0.55)
disp_image(Better,WindowHandle)

read_image(Image,'fabrik')
disp_image(Image,WindowHandle)
illuminate(Image,Better,40,40,0.55)
disp_image(Better,WindowHandle)

Result

If the parameter values are correct the operator illuminateilluminateilluminateIlluminateIlluminate returns the value 2 (H_MSG_TRUE) The behavior in case of empty input (no input images available) is set via the operator set_system(::'no_object_result',<Result>:)set_system("no_object_result",<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>). If necessary an exception is raised.

Possible Successors

disp_imagedisp_imagedisp_imageDispImageDispImage

Alternatives

scale_image_maxscale_image_maxscale_image_maxScaleImageMaxScaleImageMax, equ_histo_imageequ_histo_imageequ_histo_imageEquHistoImageEquHistoImage, mean_imagemean_imagemean_imageMeanImageMeanImage, sub_imagesub_imagesub_imageSubImageSubImage

See also

emphasizeemphasizeemphasizeEmphasizeEmphasize, gray_histogray_histogray_histoGrayHistoGrayHisto

Module

Foundation