Module annotate Methods
AnnotateImage
AnnotateImage() annotates an image with text. Optionally you can include any of the following bits of information about the image by embedding the appropriate special characters:
b file size in bytes.
c comment.
d directory in which the image resides.
e extension of the image file.
f original filename of the image.
h height of image.
i filename of the image.
k number of unique colors.
l image label.
m image file format.
n number of images in a image sequence.
o output image filename.
p page number of the image.
q image depth (8 or 16).
q image depth (8 or 16).
s image scene number.
t image filename without any extension.
u a unique temporary filename.
w image width.
x x resolution of the image.
y y resolution of the image.
The format of the AnnotateImage method is:
MagickBooleanType AnnotateImage(Image *image,DrawInfo *draw_info)
A description of each parameter follows:
image
the image.
draw_info
the draw info.
FormatMagickCaption
FormatMagickCaption() formats a caption so that it fits within the image width. It returns the number of lines in the formatted caption.
The format of the FormatMagickCaption method is:
ssize_t FormatMagickCaption(Image *image,DrawInfo *draw_info,
const MagickBooleanType split,TypeMetric *metrics,char **caption)
A description of each parameter follows.
image
The image.
draw_info
the draw info.
split
when no convenient line breaks-- insert newline.
metrics
Return the font metrics in this structure.
caption
the caption.
GetMultilineTypeMetrics
GetMultilineTypeMetrics() returns the following information for the specified font and text:
character width
character height
ascender
descender
text width
text height
maximum horizontal advance
bounds: x1
bounds: y1
bounds: x2
bounds: y2
origin: x
origin: y
underline position
underline thickness
This method is like GetTypeMetrics() but it returns the maximum text width and height for multiple lines of text.
The format of the GetMultilineTypeMetrics method is:
MagickBooleanType GetMultilineTypeMetrics(Image *image,
const DrawInfo *draw_info,TypeMetric *metrics)
A description of each parameter follows:
image
the image.
draw_info
the draw info.
metrics
Return the font metrics in this structure.
GetTypeMetrics
GetTypeMetrics() returns the following information for the specified font and text:
character width
character height
ascender
descender
text width
text height
maximum horizontal advance
bounds: x1
bounds: y1
bounds: x2
bounds: y2
origin: x
origin: y
underline position
underline thickness
The format of the GetTypeMetrics method is:
MagickBooleanType GetTypeMetrics(Image *image,const DrawInfo *draw_info,
TypeMetric *metrics)
A description of each parameter follows:
image
the image.
draw_info
the draw info.
metrics
Return the font metrics in this structure.
![[ImageMagick]](../../images/script.png)
![[sponsor]](../../images/networkredux.png)
