yuzu-emu
/
yuzu
Archived
1
0
Fork 0
Code

audio: rewrite IAudioDevice

This commit is contained in:
Liam 2024-02-20 21:17:59 -05:00
parent ea4703cb31
commit c575a85233
8 changed files with 128 additions and 127 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
src/audio_core/renderer/audio_device.cpp
View File

@ -36,8 +36,7 @@ AudioDevice::AudioDevice(Core::System& system, const u64 applet_resource_user_id
: output_sink{system.AudioCore().GetOutputSink()}, : output_sink{system.AudioCore().GetOutputSink()},
applet_resource_user_id{applet_resource_user_id_}, user_revision{revision} {} applet_resource_user_id{applet_resource_user_id_}, user_revision{revision} {}
u32 AudioDevice::ListAudioDeviceName(std::vector<AudioDeviceName>& out_buffer, u32 AudioDevice::ListAudioDeviceName(std::span<AudioDeviceName> out_buffer) const {
const size_t max_count) const {
std::span<const AudioDeviceName> names{}; std::span<const AudioDeviceName> names{};
if (CheckFeatureSupported(SupportTags::AudioUsbDeviceOutput, user_revision)) { if (CheckFeatureSupported(SupportTags::AudioUsbDeviceOutput, user_revision)) {
@ -46,19 +45,18 @@ u32 AudioDevice::ListAudioDeviceName(std::vector<AudioDeviceName>& out_buffer,
names = device_names; names = device_names;
} }
const u32 out_count{static_cast<u32>(std::min(max_count, names.size()))}; const u32 out_count{static_cast<u32>(std::min(out_buffer.size(), names.size()))};
for (u32 i = 0; i < out_count; i++) { for (u32 i = 0; i < out_count; i++) {
out_buffer.push_back(names[i]); out_buffer[i] = names[i];
} }
return out_count; return out_count;
} }
u32 AudioDevice::ListAudioOutputDeviceName(std::vector<AudioDeviceName>& out_buffer, u32 AudioDevice::ListAudioOutputDeviceName(std::span<AudioDeviceName> out_buffer) const {
const size_t max_count) const { const u32 out_count{static_cast<u32>(std::min(out_buffer.size(), output_device_names.size()))};
const u32 out_count{static_cast<u32>(std::min(max_count, output_device_names.size()))};
for (u32 i = 0; i < out_count; i++) { for (u32 i = 0; i < out_count; i++) {
out_buffer.push_back(output_device_names[i]); out_buffer[i] = output_device_names[i];
} }
return out_count; return out_count;
} }

6
src/audio_core/renderer/audio_device.h
View File

@ -36,20 +36,18 @@ public:
* Get a list of the available output devices. * Get a list of the available output devices.
* *
* @param out_buffer - Output buffer to write the available device names. * @param out_buffer - Output buffer to write the available device names.
* @param max_count - Maximum number of devices to write (count of out_buffer).
* @return Number of device names written. * @return Number of device names written.
*/ */
u32 ListAudioDeviceName(std::vector<AudioDeviceName>& out_buffer, size_t max_count) const; u32 ListAudioDeviceName(std::span<AudioDeviceName> out_buffer) const;
/** /**
* Get a list of the available output devices. * Get a list of the available output devices.
* Different to above somehow... * Different to above somehow...
* *
* @param out_buffer - Output buffer to write the available device names. * @param out_buffer - Output buffer to write the available device names.
* @param max_count - Maximum number of devices to write (count of out_buffer).
* @return Number of device names written. * @return Number of device names written.
*/ */
u32 ListAudioOutputDeviceName(std::vector<AudioDeviceName>& out_buffer, size_t max_count) const; u32 ListAudioOutputDeviceName(std::span<AudioDeviceName> out_buffer) const;
/** /**
* Set the volume of all streams in the backend sink. * Set the volume of all streams in the backend sink.

4
src/common/string_util.cpp
View File

@ -38,6 +38,10 @@ std::string StringFromBuffer(std::span<const u8> data) {
return std::string(data.begin(), std::find(data.begin(), data.end(), '\0')); return std::string(data.begin(), std::find(data.begin(), data.end(), '\0'));
} }
std::string StringFromBuffer(std::span<const char> data) {
return std::string(data.begin(), std::find(data.begin(), data.end(), '\0'));
}
// Turns " hej " into "hej". Also handles tabs. // Turns " hej " into "hej". Also handles tabs.
std::string StripSpaces(const std::string& str) { std::string StripSpaces(const std::string& str) {
const std::size_t s = str.find_first_not_of(" \t\r\n"); const std::size_t s = str.find_first_not_of(" \t\r\n");

1
src/common/string_util.h
View File

@ -19,6 +19,7 @@ namespace Common {
[[nodiscard]] std::string ToUpper(std::string str); [[nodiscard]] std::string ToUpper(std::string str);
[[nodiscard]] std::string StringFromBuffer(std::span<const u8> data); [[nodiscard]] std::string StringFromBuffer(std::span<const u8> data);
[[nodiscard]] std::string StringFromBuffer(std::span<const char> data);
[[nodiscard]] std::string StripSpaces(const std::string& s); [[nodiscard]] std::string StripSpaces(const std::string& s);
[[nodiscard]] std::string StripQuotes(const std::string& s); [[nodiscard]] std::string StripQuotes(const std::string& s);

182
src/core/hle/service/audio/audio_device.cpp
View File

@ -4,7 +4,7 @@
#include "audio_core/audio_core.h" #include "audio_core/audio_core.h"
#include "common/string_util.h" #include "common/string_util.h"
#include "core/hle/service/audio/audio_device.h" #include "core/hle/service/audio/audio_device.h"
#include "core/hle/service/ipc_helpers.h" #include "core/hle/service/cmif_serialization.h"
namespace Service::Audio { namespace Service::Audio {
using namespace AudioCore::Renderer; using namespace AudioCore::Renderer;
@ -15,20 +15,20 @@ IAudioDevice::IAudioDevice(Core::System& system_, u64 applet_resource_user_id, u
impl{std::make_unique<AudioDevice>(system_, applet_resource_user_id, revision)}, impl{std::make_unique<AudioDevice>(system_, applet_resource_user_id, revision)},
event{service_context.CreateEvent(fmt::format("IAudioDeviceEvent-{}", device_num))} { event{service_context.CreateEvent(fmt::format("IAudioDeviceEvent-{}", device_num))} {
static const FunctionInfo functions[] = { static const FunctionInfo functions[] = {
{0, &IAudioDevice::ListAudioDeviceName, "ListAudioDeviceName"}, {0, D<&IAudioDevice::ListAudioDeviceName>, "ListAudioDeviceName"},
{1, &IAudioDevice::SetAudioDeviceOutputVolume, "SetAudioDeviceOutputVolume"}, {1, D<&IAudioDevice::SetAudioDeviceOutputVolume>, "SetAudioDeviceOutputVolume"},
{2, &IAudioDevice::GetAudioDeviceOutputVolume, "GetAudioDeviceOutputVolume"}, {2, D<&IAudioDevice::GetAudioDeviceOutputVolume>, "GetAudioDeviceOutputVolume"},
{3, &IAudioDevice::GetActiveAudioDeviceName, "GetActiveAudioDeviceName"}, {3, D<&IAudioDevice::GetActiveAudioDeviceName>, "GetActiveAudioDeviceName"},
{4, &IAudioDevice::QueryAudioDeviceSystemEvent, "QueryAudioDeviceSystemEvent"}, {4, D<&IAudioDevice::QueryAudioDeviceSystemEvent>, "QueryAudioDeviceSystemEvent"},
{5, &IAudioDevice::GetActiveChannelCount, "GetActiveChannelCount"}, {5, D<&IAudioDevice::GetActiveChannelCount>, "GetActiveChannelCount"},
{6, &IAudioDevice::ListAudioDeviceName, "ListAudioDeviceNameAuto"}, {6, D<&IAudioDevice::ListAudioDeviceNameAuto>, "ListAudioDeviceNameAuto"},
{7, &IAudioDevice::SetAudioDeviceOutputVolume, "SetAudioDeviceOutputVolumeAuto"}, {7, D<&IAudioDevice::SetAudioDeviceOutputVolumeAuto>, "SetAudioDeviceOutputVolumeAuto"},
{8, &IAudioDevice::GetAudioDeviceOutputVolume, "GetAudioDeviceOutputVolumeAuto"}, {8, D<&IAudioDevice::GetAudioDeviceOutputVolumeAuto>, "GetAudioDeviceOutputVolumeAuto"},
{10, &IAudioDevice::GetActiveAudioDeviceName, "GetActiveAudioDeviceNameAuto"}, {10, D<&IAudioDevice::GetActiveAudioDeviceNameAuto>, "GetActiveAudioDeviceNameAuto"},
{11, &IAudioDevice::QueryAudioDeviceInputEvent, "QueryAudioDeviceInputEvent"}, {11, D<&IAudioDevice::QueryAudioDeviceInputEvent>, "QueryAudioDeviceInputEvent"},
{12, &IAudioDevice::QueryAudioDeviceOutputEvent, "QueryAudioDeviceOutputEvent"}, {12, D<&IAudioDevice::QueryAudioDeviceOutputEvent>, "QueryAudioDeviceOutputEvent"},
{13, &IAudioDevice::GetActiveAudioDeviceName, "GetActiveAudioOutputDeviceName"}, {13, D<&IAudioDevice::GetActiveAudioDeviceName>, "GetActiveAudioOutputDeviceName"},
{14, &IAudioDevice::ListAudioOutputDeviceName, "ListAudioOutputDeviceName"}, {14, D<&IAudioDevice::ListAudioOutputDeviceName>, "ListAudioOutputDeviceName"},
}; };
RegisterHandlers(functions); RegisterHandlers(functions);
@ -39,15 +39,33 @@ IAudioDevice::~IAudioDevice() {
service_context.CloseEvent(event); service_context.CloseEvent(event);
} }
void IAudioDevice::ListAudioDeviceName(HLERequestContext& ctx) { Result IAudioDevice::ListAudioDeviceName(
const size_t in_count = ctx.GetWriteBufferNumElements<AudioDevice::AudioDeviceName>(); OutArray<AudioDevice::AudioDeviceName, BufferAttr_HipcMapAlias> out_names, Out<s32> out_count) {
R_RETURN(this->ListAudioDeviceNameAuto(out_names, out_count));
}
std::vector<AudioDevice::AudioDeviceName> out_names{}; Result IAudioDevice::SetAudioDeviceOutputVolume(
InArray<AudioDevice::AudioDeviceName, BufferAttr_HipcMapAlias> name, f32 volume) {
R_RETURN(this->SetAudioDeviceOutputVolumeAuto(name, volume));
}
const u32 out_count = impl->ListAudioDeviceName(out_names, in_count); Result IAudioDevice::GetAudioDeviceOutputVolume(
Out<f32> out_volume, InArray<AudioDevice::AudioDeviceName, BufferAttr_HipcMapAlias> name) {
R_RETURN(this->GetAudioDeviceOutputVolumeAuto(out_volume, name));
}
Result IAudioDevice::GetActiveAudioDeviceName(
OutArray<AudioDevice::AudioDeviceName, BufferAttr_HipcMapAlias> out_name) {
R_RETURN(this->GetActiveAudioDeviceNameAuto(out_name));
}
Result IAudioDevice::ListAudioDeviceNameAuto(
OutArray<AudioDevice::AudioDeviceName, BufferAttr_HipcAutoSelect> out_names,
Out<s32> out_count) {
*out_count = impl->ListAudioDeviceName(out_names);
std::string out{}; std::string out{};
for (u32 i = 0; i < out_count; i++) { for (s32 i = 0; i < *out_count; i++) {
std::string a{}; std::string a{};
u32 j = 0; u32 j = 0;
while (out_names[i].name[j] != '\0') { while (out_names[i].name[j] != '\0') {
@ -58,109 +76,77 @@ void IAudioDevice::ListAudioDeviceName(HLERequestContext& ctx) {
} }
LOG_DEBUG(Service_Audio, "called.\nNames={}", out); LOG_DEBUG(Service_Audio, "called.\nNames={}", out);
R_SUCCEED();
IPC::ResponseBuilder rb{ctx, 3};
ctx.WriteBuffer(out_names);
rb.Push(ResultSuccess);
rb.Push(out_count);
} }
void IAudioDevice::SetAudioDeviceOutputVolume(HLERequestContext& ctx) { Result IAudioDevice::SetAudioDeviceOutputVolumeAuto(
IPC::RequestParser rp{ctx}; InArray<AudioDevice::AudioDeviceName, BufferAttr_HipcAutoSelect> name, f32 volume) {
const f32 volume = rp.Pop<f32>(); R_UNLESS(!name.empty(), Audio::ResultInsufficientBuffer);
const auto device_name_buffer = ctx.ReadBuffer(); const std::string device_name = Common::StringFromBuffer(name[0].name);
const std::string name = Common::StringFromBuffer(device_name_buffer); LOG_DEBUG(Service_Audio, "called. name={}, volume={}", device_name, volume);
LOG_DEBUG(Service_Audio, "called. name={}, volume={}", name, volume); if (device_name == "AudioTvOutput") {
if (name == "AudioTvOutput") {
impl->SetDeviceVolumes(volume); impl->SetDeviceVolumes(volume);
} }
IPC::ResponseBuilder rb{ctx, 2}; R_SUCCEED();
rb.Push(ResultSuccess);
} }
void IAudioDevice::GetAudioDeviceOutputVolume(HLERequestContext& ctx) { Result IAudioDevice::GetAudioDeviceOutputVolumeAuto(
const auto device_name_buffer = ctx.ReadBuffer(); Out<f32> out_volume, InArray<AudioDevice::AudioDeviceName, BufferAttr_HipcAutoSelect> name) {
const std::string name = Common::StringFromBuffer(device_name_buffer); R_UNLESS(!name.empty(), Audio::ResultInsufficientBuffer);
LOG_DEBUG(Service_Audio, "called. Name={}", name); const std::string device_name = Common::StringFromBuffer(name[0].name);
LOG_DEBUG(Service_Audio, "called. Name={}", device_name);
f32 volume{1.0f}; *out_volume = 1.0f;
if (name == "AudioTvOutput") { if (device_name == "AudioTvOutput") {
volume = impl->GetDeviceVolume(name); *out_volume = impl->GetDeviceVolume(device_name);
} }
IPC::ResponseBuilder rb{ctx, 3}; R_SUCCEED();
rb.Push(ResultSuccess);
rb.Push(volume);
} }
void IAudioDevice::GetActiveAudioDeviceName(HLERequestContext& ctx) { Result IAudioDevice::GetActiveAudioDeviceNameAuto(
const auto write_size = ctx.GetWriteBufferSize(); OutArray<AudioDevice::AudioDeviceName, BufferAttr_HipcAutoSelect> out_name) {
std::string out_name{"AudioTvOutput"}; R_UNLESS(!out_name.empty(), Audio::ResultInsufficientBuffer);
out_name[0] = AudioDevice::AudioDeviceName("AudioTvOutput");
LOG_DEBUG(Service_Audio, "(STUBBED) called. Name={}", out_name);
out_name.resize(write_size);
ctx.WriteBuffer(out_name);
IPC::ResponseBuilder rb{ctx, 2};
rb.Push(ResultSuccess);
}
void IAudioDevice::QueryAudioDeviceSystemEvent(HLERequestContext& ctx) {
LOG_DEBUG(Service_Audio, "(STUBBED) called"); LOG_DEBUG(Service_Audio, "(STUBBED) called");
R_SUCCEED();
}
Result IAudioDevice::QueryAudioDeviceSystemEvent(OutCopyHandle<Kernel::KReadableEvent> out_event) {
LOG_DEBUG(Service_Audio, "(STUBBED) called");
event->Signal(); event->Signal();
*out_event = &event->GetReadableEvent();
IPC::ResponseBuilder rb{ctx, 2, 1}; R_SUCCEED();
rb.Push(ResultSuccess);
rb.PushCopyObjects(event->GetReadableEvent());
} }
void IAudioDevice::GetActiveChannelCount(HLERequestContext& ctx) { Result IAudioDevice::QueryAudioDeviceInputEvent(OutCopyHandle<Kernel::KReadableEvent> out_event) {
const auto& sink{system.AudioCore().GetOutputSink()};
u32 channel_count{sink.GetSystemChannels()};
LOG_DEBUG(Service_Audio, "(STUBBED) called. Channels={}", channel_count);
IPC::ResponseBuilder rb{ctx, 3};
rb.Push(ResultSuccess);
rb.Push<u32>(channel_count);
}
void IAudioDevice::QueryAudioDeviceInputEvent(HLERequestContext& ctx) {
LOG_DEBUG(Service_Audio, "(STUBBED) called"); LOG_DEBUG(Service_Audio, "(STUBBED) called");
*out_event = &event->GetReadableEvent();
IPC::ResponseBuilder rb{ctx, 2, 1}; R_SUCCEED();
rb.Push(ResultSuccess);
rb.PushCopyObjects(event->GetReadableEvent());
} }
void IAudioDevice::QueryAudioDeviceOutputEvent(HLERequestContext& ctx) { Result IAudioDevice::QueryAudioDeviceOutputEvent(OutCopyHandle<Kernel::KReadableEvent> out_event) {
LOG_DEBUG(Service_Audio, "called"); LOG_DEBUG(Service_Audio, "called");
*out_event = &event->GetReadableEvent();
IPC::ResponseBuilder rb{ctx, 2, 1}; R_SUCCEED();
rb.Push(ResultSuccess);
rb.PushCopyObjects(event->GetReadableEvent());
} }
void IAudioDevice::ListAudioOutputDeviceName(HLERequestContext& ctx) { Result IAudioDevice::GetActiveChannelCount(Out<u32> out_active_channel_count) {
const size_t in_count = ctx.GetWriteBufferNumElements<AudioDevice::AudioDeviceName>(); *out_active_channel_count = system.AudioCore().GetOutputSink().GetSystemChannels();
LOG_DEBUG(Service_Audio, "(STUBBED) called. Channels={}", *out_active_channel_count);
R_SUCCEED();
}
std::vector<AudioDevice::AudioDeviceName> out_names{}; Result IAudioDevice::ListAudioOutputDeviceName(
OutArray<AudioDevice::AudioDeviceName, BufferAttr_HipcMapAlias> out_names, Out<s32> out_count) {
const u32 out_count = impl->ListAudioOutputDeviceName(out_names, in_count); *out_count = impl->ListAudioOutputDeviceName(out_names);
std::string out{}; std::string out{};
for (u32 i = 0; i < out_count; i++) { for (s32 i = 0; i < *out_count; i++) {
std::string a{}; std::string a{};
u32 j = 0; u32 j = 0;
while (out_names[i].name[j] != '\0') { while (out_names[i].name[j] != '\0') {
@ -171,13 +157,7 @@ void IAudioDevice::ListAudioOutputDeviceName(HLERequestContext& ctx) {
} }
LOG_DEBUG(Service_Audio, "called.\nNames={}", out); LOG_DEBUG(Service_Audio, "called.\nNames={}", out);
R_SUCCEED();
IPC::ResponseBuilder rb{ctx, 3};
ctx.WriteBuffer(out_names);
rb.Push(ResultSuccess);
rb.Push(out_count);
} }
} // namespace Service::Audio } // namespace Service::Audio

41
src/core/hle/service/audio/audio_device.h
View File

@ -4,11 +4,18 @@
#pragma once #pragma once
#include "audio_core/renderer/audio_device.h" #include "audio_core/renderer/audio_device.h"
#include "core/hle/service/cmif_types.h"
#include "core/hle/service/kernel_helpers.h" #include "core/hle/service/kernel_helpers.h"
#include "core/hle/service/service.h" #include "core/hle/service/service.h"
namespace Kernel {
class KReadableEvent;
}
namespace Service::Audio { namespace Service::Audio {
using AudioCore::Renderer::AudioDevice;
class IAudioDevice final : public ServiceFramework<IAudioDevice> { class IAudioDevice final : public ServiceFramework<IAudioDevice> {
public: public:
@ -17,15 +24,31 @@ public:
~IAudioDevice() override; ~IAudioDevice() override;
private: private:
void ListAudioDeviceName(HLERequestContext& ctx); Result ListAudioDeviceName(
void SetAudioDeviceOutputVolume(HLERequestContext& ctx); OutArray<AudioDevice::AudioDeviceName, BufferAttr_HipcMapAlias> out_names,
void GetAudioDeviceOutputVolume(HLERequestContext& ctx); Out<s32> out_count);
void GetActiveAudioDeviceName(HLERequestContext& ctx); Result SetAudioDeviceOutputVolume(
void QueryAudioDeviceSystemEvent(HLERequestContext& ctx); InArray<AudioDevice::AudioDeviceName, BufferAttr_HipcMapAlias> name, f32 volume);
void GetActiveChannelCount(HLERequestContext& ctx); Result GetAudioDeviceOutputVolume(
void QueryAudioDeviceInputEvent(HLERequestContext& ctx); Out<f32> out_volume, InArray<AudioDevice::AudioDeviceName, BufferAttr_HipcMapAlias> name);
void QueryAudioDeviceOutputEvent(HLERequestContext& ctx); Result GetActiveAudioDeviceName(
void ListAudioOutputDeviceName(HLERequestContext& ctx); OutArray<AudioDevice::AudioDeviceName, BufferAttr_HipcMapAlias> out_name);
Result ListAudioDeviceNameAuto(
OutArray<AudioDevice::AudioDeviceName, BufferAttr_HipcAutoSelect> out_names,
Out<s32> out_count);
Result SetAudioDeviceOutputVolumeAuto(
InArray<AudioDevice::AudioDeviceName, BufferAttr_HipcAutoSelect> name, f32 volume);
Result GetAudioDeviceOutputVolumeAuto(
Out<f32> out_volume, InArray<AudioDevice::AudioDeviceName, BufferAttr_HipcAutoSelect> name);
Result GetActiveAudioDeviceNameAuto(
OutArray<AudioDevice::AudioDeviceName, BufferAttr_HipcAutoSelect> out_name);
Result QueryAudioDeviceSystemEvent(OutCopyHandle<Kernel::KReadableEvent> out_event);
Result QueryAudioDeviceInputEvent(OutCopyHandle<Kernel::KReadableEvent> out_event);
Result QueryAudioDeviceOutputEvent(OutCopyHandle<Kernel::KReadableEvent> out_event);
Result GetActiveChannelCount(Out<u32> out_active_channel_count);
Result ListAudioOutputDeviceName(
OutArray<AudioDevice::AudioDeviceName, BufferAttr_HipcMapAlias> out_names,
Out<s32> out_count);
KernelHelpers::ServiceContext service_context; KernelHelpers::ServiceContext service_context;
std::unique_ptr<AudioCore::Renderer::AudioDevice> impl; std::unique_ptr<AudioCore::Renderer::AudioDevice> impl;

3
src/core/hle/service/audio/audio_in_manager.cpp
View File

@ -96,8 +96,7 @@ Result IAudioInManager::OpenAudioInProtocolSpecified(
LOG_DEBUG(Service_Audio, "Opening new AudioIn, session_id={}, free sessions={}", new_session_id, LOG_DEBUG(Service_Audio, "Opening new AudioIn, session_id={}, free sessions={}", new_session_id,
impl->num_free_sessions); impl->num_free_sessions);
const auto name_buffer = std::span(reinterpret_cast<const u8*>(name[0].name.data()), 0x100); const auto device_name = Common::StringFromBuffer(name[0].name);
const auto device_name = Common::StringFromBuffer(name_buffer);
*out_audio_in = std::make_shared<IAudioIn>(system, *impl, new_session_id, device_name, *out_audio_in = std::make_shared<IAudioIn>(system, *impl, new_session_id, device_name,
parameter, process_handle.Get(), aruid.pid); parameter, process_handle.Get(), aruid.pid);
impl->sessions[new_session_id] = (*out_audio_in)->GetImpl(); impl->sessions[new_session_id] = (*out_audio_in)->GetImpl();

4
src/core/hle/service/audio/audio_out_manager.cpp
View File

@ -75,9 +75,7 @@ Result IAudioOutManager::OpenAudioOutAuto(
R_TRY(impl->LinkToManager()); R_TRY(impl->LinkToManager());
R_TRY(impl->AcquireSessionId(new_session_id)); R_TRY(impl->AcquireSessionId(new_session_id));
const auto name_buffer = std::span(reinterpret_cast<const u8*>(name[0].name.data()), 0x100); const auto device_name = Common::StringFromBuffer(name[0].name);
const auto device_name = Common::StringFromBuffer(name_buffer);
LOG_DEBUG(Service_Audio, "Opening new AudioOut, sessionid={}, free sessions={}", new_session_id, LOG_DEBUG(Service_Audio, "Opening new AudioOut, sessionid={}, free sessions={}", new_session_id,
impl->num_free_sessions); impl->num_free_sessions);