image_io.h

Go to the documentation of this file.

/* This library is free software; you can redistribute it and/or
   modify it under the terms of the GNU Lesser General Public
   License as published by the Free Software Foundation; either
   version 2.1 of the License, or (at your option) any later version.

   This library is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
   Lesser General Public License for more details.

   You should have received a copy of the GNU Lesser General Public
   License along with this library; if not, write to the Free Software
   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
*/

#ifndef _GAN_IMAGE_IO_H
#define _GAN_IMAGE_IO_H

#include <gandalf/image/image_defs.h>
#include <gandalf/image/io/png_io.h>
#include <gandalf/image/io/pbm_io.h>
#include <gandalf/image/io/pgm_io.h>
#include <gandalf/image/io/tiff_io.h>
#include <gandalf/image/io/jpeg_io.h>
#include <gandalf/image/io/dpx_io.h>
#include <gandalf/image/io/cineon_io.h>
#include <gandalf/image/io/sgi_io.h>
#include <gandalf/image/io/targa_io.h>

#ifdef __cplusplus
extern "C" {
#endif

typedef enum
{
   GAN_PNG_FORMAT,    
   GAN_PBM_FORMAT,    
   GAN_PGM_FORMAT,    
   GAN_PPM_FORMAT,    
   GAN_TIFF_FORMAT,   
   GAN_JPEG_FORMAT,   
   GAN_DPX_FORMAT,    
   GAN_CINEON_FORMAT, 
   GAN_SGI_FORMAT,    
   GAN_TARGA_FORMAT,  
   GAN_UNKNOWN_FORMAT 
} Gan_ImageFileFormat;

typedef struct Gan_ImageReadControlStruct
{
   Gan_Bool header_only;

   Gan_Bool flip;

   Gan_Bool single_field;

   Gan_Bool upper;

   Gan_Bool whole_image;
} Gan_ImageReadControlStruct;

typedef struct Gan_ImageHeaderInfo
{
   gan_uint32 time_code;

   gan_uint32 user_bits;

   Gan_Bool interlaced;

   gan_float32 frame_rate;

#ifdef HAVE_PNG
   Gan_PNGHeaderStruct    png;
#endif
#ifdef HAVE_TIFF
   Gan_TIFFHeaderStruct   tiff;
#endif
#ifdef HAVE_JPEG
   Gan_JPEGHeaderStruct   jpeg;
#endif
   Gan_DPXHeaderStruct    dpx;
   Gan_CineonHeaderStruct cineon;
   Gan_SGIHeaderStruct    sgi;
   Gan_TargaHeaderStruct  targa;
} Gan_ImageHeaderInfo;

typedef struct Gan_ImageHeaderStruct
{
   Gan_ImageFileFormat file_format;
   unsigned int width;
   unsigned int height;
   Gan_ImageFormat format;
   Gan_Type type;
   Gan_ImageHeaderInfo info;
} Gan_ImageHeaderStruct;

typedef struct Gan_ImageWriteControlStruct
{
   Gan_Bool flip;

   Gan_Bool single_field;

   Gan_Bool upper;

   Gan_Bool whole_image;

   Gan_Bool reverse_bytes;

   Gan_ImageHeaderInfo info;
} Gan_ImageWriteControlStruct;

 Gan_ImageFileFormat gan_image_determine_file_format_stream ( FILE *infile );
 Gan_ImageFileFormat gan_image_determine_file_format ( const char *filename );
 Gan_ImageFileFormat gan_image_interpret_format_string ( const char *format_string );
 const char *gan_image_file_format_string ( Gan_ImageFileFormat format );
 const char *gan_image_format_string ( Gan_ImageFormat format );
 Gan_Bool gan_image_file_format_compressed ( Gan_ImageFileFormat format );
 Gan_Bool gan_image_format_type_supported ( Gan_ImageFileFormat file_format, Gan_ImageFormat image_format, Gan_Type type,
                                                       const Gan_ImageHeaderInfo* info );
 Gan_Bool gan_image_write_field_supported ( Gan_ImageFileFormat file_format );
 void gan_initialise_image_read_control_struct(Gan_ImageReadControlStruct *ictrlstr);
 Gan_Image *gan_image_read ( const char *filename, Gan_ImageFileFormat file_format, Gan_Image *image,
                                        const Gan_ImageReadControlStruct *ictrlstr, Gan_ImageHeaderStruct *header );
 Gan_Image *gan_image_read_stream ( FILE *infile, Gan_ImageFileFormat file_format, Gan_Image *image,
                                               const Gan_ImageReadControlStruct *ictrlstr, Gan_ImageHeaderStruct *header );
 Gan_Bool gan_initialise_image_header_info(Gan_ImageHeaderInfo *ohdrinfo, Gan_ImageFormat image_format, Gan_Type type);
 Gan_Bool gan_initialise_image_write_control_struct(Gan_ImageWriteControlStruct *octrlstr,
                                                               Gan_ImageFileFormat file_format, Gan_ImageFormat image_format, Gan_Type type);
 Gan_Bool gan_image_write ( const char *filename, Gan_ImageFileFormat file_format, const Gan_Image *image,
                                       const Gan_ImageWriteControlStruct *octrlstr );
 Gan_Bool gan_image_write_stream ( FILE *outfile, Gan_ImageFileFormat file_format, const Gan_Image *image,
                                              Gan_Bool new_file, const Gan_ImageWriteControlStruct *octrlstr );

#ifdef __cplusplus
}
#endif

#endif /* #ifndef _GAN_IMAGE_IO_H */

---