1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
|
.TH STRINGSIZE 3
.SH NAME
stringsize, stringwidth, stringnwidth, runestringsize, runestringwidth, runestringnwidth \- graphical size of strings
.SH SYNOPSIS
.nf
.PP
.ft L
#include <u.h>
#include <libc.h>
#include <draw.h>
.ft P
.ta \w'\fLPoint 'u
.PP
.B
Point stringsize(Font *f, char *s)
.PP
.B
int stringwidth(Font *f, char *s)
.PP
.B
int stringnwidth(Font *f, char *s, int n)
.PP
.B
Point runestringsize(Font *f, Rune *s)
.PP
.B
int runestringwidth(Font *f, Rune *s)
.PP
.B
int runestringnwidth(Font *f, Rune *s, int n)
.SH DESCRIPTION
These routines compute the geometrical extent of character strings when drawn on the display. The most straightforward,
.BR stringsize ,
returns a
.B Point
representing the vector from upper left to lower right of the NUL-terminated string
.I s
drawn in font
.IR f .
.B Stringwidth
returns just the
.I x
component.
.B Stringnwidth
returns the width of the first
.I n
characters of
.IR s .
.PP
The routines beginning with
.B rune
are analogous, but accept an array of runes rather than
.SM UTF\c
-encoded bytes.
.SH FILES
.BR /lib/font/bit " directory of fonts
.SH SOURCE
.B \*9/src/libdraw
.SH "SEE ALSO"
.MR addpt (3) ,
.MR cachechars (3) ,
.MR subfont (3) ,
.MR draw (3) ,
.MR draw (3) ,
.MR image (7) ,
.MR font (7)
.SH DIAGNOSTICS
Because strings are loaded dynamically, these routines may generate I/O
to the server and produce calls to the graphics error function.
|