# ImageMagick AnnotateInfo Structure

The AnnotateInfo structure is used to support annotating an image with text.

Methods Using AnnotateInfo
Method | Description
GetAnnotateInfo() | Allocate new structure with defaults set.
CloneAnnotateInfo() | Copy existing structure, allocating new structure.
DestroyAnnotateInfo() | Deallocate structure, including any members.
AnnotateImage() | Annotate image with text.
DrawImage() | Draw on image with text using texture.

Since the AnnotateInfo structure can be difficult to understand by itself, it is described in the context of the two methods which use it as shown in the following tables:

AnnotateInfo Structure Members Supporting AnnotateImage()
Member | Type | Description
degrees | double | Text rotation in degrees.
geometry | char * | Text placement coordinate (e.g. "340x230")
gravity | unsigned int | Text placement preference (e.g. NorthWestGravity).
text | char * | Text to draw. Optionally the annotation can include the image filename, type, width, height, or scene number by embedding special format characters.

AnnotateInfo Structure Members Supporting DrawImage()
Member | Type | Description
primitive | char * | Text drawing primitive (e.g "text 100,100 Cockatoo").
tile | Image * | Image texture to draw with. Use an image containing a single color (e.g. a 1x1 image) to draw in a solid color.

Image manipulation software that works like magic.