Source

love / src / modules / audio / Source.h

/**
* Copyright (c) 2006-2011 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.
**/

#ifndef LOVE_AUDIO_SOURCE_H
#define LOVE_AUDIO_SOURCE_H

// LOVE
#include <common/Object.h>
#include <common/StringMap.h>

namespace love
{
namespace audio
{
	class Source : public Object
	{
	public:

		enum Type
		{
			TYPE_STATIC = 1,
			TYPE_STREAM,
			TYPE_MAX_ENUM
		}; // Type
		
		enum Unit
		{
			UNIT_SECONDS = 1,
			UNIT_SAMPLES,
			UNIT_MAX_ENUM
		};

	protected:
		Type type;
	public:

		Source(Type type);
		virtual ~Source();

		virtual Source * copy() = 0;

		virtual void play() = 0;
		virtual void stop() = 0;
		virtual void pause() = 0;
		virtual void resume() = 0;
		virtual void rewind() = 0;
		virtual bool isStopped() const = 0;
		virtual bool isPaused() const = 0;
		virtual bool isFinished() const = 0;
		virtual void update() = 0;

		virtual void setPitch(float pitch) = 0;
		virtual float getPitch() const = 0;

		virtual void setVolume(float volume) = 0;
		virtual float getVolume() const = 0;
		
		virtual void seek(float offset, Unit unit) = 0;
		virtual float tell(Unit unit) const = 0;

		// all float * v must be of size 3
		virtual void setPosition(float * v) = 0;
		virtual void getPosition(float * v) const = 0;
		virtual void setVelocity(float * v) = 0;
		virtual void getVelocity(float * v) const = 0;
		virtual void setDirection(float * v) = 0;
		virtual void getDirection(float * v) const = 0;

		virtual void setLooping(bool looping) = 0;
		virtual bool isLooping() const = 0;
		virtual bool isStatic() const = 0;

		static bool getConstant(const char * in, Type & out);
		static bool getConstant(Type in, const char *& out);
		static bool getConstant(const char * in, Unit & out);
		static bool getConstant(Unit in, const char *& out);

	private:

		static StringMap<Type, TYPE_MAX_ENUM>::Entry typeEntries[];
		static StringMap<Type, TYPE_MAX_ENUM> types;
		static StringMap<Unit, UNIT_MAX_ENUM>::Entry unitEntries[];
		static StringMap<Unit, UNIT_MAX_ENUM> units;

	}; // Source

} // audio
} // love

#endif // LOVE_AUDIO_SOURCE_H
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.