NAME

stringsize, stringwidth, stringnwidth, runestringsize, runestringwidth, runestringnwidth − graphical size of strings

SYNOPSIS

#include <u.h>
#include <libc.h>
#include <draw.h>

Pointstringsize(Font ∗f, char ∗s)

intstringwidth(Font ∗f, char ∗s)

intstringnwidth(Font ∗f, char ∗s, int n)

Pointrunestringsize(Font ∗f, Rune ∗s)

intrunestringwidth(Font ∗f, Rune ∗s)

intrunestringnwidth(Font ∗f, Rune ∗s, int n)

DESCRIPTION

These routines compute the geometrical extent of character strings when drawn on the display.  The most straightforward, stringsize, returns a ­Point representing the vector from upper left to lower right of the NUL-terminated string ­s drawn in font f. ­Stringwidth returns just the ­x component.  ­Stringnwidth returns the width of the first ­n characters of s.

The routines beginning with ­rune are analogous, but accept an array of runes rather than UTF -encoded bytes. 

FILES

/lib/font/bit    directory of fonts

SOURCE

­/sys/src/libdraw

SEE ALSO

addpt(2), cachechars(2), subfont(2), draw(2), draw(3), image(6), font(6)

DIAGNOSTICS

Because strings are loaded dynamically, these routines may generate I/O to the server and produce calls to the graphics error function. 

Plan 9  —  March 09, 2000