


IMPIX(3IM)             SDSC IMAGE LIBRARY              IMPIX(3IM)



NAME
     impix - Alias PIX file translation

SYNOPSIS
     #include <stdio.h>
     #include "sdsc.h"
     #include "im.h"

     int ImFileRead( fd, "pix", flagsTable, dataTable )
          int         fd;
          TagTable   *flagsTable;
          TagTable   *dataTable;

     int ImFileFRead( fp, "pix", flagsTable, dataTable )
          FILE         *fp;
          TagTable   *flagsTable;
          TagTable   *dataTable;

     int ImFileWrite( fd, "pix", flagsTable, dataTable )
          int         fd;
          TagTable   *flagsTable;
          TagTable   *dataTable;

     int ImFileFWrite( fp, "pix", flagsTable, dataTable )
          FILE         *fp;
          TagTable   *flagsTable;
          TagTable   *dataTable;


DESCRIPTION
     pix image files are generated by the rendering and  painting
     tools  of Alias Research, Inc., such as renderer, raytracer,
     and paint.  See the Alias documentation set for  details  on
     how to use these tools.

     _N_o_t_e: Alias quickpaint, available on Silicon Graphics, Inc.,
     IRIS  workstations,  uses  Silicon  Graphic's rgb image file
     format rather than the Alias pix image file format.  See the
     imrgb(3IM) man page for details on the rgb format.

FILE RECOGNITION
     Alias pix files are recognized by these  following  filename
     suffixes: .alias and .pix.

NOTES
     SDSC image library support of the Alias pix format does  not
     require use of Alias tools and contains no proprietary code.
     Alias pix format handling is available on  any  machine  for
     which the SDSC image library is available.

  Reading Alias PIX files
     The  SDSC  image  library  reads  run-length-encoded  (RLE),



SDSC              Last change: August 24, 1992                  1






IMPIX(3IM)             SDSC IMAGE LIBRARY              IMPIX(3IM)



     noninterlaced,  24-bit  RGB Alias pix files and maps them to
     IMVFBRGB VFBs without color lookup tables (CLTs).

  Writing Alias PIX files
     Image library  IMVFBRGB  VFBs  are  written  to  run-length-
     encoded,   noninterlaced,   24-bit   RGB  Alias  pix  files.
     Scanline- and plane-interlaced modes are  not  supported  by
     Alias pix files.

     Other image library VFB types are converted to IMVFBRGB VFBs
     prior  to  being  written out.  See the ImFileWrite(3IM) man
     page for details.

ERRORS
     In addition to those listed for ImFileRead(3IM),  Alias  pix
     file reading returns the following error codes:

          IMEMALLOC   Cannot allocate enough memory
          IMESYS      System call error in read operation

     In addition to those listed for ImFileWrite(3IM), Alias  pix
     file writing returns the following error codes:

          IMEMALLOC   Cannot allocate enough memory
          IMESYS      System call error in write operation

DOCUMENTATION
     _A_l_i_a_s _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l, Alias Research, Inc.

SEE ALSO
     imconv(1IM), imfile(1IM), imformats(1IM)

AUTHOR
     Dave Nadeau
     San Diego Supercomputer Center

CONTACT
     SDSC consultants, (619)534-5100, consult@y1.sdsc.edu

















2                 Last change: August 24, 1992               SDSC



