1IM_TEXT(3)                 Library Functions Manual                 IM_TEXT(3)
2
3
4

NAME

6       im_text - render a utf-8 text string into an image
7

SYNOPSIS

9       #include <vips/vips.h>
10
11       int im_text( out, text, font, width, alignment, dpi )
12       IMAGE *out;
13       const char *text;
14       const char *font;
15       int width;
16       int alignment;
17       int dpi;
18
19

DESCRIPTION

21       im_text(3) makes an image containing the text string rendered as a bit‐
22       map with Pango.  The result is a one band 8 bit image with 0 -  255  as
23       black  to  white.  The  string  may  contain  Pango markup, for example
24       "<i>The</i>Guardian".
25
26       Fonts are specified pango-style as "family  style  size",  for  example
27       "sans 12" or "times italic 14".
28
29       The width parameter, if greater than zero, gives the line width to wrap
30       at.
31
32       alignment can be 0, 1 or 2 for right, centre and left alignment.
33
34       dpi is the resolution to render the text at. 300 is good for print, 100
35       for displays.
36
37

RETURN VALUE

39       The function returns 0 on success and -1 on error.
40

SEE ALSO

42       im_plotmask(3), im_insertplace(3)
43

45       National Gallery 2004
46
47
48
49                                  20 May 2004                       IM_TEXT(3)
Impressum