<!-- manual page source format generated by PolyglotMan v3.2, --> <!-- available at http://polyglotman.sourceforge.net/ --> <html> <head> <title>IM_TEXT(3) manual page</title> </head> <body bgcolor='white'> <a href='#toc'>Table of Contents</a><p> <h2><a name='sect0' href='#toc0'>Name</a></h2> im_text - render a utf-8 text string into an image <h2><a name='sect1' href='#toc1'>Synopsis</a></h2> <b>#include <vips/vips.h></b> <p> <b>int im_text( out, text, font, width, alignment, dpi )</b> <br> <b>IMAGE *out;</b> <br> <b>const char *text;</b> <br> <b>const char *font;</b> <br> <b>int width;</b> <br> <b>int alignment;</b> <br> <b>int dpi;</b> <p> <h2><a name='sect2' href='#toc2'>Description</a></h2> <a href='im_text.3.html'><b>im_text(3)</b></a> makes an image containing the text string rendered as a bitmap with Pango. The result is a one band 8 bit image with 0 - 255 as black to white. The string may contain Pango markup, for example "<i>The</i>Guardian". <p> Fonts are specified pango-style as "family style size", for example "sans 12" or "times italic 14". <p> The <b>width</b> parameter, if greater than zero, gives the line width to wrap at. <p> <b>alignment</b> can be 0, 1 or 2 for right, centre and left alignment. <p> <b>dpi</b> is the resolution to render the text at. 300 is good for print, 100 for displays. <p> <h2><a name='sect3' href='#toc3'>Return Value</a></h2> The function returns 0 on success and -1 on error. <h2><a name='sect4' href='#toc4'>See Also</a></h2> <a href='im_plotmask.3.html'>im_plotmask(3)</a> , <a href='im_insertplace.3.html'>im_insertplace(3)</a> <h2><a name='sect5' href='#toc5'>Copyright</a></h2> <br> National Gallery 2004 <p> <hr><p> <a name='toc'><b>Table of Contents</b></a><p> <ul> <li><a name='toc0' href='#sect0'>Name</a></li> <li><a name='toc1' href='#sect1'>Synopsis</a></li> <li><a name='toc2' href='#sect2'>Description</a></li> <li><a name='toc3' href='#sect3'>Return Value</a></li> <li><a name='toc4' href='#sect4'>SeeAlso</a></li> <li><a name='toc5' href='#sect5'>Copyright</a></li> </ul> </body> </html>