CUSound.h

//
//  CUSound.h
//  Cornell University Game Library (CUGL)
//
//  This module provides a preloaded sound asset.  In general, these assets
//  should be WAV files (as there is no benefit to compression once they are
//  loaded into memory), but we do have support for other file types. However,
//  at this time, only WAV, MP3, and OGG are guaranteed to be supported on all
//  CUGL platforms (Android and iOS have very little overlap here).
//
//  We have factored out the platform-dependent code and have hidden it
//  behind this class as an abstraction.
//
//  This class uses our standard shared-pointer architecture.
//
//  1. The constructor does not perform any initialization; it just sets all
//     attributes to their defaults.
//
//  2. All initialization takes place via init methods, which can fail if an
//     object is initialized more than once.
//
//  3. All allocation takes place via static constructors which return a shared
//     pointer.
//
//
//  CUGL zlib License:
//      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.
//
//  Author: Walker White
//  Version: 12/10/16
//
#ifndef __CU_SOUND_H__
#define __CU_SOUND_H__
#include <cugl/base/CUBase.h>

#pragma mark -
#pragma mark Sound Class

namespace cugl {

// We use the impl namespace for platform-dependent data.
namespace impl {
    struct AudioBuffer;
}
    
class Sound {
private:
    CU_DISALLOW_COPY_AND_ASSIGN(Sound);
    
    std::string  _source;
    impl::AudioBuffer* _buffer;
    float _volume;
    
#pragma mark -
#pragma mark Constructors
public:
    Sound() : _source(""), _buffer(nullptr), _volume(1) {}
    
    ~Sound() { dispose(); }
    
    void dispose();
    
    bool init(const std::string& source);

    bool init(const char* source) {
        return init(std::string(source));
    }

#pragma mark -
#pragma mark Static Constructors

    static std::shared_ptr<Sound> alloc(const std::string& source) {
        std::shared_ptr<Sound> result = std::make_shared<Sound>();
        return (result->init(source) ? result : nullptr);
    }
    
    static std::shared_ptr<Sound> alloc(const char* source) {
        std::shared_ptr<Sound> result = std::make_shared<Sound>();
        return (result->init(source) ? result : nullptr);
    }
    
#pragma mark Attributes

    const std::string& getSource() const { return _source; }
    
    std::string getSuffix() const {
        size_t pos = _source.rfind(".");
        return (pos == std::string::npos ? "" : _source.substr(pos));
    }

    double getDuration() const;
        
    double getSampleRate() const;
    
    Uint64 getLength() const;
    
    Uint32 getChannels() const;
    
    float getVolume() const { return _volume; }

    void setVolume(float volume);
    
    friend class SoundChannel;
};

}

#endif /* __CU_SOUND_H__ */