1 // queue.hxx -- Sample Queue encapsulation class
5 // Copyright (C) 2010 Erik Hofman <erik@ehofman.com>
7 // This program is free software; you can redistribute it and/or
8 // modify it under the terms of the GNU General Public License as
9 // published by the Free Software Foundation; either version 2 of the
10 // License, or (at your option) any later version.
12 // This program is distributed in the hope that it will be useful, but
13 // WITHOUT ANY WARRANTY; without even the implied warranty of
14 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 // General Public License for more details.
17 // You should have received a copy of the GNU General Public License
18 // along with this program; if not, write to the Free Software Foundation,
19 // Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
24 * \file audio sample.hxx
25 * Provides a sample queue encapsulation
29 #define _SG_QUEUE_HXX 1
32 # error This library requires C++
38 #include <simgear/compiler.h>
39 #include <simgear/structure/SGReferenced.hxx>
40 #include <simgear/structure/SGSharedPtr.hxx>
42 #include "sample_openal.hxx"
45 * manages everything we need to know for an individual audio sample
48 class SGSampleQueue : public SGSoundSample {
53 * Empty constructor, can be used to read data to the systems
54 * memory and not to the driver.
55 * @param freq sample frequentie of the samples
56 * @param format OpenAL format id of the data
58 SGSampleQueue(int freq, int format = AL_FORMAT_MONO8);
66 * Schedule this audio sample to stop playing.
71 * Queue new data for this audio sample
72 * @param data Pointer to a memory block containg this audio sample data.
73 * @param len length of the sample buffer in bytes
75 void add( const void* smp_data, size_t len );
78 * Set the source id of this source
79 * @param sid OpenAL source-id
81 virtual void set_source(unsigned int sid);
84 * Test if the buffer-id of this audio sample may be passed to OpenAL.
85 * @return false for sample queue
87 inline bool is_valid_buffer() const { return false; }
89 inline virtual bool is_queue() const { return true; }
92 std::string _refname; // sample name
93 std::vector<unsigned int> _buffers;
98 std::string random_string();
102 #endif // _SG_QUEUE_HXX