


IMIFF(3IM)             SDSC IMAGE LIBRARY              IMIFF(3IM)



NAME
     imiff - Sun-TAAC file translation

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

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

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

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

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


DESCRIPTION
     iff image files  are  generated  by  Sun  Microsystems  TAAC
     software  such  as  voxvu(1) and cloudvu(1).  See the _T_A_A_C-_1
     _A_p_p_l_i_c_a_t_i_o_n  _A_c_c_e_l_e_r_a_t_o_r:  _S_o_f_t_w_a_r_e  _R_e_f_e_r_e_n_c_e  _M_a_n_u_a_l   for
     information on how to use these programs.

     Note that image files compressed with the  Sun-TAAC  utility
     make_movie(1) cannot be read by the SDSC image library.

FILE RECOGNITION
     iff files are recognized by the following  filename  suffix:
     .iff.

NOTES
     SDSC image library support of the Sun-TAAC iff  format  does
     not  require  use of Sun-TAAC tools or hardware and contains
     no proprietary code.  Sun-TAAC iff format handling is avail-
     able  on  any  machine  for  which the SDSC image library is
     available.

  Reading Sun-TAAC IFF files
     The SDSC image library reads unencoded, non-interlaced,  24-
     bit  RGB  and  32-bit RGB+Alpha Sun-TAAC iff file images and



SDSC              Last change: August 19, 1992                  1






IMIFF(3IM)             SDSC IMAGE LIBRARY              IMIFF(3IM)



     maps them  to  IMVFBRGB  or  (IMVFBRGB  |  IMVFBALPHA)  VFBs
     without CLTs.

     The library reads unencoded, 8-bit color index Sun-TAAC  iff
     images  with  CLTs  and  maps  them to IMVFBINDEX8 VFBs with
     CLTs.  Note that color index  images  never  have  an  alpha
     plane.

  Writing Sun-TAAC IFF files
     The SDSC image  library  writes  IMVFBRGB  and  (IMVFBRGB  |
     IMVFBALPHA)  VFBs to unencoded, non-interlaced 24-bit RGB or
     32-bit RGB+Alpha Sun-TAAC iff files.  Scanline-  and  plane-
     interlaced modes are not available in iff files.

     The image library writes IMVFBINDEX8 VFBs with CLTs as unen-
     coded,  8-bit  color  index images with CLTs in Sun-TAAC iff
     files.

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

     iff does not support any form of image compression.

ERRORS
     In addition to those listed  for  ImFileRead(3IM),  Sun-TAAC
     iff file reading returns the following error codes:

          IMEDEPTH    Unknown image depth
          IMEFORMAT   Bad format
          IMEMAGIC    Bad magic number
          IMEMALLOC   Cannot allocate enough memory
          IMESYS      System call error in read operation
          IMESYNTAX   Syntax error

     In addition to those listed for  ImFileWrite(3IM),  Sun-TAAC
     iff file writing returns the following error codes:

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

DOCUMENTATION
     _S_u_n-_T_A_A_C  _U_s_e_r  _M_a_n_u_a_l,  _V_o_l_u_m_e   _R_e_n_d_e_r_i_n_g   _P_a_c_k_a_g_e,   Sun
     Microsystems.

SEE ALSO
     ImIntro(3IM),   ImErrNo(3IM),   imconv(1IM),    imfile(1IM),
     imformats(1IM), imras(3IM)

AUTHOR
     T. Todd Elvins
     San Diego Supercomputer Center



2                 Last change: August 19, 1992               SDSC






IMIFF(3IM)             SDSC IMAGE LIBRARY              IMIFF(3IM)



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





















































SDSC              Last change: August 19, 1992                  3



