audio/sound.h

Go to the documentation of this file.

/******************************************************************************
 * This file is part of the Gluon Development Platform
 * Copyright (C) 2007 Laurent Gomila <laurent.gom@gmail.com>
 * Copyright (C) 2009 Sacha Schutz <istdasklar@free.fr>
 * Copyright (C) 2009 Guillaume Martres <smarter@ubuntu.com>
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
 */
#ifndef GLUON_AUDIO_SOUND_H
#define GLUON_AUDIO_SOUND_H

#include <QtCore/QObject>
#include <QtGui/QVector3D>
#include <al.h>

#include "gluon_audio_export.h"

namespace GluonAudio
{
    class Buffer;

    class GLUON_AUDIO_EXPORT Sound : public QObject
    {
            Q_OBJECT

        public:
            Sound( QObject* parent = 0 );
            explicit Sound( const QString& soundFile, QObject* parent = 0 );
            explicit Sound( Buffer* buffer, QObject* parent = 0 );
            explicit Sound( ALuint buffer, QObject* parent = 0 );

            void load( const QString& soundFile );
            void load( Buffer* buffer );
            void load( ALuint buffer );

            ~Sound();

            ALfloat elapsedTime() const ;

            ALint status() const ;

            bool isPlaying();
            bool isLooping();

            QString lastError() const ;

            QVector3D position() const;

            ALfloat x() const ;

            ALfloat y() const ;

            ALfloat z() const ;

            ALfloat volume() const ;

            ALfloat pitch() const ;

            ALfloat radius() const;

            ALfloat duration() const ;

            ALuint source() const ;

        public Q_SLOTS:
            void play();
            void pause();

            void stop();

            void rewind();

            void setLoop( bool enabled = true );

            void setPosition( QVector3D position );

            void setPosition( ALfloat x = 0.0, ALfloat y = 0.0, ALfloat z = 0.0 );

            void setVolume( ALfloat volume = 1.0f );

            void setPitch( ALfloat pitch = 1.0f );

            void setRadius( ALfloat radius = 10000.0f );

            void setMinVolume( ALfloat min = 0.0f );

            void setMaxVolume( ALfloat max = 10.0f );
            void setVelocity( ALfloat vx, ALfloat vy, ALfloat vz );
            void setDirection( ALfloat dx, ALfloat dy, ALfloat dz );

            void setTimePosition( ALfloat time );

            //void setRadius(float radius);

        protected:
            void setupSource();

        private:
            Q_DISABLE_COPY( Sound )

            class SoundPrivate;
            SoundPrivate* const d;
    };
}

#endif // GLUON_AUDIO_SOUND_H

---