property.c File Reference

#include "magick/studio.h"
#include "magick/attribute.h"
#include "magick/cache.h"
#include "magick/color.h"
#include "magick/compare.h"
#include "magick/constitute.h"
#include "magick/draw.h"
#include "magick/effect.h"
#include "magick/exception.h"
#include "magick/exception-private.h"
#include "magick/fx.h"
#include "magick/fx-private.h"
#include "magick/gem.h"
#include "magick/geometry.h"
#include "magick/histogram.h"
#include "magick/image.h"
#include "magick/layer.h"
#include "magick/list.h"
#include "magick/memory_.h"
#include "magick/monitor.h"
#include "magick/montage.h"
#include "magick/option.h"
#include "magick/profile.h"
#include "magick/property.h"
#include "magick/quantum.h"
#include "magick/resource_.h"
#include "magick/splay-tree.h"
#include "magick/signature-private.h"
#include "magick/statistic.h"
#include "magick/string_.h"
#include "magick/token.h"
#include "magick/utility.h"
#include "magick/xml-tree.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)
MagickExport MagickBooleanType	DeleteImageProperty (Image *image, const char *property)
MagickExport void	DestroyImageProperties (Image *image)
MagickExport MagickBooleanType	FormatImagePropertyList (Image *image, const char *property, const char *format, va_list operands)
MagickExport MagickBooleanType	FormatImageProperty (Image *image, const char *property, const char *format,...)
static char *	TracePSClippath (const unsigned char *, size_t, const unsigned long, const unsigned long)
static char **	TraceSVGClippath (const unsigned char *, size_t, const unsigned long, const unsigned long)
static MagickBooleanType	GetIPTCProperty (const Image *image, const char *key)
static long	MagickMax (const long x, const long y)
static int	ReadPropertyByte (const unsigned char **p, size_t *length)
static unsigned long	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)
static unsigned short	ReadPropertyShort (const EndianType endian, const unsigned char *buffer)
static unsigned long	ReadPropertyLong (const EndianType endian, const unsigned char *buffer)
static MagickBooleanType	GetEXIFProperty (const Image *image, const char *property)
static MagickBooleanType	GetXMPProperty (const Image *image, const char *property)
static char *	TracePSClippath (const unsigned char *blob, size_t length, const unsigned long magick_unused(columns), const unsigned long magick_unused(rows))
MagickExport const char *	GetImageProperty (const Image *image, const char *property)
MagickExport const char *	GetMagickProperty (const ImageInfo *image_info, Image *image, const char *property)
MagickExport char *	GetNextImageProperty (const Image *image)
MagickExport char *	InterpretImageProperties (const ImageInfo *image_info, Image *image, const char *embed_text)
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)

---

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:

{ \
   long \
     component; \
 \
   size_t \
     length; \
 \
   unsigned char \
     *p1; \
 \
   length=0; \
   p1=p; \
   for (component=0; component < components; component++) \
   { \
     length+=FormatMagickString(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:

{ \
   long \
     component; \
 \
   size_t \
     length; \
 \
   unsigned char \
     *p1; \
 \
   length=0; \
   p1=p; \
   for (component=0; component < components; component++) \
   { \
     length+=FormatMagickString(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 103 of file property.c.

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

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

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

Definition at line 197 of file property.c.

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

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

Definition at line 244 of file property.c.

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

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

MagickExport void DestroyImageProperties

(

Image *

image

)

Definition at line 280 of file property.c.

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

Referenced by CloneImageProperties(), and DestroyImage().

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

Definition at line 341 of file property.c.

References FormatImagePropertyList().

MagickExport MagickBooleanType FormatImagePropertyList	(	Image *	image,
		const char *	property,
		const char *	format,
		va_list	operands
	)

Definition at line 322 of file property.c.

References MaxTextExtent, SetImageProperty(), and vsnprintf.

Referenced by FormatImageAttribute(), and FormatImageProperty().

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

Definition at line 529 of file property.c.

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

Referenced by GetImageProperty().

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

Definition at line 709 of file property.c.

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

Referenced by GetImageProperty().

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

Definition at line 1944 of file property.c.

References AcquireFxInfo(), BlackChannel, _MagickPixelPacket::blue, BlueChannel, CMYKColorspace, _Image::colorspace, _Image::debug, DestroyFxInfo(), _Image::filename, FormatMagickString(), FxEvaluateChannelExpression(), FxEvaluateExpression(), Get8BIMProperty(), GetEXIFProperty(), GetIPTCProperty(), GetMagickModule, GetMagickPixelPacket(), GetNextValueInSplayTree(), GetValueFromSplayTree(), GetXMPProperty(), _MagickPixelPacket::green, GreenChannel, _MagickPixelPacket::index, LocaleNCompare(), LogMagickEvent(), MagickFalse, MagickSignature, MaxTextExtent, _MagickPixelPacket::opacity, OpacityChannel, _Image::properties, QuantumRange, QueryMagickColorname(), _MagickPixelPacket::red, RedChannel, ResetSplayTreeIterator(), SetImageProperty(), _Image::signature, SVGCompliance, and TraceEvent.

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

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

Definition at line 387 of file property.c.

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

Referenced by GetImageProperty().

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

Definition at line 2138 of file property.c.

References AddValueToSplayTree(), BasePath, _ImageInfo::channel, _Image::colorspace, CompareSplayTreeString(), ConcatenateMagickString(), ConstantString(), CopyMagickString(), _Image::depth, _Image::exception, ExtensionPath, _ImageInfo::filename, _Image::filename, FormatMagickSize(), FormatMagickString(), GetBlobSize(), GetImageChannelKurtosis(), GetImageChannelMean(), GetImageChannelRange(), GetImageListLength(), GetImageProperty(), GetPathComponent(), GetPreviousImageInList(), GRAYColorspace, _ImageInfo::group, HeadPath, IsGrayImage(), LocaleLower(), LocaleNCompare(), _Image::magick, _Image::magick_columns, _Image::magick_filename, _Image::magick_rows, MagickColorspaceOptions, MagickFalse, MagickOptionToMnemonic(), _Image::matte, MaxTextExtent, NewSplayTree(), _ImageInfo::number_scenes, _Image::properties, RelinquishMagickMemory(), _ImageInfo::scene, _Image::scene, _ImageInfo::unique, _Image::x_resolution, _Image::y_resolution, and _ImageInfo::zero.

Referenced by InterpretImageFilename(), and InterpretImageProperties().

MagickExport char* GetNextImageProperty

(

const Image *

image

)

Definition at line 2472 of file property.c.

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

Referenced by GetNextImageAttribute(), IdentifyImage(), and InterpretImageProperties().

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

Definition at line 1485 of file property.c.

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

Referenced by GetImageProperty().

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

Definition at line 2513 of file property.c.

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

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

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

Definition at line 452 of file property.c.

Referenced by Get8BIMProperty().

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

Definition at line 459 of file property.c.

Referenced by Get8BIMProperty(), and GetEXIFProperty().

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

Definition at line 692 of file property.c.

References MSBEndian.

Referenced by GetEXIFProperty().

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

Definition at line 471 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 501 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 676 of file property.c.

References MSBEndian.

Referenced by GetEXIFProperty().

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

Definition at line 3158 of file property.c.

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

MagickExport void ResetImagePropertyIterator

(

const Image *

image

)

Definition at line 3200 of file property.c.

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

Referenced by IdentifyImage(), InterpretImageProperties(), and ResetImageAttributeIterator().

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

Definition at line 3239 of file property.c.

References AddValueToSplayTree(), _Image::bias, CompareSplayTreeString(), _Image::compose, _Image::compression, ConstantString(), _Image::debug, _Image::delay, DeleteImageProperty(), _Image::depth, DestroyString(), _Image::dispose, _Image::filename, GetMagickModule, GetPageGeometry(), _Image::gravity, GreaterValue, _Image::interpolate, _Image::iterations, LessValue, LocaleCompare(), LogMagickEvent(), MagickColorspaceOptions, MagickComposeOptions, MagickCompressOptions, MagickDisposeOptions, MagickFalse, MagickGravityOptions, MagickIntentOptions, MagickInterpolateOptions, MagickSignature, MagickTrue, NewSplayTree(), _Image::page, ParseAbsoluteGeometry(), ParseGeometry(), ParseMagickOption(), _Image::properties, QuantumRange, RelinquishMagickMemory(), _Image::rendering_intent, _GeometryInfo::rho, SetImageColorspace(), _GeometryInfo::sigma, SigmaValue, _Image::signature, StringToDouble(), _Image::ticks_per_second, _Image::tile_offset, and TraceEvent.

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

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

Definition at line 1562 of file property.c.

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

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

Referenced by Get8BIMProperty().

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

Definition at line 1771 of file property.c.

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

Referenced by Get8BIMProperty().