NAME

Image::XFace - encode and decode `X-Face' 48x48x1 face bitmaps

SYNOPSIS

use Image::XFace;

# obtain $xface data...
@bits = Image::XFace::uncompface($xface);
if (@bits != 48) {
    # data were invalid
}

# create xface data
$xface = Image::XFace::compface(@bits);

# get xface data as an image
use GD;
$img = Image::XFace::uncompface_gd($xface);
# do with img as you will....

DESCRIPTION

Simple interface to compressing and uncompressing X-Face header data. For instance, a small bitmap of me is represented by

"kUA_=&I|(by86eXgYc|U}5`O%<xlo,~+JN9uk"Z`A.UCf2\1KKZ
{FY-IIOqH/IS"=5=cb`U,mDyyf8a6BzVgYT~pRtqze]%s#\(J{/u
m"(r,Ol^4J*Y%aWe-9`ZKGEYjG}d?#u2jzP,x37.%A~Qa;Yy6Fz`
i/vu{}?y8%cI)RJpLnW=$yTs=TDM'MGjX`/LDw%p;EK;[ww;9_;U
nRa+JZYO}[-j]O08X\Nm/K>M(P#,)y`g7N}Boz4b^JTFYHPz:s%i
dl@t$\Vv$3OL6:>GEGwFHrV$/bfnL=6uO/ggqZfet:&D3Q=9c

PUBLIC INTERFACE

uncompface XFACE

Decode XFACE data. Returns in list context 48 bit-strings of image data as generated by vec.

compface IMAGE

Encodes binary image data encoded in bit-strings as XFACE data, returning it in scalar context.

uncompface_gd XFACE

Decode XFACE data into a GD image object.

AUTHOR

Chris Lightfoot <chris@ex-parrot.com>, though all the real work is done by the compface library of James Ashton.

COPYING

Copyright (c) 2002 Chris Lightfoot.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

VERSION

$Id: XFace.pm,v 1.1.1.1 2002/02/17 23:09:57 chris Exp $

SEE ALSO

compface(3)