NAME

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

SYNOPSIS

	#include <u.h> #include <libc.h> #include <draw.h> Point stringsize(Font *f, char *s) int     stringwidth(Font *f, char *s) int     stringnwidth(Font *f, char *s, int n) Point runestringsize(Font *f, Rune *s) int     runestringwidth(Font *f, Rune *s) int     runestringnwidth(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.

Copyright © 2024 Plan 9 Foundation. All rights reserved.