ImageMagick ImageInfo Structure

The ImageInfo structure is used to supply option information to the functions AllocateImage(), AnimateImages(), BlobToImage(), CloneAnnotateInfo(), DisplayImages(), GetAnnotateInfo(), ImageToBlob(), PingImage(), ReadImage(), ReadImages(), and,
WriteImage(). These functions update information in ImageInfo to reflect attributes of the current image.

Use CloneImageInfo() to duplicate an existing ImageInfo structure or allocate a new one.
Use DestroyImageInfo() to deallocate memory associated with an ImageInfo structure.
Use GetImageInfo() to initialize an existing ImageInfo structure.
Use SetImageInfo() to set image type information in the ImageInfo structure based on an existing image.

The members of the ImageInfo structure are shown in the following table:

ImageInfo Structure Members
Member Type Description

adjoin unsigned int Join images into a single multi-image file.

antialias unsigned int Control antialiasing of rendered Postscript and Postscript or TrueType fonts. Enabled by default.

background_color PixelPacket Image background color.

border_color PixelPacket Image border color.

colorspace ColorspaceType Image pixel interpretation.If the colorspace is RGB the pixels are red, green, blue. If matte is true, then red, green, blue, and index. If it is CMYK, the pixels are cyan, yellow, magenta, black. Otherwise the colorspace is ignored.

compression CompressionType Image compresion type. The default is the compression type of the specified image file.

delay char * Time in 1/100ths of a second (0 to 65535) which must expire before displaying the next image in an animated sequence. This option is useful for regulating the animation of a sequence of GIF images within Netscape.

density char * Vertical and horizontal resolution in pixels of the image. This option specifies an image density when decoding a Postscript or Portable Document page. Often used with page.

depth unsigned int Image depth (8 or 16). QuantumLeap must be defined before a depth of 16 is valid.

dispose char * GIF disposal method. This option is used to control how successive frames are rendered (how the preceding frame is disposed of) when creating a GIF animation.

dither unsigned int Apply Floyd/Steinberg error diffusion to the image. The basic strategy of dithering is to trade intensity resolution for spatial resolution by averaging the intensities of several neighboring pixels. Images which suffer from severe contouring when reducing colors can be improved with this option. The colors or monochrome option must be set for this option to take effect.

file FILE * Stdio stream to read image from or write image to. If set, ImageMagick will read from or write to the stream rather than opening a file. Used by ReadImage() and WriteImage(). The stream is closed when the operation completes.

filename char[MaxTextExtent] Image file name to read or write.

fill PixelPacket Drawing object fill color.

font char * Text rendering font. If the font is a fully qualified X server font name, the font is obtained from an X server. To use a TrueType font, precede the TrueType filename with an @. Otherwise, specify a Postscript font name (e.g. "helvetica").

fuzz int Colors within this distance are considered equal. A number of algorithms search for a target color. By default the color must be exact. Use this option to match colors that are close to the target color in RGB space.

interlace InterlaceType The type of interlacing scheme (default NoInterlace). This option is used to specify the type of interlacing scheme for raw image formats such as RGB or YUV. NoInterlace means do not interlace, LineInterlace uses scanline interlacing, and PlaneInterlace uses plane interlacing. PartitionInterlace is like PlaneInterlace except the different planes are saved to individual files (e.g. image.R, image.G, and image.B). Use LineInterlace or PlaneInterlace to create an interlaced GIF or progressive JPEG image.

iterations char * Number of iterations to loop an animation (e.g. Netscape loop extension) for.

linewidth unsigned int Line width for drawing lines, circles, ellipses, etc.

magick char[MaxTextExtent] Image encoding format (e.g. "GIF").

matte_color PixelPacket Image matte (transparent) color.

monochrome unsigned int Transform the image to black and white.

page char * Equivalent size of Postscript page.

ping unsigned int Set to True to read enough of the image to determine the image columns, rows, and filesize. The columns, rows, and size attributes are valid after invoking ReadImage() while ping is set. The image data is not valid after calling ReadImage() if ping is set.

pointsize double Text rendering font point size.

preview_type PreviewType Image manipulation preview option. Used by 'display'.

quality unsigned int JPEG/MIFF/PNG compression level (default 75).

server_name char * X11 display to display to obtain fonts from, or to capture image from.

size char * Width and height of a raw image (an image which does not support width and height information). Size may also be used to affect the image size read from a multi-resolution format (e.g. Photo CD, JBIG, or JPEG.

stroke PixelPacket Drawing object outline color.

subimage unsigned int Subimage of an image sequence.

subrange unsigned int Number of images relative to the base image.

texture char * Image filename to use as background texture.

tile char * Tile name.

units ResolutionType Units of image resolution.

verbose unsigned int Print detailed information about the image if True.

view char * FlashPix viewing parameters.

**ImageInfo Structure Members**
Member	Type	Description
adjoin	unsigned int	Join images into a single multi-image file.
antialias	unsigned int	Control antialiasing of rendered Postscript and Postscript or TrueType fonts. Enabled by default.
background_color	PixelPacket	Image background color.
border_color	PixelPacket	Image border color.
colorspace	ColorspaceType	Image pixel interpretation.If the colorspace is RGB the pixels are red, green, blue. If matte is true, then red, green, blue, and index. If it is CMYK, the pixels are cyan, yellow, magenta, black. Otherwise the colorspace is ignored.
compression	CompressionType	Image compresion type. The default is the compression type of the specified image file.
delay	char *	Time in 1/100ths of a second (0 to 65535) which must expire before displaying the next image in an animated sequence. This option is useful for regulating the animation of a sequence of GIF images within Netscape.
density	char *	Vertical and horizontal resolution in pixels of the image. This option specifies an image density when decoding a Postscript or Portable Document page. Often used with page.
depth	unsigned int	Image depth (8 or 16). QuantumLeap must be defined before a depth of 16 is valid.
dispose	char *	GIF disposal method. This option is used to control how successive frames are rendered (how the preceding frame is disposed of) when creating a GIF animation.
dither	unsigned int	Apply Floyd/Steinberg error diffusion to the image. The basic strategy of dithering is to trade intensity resolution for spatial resolution by averaging the intensities of several neighboring pixels. Images which suffer from severe contouring when reducing colors can be improved with this option. The colors or monochrome option must be set for this option to take effect.
file	FILE *	Stdio stream to read image from or write image to. If set, ImageMagick will read from or write to the stream rather than opening a file. Used by ReadImage() and WriteImage(). The stream is closed when the operation completes.
filename	char[MaxTextExtent]	Image file name to read or write.
fill	PixelPacket	Drawing object fill color.
font	char *	Text rendering font. If the font is a fully qualified X server font name, the font is obtained from an X server. To use a TrueType font, precede the TrueType filename with an @. Otherwise, specify a Postscript font name (e.g. "helvetica").
fuzz	int	Colors within this distance are considered equal. A number of algorithms search for a target color. By default the color must be exact. Use this option to match colors that are close to the target color in RGB space.
interlace	InterlaceType	The type of interlacing scheme (default NoInterlace). This option is used to specify the type of interlacing scheme for raw image formats such as RGB or YUV. NoInterlace means do not interlace, LineInterlace uses scanline interlacing, and PlaneInterlace uses plane interlacing. PartitionInterlace is like PlaneInterlace except the different planes are saved to individual files (e.g. image.R, image.G, and image.B). Use LineInterlace or PlaneInterlace to create an interlaced GIF or progressive JPEG image.
iterations	char *	Number of iterations to loop an animation (e.g. Netscape loop extension) for.
linewidth	unsigned int	Line width for drawing lines, circles, ellipses, etc.
magick	char[MaxTextExtent]	Image encoding format (e.g. "GIF").
matte_color	PixelPacket	Image matte (transparent) color.
monochrome	unsigned int	Transform the image to black and white.
page	char *	Equivalent size of Postscript page.
ping	unsigned int	Set to True to read enough of the image to determine the image columns, rows, and filesize. The columns, rows, and size attributes are valid after invoking ReadImage() while ping is set. The image data is not valid after calling ReadImage() if ping is set.
pointsize	double	Text rendering font point size.
preview_type	PreviewType	Image manipulation preview option. Used by 'display'.
quality	unsigned int	JPEG/MIFF/PNG compression level (default 75).
server_name	char *	X11 display to display to obtain fonts from, or to capture image from.
size	char *	Width and height of a raw image (an image which does not support width and height information). Size may also be used to affect the image size read from a multi-resolution format (e.g. Photo CD, JBIG, or JPEG.
stroke	PixelPacket	Drawing object outline color.
subimage	unsigned int	Subimage of an image sequence.
subrange	unsigned int	Number of images relative to the base image.
texture	char *	Image filename to use as background texture.
tile	char *	Tile name.
units	ResolutionType	Units of image resolution.
verbose	unsigned int	Print detailed information about the image if True.
view	char *	FlashPix viewing parameters.

Image manipulation software that works like magic.