3// SFML - Simple and Fast Multimedia Library 4// Copyright (C) 2007-2025 Laurent Gomila (laurent@sfml-dev.org) 6// This software is provided 'as-is', without any express or implied warranty. 7// In no event will the authors be held liable for any damages arising from the use of this software. 9// Permission is granted to anyone to use this software for any purpose, 10// including commercial applications, and to alter it and redistribute it freely, 11// subject to the following restrictions: 13// 1. The origin of this software must not be misrepresented; 14// you must not claim that you wrote the original software. 15// If you use this software in a product, an acknowledgment 16// in the product documentation would be appreciated but is not required. 18// 2. Altered source versions must be plainly marked as such, 19// and must not be misrepresented as being the original software. 21// 3. This notice may not be removed or altered from any source distribution. 37#include <unordered_set> 137 std::uint64_t sampleCount,
138unsignedint channelCount,
139unsignedint sampleRate,
140const std::vector<SoundChannel>& channelMap);
211 std::uint64_t sampleCount,
212unsignedint channelCount,
213unsignedint sampleRate,
214const std::vector<SoundChannel>& channelMap);
227 [[nodiscard]]
boolsaveToFile(
const std::filesystem::path& filename)
const;
339 [[nodiscard]]
bool update(
unsignedint channelCount,
unsignedint sampleRate,
const std::vector<SoundChannel>& channelMap);
347void attachSound(
Sound* sound)
const;
355void detachSound(
Sound* sound)
const;
360usingSoundList = std::unordered_set<Sound*>;
365 std::vector<std::int16_t> m_samples;
366unsignedint m_sampleRate{44100};
369mutable SoundList m_sounds;
Provide read access to sound files.
Abstract class for custom file input streams.
unsigned int getChannelCount() const
Get the number of channels used by the sound.
SoundBuffer(const std::filesystem::path &filename)
Construct the sound buffer from a file.
Time getDuration() const
Get the total duration of the sound.
unsigned int getSampleRate() const
Get the sample rate of the sound.
SoundBuffer(const std::int16_t *samples, std::uint64_t sampleCount, unsigned int channelCount, unsigned int sampleRate, const std::vector< SoundChannel > &channelMap)
Construct the sound buffer from an array of audio samples.
bool loadFromFile(const std::filesystem::path &filename)
Load the sound buffer from a file.
const std::int16_t * getSamples() const
Get the array of audio samples stored in the buffer.
std::vector< SoundChannel > getChannelMap() const
Get the map of position in sample frame to sound channel.
std::uint64_t getSampleCount() const
Get the number of samples stored in the buffer.
SoundBuffer()=default
Default constructor.
bool loadFromSamples(const std::int16_t *samples, std::uint64_t sampleCount, unsigned int channelCount, unsigned int sampleRate, const std::vector< SoundChannel > &channelMap)
Load the sound buffer from an array of audio samples.
SoundBuffer(const SoundBuffer ©)
Copy constructor.
bool saveToFile(const std::filesystem::path &filename) const
Save the sound buffer to an audio file.
SoundBuffer & operator=(const SoundBuffer &right)
Overload of assignment operator.
bool loadFromStream(InputStream &stream)
Load the sound buffer from a custom stream.
~SoundBuffer()
Destructor.
SoundBuffer(InputStream &stream)
Construct the sound buffer from a custom stream.
SoundBuffer(const void *data, std::size_t sizeInBytes)
Construct the sound buffer from a file in memory.
bool loadFromMemory(const void *data, std::size_t sizeInBytes)
Load the sound buffer from a file in memory.
Regular sound that can be played in the audio environment.