You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
121 lines
2.7 KiB
121 lines
2.7 KiB
#pragma once |
|
|
|
#include <cstddef> |
|
#include <cstdint> |
|
#include <memory> |
|
|
|
#include <Aulib/Stream.h> |
|
|
|
#include "engine/sound_defs.hpp" |
|
#include "utils/stdcompat/shared_ptr_array.hpp" |
|
|
|
namespace devilution { |
|
|
|
class SoundSample final { |
|
public: |
|
SoundSample() = default; |
|
SoundSample(SoundSample &&) noexcept = default; |
|
SoundSample &operator=(SoundSample &&) noexcept = default; |
|
|
|
[[nodiscard]] bool IsLoaded() const |
|
{ |
|
return stream_ != nullptr; |
|
} |
|
|
|
void Release(); |
|
bool IsPlaying(); |
|
|
|
// Returns 0 on success. |
|
int SetChunkStream(std::string filePath, bool isMp3, bool logErrors = true); |
|
|
|
void SetFinishCallback(Aulib::Stream::Callback &&callback) |
|
{ |
|
stream_->setFinishCallback(std::forward<Aulib::Stream::Callback>(callback)); |
|
} |
|
|
|
#ifndef STREAM_ALL_AUDIO |
|
/** |
|
* @brief Sets the sample's WAV, FLAC, or Ogg/Vorbis data. |
|
* @param fileData Buffer containing the data |
|
* @param dwBytes Length of buffer |
|
* @param isMp3 Whether the data is an MP3 |
|
* @return 0 on success, -1 otherwise |
|
*/ |
|
int SetChunk(ArraySharedPtr<std::uint8_t> fileData, std::size_t dwBytes, bool isMp3); |
|
#endif |
|
|
|
#ifndef STREAM_ALL_AUDIO |
|
[[nodiscard]] bool IsStreaming() const |
|
{ |
|
return file_data_ == nullptr; |
|
} |
|
#endif |
|
|
|
int DuplicateFrom(const SoundSample &other) |
|
{ |
|
#ifdef STREAM_ALL_AUDIO |
|
return SetChunkStream(other.file_path_, other.isMp3_); |
|
#else |
|
if (other.IsStreaming()) |
|
return SetChunkStream(other.file_path_, other.isMp3_); |
|
return SetChunk(other.file_data_, other.file_data_size_, other.isMp3_); |
|
#endif |
|
} |
|
|
|
/** |
|
* @brief Start playing the sound for a given number of iterations (0 means loop). |
|
*/ |
|
bool Play(int numIterations = 1); |
|
|
|
/** |
|
* @brief Start playing the sound with the given sound and user volume, and a stereo position. |
|
*/ |
|
bool PlayWithVolumeAndPan(int logSoundVolume, int logUserVolume, int logPan) |
|
{ |
|
SetVolume(logSoundVolume + logUserVolume * (ATTENUATION_MIN / VOLUME_MIN), ATTENUATION_MIN, 0); |
|
SetStereoPosition(logPan); |
|
return Play(); |
|
} |
|
|
|
/** |
|
* @brief Stop playing the sound |
|
*/ |
|
void Stop() |
|
{ |
|
stream_->stop(); |
|
} |
|
|
|
void SetVolume(int logVolume, int logMin, int logMax); |
|
void SetStereoPosition(int logPan); |
|
|
|
void Mute() |
|
{ |
|
stream_->mute(); |
|
} |
|
|
|
void Unmute() |
|
{ |
|
stream_->unmute(); |
|
} |
|
|
|
/** |
|
* @return Audio duration in ms |
|
*/ |
|
int GetLength() const; |
|
|
|
private: |
|
#ifndef STREAM_ALL_AUDIO |
|
// Non-streaming audio fields: |
|
ArraySharedPtr<std::uint8_t> file_data_; |
|
std::size_t file_data_size_; |
|
#endif |
|
|
|
// Set for streaming audio to allow for duplicating it: |
|
std::string file_path_; |
|
|
|
bool isMp3_; |
|
|
|
std::unique_ptr<Aulib::Stream> stream_; |
|
}; |
|
|
|
} // namespace devilution
|
|
|