>K [ 1 R 1 ImageMagick ImageInfo Structurep


-ImageMagick ImageInfo Structure

MThe ImageInfo structure is used to supply option information to the functions:AllocateImage(),:AnimateImages(),5BlobToImage(),ECloneAnnotateInfo(),:DisplayImages(),AGetAnnotateInfo(),5ImageToBlob(),2PingImage(),2ReadImage(),9ReadImages(), and,N
WriteImage().  These functionsKupdate information in ImageInfo to reflect attributes of the current image.O

Use CloneImageInfo() to duplicate6an existing ImageInfo structure or allocate a new one.G
Use DestroyImageInfo()<to deallocate memory associated with an ImageInfo structure.M
Use GetImageInfo() to initialize an existing ImageInfo structure.F
Use SetImageInfo() to setFimage type information in the ImageInfo structure based on an existingimage.K

The members of the ImageInfo structure are shown in the following table:
 55+*I+*! .*H5$5)&U1$1($M4*!/[I0]G;*!*$F,$L**K,$I+*I)$G-1?)$G)!L*"!5*!.YG/$J.*S+1A0$>/*E)$A($V)*F.*=1)S,*K07J)$F-*<-*J.*!,$J)$(+1!*[8,*I)$: 01!
ImageInfo Structure Members

Member


Type

#
Description

adjoinunsigned intJoin images into a single multi-image file.
affirmunsigned int???
antialiasunsigned intControl antialiasing of rendered Postscript and=Postscript or TrueType fonts. Enabled by default.
background_colorchar *Image background color.
blobBlobInfoPrivate member. Use by BlobToImage() and ImageToBlob().
border_colorchar *Image border color.
boxchar *Base color that annotation text is rendered on.
coalesce_framesunsigned int???
colorspaceColorspaceTypeImage pixel interpretation.If the colorspace is RGB theIpixels are red, green, blue. If matte is true, then red, green, blue, andLindex. If it is CMYK, the pixels are cyan, yellow, magenta, black. Otherwise&the colorspace is ignored.
compressionCompressionTypeImage compresion type. The default is the compression-type of the specified image file.
decode_all_MNG_objectsunsigned int???
delaychar *Time in 1/100ths of a second (0 to 65535) which mustLexpire before displaying the next image in an animated sequence. This optionIis useful for regulating the animation of a sequence of GIF images withinNetscape.
densitychar *Vertical and horizontal resolution in pixels of the image.MThis option specifies an image density when decoding a Postscript or PortableNDocument page. Often used with page.
depthunsigned intImage depth (8 or 16). QuantumLeap must be defined before#a depth of 16 is valid.
disposechar *GIF disposal method. This option is used to control howGsuccessive frames are rendered (how the preceding frame is disposed of)*when creating a GIF animation.
ditherunsigned intApply Floyd/Steinberg error diffusion to the image. TheHbasic strategy of dithering is to trade intensity resolution for spatialFresolution by averaging the intensities of several neighboring pixels.FImages which suffer from severe contouring when reducing colors can beFimproved with this option. The colors or monochrome option must be set+for this option to take effect.
fileFILE *Stdio stream to read image from or write image to. IfJset, ImageMagick will read from or write to the stream rather than openingGa file. Used by ReadImage() and WriteImage(). The stream is closed when$the operation completes.
filenamechar[MaxTextExtent]Image file name to read or write.
fontchar *Text rendering font. If the font is a fully qualifiedLX server font name, the font is obtained from an X server. To use a TrueTypeNfont, precede the TrueType filename with an @. Otherwise, specify a Postscript)font name (e.g. "helvetica").
fuzzintColors within this distance are considered equal. A numberLof algorithms search for a target color. By default the color must be exact.IUse this option to match colors that are close to the target color in RGBspace.
grouplong???
insert_backdropsunsigned int???
interlaceInterlaceTypeThe type of interlacing scheme (default NoInterlace).KThis option is used to specify the type of interlacing scheme for raw imageMformats such as RGB or YUV. NoInterlace means do not interlace, LineInterlaceXuses scanline interlacing, and PlaneInterlace uses plane interlacing. PartitionInterlaceJis like PlaneInterlace except the different planes are saved to individualOfiles (e.g. image.R, image.G, and image.B). Use LineInterlace or PlaneInterlaceBto create an interlaced GIF or progressive JPEG image.
iterationschar *Number of iterations to loop an animation (e.g. Netscape loop extension) for.
linewidthunsigned intLine width for drawing lines, circles, ellipses, etc.
magickchar[MaxTextExtent]Image encoding format (e.g. "GIF").
matte_colorchar *Image matte (transparent) color.
monochromeunsigned intTransform the image to black and white.
pagechar *Equivalent size of Postscript page.
penchar *Pen color to use when annotating on or drawing on image.
pingunsigned intSet to True to read enough of the image to determineMthe image columns, rows, and filesize. The columns, rows, and size attributesFare valid after invoking ReadImage() while ping is set. The image dataBis not valid after calling ReadImage() if ping is set.
pointsizeunsigned intText rendering font point size.
preview_typePreviewTypeImage manipulation preview option. Used by 'display'.
qualityunsigned intJPEG/MIFF/PNG compression level (default 75).
server_nameX11 display to display toobtain fonts from, or to capture image from.
sizechar *Width and height of a raw image (an image which doesJnot support width and height information). Size may also be used to affectHthe image size read from a multi-resolution format (e.g. Photo CD, JBIG,or JPEG.
subimageunsigned intSubimage of an image sequence.
subrangeunsigned intNumber of images relative to the base image.
temporaryunsigned int???
texturechar *Image filename to use as background texture.
tilechar *Tile name.
uniquechar[MaxTextExtent]???
unitsResolutionTypeUnits of image resolution.
verboseunsigned intPrint detailed information about the image.
viewchar *FlashPix viewing parameters.
zerochar[MaxTextExtent]???



J

Home Page@ Image manipulation software that works like magic.