This package provides an `X-Face:' module for Python called `compface'.

`compface' allows the manipulation of `X-Face:' header lines found
in some mail messages, which contain compressed 48x48x1 b+w images.

For instance, here is some code that will produce an image
using PIL given the data from a mail `X-Face:' header line:

 xface = '''
 HpqDCL'KQ$sj+=Yf>5(<A%rvZ$%3r7Z{dl%AAfN/eY~aZ+o!4&<[C$w<fU!^M/%c*76SIKu
 Pg:!xM1^%:AcgeP-*^-E[TUtFa^Q+$]7xl8](d8]|KL{``gFCsv/fSe-ERH+#GjE/6kcvten"T34m9
 9ynz$uMI~rKs*:t>5%"P<h5[e
 '''
 import compface, Image, ImageTk, Tkinter
 root = Tkinter.Tk()
 data = compface.uncompface(xface)
 (bitmap, width, height) = compface.face2bitmap(data)
 im = Image.fromstring('1', (width, height), bitmap, 'raw', '1')
 tkim = ImageTk.BitmapImage(im)
 Tkinter.Label(root, image=tkim).pack()
 root.mainloop()

This is the `__doc__' string from the module:

 `compface' is a function for generating highly compressed
 representations of 48x48x1 face image files. `uncompface' is an inverse
 function which performs an inverse transformation with no loss of
 data.  The algorithm used is highly tuned for its purpose and achieves
 better than a five to one compression ratio on average.

 The input format for `compface' (and the output format for
 `uncompface') is 48 lines each of 3 sixteen bit hexadecimal integers,
 comma terminated in C initialiser style. The output format of compface
 (and the input format for uncompface) is some number of lines made up
 of a space followed by printable characters (in the range `!' to `~'
 inclusive). The first line contains 72 characters and following lines
 contain 79 characters except that the last line may be short.

 The amount of compression obtained varies between face image files but
 the output of compface averages less than 200 characters. The average
 number of output lines is three.

INSTALLATION
============

Copy `compface.c' and `compfacemodule.c' to your Python source
`Modules' directory, and add the following lines to your `Setup.local':

 # `X-Face:' module
 compface compfacemodule.c compface.c

Then type `make install' in your Python source directory.