1 058b0118 2005-01-03 devnull .TH FACE 7
3 058b0118 2005-01-03 devnull face \- face files
4 058b0118 2005-01-03 devnull .SH DESCRIPTION
5 058b0118 2005-01-03 devnull The directories
6 058b0118 2005-01-03 devnull .B /usr/$user/lib/face
8 058b0118 2005-01-03 devnull .B /lib/face
9 058b0118 2005-01-03 devnull contain a hierarchy of images of people.
10 058b0118 2005-01-03 devnull In those directories are subdirectories named by the sizes of
11 058b0118 2005-01-03 devnull the corresponding image files:
12 058b0118 2005-01-03 devnull .B 48x48x1
13 058b0118 2005-01-03 devnull (48 by 48 pixels, one bit per pixel);
14 058b0118 2005-01-03 devnull .B 48x48x2
15 058b0118 2005-01-03 devnull (48 by 48 pixels, two (grey) bits per pixel);
16 058b0118 2005-01-03 devnull .B 48x48x4
17 058b0118 2005-01-03 devnull (48 by 48 pixels, four (grey) bits per pixel);
18 058b0118 2005-01-03 devnull .B 48x48x8
19 058b0118 2005-01-03 devnull (48 by 48 pixels, eight (color-mapped) bits per pixel);
20 058b0118 2005-01-03 devnull .B 512x512x8
21 058b0118 2005-01-03 devnull (512 by 512 pixels, eight (color-mapped) bits per pixel);
22 058b0118 2005-01-03 devnull .B 512x512x24
23 058b0118 2005-01-03 devnull (512 by 512 pixels, twenty-four bits per pixel (3 times 8 bits
24 058b0118 2005-01-03 devnull per color)).
25 058b0118 2005-01-03 devnull The large files serve no special purpose; they are stored
26 058b0118 2005-01-03 devnull as images
28 d32deab1 2020-08-16 rsc .MR image (7) ).
29 058b0118 2005-01-03 devnull The small files are the `icons' displayed by
32 058b0118 2005-01-03 devnull .B seemail
33 058b0118 2005-01-03 devnull (see Plan 9's
34 977b25a7 2020-08-14 rsc .IR faces (1));
35 058b0118 2005-01-03 devnull for depths less than 4, their format is special.
37 058b0118 2005-01-03 devnull One- and two-bit deep icons are stored as text, one line of the file to one scan line
38 058b0118 2005-01-03 devnull of display.
39 058b0118 2005-01-03 devnull Each line is divided into 8-bit, 16-bit, or 32-bit big-endian words,
40 058b0118 2005-01-03 devnull stored as a list of comma-separated hexadecimal C constants,
44 058b0118 2005-01-03 devnull 0x9200, 0x1bb0, 0x003e,
47 058b0118 2005-01-03 devnull This odd format is historical and the programs that read it
48 058b0118 2005-01-03 devnull are somewhat forgiving about blanks and the need for commas.
50 058b0118 2005-01-03 devnull The files
51 058b0118 2005-01-03 devnull .BR lib/face/*/.dict
52 058b0118 2005-01-03 devnull hold a correspondence between users at machines
53 058b0118 2005-01-03 devnull and face files.
54 058b0118 2005-01-03 devnull The format is
57 058b0118 2005-01-03 devnull .I machine\fB/\fPuser directory\fB/\fPfile\fB.\fPver
61 058b0118 2005-01-03 devnull .I machine
62 058b0118 2005-01-03 devnull is the domain name of the machine sending the message,
65 058b0118 2005-01-03 devnull the name of the user sending it.
67 058b0118 2005-01-03 devnull .I directory
68 058b0118 2005-01-03 devnull is a further subdirectory of (say)
69 058b0118 2005-01-03 devnull .BR /lib/face/48x48x1 ,
70 058b0118 2005-01-03 devnull named by a single letter corresponding to the first character
71 058b0118 2005-01-03 devnull of the user names. The
73 058b0118 2005-01-03 devnull is the name of the file, typically but not always the user name,
76 058b0118 2005-01-03 devnull is a number to distinguish different images, for example to
77 058b0118 2005-01-03 devnull distinguish the image for Bill Gates from the image for Bill Joy,
78 058b0118 2005-01-03 devnull both of which might otherwise be called
79 058b0118 2005-01-03 devnull .BR b/bill .
80 058b0118 2005-01-03 devnull For example, Bill Gates might be represented by the line
83 058b0118 2005-01-03 devnull microsoft.com/bill b/bill.1
86 058b0118 2005-01-03 devnull If multiple entries exist for a user in the various
90 058b0118 2005-01-03 devnull chooses the highest pixel size less than or equal to that of the
91 058b0118 2005-01-03 devnull display on which it is running.
93 058b0118 2005-01-03 devnull Finally, or rather firstly, the file
94 058b0118 2005-01-03 devnull .B /lib/face/.machinelist
95 058b0118 2005-01-03 devnull contains a list of machine/domain pairs, one per line,
96 058b0118 2005-01-03 devnull to map any of a set of machines to a single domain name to
97 058b0118 2005-01-03 devnull be looked up in the
99 058b0118 2005-01-03 devnull files. The machine name may be a regular expression,
100 058b0118 2005-01-03 devnull so for example the entry
103 058b0118 2005-01-03 devnull \&.*research\e.bell-labs\e.com astro
106 058b0118 2005-01-03 devnull maps any of the machines in Bell Labs Research into the
107 058b0118 2005-01-03 devnull shorthand name
108 058b0118 2005-01-03 devnull .BR astro ,
109 058b0118 2005-01-03 devnull which then appears as a domain name in the
110 058b0118 2005-01-03 devnull .B .dict
112 058b0118 2005-01-03 devnull .SH "SEE ALSO"
113 d32deab1 2020-08-16 rsc .MR mail (1) ,
114 d32deab1 2020-08-16 rsc .MR tweak (1) ,
115 d32deab1 2020-08-16 rsc .MR image (7)
