Qt Reference Documentation

# GEAudioBuffer.h Example File

demos/mobile/quickhit/ga_src/GEAudioBuffer.h

     /****************************************************************************
     **
     ** Copyright (C) 2011 Nokia Corporation and/or its subsidiary(-ies).
     ** All rights reserved.
     ** Contact: Nokia Corporation (qt-info@nokia.com)
     **
     ** This file is part of the QtDeclarative module of the Qt Toolkit.
     **
     ** $QT_BEGIN_LICENSE:BSD$
     ** You may use this file under the terms of the BSD license as follows:
     **
     ** "Redistribution and use in source and binary forms, with or without
     ** modification, are permitted provided that the following conditions are
     ** met:
     **   * Redistributions of source code must retain the above copyright
     **     notice, this list of conditions and the following disclaimer.
     **   * Redistributions in binary form must reproduce the above copyright
     **     notice, this list of conditions and the following disclaimer in
     **     the documentation and/or other materials provided with the
     **     distribution.
     **   * Neither the name of Nokia Corporation and its Subsidiary(-ies) nor
     **     the names of its contributors may be used to endorse or promote
     **     products derived from this software without specific prior written
     **     permission.
     **
     ** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
     ** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
     ** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
     ** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
     ** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
     ** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
     ** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
     ** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
     ** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
     ** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
     ** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE."
     ** $QT_END_LICENSE$
     **
     ****************************************************************************/

     #ifndef __GE_IGA_AUDIOBUFFER__
     #define __GE_IGA_AUDIOBUFFER__

     #include <QFile>
     #include "GEInterfaces.h"

     namespace GE {

         class CAudioBufferPlayInstance;
         class CAudioBuffer;         // forward declaration
         typedef AUDIO_SAMPLE_TYPE(*SAMPLE_FUNCTION_TYPE)(CAudioBuffer *abuffer, int pos, int channel);

         class CAudioBuffer {            // container for a sound
         public:
             CAudioBuffer();
             virtual ~CAudioBuffer();

             static CAudioBuffer* loadWav( QString fileName );
             static CAudioBuffer* loadWav( FILE *wavFile );          // support for stdio
             void reallocate( int length );

             inline void* getRawData() { return m_data; }
             inline int getDataLength() { return m_dataLength; }

             inline int getBytesPerSample() { return (m_bitsPerSample>>3); }
             inline int getBitsPerSample() { return m_bitsPerSample; }
             inline int getSamplesPerSec() { return m_samplesPerSec; }
             inline short getNofChannels() { return m_nofChannels; }
             inline SAMPLE_FUNCTION_TYPE getSampleFunction() { return m_sampleFunction; }

             // static implementations of sample functions
             static AUDIO_SAMPLE_TYPE sampleFunction8bitMono( CAudioBuffer *abuffer, int pos, int channel );
             static AUDIO_SAMPLE_TYPE sampleFunction16bitMono( CAudioBuffer *abuffer, int pos, int channel );
             static AUDIO_SAMPLE_TYPE sampleFunction8bitStereo( CAudioBuffer *abuffer, int pos, int channel );
             static AUDIO_SAMPLE_TYPE sampleFunction16bitStereo( CAudioBuffer *abuffer, int pos, int channel );

             CAudioBufferPlayInstance *playWithMixer( GE::CAudioMixer &mixer );

         protected:
             SAMPLE_FUNCTION_TYPE m_sampleFunction;
             short m_nofChannels;
             void *m_data;
             int m_dataLength;                // in bytes
             short m_bitsPerSample;
             bool m_signedData;
             int m_samplesPerSec;
         };

         class CAudioBufferPlayInstance : public IAudioSource {
         public:
             CAudioBufferPlayInstance();
             CAudioBufferPlayInstance( CAudioBuffer *start_playing );
             virtual ~CAudioBufferPlayInstance();
             void playBuffer( CAudioBuffer *startPlaying, float volume, float fixedSpeed, int loopTimes = 0 );            // looptimes -1 = loop forever

             void setSpeed( float speed );
             void setLeftVolume( float lvol );
             void setRightVolume( float rvol );

             inline void setLoopTimes( int ltimes ) { m_loopTimes = ltimes; }
             void stop();

             int pullAudio( AUDIO_SAMPLE_TYPE *target, int bufferLength );
             bool canBeDestroyed();

             bool isPlaying() { if (m_buffer) return true; else return false; }
             inline bool isFinished() { return m_finished; }
             inline bool destroyWhenFinished() { return m_destroyWhenFinished; }
             inline void setDestroyWhenFinished( bool set ) { m_destroyWhenFinished = set; }

         protected:
             int mixBlock( AUDIO_SAMPLE_TYPE *target, int bufferLength );
             bool m_finished;
             bool m_destroyWhenFinished;
             int m_fixedPos;
             int m_fixedInc;

             int m_fixedLeftVolume;
             int m_fixedRightVolume;
             int m_fixedCenter;
             int m_loopTimes;
             CAudioBuffer *m_buffer;
         };

     };

     #endif