<HTML> <STYLE> <!-- A{textdecoration:none} --> </STYLE> <STYLE type="text/css"> A:link, A:visited, A:active { text-decoration: none; } </STYLE> <HEAD> <TITLE>IDirectFBFont - GetStringExtents [DirectFB Reference Manual]</TITLE> </HEAD> <BODY bgcolor=#F8F4D8 link=#2369E0 vlink=#2369E0 text=#232323> <TABLE width=100% bgcolor=#C0B090 border=0 cellspacing=0 cellpadding=5> <TR><TD width=30%> <A href="http://www.directfb.org"><IMG border=0 src="dfb_logo-alpha.png"></A> </TD><TD align=right> <A href="index.html"><FONT size=+3 color=#203040>Reference Manual - 1.4.11</FONT></A> </TD></TR> <TR><TD colspan=2 align=center bgcolor=#284460> <TABLE border=0 cellspacing=0 cellpadding=0> <TR><TD nowrap align=right width=50%> <BIG><FONT color=#D0D0D0><A href="IDirectFBFont.html"> <FONT color=#D0D0D0>IDirectFBFont</FONT></A> </FONT></BIG> </TD><TD nowrap align=left width=50%> <BIG><FONT color=#E09040> GetStringExtents</FONT></BIG> </TD></TR> </TABLE> </TD></TR> </TABLE> <H4> Get the logical and real extents of the specified string as if it were drawn with this font. </H4> <TABLE border=0 cellspacing=4 cellpadding=2 bgcolor=#F8F8F0> <TR><TD colspan=5><I><FONT color=#425469><A href="types.html#DFBResult">DFBResult</A> <b>GetStringExtents (</b></FONT></I></TD></TR> <TR><TD width=50> </TD><TD valign=top> <A href="IDirectFBFont.html">IDirectFBFont</A> </TD><TD width=20> </TD><TD align=right> <FONT color=#424242><B>*</B></FONT> </TD><TD valign=top> <FONT color=#234269><B>thiz,</B></FONT> </TD></TR> <TR><TD width=50> </TD><TD valign=top> const char </TD><TD width=20> </TD><TD align=right> <FONT color=#424242><B>*</B></FONT> </TD><TD valign=top> <FONT color=#234269><B>text,</B></FONT> </TD></TR> <TR><TD width=50> </TD><TD valign=top> int </TD><TD width=20> </TD><TD align=right> <FONT color=#424242><B></B></FONT> </TD><TD valign=top> <FONT color=#234269><B>bytes,</B></FONT> </TD></TR> <TR><TD width=50> </TD><TD valign=top> <A href="types.html#DFBRectangle">DFBRectangle</A> </TD><TD width=20> </TD><TD align=right> <FONT color=#424242><B>*</B></FONT> </TD><TD valign=top> <FONT color=#234269><B>ret_logical_rect,</B></FONT> </TD></TR> <TR><TD width=50> </TD><TD valign=top> <A href="types.html#DFBRectangle">DFBRectangle</A> </TD><TD width=20> </TD><TD align=right> <FONT color=#424242><B>*</B></FONT> </TD><TD valign=top> <FONT color=#234269><B>ret_ink_rect</B></FONT> </TD></TR> <TR><TD colspan=5><I><FONT color=#425469><b>);</b></FONT></I></TD></TR> </TABLE> </P> <P> Bytes specifies the number of bytes to take from the string or -1 for the complete NULL-terminated string. </P><P> The logical rectangle describes the typographic extents and should be used to layout text. The ink rectangle describes the smallest rectangle containing all pixels that are touched when drawing the string. If you only need one of the rectangles, pass NULL for the other one. </P><P> The ink rectangle is guaranteed to be a valid rectangle with positive width and height, while the logical rectangle may have negative width indicating right-to-left layout. </P><P> The rectangle offsets are reported relative to the baseline and refer to the text being drawn using DSTF_LEFT. </P> <TABLE width=100% bgcolor=#E0E8F0 border=0 cellspacing=1 cellpadding=3> <TR><TD width=100> <a rel="license" href="http://creativecommons.org/licenses/by-sa/3.0/"> <img alt="Creative Commons License" style="border-width:0" border="0" src="http://i.creativecommons.org/l/by-sa/3.0/88x31.png" /> </a> </TD><TD> This work is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by-sa/3.0/"> Creative Commons Attribution-Share Alike 3.0 License</a> </TD></TR> </TABLE> </BODY> </HTML>