1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
|
// SPDX-FileCopyrightText: Copyright 2022 yuzu Emulator Project
// SPDX-License-Identifier: GPL-2.0-or-later
#pragma once
#include <span>
#include "audio_core/renderer/mix/mix_info.h"
#include "audio_core/renderer/nodes/edge_matrix.h"
#include "audio_core/renderer/nodes/node_states.h"
#include "common/common_types.h"
namespace AudioCore::Renderer {
class SplitterContext;
/*
* Manages mixing states, sorting and building a node graph to describe a mix order.
*/
class MixContext {
public:
/**
* Initialize the mix context.
*
* @param sorted_mix_infos - Buffer for the sorted mix infos.
* @param mix_infos - Buffer for the mix infos.
* @param effect_process_order_buffer - Buffer for the effect process orders.
* @param effect_count - Number of effects in the buffer.
* @param node_states_workbuffer - Buffer for node states.
* @param node_buffer_size - Size of the node states buffer.
* @param edge_matrix_workbuffer - Buffer for edge matrix.
* @param edge_matrix_size - Size of the edge matrix buffer.
*/
void Initialize(std::span<MixInfo*> sorted_mix_infos, std::span<MixInfo> mix_infos, u32 count_,
std::span<s32> effect_process_order_buffer, u32 effect_count,
std::span<u8> node_states_workbuffer, u64 node_buffer_size,
std::span<u8> edge_matrix_workbuffer, u64 edge_matrix_size);
/**
* Get a sorted mix at the given index.
*
* @param index - Index of sorted mix.
* @return The sorted mix.
*/
MixInfo* GetSortedInfo(s32 index);
/**
* Set the sorted info at the given index.
*
* @param index - Index of sorted mix.
* @param mix_info - The new mix for this index.
*/
void SetSortedInfo(s32 index, MixInfo& mix_info);
/**
* Get a mix at the given index.
*
* @param index - Index of mix.
* @return The mix.
*/
MixInfo* GetInfo(s32 index);
/**
* Get the final mix.
*
* @return The final mix.
*/
MixInfo* GetFinalMixInfo();
/**
* Get the current number of mixes.
*
* @return The number of active mixes.
*/
s32 GetCount() const;
/**
* Update all of the mixes' distance from the final mix.
* Needs to be called after altering the mix graph.
*/
void UpdateDistancesFromFinalMix();
/**
* Non-splitter sort, sorts the sorted mixes based on their distance from the final mix.
*/
void SortInfo();
/**
* Re-calculate the mix buffer offsets for each mix after altering the mix.
*/
void CalcMixBufferOffset();
/**
* Splitter sort, traverse the splitter node graph and sort the sorted mixes from results.
*
* @param splitter_context - Splitter context for the sort.
* @return True if the sort was successful, otherwise false.
*/
bool TSortInfo(const SplitterContext& splitter_context);
/**
* Get the edge matrix used for the mix graph.
*
* @return The edge matrix used.
*/
EdgeMatrix& GetEdgeMatrix();
private:
/// Array of sorted mixes
std::span<MixInfo*> sorted_mix_infos{};
/// Array of mixes
std::span<MixInfo> mix_infos{};
/// Number of active mixes
s32 count{};
/// Array of effect process orderings
std::span<s32> effect_process_order_buffer{};
/// Number of effects in the process ordering buffer
u64 effect_count{};
/// Node states used in splitter sort
NodeStates node_states{};
/// Edge matrix for connected nodes used in splitter sort
EdgeMatrix edge_matrix{};
};
} // namespace AudioCore::Renderer
|