1<?xml version="1.0" encoding="utf-8" ?> 2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 3<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> 4<head> 5<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> 6<title>Magick++ API: Annotating an Image</title> 7<link rel="stylesheet" href="magick.css" type="text/css" /> 8</head> 9<body> 10<div class="doc-section"> 11<h1 align="center">Special Format Characters</h1> 12<p style="margin-bottom: 0cm">The Magick::Image methods <a href="Image++.html#annotate"><i>annotate</i></a>, <a href="Image++.html#draw"><i>draw</i></a>, <a href="Image++.html#label"><i>label</i></a>, and the template function <i>montageImages</i> support special format characters contained in the argument text. These format characters work similar to C's <i>printf</i>. Whenever a format character appears in the text, it is replaced with the equivalent attribute text. The available format characters are shown in the following table.</p> 13<br /> 14<p align="center" style="margin-bottom: 0cm"><b>Format Characters</b></p> 15<center> 16<table width="50%" border="1" cellpadding="2" cellspacing="3"> 17<col width="131*" /> 18<col width="125*" /> 19<tr> 20<td width="51%"> 21<p align="center"><b>Format Character</b></p></td> 22<td width="49%"> 23<p align="center"><b>Description</b></p></td></tr> 24<tr> 25<td width="51%"> 26<p align="center">%b</p></td> 27<td width="49%"> 28<p>file size</p></td></tr> 29<tr> 30<td width="51%"> 31<p align="center">%d</p></td> 32<td width="49%"> 33<p>directory</p></td></tr> 34<tr> 35<td width="51%"> 36<p align="center">%e</p></td> 37<td width="49%"> 38<p>filename extension</p></td></tr> 39<tr> 40<td width="51%"> 41<p align="center">%f</p></td> 42<td width="49%"> 43<p>filename</p></td></tr> 44<tr> 45<td width="51%"> 46<p align="center">%h</p></td> 47<td width="49%"> 48<p>height</p></td></tr> 49<tr> 50<td width="51%"> 51<p align="center">%m</p></td> 52<td width="49%"> 53<p>magick (e.g GIF)</p></td></tr> 54<tr> 55<td width="51%"> 56<p align="center">%p</p></td> 57<td width="49%"> 58<p>page number</p></td></tr> 59<tr> 60<td width="51%"> 61<p align="center">%s</p></td> 62<td width="49%"> 63<p>scene number</p></td></tr> 64<tr> 65<td width="51%"> 66<p align="center">%t</p></td> 67<td width="49%"> 68<p>top of filename</p></td></tr> 69<tr> 70<td width="51%"> 71<p align="center">%w</p></td> 72<td width="49%"> 73<p>width</p></td></tr> 74<tr> 75<td width="51%"> 76<p align="center">%x</p></td> 77<td width="49%"> 78<p>x resolution</p></td></tr> 79<tr> 80<td width="51%"> 81<p align="center">%y</p></td> 82<td width="49%"> 83<p>y resolution</p></td></tr> 84<tr> 85<td width="51%"> 86<p align="center">\n</p></td> 87<td width="49%"> 88<p>newline</p></td></tr> 89<tr> 90<td width="51%"> 91<p align="center">\r</p></td> 92<td width="49%"> 93<p>carriage return</p></td></tr></table></center> 94</div> 95</body> 96</html> 97