summaryrefslogtreecommitdiff
path: root/www/Magick++/FormatCharacters.rst
blob: aa1a0965fad45a56a8574aa7f6f10da67a41e1a5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
.. -*- mode: rst -*-
.. This text is in reStucturedText format, so it may look a bit odd.
.. See http://docutils.sourceforge.net/rst.html for details.

=========================
Special Format Characters
=========================

The Magick::Image methods `annotate <Image.html#annotate>`_, `draw
<Image.html#draw>`_, `label <Image.html#label>`_, and the template
function `montageImages <STL.html#montageImages>`_ support special
format characters contained in the argument text. These format
characters work similar to C's printf. 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:

.. table:: Format Characters

   ================  ===========================
   Format Character  Description
   ================  ===========================
   %b                file size
   %d                directory
   %e                filename extension
   %f                filename
   %h                height
   %m                magick (e.g GIF)
   %p                page number
   %s                scene number
   %t                top of filename
   %w                width
   %x                x resolution
   %y                y resolution
   \n                newline
   \r                carriage return
   ================  ===========================

.. |copy|   unicode:: U+000A9 .. COPYRIGHT SIGN

Copyright |copy| Bob Friesenhahn 1999 - 2019