love / src / modules / audio / openal / Pool.h

 * Copyright (c) 2006-2013 LOVE Development Team
 * This software is provided 'as-is', without any express or implied
 * warranty.  In no event will the authors be held liable for any damages
 * arising from the use of this software.
 * Permission is granted to anyone to use this software for any purpose,
 * including commercial applications, and to alter it and redistribute it
 * freely, subject to the following restrictions:
 * 1. The origin of this software must not be misrepresented; you must not
 *    claim that you wrote the original software. If you use this software
 *    in a product, an acknowledgment in the product documentation would be
 *    appreciated but is not required.
 * 2. Altered source versions must be plainly marked as such, and must not be
 *    misrepresented as being the original software.
 * 3. This notice may not be removed or altered from any source distribution.


// STD
#include <queue>
#include <map>
#include <iostream>
#include <cmath>

#include "common/config.h"
#include "common/Exception.h"
#include "thread/threads.h"

// OpenAL
#include <OpenAL-Soft/alc.h>
#include <OpenAL-Soft/al.h>
#include <AL/alc.h>
#include <AL/al.h>
#include <AL/alext.h>

namespace love
namespace audio
namespace openal

class Source;

class Pool


	 * Checks whether an OpenAL source is available.
	 * @return True if at least one is available, false otherwise.
	bool isAvailable() const;

	 * Checks whether a Source is currently in the playing list.
	bool isPlaying(Source *s);

	void update();

	int getNumSources() const;
	int getMaxSources() const;

	bool play(Source *source, ALuint &out);
	void stop();
	void stop(Source *source);
	void pause();
	void pause(Source *source);
	void resume();
	void resume(Source *source);
	void rewind();
	void rewind(Source *source);
	void softRewind(Source *source);
	void seek(Source *source, float offset, void *unit);
	float tell(Source *source, void *unit);


	 * Makes the specified OpenAL source available for use.
	 * @param source The OpenAL source.
	void release(Source *source);

	ALuint findi(const Source *source) const;

	bool findSource(Source *source, ALuint &out);
	bool removeSource(Source *source);
	// Number of OpenAL sources.
	static const int NUM_SOURCES = 64;

	// OpenAL sources
	ALuint sources[NUM_SOURCES];

	// A queue of available sources.
	std::queue<ALuint> available;

	// A map of playing sources.
	std::map<Source *, ALuint> playing;

	// Only one thread can access this object at the same time. This mutex will
	// make sure of that.
	thread::Mutex *mutex;

}; // Pool

} // openal
} // audio
} // love