Audio:
[blender.git] / intern / audaspace / intern / AUD_FileWriter.h
1 /*
2  * ***** BEGIN GPL LICENSE BLOCK *****
3  *
4  * Copyright 2009-2011 Jörg Hermann Müller
5  *
6  * This file is part of AudaSpace.
7  *
8  * Audaspace is free software; you can redistribute it and/or modify
9  * it under the terms of the GNU General Public License as published by
10  * the Free Software Foundation; either version 2 of the License, or
11  * (at your option) any later version.
12  *
13  * AudaSpace is distributed in the hope that it will be useful,
14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16  * GNU General Public License for more details.
17  *
18  * You should have received a copy of the GNU General Public License
19  * along with Audaspace; if not, write to the Free Software Foundation,
20  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
21  *
22  * ***** END GPL LICENSE BLOCK *****
23  */
24
25 /** \file audaspace/intern/AUD_FileWriter.h
26  *  \ingroup audaspaceintern
27  */
28
29
30 #ifndef __AUD_FILEWRITER_H__
31 #define __AUD_FILEWRITER_H__
32
33 #include <string>
34 #include <vector>
35
36 #include "AUD_Reference.h"
37
38 #include "AUD_IWriter.h"
39 #include "AUD_IReader.h"
40
41 /**
42  * This class is able to create IWriter classes as well as write reads to them.
43  */
44 class AUD_FileWriter
45 {
46 private:
47         // hide default constructor, copy constructor and operator=
48         AUD_FileWriter();
49         AUD_FileWriter(const AUD_FileWriter&);
50         AUD_FileWriter& operator=(const AUD_FileWriter&);
51
52 public:
53         /**
54          * Creates a new IWriter.
55          * \param filename The file to write to.
56          * \param specs The file's audio specification.
57          * \param format The file's container format.
58          * \param codec The codec used for encoding the audio data.
59          * \param bitrate The bitrate for encoding.
60          * \return The writer to write data to.
61          */
62         static AUD_Reference<AUD_IWriter> createWriter(std::string filename, AUD_DeviceSpecs specs, AUD_Container format, AUD_Codec codec, unsigned int bitrate);
63
64         /**
65          * Writes a reader to a writer.
66          * \param reader The reader to read from.
67          * \param writer The writer to write to.
68          * \param length How many samples should be transfered.
69          * \param buffersize How many samples should be transfered at once.
70          */
71         static void writeReader(AUD_Reference<AUD_IReader> reader, AUD_Reference<AUD_IWriter> writer, unsigned int length, unsigned int buffersize);
72
73         /**
74          * Writes a reader to several writers.
75          * \param reader The reader to read from.
76          * \param writers The writers to write to.
77          * \param length How many samples should be transfered.
78          * \param buffersize How many samples should be transfered at once.
79          */
80         static void writeReader(AUD_Reference<AUD_IReader> reader, std::vector<AUD_Reference<AUD_IWriter> >& writers, unsigned int length, unsigned int buffersize);
81 };
82
83 #endif //__AUD_FILEWRITER_H__