Update to 2.0.0 tree from current Fremantle build
[opencv] / src / 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 //                           License Agreement
11 //                For Open Source Computer Vision Library
12 //
13 // Copyright (C) 2000-2008, Intel Corporation, all rights reserved.
14 // Copyright (C) 2009, Willow Garage Inc., all rights reserved.
15 // Third party copyrights are property of their respective owners.
16 //
17 // Redistribution and use in source and binary forms, with or without modification,
18 // are permitted provided that the following conditions are met:
19 //
20 //   * Redistribution's of source code must retain the above copyright notice,
21 //     this list of conditions and the following disclaimer.
22 //
23 //   * Redistribution's in binary form must reproduce the above copyright notice,
24 //     this list of conditions and the following disclaimer in the documentation
25 //     and/or other materials provided with the distribution.
26 //
27 //   * The name of the copyright holders may not be used to endorse or promote products
28 //     derived from this software without specific prior written permission.
29 //
30 // This software is provided by the copyright holders and contributors "as is" and
31 // any express or implied warranties, including, but not limited to, the implied
32 // warranties of merchantability and fitness for a particular purpose are disclaimed.
33 // In no event shall the Intel Corporation or contributors be liable for any direct,
34 // indirect, incidental, special, exemplary, or consequential damages
35 // (including, but not limited to, procurement of substitute goods or services;
36 // loss of use, data, or profits; or business interruption) however caused
37 // and on any theory of liability, whether in contract, strict liability,
38 // or tort (including negligence or otherwise) arising in any way out of
39 // the use of this software, even if advised of the possibility of such damage.
40 //
41 //M*/
42
43 #ifndef _GRFMT_BASE_H_
44 #define _GRFMT_BASE_H_
45
46 #include "utils.h"
47 #include "bitstrm.h"
48
49 namespace cv
50 {
51
52 class BaseImageDecoder;
53 class BaseImageEncoder;
54 typedef Ptr<BaseImageEncoder> ImageEncoder;
55 typedef Ptr<BaseImageDecoder> ImageDecoder;
56
57 ///////////////////////////////// base class for decoders ////////////////////////
58 class BaseImageDecoder
59 {
60 public:
61     BaseImageDecoder();
62     virtual ~BaseImageDecoder() {};
63
64     int width() const { return m_width; };
65     int height() const { return m_height; };
66     int type() const { return m_type; };
67
68     virtual bool setSource( const string& filename );
69     virtual bool setSource( const Mat& buf );
70     virtual bool readHeader() = 0;
71     virtual bool readData( Mat& img ) = 0;
72
73     virtual size_t signatureLength() const;
74     virtual bool checkSignature( const string& signature ) const;
75     virtual ImageDecoder newDecoder() const;
76
77 protected:
78     int  m_width;  // width  of the image ( filled by readHeader )
79     int  m_height; // height of the image ( filled by readHeader )
80     int  m_type;
81     string m_filename;
82     string m_signature;
83     Mat m_buf;
84     bool m_buf_supported;
85 };
86
87
88 ///////////////////////////// base class for encoders ////////////////////////////
89 class BaseImageEncoder
90 {
91 public:
92     BaseImageEncoder();
93     virtual ~BaseImageEncoder() {};
94     virtual bool isFormatSupported( int depth ) const;
95
96     virtual bool setDestination( const string& filename );
97     virtual bool setDestination( vector<uchar>& buf );
98     virtual bool write( const Mat& img, const vector<int>& params ) = 0;
99
100     virtual string getDescription() const;
101     virtual ImageEncoder newEncoder() const;
102
103 protected:
104     string m_description;
105     
106     string m_filename;
107     vector<uchar>* m_buf;
108     bool m_buf_supported;
109 };
110
111 }
112
113 #endif/*_GRFMT_BASE_H_*/