apply()

bool MayaFlux::Buffers::LogicProcessor::apply	(	const std::shared_ptr< Buffer > &	buffer,
		ModulationFunction	modulation_func = nullptr
	)

Applies stored logic data to the given buffer.

Parameters

buffer	Buffer to apply logic data to
modulation_func	Optional function defining how to apply logic to audio

Returns

Whether application was successful

Use cases:

• Conditional data transformation
• Digital gating of signals
• Binary masking operations
• Custom digital signal processing chains

Definition at line 63 of file LogicProcessor.cpp.

{
    if (!buffer || !m_has_generated_data) {
        return false;
    }
 
    auto& buffer_data = std::dynamic_pointer_cast<AudioBuffer>(buffer)->get_data();
    size_t min_size = std::min(m_logic_data.size(), buffer_data.size());
 
    if (!modulation_func) {
        switch (m_modulation_type) {
        case ModulationType::REPLACE:
            modulation_func = [](double logic_val, double /*buffer_val*/) {
                return logic_val;
            };
            break;
 
        case ModulationType::MULTIPLY:
            modulation_func = [](double logic_val, double buffer_val) {
                return logic_val * buffer_val;
            };
            break;
 
        case ModulationType::ADD:
            modulation_func = [](double logic_val, double buffer_val) {
                return logic_val + buffer_val;
            };
            break;
 
        case ModulationType::INVERT_ON_TRUE:
            modulation_func = [](double logic_val, double buffer_val) {
                return logic_val > 0.5 ? -buffer_val : buffer_val;
            };
            break;
 
        case ModulationType::HOLD_ON_FALSE:
            if (min_size > 0) {
                m_last_held_value = buffer_data[0];
            }
 
            modulation_func = [this](double logic_val, double buffer_val) mutable {
                if (logic_val > 0.5) {
                    m_last_held_value = buffer_val;
                    return buffer_val;
                }
                return m_last_held_value;
            };
            break;
 
        case ModulationType::ZERO_ON_FALSE:
            modulation_func = [](double logic_val, double buffer_val) {
                return logic_val > 0.5 ? buffer_val : 0.0;
            };
            break;
 
        case ModulationType::CROSSFADE:
            modulation_func = [](double logic_val, double buffer_val) {
                return buffer_val * logic_val;
            };
            break;
 
        case ModulationType::THRESHOLD_REMAP:
            modulation_func = [this](double logic_val, double /*buffer_val*/) {
                return logic_val > 0.5 ? m_high_value : m_low_value;
            };
            break;
 
        case ModulationType::SAMPLE_AND_HOLD:
            if (min_size > 0) {
                m_last_held_value = buffer_data[0];
                m_last_logic_value = m_logic_data[0];
            }
 
            modulation_func = [this, first_sample = true](double logic_val, double buffer_val) mutable {
                if (first_sample) {
                    first_sample = false;
                    return buffer_val;
                }
 
                bool logic_changed = std::abs(logic_val - m_last_logic_value) > 0.01;
                m_last_logic_value = logic_val;
 
                if (logic_changed) {
                    m_last_held_value = buffer_val;
                }
                return m_last_held_value;
            };
            break;
 
        case ModulationType::CUSTOM:
            modulation_func = m_modulation_function;
            break;
 
        default:
            modulation_func = [](double logic_val, double /*buffer_val*/) {
                return logic_val;
            };
        }
    }
 
    for (size_t i = 0; i < min_size; ++i) {
        buffer_data[i] = modulation_func(m_logic_data[i], buffer_data[i]);
    }
 
    return true;
}

References ADD, CROSSFADE, CUSTOM, HOLD_ON_FALSE, INVERT_ON_TRUE, m_has_generated_data, m_high_value, m_last_held_value, m_last_logic_value, m_logic_data, m_low_value, m_modulation_function, m_modulation_type, MULTIPLY, REPLACE, SAMPLE_AND_HOLD, THRESHOLD_REMAP, and ZERO_ON_FALSE.

Referenced by processing_function().

Here is the caller graph for this function: