face 2.8 KB

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