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