1 9b4a2324 2009-07-09 rsc .TH FONTSRV 4
  2 9b4a2324 2009-07-09 rsc .SH NAME
  3 9b4a2324 2009-07-09 rsc fontsrv \- file system access to host fonts
  4 9b4a2324 2009-07-09 rsc .SH SYNOPSIS
  5 9b4a2324 2009-07-09 rsc .B fontsrv
  6 9b4a2324 2009-07-09 rsc [
  7 9b4a2324 2009-07-09 rsc .B -m
  8 9b4a2324 2009-07-09 rsc .I mtpt
  9 9b4a2324 2009-07-09 rsc ]
 10 76f90e51 2009-07-09 rsc [
 11 76f90e51 2009-07-09 rsc .B -s
 12 76f90e51 2009-07-09 rsc .I srvname
 13 76f90e51 2009-07-09 rsc ]
 14 9b4a2324 2009-07-09 rsc .PP
 15 9b4a2324 2009-07-09 rsc .B fontsrv
 16 9b4a2324 2009-07-09 rsc .B -p
 17 9b4a2324 2009-07-09 rsc .I path
 18 9b4a2324 2009-07-09 rsc .SH DESCRIPTION
 19 9b4a2324 2009-07-09 rsc .I Fontsrv
 20 9b4a2324 2009-07-09 rsc presents the host window system's fonts
 21 9b4a2324 2009-07-09 rsc in the standard Plan 9 format
 22 9b4a2324 2009-07-09 rsc (see
 23 d32deab1 2020-08-16 rsc .MR font (7) ).
 24 9b4a2324 2009-07-09 rsc It serves a virtual directory tree mounted at
 25 9b4a2324 2009-07-09 rsc .I mtpt
 26 9b4a2324 2009-07-09 rsc (if the
 27 9b4a2324 2009-07-09 rsc .B -m
 28 9b4a2324 2009-07-09 rsc option is given)
 29 9b4a2324 2009-07-09 rsc and posted at
 30 22209440 2009-07-09 rsc .I srvname
 31 9b4a2324 2009-07-09 rsc (default
 32 9b4a2324 2009-07-09 rsc .IR font ).
 33 9b4a2324 2009-07-09 rsc .PP
 34 dd7c4e51 2020-07-23 rsc The
 35 9b4a2324 2009-07-09 rsc .B -p
 36 dd7c4e51 2020-07-23 rsc option changes
 37 22209440 2009-07-09 rsc .IR fontsrv 's
 38 9b4a2324 2009-07-09 rsc behavior: rather than serve a file system,
 39 9b4a2324 2009-07-09 rsc .I fontsrv
 40 dd7c4e51 2020-07-23 rsc prints to standard output the contents of the named
 41 9b4a2324 2009-07-09 rsc .IR path .
 42 9b4a2324 2009-07-09 rsc If
 43 9b4a2324 2009-07-09 rsc .I path
 44 9b4a2324 2009-07-09 rsc names a directory in the served file system,
 45 9b4a2324 2009-07-09 rsc .I fontsrv
 46 9b4a2324 2009-07-09 rsc lists the directory's contents.
 47 9b4a2324 2009-07-09 rsc .PP
 48 9b4a2324 2009-07-09 rsc The fonts are arranged in a two-level tree.
 49 9b4a2324 2009-07-09 rsc The root contains directories named for each system font.
 50 9b4a2324 2009-07-09 rsc Each font directory contains subdirectories named for
 51 9b4a2324 2009-07-09 rsc a point size and whether the subfonts are anti-aliased:
 52 9b4a2324 2009-07-09 rsc .B 10
 53 9b4a2324 2009-07-09 rsc (bitmap)
 54 9b4a2324 2009-07-09 rsc .BR 10a
 55 9b4a2324 2009-07-09 rsc (anti-aliased greyscale)
 56 9b4a2324 2009-07-09 rsc .BR 12 ,
 57 9b4a2324 2009-07-09 rsc .BR 12a ,
 58 9b4a2324 2009-07-09 rsc and so on.
 59 9b4a2324 2009-07-09 rsc The font directory will synthesize additional sizes on
 60 9b4a2324 2009-07-09 rsc demand: looking up
 61 9b4a2324 2009-07-09 rsc .B 19a
 62 9b4a2324 2009-07-09 rsc will synthesize the 19-point anti-aliased size
 63 9b4a2324 2009-07-09 rsc if possible.
 64 9b4a2324 2009-07-09 rsc Each size directory contains a
 65 9b4a2324 2009-07-09 rsc .B font
 66 9b4a2324 2009-07-09 rsc file and subfont files
 67 9b4a2324 2009-07-09 rsc named
 68 9b4a2324 2009-07-09 rsc .BR x0000.bit ,
 69 dd7c4e51 2020-07-23 rsc .BR x0020.bit ,
 70 9b4a2324 2009-07-09 rsc and so on
 71 dd7c4e51 2020-07-23 rsc representing 32-character Unicode ranges.
 72 9b4a2324 2009-07-09 rsc .PP
 73 9b4a2324 2009-07-09 rsc .I Openfont
 74 9b4a2324 2009-07-09 rsc (see
 75 d32deab1 2020-08-16 rsc .MR graphics (3) )
 76 dd7c4e51 2020-07-23 rsc recognizes font paths beginning with
 77 9b4a2324 2009-07-09 rsc .B /mnt/font
 78 9b4a2324 2009-07-09 rsc and implements them by invoking
 79 9b4a2324 2009-07-09 rsc .IR fontsrv ;
 80 9b4a2324 2009-07-09 rsc it need not be running already.
 81 dd7c4e51 2020-07-23 rsc See
 82 d32deab1 2020-08-16 rsc .MR font (7)
 83 b3a110af 2015-02-17 rsc for a full discussion of font name syntaxes.
 84 9b4a2324 2009-07-09 rsc .SH EXAMPLES
 85 9b4a2324 2009-07-09 rsc List the fonts on the system:
 86 9b4a2324 2009-07-09 rsc .IP
 87 9b4a2324 2009-07-09 rsc .EX
 88 9b4a2324 2009-07-09 rsc % fontsrv &
 89 9b4a2324 2009-07-09 rsc % 9p ls font
 90 9b4a2324 2009-07-09 rsc .EE
 91 9b4a2324 2009-07-09 rsc .LP
 92 9b4a2324 2009-07-09 rsc or:
 93 9b4a2324 2009-07-09 rsc .IP
 94 9b4a2324 2009-07-09 rsc .EX
 95 9b4a2324 2009-07-09 rsc % fontsrv -p .
 96 9b4a2324 2009-07-09 rsc .EE
 97 9b4a2324 2009-07-09 rsc .LP
 98 dd7c4e51 2020-07-23 rsc Run
 99 d32deab1 2020-08-16 rsc .MR acme (1)
100 9b4a2324 2009-07-09 rsc using the operating system's Monaco as the fixed-width font:
101 9b4a2324 2009-07-09 rsc .IP
102 9b4a2324 2009-07-09 rsc .EX
103 9b4a2324 2009-07-09 rsc % acme -F /mnt/font/Monaco/13a/font
104 9b4a2324 2009-07-09 rsc .EE
105 9b4a2324 2009-07-09 rsc .LP
106 9b4a2324 2009-07-09 rsc Run
107 d32deab1 2020-08-16 rsc .MR sam (1)
108 9b4a2324 2009-07-09 rsc using the same font:
109 9b4a2324 2009-07-09 rsc .IP
110 9b4a2324 2009-07-09 rsc .EX
111 72f9e950 2009-07-09 rsc % font=/mnt/font/Monaco/13a/font sam
112 9b4a2324 2009-07-09 rsc .EE
113 9b4a2324 2009-07-09 rsc .SH SOURCE
114 9b4a2324 2009-07-09 rsc .B \*9/src/cmd/fontsrv
115 9b4a2324 2009-07-09 rsc .SH SEE ALSO
116 d32deab1 2020-08-16 rsc .MR font (7)
117 9b4a2324 2009-07-09 rsc .SH BUGS
118 9b4a2324 2009-07-09 rsc .PP
119 9b4a2324 2009-07-09 rsc Due to OS X restrictions,
120 9b4a2324 2009-07-09 rsc .I fontsrv
121 9b4a2324 2009-07-09 rsc does not fork itself into the background
122 9b4a2324 2009-07-09 rsc when serving a user-level file system.
123 9b4a2324 2009-07-09 rsc .PP
124 9b4a2324 2009-07-09 rsc .I Fontsrv
125 9b4a2324 2009-07-09 rsc has no support for X11 fonts;
126 9b4a2324 2009-07-09 rsc on X11 systems, it will serve an empty top-level directory.
127 9b4a2324 2009-07-09 rsc .PP
128 9b4a2324 2009-07-09 rsc On OS X, the anti-aliased bitmaps are not perfect.
129 9b4a2324 2009-07-09 rsc For example, the lower case r in the subfont
130 9b4a2324 2009-07-09 rsc .B Times-Roman/14a/x0000.bit
131 9b4a2324 2009-07-09 rsc appears truncated on the right and
132 9b4a2324 2009-07-09 rsc too light overall.