MagickCore 7.1.0
Convert, Edit, Or Compose Bitmap Images
Data Structures | Macros | Typedefs | Functions
enhance.c File Reference
#include "MagickCore/studio.h"
#include "MagickCore/accelerate-private.h"
#include "MagickCore/artifact.h"
#include "MagickCore/attribute.h"
#include "MagickCore/cache.h"
#include "MagickCore/cache-private.h"
#include "MagickCore/cache-view.h"
#include "MagickCore/channel.h"
#include "MagickCore/color.h"
#include "MagickCore/color-private.h"
#include "MagickCore/colorspace.h"
#include "MagickCore/colorspace-private.h"
#include "MagickCore/composite-private.h"
#include "MagickCore/enhance.h"
#include "MagickCore/exception.h"
#include "MagickCore/exception-private.h"
#include "MagickCore/fx.h"
#include "MagickCore/gem.h"
#include "MagickCore/gem-private.h"
#include "MagickCore/geometry.h"
#include "MagickCore/histogram.h"
#include "MagickCore/image.h"
#include "MagickCore/image-private.h"
#include "MagickCore/memory_.h"
#include "MagickCore/monitor.h"
#include "MagickCore/monitor-private.h"
#include "MagickCore/option.h"
#include "MagickCore/pixel.h"
#include "MagickCore/pixel-accessor.h"
#include "MagickCore/quantum.h"
#include "MagickCore/quantum-private.h"
#include "MagickCore/resample.h"
#include "MagickCore/resample-private.h"
#include "MagickCore/resource_.h"
#include "MagickCore/statistic.h"
#include "MagickCore/string_.h"
#include "MagickCore/string-private.h"
#include "MagickCore/thread-private.h"
#include "MagickCore/threshold.h"
#include "MagickCore/token.h"
#include "MagickCore/xml-tree.h"
#include "MagickCore/xml-tree-private.h"
Include dependency graph for enhance.c:

Go to the source code of this file.

Data Structures

struct  _RangeInfo
 

Macros

#define BrightnessContastImageTag   "BrightnessContast/Image"
 
#define NumberCLAHEGrays   (65536)
 
#define CLAHEImageTag   "CLAHE/Image"
 
#define ClutImageTag   "Clut/Image"
 
#define ColorDecisionListCorrectImageTag   "ColorDecisionList/Image"
 
#define ContrastImageTag   "Contrast/Image"
 
#define MaxRange(color)   ((double) ScaleQuantumToMap((Quantum) (color)))
 
#define ContrastStretchImageTag   "ContrastStretch/Image"
 
#define EnhanceImageTag   "Enhance/Image"
 
#define EnhancePixel(weight)
 
#define EqualizeImageTag   "Equalize/Image"
 
#define GammaImageTag   "Gamma/Image"
 
#define GrayscaleImageTag   "Grayscale/Image"
 
#define HaldClutImageTag   "Clut/Image"
 
#define LevelImageTag   "Level/Image"
 
#define LevelizeImageTag   "Levelize/Image"
 
#define LevelizeValue(x)
 
#define LinearStretchImageTag   "LinearStretch/Image"
 
#define ModulateImageTag   "Modulate/Image"
 
#define NegateImageTag   "Negate/Image"
 
#define Sigmoidal(a, b, x)   ( 1.0/(1.0+exp((a)*((b)-(x)))) )
 
#define ScaledSigmoidal(a, b, x)
 
#define SigmoidalContrastImageTag   "SigmoidalContrast/Image"
 
#define ScaledSig(x)
 
#define InverseScaledSig(x)
 
#define WhiteBalanceImageTag   "WhiteBalance/Image"
 

Typedefs

typedef struct _RangeInfo RangeInfo
 

Functions

MagickExport MagickBooleanType AutoGammaImage (Image *image, ExceptionInfo *exception)
 
MagickExport MagickBooleanType AutoLevelImage (Image *image, ExceptionInfo *exception)
 
MagickExport MagickBooleanType BrightnessContrastImage (Image *image, const double brightness, const double contrast, ExceptionInfo *exception)
 
static void ClipCLAHEHistogram (const double clip_limit, const size_t number_bins, size_t *histogram)
 
static void GenerateCLAHEHistogram (const RectangleInfo *clahe_info, const RectangleInfo *tile_info, const size_t number_bins, const unsigned short *lut, const unsigned short *pixels, size_t *histogram)
 
static void InterpolateCLAHE (const RectangleInfo *clahe_info, const size_t *Q12, const size_t *Q22, const size_t *Q11, const size_t *Q21, const RectangleInfo *tile, const unsigned short *lut, unsigned short *pixels)
 
static void GenerateCLAHELut (const RangeInfo *range_info, const size_t number_bins, unsigned short *lut)
 
static void MapCLAHEHistogram (const RangeInfo *range_info, const size_t number_bins, const size_t number_pixels, size_t *histogram)
 
static MagickBooleanType CLAHE (const RectangleInfo *clahe_info, const RectangleInfo *tile_info, const RangeInfo *range_info, const size_t number_bins, const double clip_limit, unsigned short *pixels)
 
MagickExport MagickBooleanType CLAHEImage (Image *image, const size_t width, const size_t height, const size_t number_bins, const double clip_limit, ExceptionInfo *exception)
 
MagickExport MagickBooleanType ClutImage (Image *image, const Image *clut_image, const PixelInterpolateMethod method, ExceptionInfo *exception)
 
MagickExport MagickBooleanType ColorDecisionListImage (Image *image, const char *color_correction_collection, ExceptionInfo *exception)
 
static void Contrast (const int sign, double *red, double *green, double *blue)
 
MagickExport MagickBooleanType ContrastImage (Image *image, const MagickBooleanType sharpen, ExceptionInfo *exception)
 
MagickExport MagickBooleanType ContrastStretchImage (Image *image, const double black_point, const double white_point, ExceptionInfo *exception)
 
MagickExport Image * EnhanceImage (const Image *image, ExceptionInfo *exception)
 
MagickExport MagickBooleanType EqualizeImage (Image *image, ExceptionInfo *exception)
 
static double gamma_pow (const double value, const double gamma)
 
MagickExport MagickBooleanType GammaImage (Image *image, const double gamma, ExceptionInfo *exception)
 
MagickExport MagickBooleanType GrayscaleImage (Image *image, const PixelIntensityMethod method, ExceptionInfo *exception)
 
MagickExport MagickBooleanType HaldClutImage (Image *image, const Image *hald_image, ExceptionInfo *exception)
 
static double LevelPixel (const double black_point, const double white_point, const double gamma, const double pixel)
 
MagickExport MagickBooleanType LevelImage (Image *image, const double black_point, const double white_point, const double gamma, ExceptionInfo *exception)
 
MagickExport MagickBooleanType LevelizeImage (Image *image, const double black_point, const double white_point, const double gamma, ExceptionInfo *exception)
 
MagickExport MagickBooleanType LevelImageColors (Image *image, const PixelInfo *black_color, const PixelInfo *white_color, const MagickBooleanType invert, ExceptionInfo *exception)
 
MagickExport MagickBooleanType LinearStretchImage (Image *image, const double black_point, const double white_point, ExceptionInfo *exception)
 
static void ModulateHCL (const double percent_hue, const double percent_chroma, const double percent_luma, double *red, double *green, double *blue)
 
static void ModulateHCLp (const double percent_hue, const double percent_chroma, const double percent_luma, double *red, double *green, double *blue)
 
static void ModulateHSB (const double percent_hue, const double percent_saturation, const double percent_brightness, double *red, double *green, double *blue)
 
static void ModulateHSI (const double percent_hue, const double percent_saturation, const double percent_intensity, double *red, double *green, double *blue)
 
static void ModulateHSL (const double percent_hue, const double percent_saturation, const double percent_lightness, double *red, double *green, double *blue)
 
static void ModulateHSV (const double percent_hue, const double percent_saturation, const double percent_value, double *red, double *green, double *blue)
 
static void ModulateHWB (const double percent_hue, const double percent_whiteness, const double percent_blackness, double *red, double *green, double *blue)
 
static void ModulateLCHab (const double percent_luma, const double percent_chroma, const double percent_hue, const IlluminantType illuminant, double *red, double *green, double *blue)
 
static void ModulateLCHuv (const double percent_luma, const double percent_chroma, const double percent_hue, const IlluminantType illuminant, double *red, double *green, double *blue)
 
MagickExport MagickBooleanType ModulateImage (Image *image, const char *modulate, ExceptionInfo *exception)
 
MagickExport MagickBooleanType NegateImage (Image *image, const MagickBooleanType grayscale, ExceptionInfo *exception)
 
MagickExport MagickBooleanType NormalizeImage (Image *image, ExceptionInfo *exception)
 
static double InverseScaledSigmoidal (const double a, const double b, const double x)
 
MagickExport MagickBooleanType SigmoidalContrastImage (Image *image, const MagickBooleanType sharpen, const double contrast, const double midpoint, ExceptionInfo *exception)
 
MagickExport MagickBooleanType WhiteBalanceImage (Image *image, ExceptionInfo *exception)
 

Macro Definition Documentation

◆ BrightnessContastImageTag

#define BrightnessContastImageTag   "BrightnessContast/Image"

◆ CLAHEImageTag

#define CLAHEImageTag   "CLAHE/Image"

◆ ClutImageTag

#define ClutImageTag   "Clut/Image"

◆ ColorDecisionListCorrectImageTag

#define ColorDecisionListCorrectImageTag   "ColorDecisionList/Image"

◆ ContrastImageTag

#define ContrastImageTag   "Contrast/Image"

◆ ContrastStretchImageTag

#define ContrastStretchImageTag   "ContrastStretch/Image"

◆ EnhanceImageTag

#define EnhanceImageTag   "Enhance/Image"

◆ EnhancePixel

#define EnhancePixel (   weight)
Value:
mean=QuantumScale*((double) GetPixelRed(image,r)+pixel.red)/2.0; \
distance=QuantumScale*((double) GetPixelRed(image,r)-pixel.red); \
distance_squared=(4.0+mean)*distance*distance; \
mean=QuantumScale*((double) GetPixelGreen(image,r)+pixel.green)/2.0; \
distance=QuantumScale*((double) GetPixelGreen(image,r)-pixel.green); \
distance_squared+=(7.0-mean)*distance*distance; \
mean=QuantumScale*((double) GetPixelBlue(image,r)+pixel.blue)/2.0; \
distance=QuantumScale*((double) GetPixelBlue(image,r)-pixel.blue); \
distance_squared+=(5.0-mean)*distance*distance; \
mean=QuantumScale*((double) GetPixelBlack(image,r)+pixel.black)/2.0; \
distance=QuantumScale*((double) GetPixelBlack(image,r)-pixel.black); \
distance_squared+=(5.0-mean)*distance*distance; \
mean=QuantumScale*((double) GetPixelAlpha(image,r)+pixel.alpha)/2.0; \
distance=QuantumScale*((double) GetPixelAlpha(image,r)-pixel.alpha); \
distance_squared+=(5.0-mean)*distance*distance; \
if (distance_squared < 0.069) \
{ \
aggregate.red+=(weight)*GetPixelRed(image,r); \
aggregate.green+=(weight)*GetPixelGreen(image,r); \
aggregate.blue+=(weight)*GetPixelBlue(image,r); \
aggregate.black+=(weight)*GetPixelBlack(image,r); \
aggregate.alpha+=(weight)*GetPixelAlpha(image,r); \
total_weight+=(weight); \
} \
r+=GetPixelChannels(image);
QuantumScale
#define QuantumScale
Definition: magick-type.h:119
GetPixelAlpha
static Quantum GetPixelAlpha(const Image *magick_restrict image, const Quantum *magick_restrict pixel)
Definition: pixel-accessor.h:54
GetPixelGreen
static Quantum GetPixelGreen(const Image *magick_restrict image, const Quantum *magick_restrict pixel)
Definition: pixel-accessor.h:180
GetPixelChannels
static size_t GetPixelChannels(const Image *magick_restrict image)
Definition: pixel-accessor.h:134
GetPixelRed
static Quantum GetPixelRed(const Image *magick_restrict image, const Quantum *magick_restrict pixel)
Definition: pixel-accessor.h:393
GetPixelBlue
static Quantum GetPixelBlue(const Image *magick_restrict image, const Quantum *magick_restrict pixel)
Definition: pixel-accessor.h:86
GetPixelBlack
static Quantum GetPixelBlack(const Image *magick_restrict image, const Quantum *magick_restrict pixel)
Definition: pixel-accessor.h:73

◆ EqualizeImageTag

#define EqualizeImageTag   "Equalize/Image"

◆ GammaImageTag

#define GammaImageTag   "Gamma/Image"

◆ GrayscaleImageTag

#define GrayscaleImageTag   "Grayscale/Image"

◆ HaldClutImageTag

#define HaldClutImageTag   "Clut/Image"

◆ InverseScaledSig

#define InverseScaledSig (   x)
Value:
( ClampToQuantum(QuantumRange* \
InverseScaledSigmoidal(contrast,QuantumScale*midpoint,QuantumScale*(x))) )
InverseScaledSigmoidal
static double InverseScaledSigmoidal(const double a, const double b, const double x)
Definition: enhance.c:4222
QuantumRange
#define QuantumRange
Definition: magick-type.h:87
ClampToQuantum
static Quantum ClampToQuantum(const MagickRealType quantum)
Definition: quantum.h:86

◆ LevelImageTag

#define LevelImageTag   "Level/Image"

◆ LevelizeImageTag

#define LevelizeImageTag   "Levelize/Image"

◆ LevelizeValue

#define LevelizeValue (   x)
Value:
ClampToQuantum(((MagickRealType) gamma_pow((double) \
(QuantumScale*(x)),gamma))*(white_point-black_point)+black_point)
gamma_pow
static double gamma_pow(const double value, const double gamma)
Definition: enhance.c:2310
MagickRealType
MagickDoubleType MagickRealType
Definition: magick-type.h:124

◆ LinearStretchImageTag

#define LinearStretchImageTag   "LinearStretch/Image"

◆ MaxRange

#define MaxRange (   color)    ((double) ScaleQuantumToMap((Quantum) (color)))

◆ ModulateImageTag

#define ModulateImageTag   "Modulate/Image"

◆ NegateImageTag

#define NegateImageTag   "Negate/Image"

◆ NumberCLAHEGrays

#define NumberCLAHEGrays   (65536)

◆ ScaledSig

#define ScaledSig (   x)
Value:
( ClampToQuantum(QuantumRange* \
ScaledSigmoidal(contrast,QuantumScale*midpoint,QuantumScale*(x))) )
ScaledSigmoidal
#define ScaledSigmoidal(a, b, x)
Definition: enhance.c:4210

◆ ScaledSigmoidal

#define ScaledSigmoidal (   a,
  b,
  x 
)
Value:
( \
(Sigmoidal((a),(b),(x))-Sigmoidal((a),(b),0.0)) / \
(Sigmoidal((a),(b),1.0)-Sigmoidal((a),(b),0.0)) )
Sigmoidal
#define Sigmoidal(a, b, x)
Definition: enhance.c:4191

Definition at line 4210 of file enhance.c.

◆ Sigmoidal

#define Sigmoidal (   a,
  b,
  x 
)    ( 1.0/(1.0+exp((a)*((b)-(x)))) )

Definition at line 4191 of file enhance.c.

◆ SigmoidalContrastImageTag

#define SigmoidalContrastImageTag   "SigmoidalContrast/Image"

◆ WhiteBalanceImageTag

#define WhiteBalanceImageTag   "WhiteBalance/Image"

Typedef Documentation

◆ RangeInfo

typedef struct _RangeInfo RangeInfo

Function Documentation

◆ AutoGammaImage()

MagickExport MagickBooleanType AutoGammaImage ( Image *  image,
ExceptionInfo *  exception 
)

Definition at line 111 of file enhance.c.

References _Image::channel_mask, DefaultChannels, GetImageMean(), GetPixelChannelChannel(), GetPixelChannels(), GetPixelChannelTraits(), LevelImage(), MagickFalse, MagickTrue, QuantumRange, QuantumScale, SetImageChannelMask(), and UpdatePixelTrait.

◆ AutoLevelImage()

MagickExport MagickBooleanType AutoLevelImage ( Image *  image,
ExceptionInfo *  exception 
)

Definition at line 185 of file enhance.c.

References MinMaxStretchImage().

Referenced by AdaptiveBlurImage(), and AdaptiveSharpenImage().

◆ BrightnessContrastImage()

MagickExport MagickBooleanType BrightnessContrastImage ( Image *  image,
const double  brightness,
const double  contrast,
ExceptionInfo *  exception 
)

Definition at line 222 of file enhance.c.

References _Image::filename, FunctionImage(), GetMagickModule, IsEventLogging(), LogMagickEvent(), MagickCoreSignature, MagickFalse, MagickPI, PolynomialFunction, _Image::signature, and TraceEvent.

◆ CLAHE()

static MagickBooleanType CLAHE ( const RectangleInfo *  clahe_info,
const RectangleInfo *  tile_info,
const RangeInfo *  range_info,
const size_t  number_bins,
const double  clip_limit,
unsigned short *  pixels 
)
static

Definition at line 479 of file enhance.c.

References AcquireQuantumMemory(), AcquireVirtualMemory(), ClipCLAHEHistogram(), GenerateCLAHEHistogram(), GenerateCLAHELut(), GetVirtualMemoryBlob(), _RectangleInfo::height, InterpolateCLAHE(), MagickFalse, MagickTrue, MapCLAHEHistogram(), NumberCLAHEGrays, RelinquishMagickMemory(), RelinquishVirtualMemory(), _RectangleInfo::width, _OffsetInfo::x, _RectangleInfo::x, _OffsetInfo::y, and _RectangleInfo::y.

Referenced by CLAHEImage().

◆ CLAHEImage()

MagickExport MagickBooleanType CLAHEImage ( Image *  image,
const size_t  width,
const size_t  height,
const size_t  number_bins,
const double  clip_limit,
ExceptionInfo *  exception 
)

Definition at line 618 of file enhance.c.

References AcquireAuthenticCacheView(), AcquireVirtualCacheView(), AcquireVirtualMemory(), CLAHE(), CLAHEImageTag, _Image::colorspace, _Image::columns, DestroyCacheView(), _Image::filename, GetCacheViewAuthenticPixels(), GetCacheViewVirtualPixels(), GetMagickModule, GetPixelChannels(), GetVirtualMemoryBlob(), _RectangleInfo::height, IsEventLogging(), LabColorspace, LogMagickEvent(), magick_restrict, MagickCoreSignature, MagickFalse, MagickMin, MagickTrue, _RangeInfo::max, _RangeInfo::min, NumberCLAHEGrays, _Image::progress_monitor, RelinquishVirtualMemory(), ResourceLimitError, _Image::rows, SetImageProgress(), _Image::signature, SyncCacheViewAuthenticPixels(), ThrowBinaryException, ThrowMagickException(), TraceEvent, TransformImageColorspace(), _RectangleInfo::width, _RectangleInfo::x, and _RectangleInfo::y.

◆ ClipCLAHEHistogram()

static void ClipCLAHEHistogram ( const double  clip_limit,
const size_t  number_bins,
size_t *  histogram 
)
static

Definition at line 302 of file enhance.c.

Referenced by CLAHE().

◆ ClutImage()

MagickExport MagickBooleanType ClutImage ( Image *  image,
const Image *  clut_image,
const PixelInterpolateMethod  method,
ExceptionInfo *  exception 
)

Definition at line 833 of file enhance.c.

References AcquireAuthenticCacheView(), AcquireQuantumMemory(), AcquireVirtualCacheView(), ActivateAlphaChannel, adjust(), _PixelInfo::alpha, _Image::alpha_trait, AlphaPixelChannel, _PixelInfo::black, BlackPixelChannel, _PixelInfo::blue, BluePixelChannel, ClampToQuantum(), ClutImageTag, _Image::colorspace, _Image::columns, DestroyCacheView(), DirectClass, _Image::filename, GetCacheViewAuthenticPixels(), GetMagickModule, GetPixelAlphaTraits(), GetPixelChannels(), GetPixelChannelTraits(), GetPixelInfo(), GetPixelInfoPixel(), _PixelInfo::green, GreenPixelChannel, IntegerInterpolatePixel, _Image::interpolate, InterpolatePixelInfo(), IsEventLogging(), IsGrayColorspace(), LogMagickEvent(), magick_restrict, MagickCoreSignature, MagickFalse, MagickTrue, MaxMap, _Image::progress_monitor, _PixelInfo::red, RedPixelChannel, RelinquishMagickMemory(), ResourceLimitError, _Image::rows, SetImageAlphaChannel(), SetImageColorspace(), SetImageProgress(), SetImageStorageClass(), SetPixelViaPixelInfo(), _Image::signature, sRGBColorspace, SyncCacheViewAuthenticPixels(), ThrowBinaryException, TraceEvent, UndefinedPixelTrait, and UpdatePixelTrait.

◆ ColorDecisionListImage()

MagickExport MagickBooleanType ColorDecisionListImage ( Image *  image,
const char *  color_correction_collection,
ExceptionInfo *  exception 
)

Definition at line 1012 of file enhance.c.

References AcquireAuthenticCacheView(), AcquireQuantumMemory(), _PixelInfo::blue, ClampToQuantum(), ColorDecisionListCorrectImageTag, _Image::colormap, _Image::colors, _Image::columns, _Image::debug, DestroyCacheView(), DestroyXMLTree(), _Image::filename, GetCacheViewAuthenticPixels(), GetMagickModule, GetNextToken(), GetPixelBlue(), GetPixelChannels(), GetPixelGreen(), GetPixelRed(), GetXMLTreeChild(), GetXMLTreeContent(), _PixelInfo::green, IsEventLogging(), LogMagickEvent(), magick_restrict, MagickCoreSignature, MagickFalse, MagickPathExtent, MagickTrue, MaxMap, NewXMLTree(), _Image::progress_monitor, PseudoClass, _PixelInfo::red, RelinquishMagickMemory(), ResourceLimitError, _Image::rows, SetImageProgress(), SetPixelBlue(), SetPixelGreen(), SetPixelRed(), _Image::signature, _Image::storage_class, StringToDouble(), SyncCacheViewAuthenticPixels(), ThrowBinaryException, TraceEvent, and TransformEvent.

◆ Contrast()

static void Contrast ( const int  sign,
double *  red,
double *  green,
double *  blue 
)
static

Definition at line 1372 of file enhance.c.

References ConvertHSBToRGB(), ConvertRGBToHSB(), and MagickPI.

Referenced by ContrastImage().

◆ ContrastImage()

MagickExport MagickBooleanType ContrastImage ( Image *  image,
const MagickBooleanType  sharpen,
ExceptionInfo *  exception 
)

Definition at line 1399 of file enhance.c.

References AcquireAuthenticCacheView(), _PixelInfo::blue, ClampToQuantum(), _Image::colormap, _Image::colors, _Image::columns, Contrast(), ContrastImageTag, DestroyCacheView(), _Image::filename, GetCacheViewAuthenticPixels(), GetMagickModule, GetPixelBlue(), GetPixelChannels(), GetPixelGreen(), GetPixelRed(), _PixelInfo::green, IsEventLogging(), LogMagickEvent(), magick_restrict, MagickCoreSignature, MagickFalse, MagickTrue, _Image::progress_monitor, PseudoClass, _PixelInfo::red, _Image::rows, SetImageProgress(), SetPixelBlue(), SetPixelGreen(), SetPixelRed(), _Image::signature, _Image::storage_class, SyncCacheViewAuthenticPixels(), and TraceEvent.

Referenced by PreviewImage(), and SepiaToneImage().

◆ ContrastStretchImage()

MagickExport MagickBooleanType ContrastStretchImage ( Image *  image,
const double  black_point,
const double  white_point,
ExceptionInfo *  exception 
)

Definition at line 1551 of file enhance.c.

References AcquireAuthenticCacheView(), AcquireQuantumMemory(), AcquireVirtualCacheView(), _PixelInfo::alpha, AlphaPixelChannel, _PixelInfo::blue, BluePixelChannel, _Image::channel_mask, ClampToQuantum(), _Image::colormap, _Image::colors, _Image::columns, ContrastStretchImageTag, DefaultChannels, DestroyCacheView(), _Image::filename, GetCacheViewAuthenticPixels(), GetCacheViewVirtualPixels(), GetMagickModule, GetPixelAlphaTraits(), GetPixelBlueTraits(), GetPixelChannelChannel(), GetPixelChannelOffset(), GetPixelChannels(), GetPixelChannelTraits(), GetPixelGreenTraits(), GetPixelIntensity(), GetPixelRedTraits(), GRAYColorspace, _PixelInfo::green, GreenPixelChannel, IdentifyImageType(), IsEventLogging(), IsGrayImageType(), LogMagickEvent(), magick_restrict, MagickCoreSignature, MagickFalse, MagickTrue, MaxMap, MaxPixelChannels, MaxRange, PerceptibleReciprocal(), _Image::progress_monitor, PseudoClass, QuantumRange, _PixelInfo::red, RedPixelChannel, RelinquishMagickMemory(), ResourceLimitError, _Image::rows, SetImageColorspace(), SetImageProgress(), _Image::signature, _Image::storage_class, SyncCacheViewAuthenticPixels(), ThrowBinaryException, TraceEvent, and UpdatePixelTrait.

Referenced by NormalizeImage().

◆ EnhanceImage()

MagickExport Image * EnhanceImage ( const Image *  image,
ExceptionInfo *  exception 
)

Definition at line 1838 of file enhance.c.

References AcquireAuthenticCacheView(), AcquireVirtualCacheView(), _PixelInfo::alpha, _PixelInfo::black, _PixelInfo::blue, CloneImage(), _Image::columns, DestroyCacheView(), DestroyImage(), DirectClass, EnhanceImageTag, EnhancePixel, _Image::filename, GetCacheViewVirtualPixels(), GetMagickModule, GetPixelChannels(), GetPixelInfo(), GetPixelInfoPixel(), _PixelInfo::green, IsEventLogging(), LogMagickEvent(), magick_restrict, MagickCoreSignature, MagickEpsilon, MagickFalse, MagickTrue, _Image::progress_monitor, QueueCacheViewAuthenticPixels(), _PixelInfo::red, _Image::rows, SetImageProgress(), SetImageStorageClass(), SetPixelViaPixelInfo(), _ExceptionInfo::signature, _Image::signature, SyncCacheViewAuthenticPixels(), and TraceEvent.

◆ EqualizeImage()

MagickExport MagickBooleanType EqualizeImage ( Image *  image,
ExceptionInfo *  exception 
)

Definition at line 2033 of file enhance.c.

References AcquireAuthenticCacheView(), AcquireQuantumMemory(), AcquireVirtualCacheView(), _PixelInfo::alpha, AlphaPixelChannel, _PixelInfo::blue, BluePixelChannel, _Image::channel_mask, ClampToQuantum(), _Image::colormap, _Image::colors, _Image::columns, CompositePixelChannel, DestroyCacheView(), EqualizeImageTag, _Image::filename, GetCacheViewAuthenticPixels(), GetCacheViewVirtualPixels(), GetMagickModule, GetPixelAlphaTraits(), GetPixelBlueTraits(), GetPixelChannelChannel(), GetPixelChannels(), GetPixelChannelTraits(), GetPixelGreenTraits(), GetPixelIntensity(), GetPixelRedTraits(), _PixelInfo::green, GreenPixelChannel, IsEventLogging(), LogMagickEvent(), magick_restrict, MagickCoreSignature, MagickFalse, MagickTrue, MaxMap, MaxPixelChannels, _Image::progress_monitor, PseudoClass, _PixelInfo::red, RedPixelChannel, RelinquishMagickMemory(), ResourceLimitError, _Image::rows, SetImageProgress(), _Image::signature, _Image::storage_class, SyncCacheViewAuthenticPixels(), SyncChannels, ThrowBinaryException, TraceEvent, and UpdatePixelTrait.

Referenced by EmbossImage().

◆ gamma_pow()

static double gamma_pow ( const double  value,
const double  gamma 
)
inlinestatic

Definition at line 2310 of file enhance.c.

Referenced by LevelPixel().

◆ GammaImage()

MagickExport MagickBooleanType GammaImage ( Image *  image,
const double  gamma,
ExceptionInfo *  exception 
)

Definition at line 2315 of file enhance.c.

References AcquireAuthenticCacheView(), AcquireQuantumMemory(), _PixelInfo::alpha, _PixelInfo::blue, ClampToQuantum(), _Image::colormap, _Image::colors, _Image::columns, DestroyCacheView(), _Image::filename, _Image::gamma, GammaImageTag, GetCacheViewAuthenticPixels(), GetMagickModule, GetPixelAlphaTraits(), GetPixelBlueTraits(), GetPixelChannelChannel(), GetPixelChannels(), GetPixelChannelTraits(), GetPixelGreenTraits(), GetPixelRedTraits(), _PixelInfo::green, IsEventLogging(), LogMagickEvent(), magick_restrict, MagickCoreSignature, MagickFalse, MagickTrue, MaxMap, PerceptibleReciprocal(), _Image::progress_monitor, PseudoClass, _PixelInfo::red, RelinquishMagickMemory(), ResourceLimitError, _Image::rows, SetImageProgress(), _Image::signature, _Image::storage_class, SyncCacheViewAuthenticPixels(), ThrowBinaryException, TraceEvent, and UpdatePixelTrait.

Referenced by PreviewImage().

◆ GenerateCLAHEHistogram()

static void GenerateCLAHEHistogram ( const RectangleInfo *  clahe_info,
const RectangleInfo *  tile_info,
const size_t  number_bins,
const unsigned short *  lut,
const unsigned short *  pixels,
size_t *  histogram 
)
static

Definition at line 379 of file enhance.c.

References _RectangleInfo::height, and _RectangleInfo::width.

Referenced by CLAHE().

◆ GenerateCLAHELut()

static void GenerateCLAHELut ( const RangeInfo *  range_info,
const size_t  number_bins,
unsigned short *  lut 
)
static

Definition at line 438 of file enhance.c.

References _RangeInfo::max, and _RangeInfo::min.

Referenced by CLAHE().

◆ GrayscaleImage()

MagickExport MagickBooleanType GrayscaleImage ( Image *  image,
const PixelIntensityMethod  method,
ExceptionInfo *  exception 
)

Definition at line 2467 of file enhance.c.

References AcquireAuthenticCacheView(), AveragePixelIntensityMethod, BrightnessPixelIntensityMethod, ClampToQuantum(), _Image::colorspace, _Image::columns, DecodePixelGamma(), DestroyCacheView(), DirectClass, EncodePixelGamma(), _Image::filename, GetCacheViewAuthenticPixels(), GetMagickModule, GetPixelBlue(), GetPixelChannels(), GetPixelGreen(), GetPixelRed(), GRAYColorspace, GrayscaleImageTag, GrayscaleType, _Image::intensity, IsEventLogging(), LightnessPixelIntensityMethod, LinearGRAYColorspace, LogMagickEvent(), magick_restrict, MagickCoreSignature, MagickFalse, MagickMax, MagickMin, MagickTrue, MSPixelIntensityMethod, _Image::progress_monitor, PseudoClass, Rec601LumaPixelIntensityMethod, Rec601LuminancePixelIntensityMethod, Rec709LumaPixelIntensityMethod, Rec709LuminancePixelIntensityMethod, RGBColorspace, RMSPixelIntensityMethod, _Image::rows, SetImageColorspace(), SetImageProgress(), SetImageStorageClass(), SetPixelGray(), _Image::signature, sRGBColorspace, _Image::storage_class, SyncCacheViewAuthenticPixels(), SyncImage(), TraceEvent, and _Image::type.

Referenced by CharcoalImage().

◆ HaldClutImage()

MagickExport MagickBooleanType HaldClutImage ( Image *  image,
const Image *  hald_image,
ExceptionInfo *  exception 
)

Definition at line 2679 of file enhance.c.

References AcquireAuthenticCacheView(), AcquireVirtualCacheView(), _PixelInfo::alpha, _Image::alpha_trait, _PixelInfo::black, _PixelInfo::blue, ClampToQuantum(), CMYKColorspace, _Image::colorspace, _Image::columns, CompositePixelInfoAreaBlend(), DestroyCacheView(), DirectClass, _Image::filename, GetCacheViewAuthenticPixels(), GetMagickModule, GetPixelAlphaTraits(), GetPixelBlackTraits(), GetPixelBlue(), GetPixelBlueTraits(), GetPixelChannels(), GetPixelGreen(), GetPixelGreenTraits(), GetPixelInfo(), GetPixelRed(), GetPixelRedTraits(), _PixelInfo::green, HaldClutImageTag, _Image::interpolate, InterpolatePixelInfo(), IsEventLogging(), LogMagickEvent(), magick_restrict, MagickCoreSignature, MagickFalse, MagickMin, MagickTrue, NearestInterpolatePixel, OpaqueAlphaChannel, _Image::progress_monitor, QuantumScale, _PixelInfo::red, _Image::rows, SetImageAlphaChannel(), SetImageProgress(), SetImageStorageClass(), SetPixelAlpha(), SetPixelBlack(), SetPixelBlue(), SetPixelGreen(), SetPixelRed(), _Image::signature, SyncCacheViewAuthenticPixels(), TraceEvent, UndefinedPixelTrait, and UpdatePixelTrait.

◆ InterpolateCLAHE()

static void InterpolateCLAHE ( const RectangleInfo *  clahe_info,
const size_t *  Q12,
const size_t *  Q22,
const size_t *  Q11,
const size_t *  Q21,
const RectangleInfo *  tile,
const unsigned short *  lut,
unsigned short *  pixels 
)
static

Definition at line 408 of file enhance.c.

References _RectangleInfo::height, PerceptibleReciprocal(), and _RectangleInfo::width.

Referenced by CLAHE().

◆ InverseScaledSigmoidal()

static double InverseScaledSigmoidal ( const double  a,
const double  b,
const double  x 
)
inlinestatic

Definition at line 4222 of file enhance.c.

References MagickEpsilon, and Sigmoidal.

◆ LevelImage()

MagickExport MagickBooleanType LevelImage ( Image *  image,
const double  black_point,
const double  white_point,
const double  gamma,
ExceptionInfo *  exception 
)

Definition at line 2909 of file enhance.c.

References AcquireAuthenticCacheView(), _PixelInfo::alpha, _PixelInfo::blue, ClampImage(), ClampToQuantum(), _Image::colormap, _Image::colors, _Image::columns, DestroyCacheView(), _Image::filename, GetCacheViewAuthenticPixels(), GetMagickModule, GetPixelAlphaTraits(), GetPixelBlueTraits(), GetPixelChannelChannel(), GetPixelChannels(), GetPixelChannelTraits(), GetPixelGreenTraits(), GetPixelRedTraits(), _PixelInfo::green, IsEventLogging(), LevelImageTag, LevelPixel(), LogMagickEvent(), magick_restrict, MagickCoreSignature, MagickFalse, MagickTrue, _Image::progress_monitor, PseudoClass, _PixelInfo::red, _Image::rows, SetImageProgress(), _Image::signature, _Image::storage_class, SyncCacheViewAuthenticPixels(), TraceEvent, and UpdatePixelTrait.

Referenced by AutoGammaImage(), LevelImageColors(), LinearStretchImage(), MinMaxStretchImage(), and WhiteBalanceImage().

◆ LevelImageColors()

MagickExport MagickBooleanType LevelImageColors ( Image *  image,
const PixelInfo *  black_color,
const PixelInfo *  white_color,
const MagickBooleanType  invert,
ExceptionInfo *  exception 
)

Definition at line 3209 of file enhance.c.

References _PixelInfo::alpha, _Image::alpha_trait, AlphaChannel, _PixelInfo::black, BlackChannel, _PixelInfo::blue, BlueChannel, CMYKColorspace, _Image::colorspace, _PixelInfo::colorspace, _Image::filename, GetMagickModule, GetPixelAlphaTraits(), GetPixelBlackTraits(), GetPixelBlueTraits(), GetPixelGreenTraits(), GetPixelRedTraits(), _PixelInfo::green, GreenChannel, IsEventLogging(), IsGrayColorspace(), LevelImage(), LevelizeImage(), LogMagickEvent(), MagickCoreSignature, MagickFalse, MagickTrue, _PixelInfo::red, RedChannel, SetImageChannelMask(), SetImageColorspace(), _Image::signature, sRGBColorspace, TraceEvent, UndefinedPixelTrait, and UpdatePixelTrait.

◆ LevelizeImage()

MagickExport MagickBooleanType LevelizeImage ( Image *  image,
const double  black_point,
const double  white_point,
const double  gamma,
ExceptionInfo *  exception 
)

Definition at line 3060 of file enhance.c.

References AcquireAuthenticCacheView(), _PixelInfo::alpha, _PixelInfo::blue, _Image::colormap, _Image::colors, _Image::columns, DestroyCacheView(), _Image::filename, GetCacheViewAuthenticPixels(), GetMagickModule, GetPixelAlphaTraits(), GetPixelBlueTraits(), GetPixelChannelChannel(), GetPixelChannels(), GetPixelChannelTraits(), GetPixelGreenTraits(), GetPixelRedTraits(), _PixelInfo::green, IsEventLogging(), LevelizeImageTag, LevelizeValue, LogMagickEvent(), magick_restrict, MagickCoreSignature, MagickFalse, MagickTrue, _Image::progress_monitor, PseudoClass, _PixelInfo::red, _Image::rows, SetImageProgress(), _Image::signature, _Image::storage_class, SyncCacheViewAuthenticPixels(), TraceEvent, and UpdatePixelTrait.

Referenced by LevelImageColors().

◆ LevelPixel()

static double LevelPixel ( const double  black_point,
const double  white_point,
const double  gamma,
const double  pixel 
)
inlinestatic

Definition at line 2896 of file enhance.c.

References gamma_pow(), PerceptibleReciprocal(), and QuantumRange.

Referenced by LevelImage().

◆ LinearStretchImage()

MagickExport MagickBooleanType LinearStretchImage ( Image *  image,
const double  black_point,
const double  white_point,
ExceptionInfo *  exception 
)

Definition at line 3345 of file enhance.c.

References AcquireQuantumMemory(), AcquireVirtualCacheView(), ClampToQuantum(), _Image::columns, DestroyCacheView(), _Image::filename, GetCacheViewVirtualPixels(), GetPixelChannels(), GetPixelIntensity(), LevelImage(), magick_restrict, MagickCoreSignature, MaxMap, RelinquishMagickMemory(), ResourceLimitError, _Image::rows, _Image::signature, and ThrowBinaryException.

◆ MapCLAHEHistogram()

static void MapCLAHEHistogram ( const RangeInfo *  range_info,
const size_t  number_bins,
const size_t  number_pixels,
size_t *  histogram 
)
static

Definition at line 455 of file enhance.c.

References _RangeInfo::max, and _RangeInfo::min.

Referenced by CLAHE().

◆ ModulateHCL()

static void ModulateHCL ( const double  percent_hue,
const double  percent_chroma,
const double  percent_luma,
double *  red,
double *  green,
double *  blue 
)
inlinestatic

Definition at line 3454 of file enhance.c.

References ConvertHCLToRGB(), and ConvertRGBToHCL().

Referenced by ModulateImage().

◆ ModulateHCLp()

static void ModulateHCLp ( const double  percent_hue,
const double  percent_chroma,
const double  percent_luma,
double *  red,
double *  green,
double *  blue 
)
inlinestatic

Definition at line 3473 of file enhance.c.

References ConvertHCLpToRGB(), and ConvertRGBToHCLp().

Referenced by ModulateImage().

◆ ModulateHSB()

static void ModulateHSB ( const double  percent_hue,
const double  percent_saturation,
const double  percent_brightness,
double *  red,
double *  green,
double *  blue 
)
inlinestatic

Definition at line 3492 of file enhance.c.

References ConvertHSBToRGB(), and ConvertRGBToHSB().

Referenced by ModulateImage().

◆ ModulateHSI()

static void ModulateHSI ( const double  percent_hue,
const double  percent_saturation,
const double  percent_intensity,
double *  red,
double *  green,
double *  blue 
)
inlinestatic

Definition at line 3511 of file enhance.c.

References ConvertHSIToRGB(), and ConvertRGBToHSI().

Referenced by ModulateImage().

◆ ModulateHSL()

static void ModulateHSL ( const double  percent_hue,
const double  percent_saturation,
const double  percent_lightness,
double *  red,
double *  green,
double *  blue 
)
inlinestatic

Definition at line 3530 of file enhance.c.

References ConvertHSLToRGB(), and ConvertRGBToHSL().

Referenced by ModulateImage().

◆ ModulateHSV()

static void ModulateHSV ( const double  percent_hue,
const double  percent_saturation,
const double  percent_value,
double *  red,
double *  green,
double *  blue 
)
inlinestatic

Definition at line 3549 of file enhance.c.

References ConvertHSVToRGB(), and ConvertRGBToHSV().

Referenced by ModulateImage().

◆ ModulateHWB()

static void ModulateHWB ( const double  percent_hue,
const double  percent_whiteness,
const double  percent_blackness,
double *  red,
double *  green,
double *  blue 
)
inlinestatic

Definition at line 3568 of file enhance.c.

References ConvertHWBToRGB(), and ConvertRGBToHWB().

Referenced by ModulateImage().

◆ ModulateImage()

MagickExport MagickBooleanType ModulateImage ( Image *  image,
const char *  modulate,
ExceptionInfo *  exception 
)

Definition at line 3625 of file enhance.c.

References AcquireAuthenticCacheView(), _PixelInfo::blue, ClampToQuantum(), _Image::colormap, _Image::colors, _Image::colorspace, _Image::columns, D65Illuminant, DestroyCacheView(), _Image::filename, GetCacheViewAuthenticPixels(), GetImageArtifact(), GetMagickModule, GetPixelBlue(), GetPixelChannels(), GetPixelGreen(), GetPixelRed(), _PixelInfo::green, HCLColorspace, HCLpColorspace, HSBColorspace, HSIColorspace, HSLColorspace, HSVColorspace, HWBColorspace, IsEventLogging(), IssRGBCompatibleColorspace(), LCHabColorspace, LCHColorspace, LCHuvColorspace, LogMagickEvent(), magick_restrict, MagickColorspaceOptions, MagickCoreSignature, MagickFalse, MagickIlluminantOptions, MagickTrue, ModulateHCL(), ModulateHCLp(), ModulateHSB(), ModulateHSI(), ModulateHSL(), ModulateHSV(), ModulateHWB(), ModulateImageTag, ModulateLCHab(), ModulateLCHuv(), ParseCommandOption(), ParseGeometry(), _Image::progress_monitor, PseudoClass, _PixelInfo::red, _GeometryInfo::rho, RhoValue, _Image::rows, SetImageColorspace(), SetImageProgress(), SetPixelBlue(), SetPixelGreen(), SetPixelRed(), _GeometryInfo::sigma, SigmaValue, _Image::signature, sRGBColorspace, _Image::storage_class, SyncCacheViewAuthenticPixels(), TraceEvent, UndefinedColorspace, UndefinedIlluminant, _GeometryInfo::xi, and XiValue.

Referenced by PreviewImage().

◆ ModulateLCHab()

static void ModulateLCHab ( const double  percent_luma,
const double  percent_chroma,
const double  percent_hue,
const IlluminantType  illuminant,
double *  red,
double *  green,
double *  blue 
)
inlinestatic

Definition at line 3587 of file enhance.c.

References ConvertLCHabToRGB(), and ConvertRGBToLCHab().

Referenced by ModulateImage().

◆ ModulateLCHuv()

static void ModulateLCHuv ( const double  percent_luma,
const double  percent_chroma,
const double  percent_hue,
const IlluminantType  illuminant,
double *  red,
double *  green,
double *  blue 
)
inlinestatic

Definition at line 3606 of file enhance.c.

References ConvertLCHuvToRGB(), and ConvertRGBToLCHuv().

Referenced by ModulateImage().

◆ NegateImage()

MagickExport MagickBooleanType NegateImage ( Image *  image,
const MagickBooleanType  grayscale,
ExceptionInfo *  exception 
)

Definition at line 3922 of file enhance.c.

References AcquireAuthenticCacheView(), _PixelInfo::blue, _Image::colormap, _Image::colors, _Image::columns, DestroyCacheView(), _Image::filename, GetCacheViewAuthenticPixels(), GetMagickModule, GetPixelBlueTraits(), GetPixelChannelChannel(), GetPixelChannels(), GetPixelChannelTraits(), GetPixelGreenTraits(), GetPixelRedTraits(), _PixelInfo::green, IsEventLogging(), IsPixelGray(), LogMagickEvent(), magick_restrict, MagickCoreSignature, MagickFalse, MagickTrue, NegateImageTag, _Image::progress_monitor, PseudoClass, QuantumRange, _PixelInfo::red, _Image::rows, SetImageProgress(), _Image::signature, _Image::storage_class, SyncCacheViewAuthenticPixels(), TraceEvent, and UpdatePixelTrait.

Referenced by CharcoalImage(), ClipImagePath(), DrawClippingMask(), DrawCompositeMask(), MontageImageList(), RenderPostscript(), and SketchImage().

◆ NormalizeImage()

MagickExport MagickBooleanType NormalizeImage ( Image *  image,
ExceptionInfo *  exception 
)

Definition at line 4112 of file enhance.c.

References _Image::columns, ContrastStretchImage(), and _Image::rows.

Referenced by CharcoalImage(), SepiaToneImage(), SetImageType(), and SketchImage().

◆ SigmoidalContrastImage()

MagickExport MagickBooleanType SigmoidalContrastImage ( Image *  image,
const MagickBooleanType  sharpen,
const double  contrast,
const double  midpoint,
ExceptionInfo *  exception 
)

Definition at line 4249 of file enhance.c.

References AcquireAuthenticCacheView(), _PixelInfo::alpha, _PixelInfo::blue, _Image::colormap, _Image::colors, _Image::columns, DestroyCacheView(), _Image::filename, GetCacheViewAuthenticPixels(), GetMagickModule, GetPixelAlphaTraits(), GetPixelBlueTraits(), GetPixelChannelChannel(), GetPixelChannels(), GetPixelChannelTraits(), GetPixelGreenTraits(), GetPixelRedTraits(), _PixelInfo::green, InverseScaledSig, IsEventLogging(), LogMagickEvent(), magick_restrict, MagickCoreSignature, MagickEpsilon, MagickFalse, MagickTrue, _Image::progress_monitor, PseudoClass, _PixelInfo::red, _Image::rows, ScaledSig, SetImageProgress(), SigmoidalContrastImageTag, _Image::signature, _Image::storage_class, SyncCacheViewAuthenticPixels(), TraceEvent, and UpdatePixelTrait.

◆ WhiteBalanceImage()

MagickExport MagickBooleanType WhiteBalanceImage ( Image *  image,
ExceptionInfo *  exception 
)

Definition at line 4416 of file enhance.c.

References aChannel, AcquireAuthenticCacheView(), bChannel, ClampToQuantum(), _Image::columns, DestroyCacheView(), DirectClass, _Image::filename, GetCacheViewAuthenticPixels(), GetCacheViewVirtualPixels(), GetImageArtifact(), GetMagickModule, GetPixela(), GetPixelb(), GetPixelChannels(), GetPixelL(), IsEventLogging(), LabColorspace, LevelImage(), LogMagickEvent(), magick_restrict, MagickCoreSignature, MagickFalse, MagickTrue, ParseGeometry(), PercentValue, _Image::progress_monitor, QuantumRange, QuantumScale, _GeometryInfo::rho, RhoValue, _Image::rows, SetImageChannelMask(), SetImageProgress(), SetImageStorageClass(), SetPixela(), SetPixelb(), _Image::signature, sRGBColorspace, SyncCacheViewAuthenticPixels(), TraceEvent, TransformImageColorspace(), and WhiteBalanceImageTag.