property.c File Reference

#include "MagickCore/studio.h"
#include "MagickCore/attribute.h"
#include "MagickCore/cache.h"
#include "MagickCore/color.h"
#include "MagickCore/compare.h"
#include "MagickCore/constitute.h"
#include "MagickCore/draw.h"
#include "MagickCore/effect.h"
#include "MagickCore/exception.h"
#include "MagickCore/exception-private.h"
#include "MagickCore/fx.h"
#include "MagickCore/fx-private.h"
#include "MagickCore/gem.h"
#include "MagickCore/geometry.h"
#include "MagickCore/histogram.h"
#include "MagickCore/image.h"
#include "MagickCore/layer.h"
#include "MagickCore/locale-private.h"
#include "MagickCore/list.h"
#include "MagickCore/magick.h"
#include "MagickCore/memory_.h"
#include "MagickCore/monitor.h"
#include "MagickCore/montage.h"
#include "MagickCore/option.h"
#include "MagickCore/profile.h"
#include "MagickCore/property.h"
#include "MagickCore/quantum.h"
#include "MagickCore/resource_.h"
#include "MagickCore/splay-tree.h"
#include "MagickCore/signature.h"
#include "MagickCore/statistic.h"
#include "MagickCore/string_.h"
#include "MagickCore/string-private.h"
#include "MagickCore/token.h"
#include "MagickCore/token-private.h"
#include "MagickCore/utility.h"
#include "MagickCore/utility-private.h"
#include "MagickCore/version.h"
#include "MagickCore/xml-tree.h"
#include "MagickCore/xml-tree-private.h"

Include dependency graph for property.c:

Go to the source code of this file.

Defines
#define	MaxDirectoryStack   16
#define	EXIF_DELIMITER   "\n"
#define	EXIF_NUM_FORMATS   12
#define	EXIF_FMT_BYTE   1
#define	EXIF_FMT_STRING   2
#define	EXIF_FMT_USHORT   3
#define	EXIF_FMT_ULONG   4
#define	EXIF_FMT_URATIONAL   5
#define	EXIF_FMT_SBYTE   6
#define	EXIF_FMT_UNDEFINED   7
#define	EXIF_FMT_SSHORT   8
#define	EXIF_FMT_SLONG   9
#define	EXIF_FMT_SRATIONAL   10
#define	EXIF_FMT_SINGLE   11
#define	EXIF_FMT_DOUBLE   12
#define	TAG_EXIF_OFFSET   0x8769
#define	TAG_GPS_OFFSET   0x8825
#define	TAG_INTEROP_OFFSET   0xa005
#define	EXIFMultipleValues(size, format, arg)
#define	EXIFMultipleFractions(size, format, arg1, arg2)
Functions
MagickExport MagickBooleanType	CloneImageProperties (Image *image, const Image *clone_image)
MagickExport MagickBooleanType	DefineImageProperty (Image *image, const char *property, ExceptionInfo *exception)
MagickExport MagickBooleanType	DeleteImageProperty (Image *image, const char *property)
MagickExport void	DestroyImageProperties (Image *image)
MagickExport MagickBooleanType	FormatImageProperty (Image *image, const char *property, const char *format,...)
static char *	TracePSClippath (const unsigned char *, size_t, const size_t, const size_t)
static char *	TraceSVGClippath (const unsigned char *, size_t, const size_t, const size_t)
static MagickBooleanType	GetIPTCProperty (const Image *image, const char *key, ExceptionInfo *exception)
static ssize_t	MagickMax (const ssize_t x, const ssize_t y)
static ssize_t	MagickMin (const ssize_t x, const ssize_t y)
static int	ReadPropertyByte (const unsigned char **p, size_t *length)
static size_t	ReadPropertyMSBLong (const unsigned char **p, size_t *length)
static unsigned short	ReadPropertyMSBShort (const unsigned char **p, size_t *length)
static MagickBooleanType	Get8BIMProperty (const Image *image, const char *key, ExceptionInfo *exception)
static unsigned short	ReadPropertyShort (const EndianType endian, const unsigned char *buffer)
static size_t	ReadPropertyLong (const EndianType endian, const unsigned char *buffer)
static MagickBooleanType	GetEXIFProperty (const Image *image, const char *property, ExceptionInfo *exception)
static MagickBooleanType	GetXMPProperty (const Image *image, const char *property)
static char *	TracePSClippath (const unsigned char *blob, size_t length, const size_t magick_unused(columns), const size_t magick_unused(rows))
MagickExport const char *	GetImageProperty (const Image *image, const char *property, ExceptionInfo *exception)
MagickExport const char *	GetMagickProperty (const ImageInfo *image_info, Image *image, const char *property, ExceptionInfo *exception)
MagickExport char *	GetNextImageProperty (const Image *image)
MagickExport char *	InterpretImageProperties (const ImageInfo *image_info, Image *image, const char *embed_text, ExceptionInfo *exception)
MagickExport char *	RemoveImageProperty (Image *image, const char *property)
MagickExport void	ResetImagePropertyIterator (const Image *image)
MagickExport MagickBooleanType	SetImageProperty (Image *image, const char *property, const char *value, ExceptionInfo *exception)

---

Define Documentation

#define EXIF_DELIMITER   "\n"

#define EXIF_FMT_BYTE   1

Referenced by GetEXIFProperty().

#define EXIF_FMT_DOUBLE   12

Referenced by GetEXIFProperty().

#define EXIF_FMT_SBYTE   6

Referenced by GetEXIFProperty().

#define EXIF_FMT_SINGLE   11

Referenced by GetEXIFProperty().

#define EXIF_FMT_SLONG   9

Referenced by GetEXIFProperty().

#define EXIF_FMT_SRATIONAL   10

Referenced by GetEXIFProperty().

#define EXIF_FMT_SSHORT   8

Referenced by GetEXIFProperty().

#define EXIF_FMT_STRING   2

Referenced by GetEXIFProperty().

#define EXIF_FMT_ULONG   4

Referenced by GetEXIFProperty().

#define EXIF_FMT_UNDEFINED   7

Referenced by GetEXIFProperty().

#define EXIF_FMT_URATIONAL   5

Referenced by GetEXIFProperty().

#define EXIF_FMT_USHORT   3

Referenced by GetEXIFProperty().

#define EXIF_NUM_FORMATS   12

#define EXIFMultipleFractions	(		size,
			format,
			arg1,
			arg2
	)

Value:

{ \
   ssize_t \
     component; \
 \
   size_t \
     length; \
 \
   unsigned char \
     *p1; \
 \
   length=0; \
   p1=p; \
   for (component=0; component < components; component++) \
   { \
     length+=FormatLocaleString(buffer+length,MaxTextExtent-length, \
       format", ",arg1,arg2); \
     if (length >= (MaxTextExtent-1)) \
       length=MaxTextExtent-1; \
     p1+=size; \
   } \
   if (length > 1) \
     buffer[length-2]='\0'; \
   value=AcquireString(buffer); \
}

Referenced by GetEXIFProperty().

#define EXIFMultipleValues	(		size,
			format,
			arg
	)

Value:

{ \
   ssize_t \
     component; \
 \
   size_t \
     length; \
 \
   unsigned char \
     *p1; \
 \
   length=0; \
   p1=p; \
   for (component=0; component < components; component++) \
   { \
     length+=FormatLocaleString(buffer+length,MaxTextExtent-length, \
       format", ",arg); \
     if (length >= (MaxTextExtent-1)) \
       length=MaxTextExtent-1; \
     p1+=size; \
   } \
   if (length > 1) \
     buffer[length-2]='\0'; \
   value=AcquireString(buffer); \
}

Referenced by GetEXIFProperty().

#define MaxDirectoryStack   16

#define TAG_EXIF_OFFSET   0x8769

#define TAG_GPS_OFFSET   0x8825

Referenced by GetEXIFProperty().

#define TAG_INTEROP_OFFSET   0xa005

---

Function Documentation

MagickExport MagickBooleanType CloneImageProperties	(	Image *	image,
		const Image *	clone_image
	)

Definition at line 110 of file property.c.

References _Image::signature, MagickSignature, _Image::debug, MagickFalse, LogMagickEvent(), TraceEvent, GetMagickModule, _Image::filename, CopyMagickString(), MaxTextExtent, _Image::magick_filename, _Image::compression, _Image::quality, _Image::depth, _Image::background_color, _Image::border_color, _Image::matte_color, _Image::transparent_color, _Image::gamma, _Image::chromaticity, _Image::rendering_intent, _Image::black_point_compensation, _Image::units, _Image::montage, _Image::directory, CloneString(), _Image::geometry, _Image::offset, _Image::resolution, _PointInfo::x, _PointInfo::y, _Image::page, _Image::tile_offset, _Image::extract_info, _Image::bias, _Image::filter, _Image::blur, _Image::fuzz, _Image::interlace, _Image::interpolate, _Image::endian, _Image::gravity, _Image::compose, _Image::scene, _Image::orientation, _Image::dispose, _Image::delay, _Image::ticks_per_second, _Image::iterations, _Image::total_colors, _Image::taint, _Image::progress_monitor, _Image::client_data, _Image::start_loop, _Image::error, _Image::properties, DestroyImageProperties(), CloneSplayTree(), ConstantString(), and MagickTrue.

Referenced by CloneImage(), CoalesceImages(), and DisposeImages().

MagickExport MagickBooleanType DefineImageProperty	(	Image *	image,
		const char *	property,
		ExceptionInfo *	exception
	)

Definition at line 206 of file property.c.

References MaxTextExtent, CopyMagickString(), and SetImageProperty().

MagickExport MagickBooleanType DeleteImageProperty	(	Image *	image,
		const char *	property
	)

Definition at line 253 of file property.c.

References _Image::signature, MagickSignature, _Image::debug, MagickFalse, LogMagickEvent(), TraceEvent, GetMagickModule, _Image::filename, _Image::properties, and DeleteNodeFromSplayTree().

Referenced by ReadImage(), PreviewImage(), StripImage(), SetImageProperty(), ThumbnailImage(), and SignatureImage().

MagickExport void DestroyImageProperties

(

Image *

image

)

Definition at line 289 of file property.c.

References _Image::signature, MagickSignature, _Image::debug, MagickFalse, LogMagickEvent(), TraceEvent, GetMagickModule, _Image::filename, _Image::properties, and DestroySplayTree().

Referenced by DestroyImage(), and CloneImageProperties().

MagickExport MagickBooleanType FormatImageProperty	(	Image *	image,
		const char *	property,
		const char *	format,
			...
	)

Definition at line 330 of file property.c.

References MaxTextExtent, FormatLocaleStringList(), AcquireExceptionInfo(), SetImageProperty(), and DestroyExceptionInfo().

static MagickBooleanType Get8BIMProperty	(	const Image *	image,
		const char *	key,
		ExceptionInfo *	exception
	)		[static]

Definition at line 543 of file property.c.

References MaxTextExtent, _ProfileInfo::name, _ProfileInfo::info, _ProfileInfo::length, GetImageProfile(), MagickFalse, CopyMagickString(), StringToLong(), MagickMax(), GetStringInfoLength(), GetStringInfoDatum(), ReadPropertyByte(), ReadPropertyMSBShort(), DestroyString(), AcquireQuantumMemory(), ReadPropertyMSBLong(), LocaleCompare(), MagickMin(), CopyMagickMemory(), SetImageProperty(), TraceSVGClippath(), _Image::columns, _Image::rows, TracePSClippath(), and MagickTrue.

Referenced by GetImageProperty().

static MagickBooleanType GetEXIFProperty	(	const Image *	image,
		const char *	property,
		ExceptionInfo *	exception
	)		[static]

Definition at line 725 of file property.c.

References MaxDirectoryStack, GetImageProfile(), MagickFalse, LocaleCompare(), GetStringInfoLength(), GetStringInfoDatum(), ReadPropertyByte(), ReadPropertyShort(), LSBEndian, MSBEndian, ReadPropertyLong(), NewSplayTree(), GetValueFromSplayTree(), AddValueToSplayTree(), MaxTextExtent, EXIF_FMT_BYTE, EXIF_FMT_UNDEFINED, EXIFMultipleValues, EXIF_FMT_SBYTE, EXIF_FMT_SSHORT, EXIF_FMT_USHORT, EXIF_FMT_ULONG, EXIF_FMT_SLONG, EXIF_FMT_URATIONAL, EXIFMultipleFractions, EXIF_FMT_SRATIONAL, EXIF_FMT_SINGLE, EXIF_FMT_DOUBLE, EXIF_FMT_STRING, AcquireQuantumMemory(), CopyMagickString(), FormatLocaleString(), _Image::properties, SetImageProperty(), DestroyString(), MagickTrue, TAG_EXIF_OFFSET, TAG_INTEROP_OFFSET, TAG_GPS_OFFSET, and DestroySplayTree().

Referenced by GetImageProperty().

MagickExport const char* GetImageProperty	(	const Image *	image,
		const char *	property,
		ExceptionInfo *	exception
	)

Definition at line 1969 of file property.c.

References _Image::signature, MagickSignature, _Image::debug, MagickFalse, LogMagickEvent(), TraceEvent, GetMagickModule, _Image::filename, _Image::properties, ResetSplayTreeIterator(), GetNextValueInSplayTree(), LocaleNCompare(), GetValueFromSplayTree(), Get8BIMProperty(), GetEXIFProperty(), AcquireFxInfo(), FxEvaluateChannelExpression(), IntensityPixelChannel, DestroyFxInfo(), MaxTextExtent, FormatLocaleString(), GetMagickPrecision(), SetImageProperty(), GetIPTCProperty(), GetPixelInfo(), RedPixelChannel, _PixelInfo::red, QuantumRange, GreenPixelChannel, _PixelInfo::green, BluePixelChannel, _PixelInfo::blue, _Image::colorspace, CMYKColorspace, BlackPixelChannel, _PixelInfo::black, AlphaPixelChannel, _PixelInfo::alpha, QueryColorname(), SVGCompliance, and GetXMPProperty().

Referenced by RGBTransformImage(), TransformRGBImage(), ReadImage(), IdentifyImage(), ClipImagePath(), InterpretImageFilename(), MontageImageList(), ProfileImage(), SetImageProfile(), GetMagickProperty(), and InterpretImageProperties().

static MagickBooleanType GetIPTCProperty	(	const Image *	image,
		const char *	key,
		ExceptionInfo *	exception
	)		[static]

Definition at line 392 of file property.c.

References _ProfileInfo::length, GetImageProfile(), MagickFalse, GetStringInfoLength(), GetStringInfoDatum(), AcquireQuantumMemory(), CopyMagickString(), ConcatenateString(), DestroyString(), SetImageProperty(), and MagickTrue.

Referenced by GetImageProperty().

MagickExport const char* GetMagickProperty	(	const ImageInfo *	image_info,
		Image *	image,
		const char *	property,
		ExceptionInfo *	exception
	)

Definition at line 2174 of file property.c.

References MaxTextExtent, LocaleNCompare(), GetPathComponent(), _Image::magick_filename, BasePath, CopyMagickString(), FormatLocaleString(), CommandOptionToMnemonic(), MagickColorspaceOptions, _Image::colorspace, LocaleLower(), _Image::matte, MagickFalse, ConcatenateMagickString(), IsImageGray(), GRAYColorspace, GetMagickCopyright(), _Image::depth, HeadPath, ExtensionPath, _ImageInfo::group, _Image::magick_rows, _Image::filename, GetImageKurtosis(), GetMagickPrecision(), _Image::magick, GetImageRange(), GetImageMean(), IsImageOpaque(), _ImageInfo::filename, GetImageIndexInList(), FormatMagickSize(), GetBlobSize(), GetImageListLength(), _Image::scene, _ImageInfo::number_scenes, _ImageInfo::scene, _ImageInfo::unique, GetMagickVersion(), _Image::magick_columns, _Image::resolution, _PointInfo::x, _PointInfo::y, _ImageInfo::zero, _Image::properties, NewSplayTree(), CompareSplayTreeString(), RelinquishMagickMemory(), AddValueToSplayTree(), ConstantString(), and GetImageProperty().

Referenced by InterpretImageFilename(), and InterpretImageProperties().

MagickExport char* GetNextImageProperty

(

const Image *

image

)

Definition at line 2529 of file property.c.

References _Image::signature, MagickSignature, _Image::debug, MagickFalse, LogMagickEvent(), TraceEvent, GetMagickModule, _Image::filename, _Image::properties, and GetNextKeyInSplayTree().

Referenced by IdentifyImage(), and InterpretImageProperties().

static MagickBooleanType GetXMPProperty	(	const Image *	image,
		const char *	property
	)		[static]

Definition at line 1512 of file property.c.

References GetImageProfile(), MagickFalse, StringInfoToString(), AcquireExceptionInfo(), NewXMLTree(), DestroyString(), DestroyExceptionInfo(), GetXMLTreeChild(), _Image::properties, NewSplayTree(), CompareSplayTreeString(), RelinquishMagickMemory(), AddValueToSplayTree(), ConstantString(), GetXMLTreeTag(), GetXMLTreeContent(), LocaleCompare(), GetXMLTreeSibling(), GetNextXMLTreeTag(), and DestroyXMLTree().

Referenced by GetImageProperty().

MagickExport char* InterpretImageProperties	(	const ImageInfo *	image_info,
		Image *	image,
		const char *	embed_text,
		ExceptionInfo *	exception
	)

Definition at line 2572 of file property.c.

References MaxTextExtent, _Image::signature, MagickSignature, _Image::debug, MagickFalse, LogMagickEvent(), TraceEvent, GetMagickModule, _Image::filename, IsPathAccessible(), FileToString(), AcquireString(), ResizeQuantumMemory(), GetImageProperty(), CopyMagickString(), IsGlob(), ResetImagePropertyIterator(), GetNextImageProperty(), GlobExpression(), MagickTrue, FormatLocaleString(), GetMagickProperty(), GetImageOption(), _Image::extent, FormatMagickSize(), ConcatenateMagickString(), GetPathComponent(), _Image::magick_filename, HeadPath, ExtensionPath, TailPath, BasePath, _Image::page, _RectangleInfo::width, _RectangleInfo::height, _RectangleInfo::x, _RectangleInfo::y, _Image::rows, _Image::magick_rows, GetNumberColors(), _Image::magick, GetImageListLength(), _ImageInfo::filename, GetImageIndexInList(), MAGICKCORE_QUANTUM_DEPTH, _Image::colorspace, IsImageGray(), GRAYColorspace, CommandOptionToMnemonic(), MagickClassOptions, _Image::storage_class, MagickColorspaceOptions, _Image::matte, _ImageInfo::number_scenes, _Image::scene, _ImageInfo::scene, _ImageInfo::unique, _Image::columns, _Image::magick_columns, _Image::resolution, _PointInfo::x, MagickResolutionOptions, _Image::units, _PointInfo::y, _Image::depth, MagickBooleanOptions, MagickCompressOptions, _Image::compression, MagickDisposeOptions, _Image::dispose, _Image::quality, _Image::delay, _ImageInfo::zero, GetImageBoundingBox(), SignatureImage(), DestroyString(), and SubstituteString().

Referenced by ReadImage(), GetDelegateCommand(), InvokeDelegate(), PolaroidImage(), and MontageImageList().

static ssize_t MagickMax	(	const ssize_t	x,
		const ssize_t	y
	)		[inline, static]

Definition at line 459 of file property.c.

Referenced by Get8BIMProperty().

static ssize_t MagickMin	(	const ssize_t	x,
		const ssize_t	y
	)		[inline, static]

Definition at line 466 of file property.c.

Referenced by Get8BIMProperty(), TracePSClippath(), and TraceSVGClippath().

static int ReadPropertyByte	(	const unsigned char **	p,
		size_t *	length
	)		[inline, static]

Definition at line 473 of file property.c.

Referenced by Get8BIMProperty(), and GetEXIFProperty().

static size_t ReadPropertyLong	(	const EndianType	endian,
		const unsigned char *	buffer
	)		[inline, static]

Definition at line 708 of file property.c.

References MSBEndian.

Referenced by GetEXIFProperty().

static size_t ReadPropertyMSBLong	(	const unsigned char **	p,
		size_t *	length
	)		[inline, static]

Definition at line 485 of file property.c.

Referenced by Get8BIMProperty(), TracePSClippath(), and TraceSVGClippath().

static unsigned short ReadPropertyMSBShort	(	const unsigned char **	p,
		size_t *	length
	)		[inline, static]

Definition at line 515 of file property.c.

Referenced by Get8BIMProperty(), TracePSClippath(), and TraceSVGClippath().

static unsigned short ReadPropertyShort	(	const EndianType	endian,
		const unsigned char *	buffer
	)		[inline, static]

Definition at line 692 of file property.c.

References MSBEndian.

Referenced by GetEXIFProperty().

MagickExport char* RemoveImageProperty	(	Image *	image,
		const char *	property
	)

Definition at line 3101 of file property.c.

References _Image::signature, MagickSignature, _Image::debug, MagickFalse, LogMagickEvent(), TraceEvent, GetMagickModule, _Image::filename, _Image::properties, and RemoveNodeFromSplayTree().

MagickExport void ResetImagePropertyIterator

(

const Image *

image

)

Definition at line 3143 of file property.c.

References _Image::signature, MagickSignature, _Image::debug, MagickFalse, LogMagickEvent(), TraceEvent, GetMagickModule, _Image::filename, _Image::properties, and ResetSplayTreeIterator().

Referenced by IdentifyImage(), and InterpretImageProperties().

MagickExport MagickBooleanType SetImageProperty	(	Image *	image,
		const char *	property,
		const char *	value,
		ExceptionInfo *	exception
	)

Definition at line 3184 of file property.c.

References _Image::signature, MagickSignature, _Image::debug, MagickFalse, LogMagickEvent(), TraceEvent, GetMagickModule, _Image::filename, _Image::properties, NewSplayTree(), CompareSplayTreeString(), RelinquishMagickMemory(), DeleteImageProperty(), MagickTrue, LocaleCompare(), QueryColorCompliance(), AllCompliance, _Image::background_color, _Image::bias, StringToDoubleInterval(), QuantumRange, AddValueToSplayTree(), ConstantString(), ParseCommandOption(), MagickColorspaceOptions, SetImageColorspace(), MagickComposeOptions, _Image::compose, MagickCompressOptions, _Image::compression, ParseGeometry(), GreaterValue, _Image::delay, _GeometryInfo::rho, LessValue, _Image::ticks_per_second, _GeometryInfo::sigma, SigmaValue, _Image::resolution, _PointInfo::x, _PointInfo::y, _Image::depth, StringToUnsignedLong(), MagickDisposeOptions, _Image::dispose, MagickGravityOptions, _Image::gravity, MagickIntentOptions, _Image::rendering_intent, MagickInterpolateOptions, _Image::interpolate, _Image::iterations, GetPageGeometry(), ParseAbsoluteGeometry(), _Image::page, DestroyString(), AcquireImageInfo(), CopyMagickString(), _ImageInfo::filename, MaxTextExtent, SetImageInfo(), FileToStringInfo(), SetImageProfile(), _ImageInfo::magick, DestroyImageInfo(), _Image::tile_offset, MagickResolutionOptions, and _Image::units.

Referenced by ReadImage(), PreviewImage(), DefineImageProperty(), FormatImageProperty(), GetIPTCProperty(), Get8BIMProperty(), GetEXIFProperty(), GetImageProperty(), ThumbnailImage(), and SignatureImage().

static char* TracePSClippath	(	const unsigned char *	,
		size_t	,
		const size_t	,
		const size_t
	)		[static]

Referenced by Get8BIMProperty().

static char* TracePSClippath	(	const unsigned char *	blob,
		size_t	length,
		const size_t	magick_unusedcolumns,
		const size_t	magick_unusedrows
	)		[static]

Definition at line 1588 of file property.c.

References AcquireString(), FormatLocaleString(), MaxTextExtent, ConcatenateString(), ResetMagickMemory(), MagickFalse, ReadPropertyMSBShort(), MagickMin(), ReadPropertyMSBLong(), _PointInfo::x, _PointInfo::y, MagickTrue, and DestroyString().

static char * TraceSVGClippath	(	const unsigned char *	blob,
		size_t	length,
		const size_t	columns,
		const size_t	rows
	)

Definition at line 1796 of file property.c.

References AcquireString(), FormatLocaleString(), MaxTextExtent, ConcatenateString(), ResetMagickMemory(), MagickFalse, ReadPropertyMSBShort(), MagickMin(), ReadPropertyMSBLong(), _PointInfo::x, _PointInfo::y, MagickTrue, and DestroyString().

Referenced by Get8BIMProperty().