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)