Cycles: svn merge -r36777:37040 https://svn.blender.org/svnroot/bf-blender/trunk...
[blender.git] / intern / audaspace / ffmpeg / AUD_FFMPEGReader.h
1 /*
2  * $Id$
3  *
4  * ***** BEGIN GPL LICENSE BLOCK *****
5  *
6  * Copyright 2009-2011 Jörg Hermann Müller
7  *
8  * This file is part of AudaSpace.
9  *
10  * Audaspace is free software; you can redistribute it and/or modify
11  * it under the terms of the GNU General Public License as published by
12  * the Free Software Foundation; either version 2 of the License, or
13  * (at your option) any later version.
14  *
15  * AudaSpace is distributed in the hope that it will be useful,
16  * but WITHOUT ANY WARRANTY; without even the implied warranty of
17  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
18  * GNU General Public License for more details.
19  *
20  * You should have received a copy of the GNU General Public License
21  * along with Audaspace; if not, write to the Free Software Foundation,
22  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
23  *
24  * ***** END GPL LICENSE BLOCK *****
25  */
26
27 /** \file audaspace/ffmpeg/AUD_FFMPEGReader.h
28  *  \ingroup audffmpeg
29  */
30
31
32 #ifndef AUD_FFMPEGREADER
33 #define AUD_FFMPEGREADER
34
35 #include "AUD_ConverterFunctions.h"
36 #include "AUD_IReader.h"
37 #include "AUD_Reference.h"
38 #include "AUD_Buffer.h"
39
40 #include <string>
41
42 struct AVCodecContext;
43 extern "C" {
44 #include <libavformat/avformat.h>
45 }
46
47 /**
48  * This class reads a sound file via ffmpeg.
49  * \warning Seeking may not be accurate! Moreover the position is updated after
50  *          a buffer reading call. So calling getPosition right after seek
51  *          normally results in a wrong value.
52  * \warning Playback of an ogg with some outdated ffmpeg versions results in a
53  *          segfault on windows.
54  */
55 class AUD_FFMPEGReader : public AUD_IReader
56 {
57 private:
58         /**
59          * The current position in samples.
60          */
61         int m_position;
62
63         /**
64          * The playback buffer.
65          */
66         AUD_Buffer m_buffer;
67
68         /**
69          * The specification of the audio data.
70          */
71         AUD_DeviceSpecs m_specs;
72
73         /**
74          * The buffer for package reading.
75          */
76         AUD_Buffer m_pkgbuf;
77
78         /**
79          * The count of samples still available from the last read package.
80          */
81         int m_pkgbuf_left;
82
83         /**
84          * The AVFormatContext structure for using ffmpeg.
85          */
86         AVFormatContext* m_formatCtx;
87
88         /**
89          * The AVCodecContext structure for using ffmpeg.
90          */
91         AVCodecContext* m_codecCtx;
92
93         /**
94          * The ByteIOContext to read the data from.
95          */
96         ByteIOContext* m_byteiocontext;
97
98         /**
99          * The stream ID in the file.
100          */
101         int m_stream;
102
103         /**
104          * Converter function.
105          */
106         AUD_convert_f m_convert;
107
108         /**
109          * The memory file to read from.
110          */
111         AUD_Reference<AUD_Buffer> m_membuffer;
112
113         /**
114          * The buffer to read with.
115          */
116         data_t* m_membuf;
117
118         /**
119          * Reading position of the buffer.
120          */
121         int64_t m_membufferpos;
122
123         /**
124          * Decodes a packet into the given buffer.
125          * \param packet The AVPacket to decode.
126          * \param buffer The target buffer.
127          * \return The count of read bytes.
128          */
129         int decode(AVPacket* packet, AUD_Buffer& buffer);
130
131         /**
132          * Initializes the object.
133          */
134         void init();
135
136         // hide copy constructor and operator=
137         AUD_FFMPEGReader(const AUD_FFMPEGReader&);
138         AUD_FFMPEGReader& operator=(const AUD_FFMPEGReader&);
139
140 public:
141         /**
142          * Creates a new reader.
143          * \param filename The path to the file to be read.
144          * \exception AUD_Exception Thrown if the file specified does not exist or
145          *            cannot be read with ffmpeg.
146          */
147         AUD_FFMPEGReader(std::string filename);
148
149         /**
150          * Creates a new reader.
151          * \param buffer The buffer to read from.
152          * \exception AUD_Exception Thrown if the buffer specified cannot be read
153          *                          with ffmpeg.
154          */
155         AUD_FFMPEGReader(AUD_Reference<AUD_Buffer> buffer);
156
157         /**
158          * Destroys the reader and closes the file.
159          */
160         virtual ~AUD_FFMPEGReader();
161
162         static int read_packet(void* opaque, uint8_t* buf, int buf_size);
163         static int64_t seek_packet(void* opaque, int64_t offset, int whence);
164
165         virtual bool isSeekable() const;
166         virtual void seek(int position);
167         virtual int getLength() const;
168         virtual int getPosition() const;
169         virtual AUD_Specs getSpecs() const;
170         virtual void read(int & length, sample_t* & buffer);
171 };
172
173 #endif //AUD_FFMPEGREADER