#include <OpenALSoundProvider.h>

Классы
struct	StreamingTrackBuffer

struct	TrackBuffer

Открытые члены
	OpenALSoundProvider ()

virtual	~OpenALSoundProvider ()

bool	Initialize ()

void	Release ()

void	DeleteStreamingTrack (StreamingTrackBuffer **buffer)

void	DeleteBuffer16 (TrackBuffer **buffer)

float	alBufferLength (unsigned int buffer)

StreamingTrackBuffer *	CreateStreamingTrack16 (int num_channels, int sample_rate, int bytes_per_sample)

void	Stream16 (StreamingTrackBuffer buffer, int num_samples, const void samples, bool wait=false)

TrackBuffer *	CreateTrack16 (int num_channels, int sample_rate, const void *data, size_t size)

void	PlayTrack16 (TrackBuffer *buffer, bool loop=false, bool wait=false)

void	SetListenerPosition (float x, float y, float z)

void	SetOrientation (float yaw, float pitch)

Защищенные данные
ALCdevice *	device

ALCcontext *	context

Подробное описание

См. определение в файле OpenALSoundProvider.h строка 12

Конструктор(ы)

◆ OpenALSoundProvider()

OpenALSoundProvider::OpenALSoundProvider ( )

См. определение в файле OpenALSoundProvider.cpp строка 43

                                          {
     device = nullptr;
     context = nullptr;
 }

Перекрестные ссылки context и device.

◆ ~OpenALSoundProvider()

OpenALSoundProvider::~OpenALSoundProvider ( )

virtual

См. определение в файле OpenALSoundProvider.cpp строка 48

48 { Release(); }

Перекрестные ссылки Release().

Граф вызовов:

Методы

◆ Initialize()

bool OpenALSoundProvider::Initialize ( )

См. определение в файле OpenALSoundProvider.cpp строка 50

                                      {
     const char *device_names = alcGetString(nullptr, ALC_ALL_DEVICES_SPECIFIER);
     if (!device_names) {
         device_names = alcGetString(nullptr, ALC_DEVICE_SPECIFIER);
     }
  
     if (device_names) {
         for (const char *device_name = device_names; device_name[0];
              device_name += strlen(device_name) + 1) {
             log("al: device found \"%s\"", device_name);
         }
     }
  
     const char *defname = alcGetString(0, ALC_DEFAULT_DEVICE_SPECIFIER);
  
     device = alcOpenDevice(defname);
     if (device == nullptr) {
         CheckError();
         log("al: Default sound device not present");
         return false;
     }
  
     context = alcCreateContext(device, nullptr);
     if (context == nullptr) {
         CheckError();
         Release();
         return false;
     }
  
     if (alcMakeContextCurrent(context) != ALC_TRUE) {
         CheckError();
         Release();
         return false;
     }
  
     alListener3f(AL_POSITION, 0.f, 0.f, 0.f);
     alListener3f(AL_VELOCITY, 0.f, 0.f, 0.f);
     ALfloat listenerOri[] = {0.f, 1.f, 0.f, 0.f, 0.f, -1.f};
     alListenerfv(AL_ORIENTATION, listenerOri);
  
     return true;
 }

Перекрестные ссылки alcCreateContext(), alcGetString(), alcMakeContextCurrent(), alcOpenDevice(), alListener3f(), alListenerfv(), CheckError(), context, device, log() и Release().

Используется в MPlayer::MPlayer().

Граф вызовов:

Граф вызова функции:

◆ Release()

void OpenALSoundProvider::Release ( )

См. определение в файле OpenALSoundProvider.cpp строка 106

                                   {
     alcMakeContextCurrent(nullptr);
     if (context) {
         alcDestroyContext(context);
     }
     if (device) {
         alcCloseDevice(device);
     }
 }

Перекрестные ссылки alcCloseDevice(), alcDestroyContext(), alcMakeContextCurrent(), context и device.

Используется в Initialize() и ~OpenALSoundProvider().

Граф вызовов:

Граф вызова функции:

◆ DeleteStreamingTrack()

void OpenALSoundProvider::DeleteStreamingTrack ( StreamingTrackBuffer ** buffer )

См. определение в файле OpenALSoundProvider.cpp строка 116

                                                                             {
     if (!buffer && !*buffer) return;
     auto track = *buffer;
  
     int status;
     alGetSourcei(track->source_id, AL_SOURCE_STATE, &status);
     if (status == AL_PLAYING) {
         alSourceStop(track->source_id);
         if (CheckError()) assert(false);
     }
  
     int num_processed_buffers = 0;
     int num_queued_buffers = 0;
     alGetSourcei(track->source_id, AL_BUFFERS_PROCESSED,
                  &num_processed_buffers);
     alGetSourcei(track->source_id, AL_BUFFERS_QUEUED, &num_queued_buffers);
     //  int num_track_buffers = num_queued_buffers + num_processed_buffers;
     for (int i = 0; i < num_processed_buffers; ++i) {
         unsigned int buffer_id;
         alSourceUnqueueBuffers(track->source_id, 1, &buffer_id);
         if (!CheckError()) {
             alDeleteBuffers(1, &buffer_id);
         } else {
             assert(false);
         }
     }
  
     alDeleteSources(1, &track->source_id);
     CheckError();
  
     delete *buffer;
     *buffer = nullptr;
 }

Перекрестные ссылки alDeleteBuffers(), alDeleteSources(), alGetSourcei(), alSourceStop(), alSourceUnqueueBuffers() и CheckError().

Используется в Movie::Close().

Граф вызовов:

Граф вызова функции:

◆ DeleteBuffer16()

void OpenALSoundProvider::DeleteBuffer16 ( TrackBuffer ** buffer )

См. определение в файле OpenALSoundProvider.cpp строка 150

                                                              {
     alDeleteBuffers(1, &(*buffer)->buffer_id);
     CheckError();
  
     delete *buffer;
     *buffer = nullptr;
 }

Перекрестные ссылки alDeleteBuffers() и CheckError().

Граф вызовов:

◆ alBufferLength()

float OpenALSoundProvider::alBufferLength ( unsigned int buffer )

См. определение в файле OpenALSoundProvider.cpp строка 158

                                                              {
     int size, bits, channels, freq;
  
     alGetBufferi(buffer, AL_SIZE, &size);
     alGetBufferi(buffer, AL_BITS, &bits);
     alGetBufferi(buffer, AL_CHANNELS, &channels);
     alGetBufferi(buffer, AL_FREQUENCY, &freq);
     if (CheckError()) {
         return 0.f;
     }
  
     return (ALfloat)((ALuint)size / channels / (bits / 8)) / (ALfloat)freq;
 }

Перекрестные ссылки alGetBufferi() и CheckError().

Используется в PlayTrack16().

Граф вызовов:

Граф вызова функции:

◆ CreateStreamingTrack16()

OpenALSoundProvider::StreamingTrackBuffer * OpenALSoundProvider::CreateStreamingTrack16	(	int	num_channels,
		int	sample_rate,
		int	bytes_per_sample
	)

См. определение в файле OpenALSoundProvider.cpp строка 173

                                                                   {
     Assert(bytes_per_sample == 2,
            "OpenALSoundProvider: unsupported sample size: %u",
            bytes_per_sample);
  
     ALenum sound_format;
     switch (num_channels) {
         case 1:
             sound_format = AL_FORMAT_MONO16;
             break;
         case 2:
             sound_format = AL_FORMAT_STEREO16;
             break;
         default:
             if (alIsExtensionPresent("AL_EXT_MCFORMATS")) {
                 switch (num_channels) {
                     case 4:
                         sound_format = alGetEnumValue("AL_FORMAT_QUAD16");
                         break;
                     case 6:
                         sound_format = alGetEnumValue("AL_FORMAT_51CHN16");
                         break;
                     case 7:
                         sound_format = alGetEnumValue("AL_FORMAT_61CHN16");
                         break;
                     case 8:
                         sound_format = alGetEnumValue("AL_FORMAT_71CHN16");
                         break;
                 }
             }
             Error("Unsupported number of audio channels: %u", num_channels);
     }
  
     unsigned int al_source = -1;
     alGenSources(1, &al_source);
     if (CheckError()) {
         return nullptr;
     }
  
     alSourcei(al_source, AL_LOOPING, AL_FALSE);
     alSourcef(al_source, AL_PITCH, 1.f);
     alSourcef(al_source, AL_GAIN, 1.f);
     alSource3f(al_source, AL_POSITION, 0.f, 0.f, 0.f);
     alSource3f(al_source, AL_VELOCITY, 0.f, 0.f, 0.f);
  
     StreamingTrackBuffer *ret = new StreamingTrackBuffer;
     ret->source_id = al_source;
     ret->sample_format = sound_format;
     ret->sample_rate = sample_rate;
     return ret;
 }

Перекрестные ссылки alGenSources(), alGetEnumValue(), alIsExtensionPresent(), alSource3f(), alSourcef(), alSourcei(), CheckError(), OpenALSoundProvider::StreamingTrackBuffer::sample_format, OpenALSoundProvider::StreamingTrackBuffer::sample_rate и OpenALSoundProvider::StreamingTrackBuffer::source_id.

Используется в Movie::Load().

Граф вызовов:

Граф вызова функции:

◆ Stream16()

void OpenALSoundProvider::Stream16	(	StreamingTrackBuffer *	buffer,
		int	num_samples,
		const void *	samples,
		bool	wait = `false`
	)

См. определение в файле OpenALSoundProvider.cpp строка 226

                                               {
     if (buffer == nullptr) {
         return;
     }
  
     int bytes_per_sample = 2;
  
     int num_processed_buffers = 0;
     alGetSourcei(buffer->source_id, AL_BUFFERS_PROCESSED,
                  &num_processed_buffers);
     if (num_processed_buffers > 0) {
         unsigned int *processed_buffer_ids =
             new unsigned int[num_processed_buffers];
         alSourceUnqueueBuffers(buffer->source_id, num_processed_buffers,
                                processed_buffer_ids);
         if (CheckError()) {
             log("OpenAL: Faile to get played buffers.");
         } else {
             alDeleteBuffers(num_processed_buffers, processed_buffer_ids);
             if (CheckError()) {
                 log("OpenAL: Faile to delete played buffers.");
             }
         }
         delete[] processed_buffer_ids;
     }
  
     unsigned int al_buffer;
     alGenBuffers(1, &al_buffer);
     alBufferData(al_buffer, buffer->sample_format, samples,
                  num_samples * bytes_per_sample, buffer->sample_rate);
     if (CheckError()) {
         alDeleteBuffers(1, &al_buffer);
         return;
     }
  
     alSourceQueueBuffers(buffer->source_id, 1, &al_buffer);
     if (CheckError()) {
         alDeleteBuffers(1, &al_buffer);
         return;
     }
  
     volatile int status;
     alGetSourcei(buffer->source_id, AL_SOURCE_STATE, (int *)&status);
     if (status != AL_PLAYING) {
         alSourcePlay(buffer->source_id);
         if (CheckError()) {
             assert(false);
         }
  
         if (wait) {
             do {
                 alGetSourcei(buffer->source_id, AL_SOURCE_STATE,
                              (int *)&status);
             } while (status == AL_PLAYING);
         }
     }
 }

Перекрестные ссылки alBufferData(), alDeleteBuffers(), alGenBuffers(), alGetSourcei(), alSourcePlay(), alSourceQueueBuffers(), alSourceUnqueueBuffers(), CheckError() и log().

Используется в Movie::GetFrame().

Граф вызовов:

Граф вызова функции:

◆ CreateTrack16()

OpenALSoundProvider::TrackBuffer * OpenALSoundProvider::CreateTrack16	(	int	num_channels,
		int	sample_rate,
		const void *	data,
		size_t	size
	)

См. определение в файле OpenALSoundProvider.cpp строка 286

                                                                       {
     ALenum sound_format;
     switch (num_channels) {
         case 1: {
             sound_format = AL_FORMAT_MONO16;
             break;
         }
         case 2: {
             sound_format = AL_FORMAT_STEREO16;
             break;
         }
         default: {
             if (alIsExtensionPresent("AL_EXT_MCFORMATS")) {
                 switch (num_channels) {
                     case 4:
                         sound_format = alGetEnumValue("AL_FORMAT_QUAD16");
                         break;
                     case 6:
                         sound_format = alGetEnumValue("AL_FORMAT_51CHN16");
                         break;
                     case 7:
                         sound_format = alGetEnumValue("AL_FORMAT_61CHN16");
                         break;
                     case 8:
                         sound_format = alGetEnumValue("AL_FORMAT_71CHN16");
                         break;
                 }
             }
             Error("Unsupported number of audio channels: %u", num_channels);
         }
     }
  
     ALuint al_source = -1;
     alGenSources((ALuint)1, &al_source);
     if (CheckError()) {
         return nullptr;
     }
  
     alSourcei(al_source, AL_LOOPING, AL_FALSE);
     alSourcef(al_source, AL_PITCH, 1.f);
     alSourcef(al_source, AL_GAIN, 1.f);
     alSource3f(al_source, AL_POSITION, 0.f, 0.f, 0.f);
     alSource3f(al_source, AL_VELOCITY, 0.f, 0.f, 0.f);
  
     ALuint al_buffer = -1;
     alGenBuffers(1, &al_buffer);
     if (CheckError()) {
         alDeleteSources(1, &al_source);
         return nullptr;
     }
  
     alBufferData(al_buffer, sound_format, data, size, sample_rate);
     if (CheckError()) {
         alDeleteSources(1, &al_source);
         alDeleteBuffers(1, &al_buffer);
         return nullptr;
     }
  
     alSourcei(al_source, AL_BUFFER, al_buffer);
     if (CheckError()) {
         alDeleteSources(1, &al_source);
         alDeleteBuffers(1, &al_buffer);
         return nullptr;
     }
  
     TrackBuffer *ret = new TrackBuffer;
     ret->source_id = al_source;
     ret->buffer_id = al_buffer;
     return ret;
 }

Перекрестные ссылки alBufferData(), alDeleteBuffers(), alDeleteSources(), alGenBuffers(), alGenSources(), alGetEnumValue(), alIsExtensionPresent(), alSource3f(), alSourcef(), alSourcei(), OpenALSoundProvider::TrackBuffer::buffer_id, CheckError() и OpenALSoundProvider::TrackBuffer::source_id.

Граф вызовов:

◆ PlayTrack16()

void OpenALSoundProvider::PlayTrack16	(	TrackBuffer *	buffer,
		bool	loop = `false`,
		bool	wait = `false`
	)

См. определение в файле OpenALSoundProvider.cpp строка 358

                                                  {
     int status;
     alGetSourcei(buffer->source_id, AL_SOURCE_STATE, (int *)&status);
     if (status == AL_PLAYING) {
         return;
     }
  
     alSourcei(buffer->source_id, AL_LOOPING, loop ? AL_TRUE : AL_FALSE);
     alSourcePlay(buffer->source_id);
     if (CheckError()) {
         assert(false);
     }
  
     if (wait && !loop) {
         float track_length = alBufferLength(buffer->buffer_id);
         do {
             float track_offset = 0;
             alGetSourcef(buffer->source_id, AL_SEC_OFFSET, &track_offset);
             log("playing: %.4f/%.4f\n", track_offset, track_length);
  
             alGetSourcei(buffer->source_id, AL_SOURCE_STATE, (int *)&status);
         } while (status == AL_PLAYING);
     }
 }

Перекрестные ссылки alBufferLength(), alGetSourcef(), alGetSourcei(), alSourcei(), alSourcePlay(), CheckError() и log().

Граф вызовов:

◆ SetListenerPosition()

void OpenALSoundProvider::SetListenerPosition	(	float	x,
		float	y,
		float	z
	)

См. определение в файле OpenALSoundProvider.cpp строка 93

                                                                        {
     alListener3f(AL_POSITION, x, y, z);
 }

Перекрестные ссылки alListener3f().

Используется в AudioPlayer::PlaySound() и AudioPlayer::UpdateSounds().

Граф вызовов:

Граф вызова функции:

◆ SetOrientation()

void OpenALSoundProvider::SetOrientation	(	float	yaw,
		float	pitch
	)

См. определение в файле OpenALSoundProvider.cpp строка 97

                                                                {
     float x = cos(pitch) * cos(yaw);
     float y = sin(yaw) * cos(pitch);
     float z = -sin(pitch);
  
     ALfloat listenerOri[] = {-x, y, z, 0.f, 0.f, 1.f};
     alListenerfv(AL_ORIENTATION, listenerOri);
 }

Перекрестные ссылки alListenerfv().

Используется в AudioPlayer::UpdateSounds().

Граф вызовов:

Граф вызова функции:

Данные класса

◆ device

ALCdevice* OpenALSoundProvider::device

protected

См. определение в файле OpenALSoundProvider.h строка 46

Используется в Initialize(), OpenALSoundProvider() и Release().

◆ context

ALCcontext* OpenALSoundProvider::context

protected

См. определение в файле OpenALSoundProvider.h строка 47

Используется в Initialize(), OpenALSoundProvider() и Release().

Объявления и описания членов классов находятся в файлах:

C:/git/world-of-might-and-magic/Media/Audio/OpenALSoundProvider.h
C:/git/world-of-might-and-magic/Media/Audio/OpenALSoundProvider.cpp

Классы

Открытые члены

Защищенные данные

Подробное описание

Конструктор(ы)

◆ OpenALSoundProvider()

◆ ~OpenALSoundProvider()

Методы

◆ Initialize()

◆ Release()

◆ DeleteStreamingTrack()

◆ DeleteBuffer16()

◆ alBufferLength()

◆ CreateStreamingTrack16()

◆ Stream16()

◆ CreateTrack16()

◆ PlayTrack16()

◆ SetListenerPosition()

◆ SetOrientation()

Данные класса

◆ device

◆ context