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