<?xml version="1.0" encoding="utf-8" ?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <meta name="generator" content="Docutils 0.5: http://docutils.sourceforge.net/" /> <title>annotate</title> <link rel="stylesheet" href="../docutils-api.css" type="text/css" /> </head> <body> <div class="banner"> <span> <img src="../images/gm-107x76.png" alt="GraphicMagick logo" width="107" height="76" /> <span class="title">GraphicsMagick</span> <form action="http://www.google.com/search"> Search site <input type=hidden name="domains" value="www.graphicsmagick.org" /> <input type=hidden name="sitesearch" value="www.graphicsmagick.org" /> <input type=text name="q" size="25" maxlength="255" /> <input type=submit name="sa" value="Search" /> </form> </span> </div> <div class="navmenu"> <ul> <li><a href="../index.html">Home</a></li> <li><a href="../Copyright.html">License</a></li> <li><a href="../mission.html">Mission</a></li> <li><a href="../download.html">Download</a></li> <li><a href="../README.html">Installation</a></li> <li><a href="../FAQ.html">FAQ</a></li> <li><a href="../NEWS.html">News</a> </li> <li><a href="../formats.html">Formats</a></li> </ul> </div> <div class="navmenu"> <ul> <li><a href="../process.html">Process</a></li> <li><a href="../contribute.html">Contribute</a></li> <li><a href="../CVS.html">CVS</a></li> <li><a href="http://sourceforge.net/mail/?group_id=73485" target="top_">Mailing Lists</a></li> <li><a href="../Changelog.html">ChangeLog</a></li> <li><a href="http://sourceforge.net/projects/graphicsmagick/" target="top_">Report Bugs</a></li> <li><a href="../utilities.html">Utilities</a></li> <li><a href="../programming.html">Programming</a></li> <li><a href="../links.html">Links</a></li> </ul> </div> <div class="document" id="annotate"> <h1 class="title">annotate</h1> <h2 class="subtitle" id="annotate-an-image-with-text">Annotate an image with text</h2> <div class="contents topic" id="contents"> <p class="topic-title first">Contents</p> <ul class="simple"> <li><a class="reference internal" href="#annotateimage" id="id3">AnnotateImage</a></li> <li><a class="reference internal" href="#gettypemetrics" id="id4">GetTypeMetrics</a></li> </ul> </div> <div class="section" id="annotateimage"> <h1><a class="toc-backref" href="#id3">AnnotateImage</a></h1> <div class="section" id="synopsis"> <h2>Synopsis</h2> <pre class="literal-block"> unsigned int AnnotateImage( <a class="reference external" href="../api/types.html#image">Image</a> *image, <a class="reference external" href="../api/types.html#drawinfo">DrawInfo</a> *draw_info ); </pre> </div> <div class="section" id="description"> <h2>Description</h2> <p>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:</p> <p>%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). %p page number of the image. %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.</p> <p>The format of the AnnotateImage method is:</p> <pre class="literal-block"> unsigned int AnnotateImage( <a class="reference external" href="../api/types.html#image">Image</a> *image, <a class="reference external" href="../api/types.html#drawinfo">DrawInfo</a> *draw_info ); </pre> <p>A description of each parameter follows:</p> <dl class="docutils"> <dt>status:</dt> <dd>Method AnnotateImage returns True if the image is annotated otherwise False.</dd> <dt>image:</dt> <dd>The image.</dd> <dt>draw_info:</dt> <dd>The draw info.</dd> </dl> </div> </div> <div class="section" id="gettypemetrics"> <h1><a class="toc-backref" href="#id4">GetTypeMetrics</a></h1> <div class="section" id="id1"> <h2>Synopsis</h2> <pre class="literal-block"> unsigned int GetTypeMetrics( <a class="reference external" href="../api/types.html#image">Image</a> *image, const <a class="reference external" href="../api/types.html#drawinfo">DrawInfo</a> *draw_info, <a class="reference external" href="../api/types.html#typemetric">TypeMetric</a> *metrics ); </pre> </div> <div class="section" id="id2"> <h2>Description</h2> <p>GetTypeMetrics() returns the following information for the specified font and text:</p> <p>o character width o character height o ascent o descent o text width o text height o maximum horizontal advance o underline position o underline thickness</p> <p>The format of the GetTypeMetrics method is:</p> <pre class="literal-block"> unsigned int GetTypeMetrics( <a class="reference external" href="../api/types.html#image">Image</a> *image, const <a class="reference external" href="../api/types.html#drawinfo">DrawInfo</a> *draw_info, <a class="reference external" href="../api/types.html#typemetric">TypeMetric</a> *metrics ); </pre> <dl class="docutils"> <dt>image:</dt> <dd>The image.</dd> <dt>draw_info:</dt> <dd>The draw info.</dd> <dt>metrics:</dt> <dd>Return the font metrics in this structure.</dd> </dl> </div> </div> </div> <div class="footer"> <hr class="footer" /> Generated on: 2010-01-20 23:38 UTC. </div> </body> </html>