1COMPFACE(1)                 General Commands Manual                COMPFACE(1)
2
3
4

NAME

6       compface, uncompface - compress and expand 48x48x1 face image files
7

SYNOPSIS

9       compface [ infile [ outfile ] ] ...
10
11       uncompface [-X] [ infile [ outfile ] ] ...
12

DESCRIPTION

14       compface  is  a filter for generating highly compressed representations
15       of 48x48x1 face image files.  uncompface is  an  inverse  filter  which
16       performs an inverse transformation with no loss of data.  The algorithm
17       used is highly tuned for its purpose and achieves better than a five to
18       one  compression  ratio  on average.  Arguments operate identically for
19       both programmes.  The first argument, if present, causes  input  to  be
20       taken  from  the named file instead of from standard input unless it is
21       the string ``-''.  A second argument, if present, causes output  to  go
22       to the named file instead of to standard output unless it is the string
23       ``-''.  Subsequent pairs of arguments may be used  to  specify  further
24       pairs of input and output files.
25
26       The input format for compface (and the output format for uncompface) is
27       48 lines each of 3 sixteen bit hexadecimal integers,  comma  terminated
28       in  C  initialiser style.  The output format of compface (and the input
29       format for uncompface) is some number of lines made up of a space  fol‐
30       lowed  by printable characters (in the range ``!'' to ``~'' inclusive).
31       The first line contains 72 characters and following  lines  contain  79
32       characters except that the last line may be short.
33
34       This  version  of  compface  has been patched to also be able to handle
35       normal XBM images.  uncompface will produce XBM output only if  the  -X
36       switch is applied.
37
38       The  amount of compression obtained varies between face image files but
39       the output of compface averages less than 200 characters.  The  average
40       number of output lines is three.
41

DIAGNOSTICS

43       Exit  status  is  normally  0.   Possible errors include IO errors when
44       opening, reading or writing files,  format  errors  in  compface  input
45       files and invalid arguments.  Each results in an explanatory message on
46       standard error and an exit status of 1.  A warning will be produced  if
47       compface detects extra input data.
48

BUGS

50       Nominating standard input as input more than once does not work.
51

SEE ALSO

53       Compface(3)
54
55
56
57                                25 January 1990                    COMPFACE(1)
Impressum