This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

PfTextWidthChars()

Calculate the width of a char string of multibyte UTF-8 characters

Synopsis:

#include <photon/Pf.h>
int PfTextWidthChars( const char *font,
                      const char *str,
                      int len );

font: The name of the desired font. You should use PfGenerateFontName() to create this name.
str: A char string of multibyte UTF-8 characters.
len: The number of characters in the string. If len is 0, strlen(str) is assumed.

ph

PfTextWidthChars() is a convenience function that calculates the width of the given string in the given font, using the formula:

extent.lr.x - min(extent.ul.x, 0) + 1

PfTextWidthBytes() is similar, but you pass it the number of bytes in the string, not the number of characters.

The width of the string, or 0 if an error occurred.

Photon