230 lines
8.0 KiB
C++
230 lines
8.0 KiB
C++
|
////////////////////////////////////////////////////////////
|
||
|
//
|
||
|
// SFML - Simple and Fast Multimedia Library
|
||
|
// Copyright (C) 2007-2017 Laurent Gomila (laurent@sfml-dev.org)
|
||
|
//
|
||
|
// 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 SFML_MUSIC_HPP
|
||
|
#define SFML_MUSIC_HPP
|
||
|
|
||
|
////////////////////////////////////////////////////////////
|
||
|
// Headers
|
||
|
////////////////////////////////////////////////////////////
|
||
|
#include <SFML/Audio/Export.hpp>
|
||
|
#include <SFML/Audio/SoundStream.hpp>
|
||
|
#include <SFML/Audio/InputSoundFile.hpp>
|
||
|
#include <SFML/System/Mutex.hpp>
|
||
|
#include <SFML/System/Time.hpp>
|
||
|
#include <string>
|
||
|
#include <vector>
|
||
|
|
||
|
|
||
|
namespace sf
|
||
|
{
|
||
|
class InputStream;
|
||
|
|
||
|
////////////////////////////////////////////////////////////
|
||
|
/// \brief Streamed music played from an audio file
|
||
|
///
|
||
|
////////////////////////////////////////////////////////////
|
||
|
class SFML_AUDIO_API Music : public SoundStream
|
||
|
{
|
||
|
public:
|
||
|
|
||
|
////////////////////////////////////////////////////////////
|
||
|
/// \brief Default constructor
|
||
|
///
|
||
|
////////////////////////////////////////////////////////////
|
||
|
Music();
|
||
|
|
||
|
////////////////////////////////////////////////////////////
|
||
|
/// \brief Destructor
|
||
|
///
|
||
|
////////////////////////////////////////////////////////////
|
||
|
~Music();
|
||
|
|
||
|
////////////////////////////////////////////////////////////
|
||
|
/// \brief Open a music from an audio file
|
||
|
///
|
||
|
/// This function doesn't start playing the music (call play()
|
||
|
/// to do so).
|
||
|
/// See the documentation of sf::InputSoundFile for the list
|
||
|
/// of supported formats.
|
||
|
///
|
||
|
/// \warning Since the music is not loaded at once but rather
|
||
|
/// streamed continuously, the file must remain accessible until
|
||
|
/// the sf::Music object loads a new music or is destroyed.
|
||
|
///
|
||
|
/// \param filename Path of the music file to open
|
||
|
///
|
||
|
/// \return True if loading succeeded, false if it failed
|
||
|
///
|
||
|
/// \see openFromMemory, openFromStream
|
||
|
///
|
||
|
////////////////////////////////////////////////////////////
|
||
|
bool openFromFile(const std::string& filename);
|
||
|
|
||
|
////////////////////////////////////////////////////////////
|
||
|
/// \brief Open a music from an audio file in memory
|
||
|
///
|
||
|
/// This function doesn't start playing the music (call play()
|
||
|
/// to do so).
|
||
|
/// See the documentation of sf::InputSoundFile for the list
|
||
|
/// of supported formats.
|
||
|
///
|
||
|
/// \warning Since the music is not loaded at once but rather streamed
|
||
|
/// continuously, the \a data buffer must remain accessible until
|
||
|
/// the sf::Music object loads a new music or is destroyed. That is,
|
||
|
/// you can't deallocate the buffer right after calling this function.
|
||
|
///
|
||
|
/// \param data Pointer to the file data in memory
|
||
|
/// \param sizeInBytes Size of the data to load, in bytes
|
||
|
///
|
||
|
/// \return True if loading succeeded, false if it failed
|
||
|
///
|
||
|
/// \see openFromFile, openFromStream
|
||
|
///
|
||
|
////////////////////////////////////////////////////////////
|
||
|
bool openFromMemory(const void* data, std::size_t sizeInBytes);
|
||
|
|
||
|
////////////////////////////////////////////////////////////
|
||
|
/// \brief Open a music from an audio file in a custom stream
|
||
|
///
|
||
|
/// This function doesn't start playing the music (call play()
|
||
|
/// to do so).
|
||
|
/// See the documentation of sf::InputSoundFile for the list
|
||
|
/// of supported formats.
|
||
|
///
|
||
|
/// \warning Since the music is not loaded at once but rather
|
||
|
/// streamed continuously, the \a stream must remain accessible
|
||
|
/// until the sf::Music object loads a new music or is destroyed.
|
||
|
///
|
||
|
/// \param stream Source stream to read from
|
||
|
///
|
||
|
/// \return True if loading succeeded, false if it failed
|
||
|
///
|
||
|
/// \see openFromFile, openFromMemory
|
||
|
///
|
||
|
////////////////////////////////////////////////////////////
|
||
|
bool openFromStream(InputStream& stream);
|
||
|
|
||
|
////////////////////////////////////////////////////////////
|
||
|
/// \brief Get the total duration of the music
|
||
|
///
|
||
|
/// \return Music duration
|
||
|
///
|
||
|
////////////////////////////////////////////////////////////
|
||
|
Time getDuration() const;
|
||
|
|
||
|
protected:
|
||
|
|
||
|
////////////////////////////////////////////////////////////
|
||
|
/// \brief Request a new chunk of audio samples from the stream source
|
||
|
///
|
||
|
/// This function fills the chunk from the next samples
|
||
|
/// to read from the audio file.
|
||
|
///
|
||
|
/// \param data Chunk of data to fill
|
||
|
///
|
||
|
/// \return True to continue playback, false to stop
|
||
|
///
|
||
|
////////////////////////////////////////////////////////////
|
||
|
virtual bool onGetData(Chunk& data);
|
||
|
|
||
|
////////////////////////////////////////////////////////////
|
||
|
/// \brief Change the current playing position in the stream source
|
||
|
///
|
||
|
/// \param timeOffset New playing position, from the beginning of the music
|
||
|
///
|
||
|
////////////////////////////////////////////////////////////
|
||
|
virtual void onSeek(Time timeOffset);
|
||
|
|
||
|
private:
|
||
|
|
||
|
////////////////////////////////////////////////////////////
|
||
|
/// \brief Initialize the internal state after loading a new music
|
||
|
///
|
||
|
////////////////////////////////////////////////////////////
|
||
|
void initialize();
|
||
|
|
||
|
////////////////////////////////////////////////////////////
|
||
|
// Member data
|
||
|
////////////////////////////////////////////////////////////
|
||
|
InputSoundFile m_file; ///< The streamed music file
|
||
|
Time m_duration; ///< Music duration
|
||
|
std::vector<Int16> m_samples; ///< Temporary buffer of samples
|
||
|
Mutex m_mutex; ///< Mutex protecting the data
|
||
|
};
|
||
|
|
||
|
} // namespace sf
|
||
|
|
||
|
|
||
|
#endif // SFML_MUSIC_HPP
|
||
|
|
||
|
|
||
|
////////////////////////////////////////////////////////////
|
||
|
/// \class sf::Music
|
||
|
/// \ingroup audio
|
||
|
///
|
||
|
/// Musics are sounds that are streamed rather than completely
|
||
|
/// loaded in memory. This is especially useful for compressed
|
||
|
/// musics that usually take hundreds of MB when they are
|
||
|
/// uncompressed: by streaming it instead of loading it entirely,
|
||
|
/// you avoid saturating the memory and have almost no loading delay.
|
||
|
/// This implies that the underlying resource (file, stream or
|
||
|
/// memory buffer) must remain valid for the lifetime of the
|
||
|
/// sf::Music object.
|
||
|
///
|
||
|
/// Apart from that, a sf::Music has almost the same features as
|
||
|
/// the sf::SoundBuffer / sf::Sound pair: you can play/pause/stop
|
||
|
/// it, request its parameters (channels, sample rate), change
|
||
|
/// the way it is played (pitch, volume, 3D position, ...), etc.
|
||
|
///
|
||
|
/// As a sound stream, a music is played in its own thread in order
|
||
|
/// not to block the rest of the program. This means that you can
|
||
|
/// leave the music alone after calling play(), it will manage itself
|
||
|
/// very well.
|
||
|
///
|
||
|
/// Usage example:
|
||
|
/// \code
|
||
|
/// // Declare a new music
|
||
|
/// sf::Music music;
|
||
|
///
|
||
|
/// // Open it from an audio file
|
||
|
/// if (!music.openFromFile("music.ogg"))
|
||
|
/// {
|
||
|
/// // error...
|
||
|
/// }
|
||
|
///
|
||
|
/// // Change some parameters
|
||
|
/// music.setPosition(0, 1, 10); // change its 3D position
|
||
|
/// music.setPitch(2); // increase the pitch
|
||
|
/// music.setVolume(50); // reduce the volume
|
||
|
/// music.setLoop(true); // make it loop
|
||
|
///
|
||
|
/// // Play it
|
||
|
/// music.play();
|
||
|
/// \endcode
|
||
|
///
|
||
|
/// \see sf::Sound, sf::SoundStream
|
||
|
///
|
||
|
////////////////////////////////////////////////////////////
|