git.maemo.org Git - opencv/blob - otherlibs/highgui/grfmt_base.h

   1 /*M///////////////////////////////////////////////////////////////////////////////////////
   2 //
   3 //  IMPORTANT: READ BEFORE DOWNLOADING, COPYING, INSTALLING OR USING.
   4 //
   5 //  By downloading, copying, installing or using the software you agree to this license.
   6 //  If you do not agree to this license, do not download, install,
   7 //  copy or use the software.
   8 //
   9 //
  10 //                        Intel License Agreement
  11 //                For Open Source Computer Vision Library
  12 //
  13 // Copyright (C) 2000, Intel Corporation, all rights reserved.
  14 // Third party copyrights are property of their respective owners.
  15 //
  16 // Redistribution and use in source and binary forms, with or without modification,
  17 // are permitted provided that the following conditions are met:
  18 //
  19 //   * Redistribution's of source code must retain the above copyright notice,
  20 //     this list of conditions and the following disclaimer.
  21 //
  22 //   * Redistribution's in binary form must reproduce the above copyright notice,
  23 //     this list of conditions and the following disclaimer in the documentation
  24 //     and/or other materials provided with the distribution.
  25 //
  26 //   * The name of Intel Corporation may not be used to endorse or promote products
  27 //     derived from this software without specific prior written permission.
  28 //
  29 // This software is provided by the copyright holders and contributors "as is" and
  30 // any express or implied warranties, including, but not limited to, the implied
  31 // warranties of merchantability and fitness for a particular purpose are disclaimed.
  32 // In no event shall the Intel Corporation or contributors be liable for any direct,
  33 // indirect, incidental, special, exemplary, or consequential damages
  34 // (including, but not limited to, procurement of substitute goods or services;
  35 // loss of use, data, or profits; or business interruption) however caused
  36 // and on any theory of liability, whether in contract, strict liability,
  37 // or tort (including negligence or otherwise) arising in any way out of
  38 // the use of this software, even if advised of the possibility of such damage.
  39 //
  40 //M*/
  41
  42 #ifndef _GRFMT_BASE_H_
  43 #define _GRFMT_BASE_H_
  44
  45 #if _MSC_VER >= 1200
  46     #pragma warning( disable: 4514 )
  47     #pragma warning( disable: 4711 )
  48     #pragma warning( disable: 4611 )
  49 #endif
  50
  51 #include "utils.h"
  52 #include "bitstrm.h"
  53
  54 #define  RBS_BAD_HEADER     -125  /* invalid image header */
  55 #define  BAD_HEADER_ERR()   goto bad_header_exit
  56
  57 #ifndef _MAX_PATH
  58     #define _MAX_PATH    1024
  59 #endif
  60
  61
  62 ///////////////////////////////// base class for readers ////////////////////////
  63 class   GrFmtReader
  64 {
  65 public:
  66
  67     GrFmtReader( const char* filename );
  68     virtual ~GrFmtReader();
  69
  70     int   GetWidth()  { return m_width; };
  71     int   GetHeight() { return m_height; };
  72     bool  IsColor()   { return m_iscolor; };
  73     int   GetDepth()  { return m_bit_depth; };
  74     void  UseNativeDepth( bool yes ) { m_native_depth = yes; };
  75     bool  IsFloat()   { return m_isfloat; };
  76
  77     virtual bool  ReadHeader() = 0;
  78     virtual bool  ReadData( uchar* data, int step, int color ) = 0;
  79     virtual void  Close();
  80
  81 protected:
  82
  83     bool    m_iscolor;
  84     int     m_width;    // width  of the image ( filled by ReadHeader )
  85     int     m_height;   // height of the image ( filled by ReadHeader )
  86     int     m_bit_depth;// bit depth per channel (normally 8)
  87     char    m_filename[_MAX_PATH]; // filename
  88     bool    m_native_depth;// use the native bit depth of the image
  89     bool    m_isfloat;  // is image saved as float or double?
  90 };
  91
  92
  93 ///////////////////////////// base class for writers ////////////////////////////
  94 class   GrFmtWriter
  95 {
  96 public:
  97
  98     GrFmtWriter( const char* filename );
  99     virtual ~GrFmtWriter() {};
 100     virtual bool  IsFormatSupported( int depth );
 101     virtual bool  WriteImage( const uchar* data, int step,
 102                               int width, int height, int depth, int channels ) = 0;
 103 protected:
 104     char    m_filename[_MAX_PATH]; // filename
 105 };
 106
 107
 108 ////////////////////////////// base class for filter factories //////////////////
 109 class   GrFmtFilterFactory
 110 {
 111 public:
 112
 113     GrFmtFilterFactory();
 114     virtual ~GrFmtFilterFactory() {};
 115
 116     const char*  GetDescription() { return m_description; };
 117     int     GetSignatureLength()  { return m_sign_len; };
 118         virtual bool CheckFile( const char* filename );
 119     virtual bool CheckSignature( const char* signature );
 120     virtual bool CheckExtension( const char* filename );
 121     virtual GrFmtReader* NewReader( const char* filename ) = 0;
 122     virtual GrFmtWriter* NewWriter( const char* filename ) = 0;
 123
 124 protected:
 125     const char* m_description;
 126            // graphic format description in form:
 127            // <Some textual description>( *.<extension1> [; *.<extension2> ...]).
 128            // the textual description can not contain symbols '(', ')'
 129            // and may be, some others. It is safe to use letters, digits and spaces only.
 130            // e.g. "Targa (*.tga)",
 131            // or "Portable Graphic Format (*.pbm;*.pgm;*.ppm)"
 132
 133     int          m_sign_len;    // length of the signature of the format
 134     const char*  m_signature;   // signature of the format
 135 };
 136
 137
 138 /////////////////////////// list of graphic format filters ///////////////////////////////
 139
 140 typedef void* ListPosition;
 141
 142 class   GrFmtFactoriesList
 143 {
 144 public:
 145
 146     GrFmtFactoriesList();
 147     virtual ~GrFmtFactoriesList();
 148     void  RemoveAll();
 149     bool  AddFactory( GrFmtFilterFactory* factory );
 150     int   FactoriesCount() { return m_curFactories; };
 151     ListPosition  GetFirstFactoryPos();
 152     GrFmtFilterFactory*  GetNextFactory( ListPosition& pos );
 153     virtual GrFmtReader*  FindReader( const char* filename );
 154     virtual GrFmtWriter*  FindWriter( const char* filename );
 155
 156 protected:
 157
 158     GrFmtFilterFactory** m_factories;
 159     int  m_maxFactories;
 160     int  m_curFactories;
 161 };
 162
 163 #endif/*_GRFMT_BASE_H_*/