# 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.
affirm | unsigned int | ???
antialias | unsigned int | Control antialiasing of rendered Postscript and Postscript or TrueType fonts. Enabled by default.
background_color | char * | Image background color.
blob | BlobInfo | Private member. Use by BlobToImage() and ImageToBlob().
border_color | char * | Image border color.
box | char * | Base color that annotation text is rendered on.
coalesce_frames | unsigned int | ???
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.
decode_all_MNG_objects | unsigned int | ???
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.
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.
group | long | ???
insert_backdrops | unsigned int | ???
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 | char * | Image matte (transparent) color.
monochrome | unsigned int | Transform the image to black and white.
page | char * | Equivalent size of Postscript page.
pen | char * | Pen color to use when annotating on or drawing on image.
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 | unsigned int | 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 | 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.
subimage | unsigned int | Subimage of an image sequence.
subrange | unsigned int | Number of images relative to the base image.
temporary | unsigned int | ???
texture | char * | Image filename to use as background texture.
tile | char * | Tile name.
unique | char[MaxTextExtent] | ???
units | ResolutionType | Units of image resolution.
verbose | unsigned int | Print detailed information about the image.
view | char * | FlashPix viewing parameters.
zero | char[MaxTextExtent] | ???