#include "MagickCore/studio.h"
#include "MagickCore/artifact.h"
#include "MagickCore/cache.h"
#include "MagickCore/cache-view.h"
#include "MagickCore/color.h"
#include "MagickCore/color-private.h"
#include "MagickCore/colorspace.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-accessor.h"
#include "MagickCore/quantum.h"
#include "MagickCore/quantum-private.h"
#include "MagickCore/resample.h"
#include "MagickCore/resample-private.h"
#include "MagickCore/statistic.h"
#include "MagickCore/string_.h"
#include "MagickCore/string-private.h"
#include "MagickCore/thread-private.h"
#include "MagickCore/token.h"
#include "MagickCore/xml-tree.h"
#include "MagickCore/xml-tree-private.h"

Include dependency graph for enhance.c:

Defines
#define	BrightnessContastImageTag "BrightnessContast/Image"
#define	ClutImageTag "Clut/Image"
#define	ColorDecisionListCorrectImageTag "ColorDecisionList/Image"
#define	ContrastImageTag "Contrast/Image"
#define	MaxRange(color) ((MagickRealType) ScaleQuantumToMap((Quantum) (color)))
#define	ContrastStretchImageTag "ContrastStretch/Image"
#define	EnhancePixel(weight)
#define	EnhanceImageTag "Enhance/Image"
#define	EqualizeImageTag "Equalize/Image"
#define	GammaCorrectImageTag "GammaCorrect/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	SigmoidalContrastImageTag "SigmoidalContrast/Image"
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)
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)
MagickExport MagickBooleanType	GammaImage (Image image, const double gamma, ExceptionInfo exception)
static size_t	MagickMin (const size_t x, const size_t y)
MagickExport MagickBooleanType	HaldClutImage (Image image, const Image hald_image, ExceptionInfo *exception)
static MagickRealType	LevelPixel (const double black_point, const double white_point, const double gamma, const MagickRealType 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	ModulateHSB (const double percent_hue, const double percent_saturation, const double percent_brightness, 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	ModulateHWB (const double percent_hue, const double percent_whiteness, const double percent_blackness, 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)
MagickExport MagickBooleanType	SigmoidalContrastImage (Image image, const MagickBooleanType sharpen, const double contrast, const double midpoint, ExceptionInfo exception)

Define Documentation

#define BrightnessContastImageTag "BrightnessContast/Image"

#define ClutImageTag "Clut/Image"

Referenced by ClutImage().

#define ColorDecisionListCorrectImageTag "ColorDecisionList/Image"

Referenced by ColorDecisionListImage().

#define ContrastImageTag "Contrast/Image"

Referenced by ContrastImage().

#define ContrastStretchImageTag "ContrastStretch/Image"

Referenced by ContrastStretchImage().

#define EnhanceImageTag "Enhance/Image"

Referenced by EnhanceImage().

#define EnhancePixel ( weight )

Value:

mean=((MagickRealType) r[i]+GetPixelChannel(enhance_image,channel,q))/2.0; \
  distance=(MagickRealType) r[i]-(MagickRealType) GetPixelChannel( \
    enhance_image,channel,q); \
  distance_squared=QuantumScale*(2.0*((MagickRealType) QuantumRange+1.0)+ \
    mean)*distance*distance; \
  if (distance_squared < ((MagickRealType) QuantumRange*(MagickRealType) \
      QuantumRange/25.0f)) \
    { \
      aggregate+=(weight)*r[i]; \
      total_weight+=(weight); \
    } \
  r+=GetPixelChannels(image);

Referenced by EnhanceImage().

#define EqualizeImageTag "Equalize/Image"

Referenced by EqualizeImage().

#define GammaCorrectImageTag "GammaCorrect/Image"

Referenced by GammaImage().

#define HaldClutImageTag "Clut/Image"

Referenced by HaldClutImage().

#define LevelImageTag "Level/Image"

Referenced by LevelImage().

#define LevelizeImageTag "Levelize/Image"

Referenced by LevelizeImage().

#define LevelizeValue ( x )

Value:

(ClampToQuantum(((MagickRealType) \
  pow((double) (QuantumScale*(x)),1.0/gamma))*(white_point-black_point)+ \
  black_point))

Referenced by LevelizeImage().

#define LinearStretchImageTag "LinearStretch/Image"

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

Referenced by ContrastStretchImage().

#define ModulateImageTag "Modulate/Image"

Referenced by ModulateImage().

#define NegateImageTag "Negate/Image"

Referenced by NegateImage().

#define SigmoidalContrastImageTag "SigmoidalContrast/Image"

Referenced by SigmoidalContrastImage().

Function Documentation

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

Definition at line 103 of file enhance.c.

References _Image::channel_mask, DefaultChannels, GetImageMean(), QuantumScale, LevelImage(), QuantumRange, MagickTrue, GetPixelChannels(), GetPixelChannelMapChannel(), GetPixelChannelMapTraits(), UpdatePixelTrait, SetPixelChannelMask(), and MagickFalse.

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

Definition at line 183 of file enhance.c.

References MinMaxStretchImage().

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

Definition at line 220 of file enhance.c.

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

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

Definition at line 297 of file enhance.c.

References _Image::signature, MagickSignature, _Image::debug, MagickFalse, LogMagickEvent(), TraceEvent, GetMagickModule, _Image::filename, SetImageStorageClass(), DirectClass, AcquireQuantumMemory(), MaxMap, GetPixelChannels(), ThrowBinaryException, ResourceLimitError, MagickTrue, _Image::interpolate, IntegerInterpolatePixel, AcquireCacheView(), InterpolatePixelChannel(), QuantumScale, _Image::columns, _Image::rows, DestroyCacheView(), GetCacheViewAuthenticPixels(), GetPixelMask(), GetPixelChannelMapChannel(), GetPixelChannelMapTraits(), UndefinedPixelTrait, UpdatePixelTrait, SetPixelChannel(), ClampToQuantum(), GetPixelChannel(), SyncCacheViewAuthenticPixels(), _Image::progress_monitor, SetImageProgress(), ClutImageTag, RelinquishMagickMemory(), _Image::matte, GetPixelAlphaTraits(), SetImageAlphaChannel(), and ActivateAlphaChannel.

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

Definition at line 477 of file enhance.c.

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

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

Definition at line 846 of file enhance.c.

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

Referenced by ContrastImage().

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
	)

Definition at line 1007 of file enhance.c.

References _Image::signature, MagickSignature, _Image::debug, MagickFalse, LogMagickEvent(), TraceEvent, GetMagickModule, _Image::filename, AcquireQuantumMemory(), GetPixelChannels(), MaxMap, RelinquishMagickMemory(), ThrowBinaryException, ResourceLimitError, MagickTrue, ResetMagickMemory(), AcquireCacheView(), _Image::rows, GetCacheViewVirtualPixels(), _Image::columns, MaxRange, QuantumRange, _Image::storage_class, PseudoClass, _Image::colors, GetPixelRedTraits(), UpdatePixelTrait, GetPixelChannelMapChannel(), RedPixelChannel, _Image::colormap, _PixelInfo::red, ClampToQuantum(), GetPixelGreenTraits(), GreenPixelChannel, _PixelInfo::green, GetPixelBlueTraits(), BluePixelChannel, _PixelInfo::blue, GetPixelAlphaTraits(), AlphaPixelChannel, _PixelInfo::alpha, GetCacheViewAuthenticPixels(), GetPixelMask(), GetPixelChannelMapTraits(), SyncCacheViewAuthenticPixels(), _Image::progress_monitor, SetImageProgress(), ContrastStretchImageTag, and DestroyCacheView().

Referenced by NormalizeImage().

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

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

Definition at line 1498 of file enhance.c.

References CompositePixelChannel, _Image::signature, MagickSignature, _Image::debug, MagickFalse, LogMagickEvent(), TraceEvent, GetMagickModule, _Image::filename, AcquireQuantumMemory(), MaxMap, GetPixelChannels(), RelinquishMagickMemory(), ThrowBinaryException, ResourceLimitError, MagickTrue, ResetMagickMemory(), AcquireCacheView(), _Image::rows, GetCacheViewVirtualPixels(), _Image::columns, _Image::storage_class, PseudoClass, _Image::colors, GetPixelRedTraits(), UpdatePixelTrait, GetPixelChannelMapChannel(), RedPixelChannel, _Image::colormap, _PixelInfo::red, ClampToQuantum(), GetPixelGreenTraits(), GreenPixelChannel, _PixelInfo::green, GetPixelBlueTraits(), BluePixelChannel, _PixelInfo::blue, GetPixelAlphaTraits(), AlphaPixelChannel, _PixelInfo::alpha, GetCacheViewAuthenticPixels(), GetPixelMask(), GetPixelChannelMapTraits(), SyncCacheViewAuthenticPixels(), _Image::progress_monitor, SetImageProgress(), EqualizeImageTag, and DestroyCacheView().

Referenced by EmbossImage().

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

Definition at line 1784 of file enhance.c.

References _Image::signature, MagickSignature, _Image::debug, MagickFalse, LogMagickEvent(), TraceEvent, GetMagickModule, _Image::filename, MagickTrue, AcquireQuantumMemory(), MaxMap, ThrowBinaryException, ResourceLimitError, ResetMagickMemory(), _Image::storage_class, PseudoClass, _Image::colors, GetPixelRedTraits(), UpdatePixelTrait, _Image::colormap, _PixelInfo::red, ClampToQuantum(), GetPixelGreenTraits(), _PixelInfo::green, GetPixelBlueTraits(), _PixelInfo::blue, GetPixelAlphaTraits(), _PixelInfo::alpha, AcquireCacheView(), _Image::rows, GetCacheViewAuthenticPixels(), _Image::columns, GetPixelMask(), GetPixelChannels(), GetPixelChannelMapChannel(), GetPixelChannelMapTraits(), SyncCacheViewAuthenticPixels(), _Image::progress_monitor, SetImageProgress(), GammaCorrectImageTag, DestroyCacheView(), RelinquishMagickMemory(), and _Image::gamma.

Referenced by PreviewImage().

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

Definition at line 1965 of file enhance.c.

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

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

Definition at line 2181 of file enhance.c.

References _Image::signature, MagickSignature, _Image::debug, MagickFalse, LogMagickEvent(), TraceEvent, GetMagickModule, _Image::filename, _Image::storage_class, PseudoClass, _Image::colors, GetPixelRedTraits(), UpdatePixelTrait, _Image::colormap, _PixelInfo::red, ClampToQuantum(), LevelPixel(), GetPixelGreenTraits(), _PixelInfo::green, GetPixelBlueTraits(), _PixelInfo::blue, GetPixelAlphaTraits(), _PixelInfo::alpha, MagickTrue, AcquireCacheView(), _Image::rows, GetCacheViewAuthenticPixels(), _Image::columns, GetPixelMask(), GetPixelChannels(), GetPixelChannelMapChannel(), GetPixelChannelMapTraits(), SyncCacheViewAuthenticPixels(), _Image::progress_monitor, SetImageProgress(), LevelImageTag, and DestroyCacheView().

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

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

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

static MagickRealType LevelPixel	(	const double	black_point,
		const double	white_point,
		const double	gamma,
		const MagickRealType	pixel
	)		`[inline, static]`

Definition at line 2164 of file enhance.c.

References QuantumRange.

Referenced by LevelImage().

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

Definition at line 2639 of file enhance.c.

References _Image::signature, MagickSignature, AcquireQuantumMemory(), MaxMap, ThrowBinaryException, ResourceLimitError, _Image::filename, ResetMagickMemory(), AcquireCacheView(), _Image::rows, GetCacheViewVirtualPixels(), _Image::columns, GetPixelIntensity(), GetPixelChannels(), DestroyCacheView(), RelinquishMagickMemory(), and LevelImage().

static size_t MagickMin	(	const size_t	x,
		const size_t	y
	)		`[inline, static]`

Definition at line 1958 of file enhance.c.

Referenced by HaldClutImage().

static void ModulateHSB	(	const double	percent_hue,
		const double	percent_saturation,
		const double	percent_brightness,
		double *	red,
		double *	green,
		double *	blue
	)		`[static]`

Definition at line 2746 of file enhance.c.

References ConvertRGBToHSB(), and ConvertHSBToRGB().

Referenced by ModulateImage().

static void ModulateHSL	(	const double	percent_hue,
		const double	percent_saturation,
		const double	percent_lightness,
		double *	red,
		double *	green,
		double *	blue
	)		`[static]`

Definition at line 2772 of file enhance.c.

References ConvertRGBToHSL(), and ConvertHSLToRGB().

Referenced by ModulateImage().

static void ModulateHWB	(	const double	percent_hue,
		const double	percent_whiteness,
		const double	percent_blackness,
		double *	red,
		double *	green,
		double *	blue
	)		`[static]`

Definition at line 2798 of file enhance.c.

References ConvertRGBToHWB(), and ConvertHWBToRGB().

Referenced by ModulateImage().

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

Definition at line 2822 of file enhance.c.

References _Image::signature, MagickSignature, _Image::debug, MagickFalse, LogMagickEvent(), TraceEvent, GetMagickModule, _Image::filename, ParseGeometry(), _GeometryInfo::rho, _GeometryInfo::sigma, SigmaValue, _GeometryInfo::xi, XiValue, UndefinedColorspace, GetImageArtifact(), ParseCommandOption(), MagickColorspaceOptions, _Image::storage_class, PseudoClass, _Image::colors, HSBColorspace, ModulateHSB(), _Image::colormap, _PixelInfo::red, _PixelInfo::green, _PixelInfo::blue, HSLColorspace, ModulateHSL(), HWBColorspace, ModulateHWB(), MagickTrue, AcquireCacheView(), _Image::rows, GetCacheViewAuthenticPixels(), _Image::columns, GetPixelRed(), GetPixelGreen(), GetPixelBlue(), SetPixelRed(), ClampToQuantum(), SetPixelGreen(), SetPixelBlue(), GetPixelChannels(), SyncCacheViewAuthenticPixels(), _Image::progress_monitor, SetImageProgress(), ModulateImageTag, and DestroyCacheView().

Referenced by PreviewImage().

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

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

Definition at line 3244 of file enhance.c.

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

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

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

Definition at line 3295 of file enhance.c.

References _Image::signature, MagickSignature, _Image::debug, MagickFalse, LogMagickEvent(), TraceEvent, GetMagickModule, _Image::filename, AcquireQuantumMemory(), MaxMap, ThrowBinaryException, ResourceLimitError, ResetMagickMemory(), QuantumRange, QuantumScale, _Image::storage_class, PseudoClass, _Image::colors, GetPixelRedTraits(), UpdatePixelTrait, _Image::colormap, _PixelInfo::red, ClampToQuantum(), GetPixelGreenTraits(), _PixelInfo::green, GetPixelBlueTraits(), _PixelInfo::blue, GetPixelAlphaTraits(), _PixelInfo::alpha, MagickTrue, AcquireCacheView(), _Image::rows, GetCacheViewAuthenticPixels(), _Image::columns, GetPixelMask(), GetPixelChannels(), GetPixelChannelMapChannel(), GetPixelChannelMapTraits(), SyncCacheViewAuthenticPixels(), _Image::progress_monitor, SetImageProgress(), SigmoidalContrastImageTag, DestroyCacheView(), and RelinquishMagickMemory().

Defines

Functions

Define Documentation

Function Documentation