pluck()

void MayaFlux::Nodes::Network::WaveguideNetwork::pluck	(	double	position = 0.5,
		double	strength = 1.0
	)

Pluck the string at a normalized position.

Parameters

position	Normalized position along string (0.0 to 1.0)
strength	Excitation amplitude (0.0 to 1.0+)

Fills the delay line with a shaped noise burst. Position affects spectral content: 0.5 = center (warm), near 0/1 = bridge (bright).

Definition at line 226 of file WaveguideNetwork.cpp.

{
    position = std::clamp(position, 0.01, 0.99);
 
    if (m_segments.empty())
        return;
 
    auto& seg = m_segments[0];
    const size_t len = m_delay_length_integer;
    const auto pluck_sample = static_cast<size_t>(position * static_cast<double>(len));
    const double effective_strength = (m_exciter_type == ExciterType::CONTINUOUS)
        ? std::max(strength, 1.0)
        : strength;
 
    seg.p_plus = Memory::HistoryBuffer<double>(seg.p_plus.capacity());
    seg.p_minus = Memory::HistoryBuffer<double>(seg.p_minus.capacity());
 
    for (size_t s = 0; s < len; ++s) {
        double value = 0.0;
        if (s <= pluck_sample) {
            value = effective_strength * static_cast<double>(s)
                / static_cast<double>(pluck_sample);
        } else {
            value = effective_strength * static_cast<double>(len - s)
                / static_cast<double>(len - pluck_sample);
        }
        seg.p_plus.push(value);
    }
 
    if (m_exciter_type != ExciterType::CONTINUOUS) {
        m_exciter_active = false;
        m_exciter_samples_remaining = 0;
    }
}

References CONTINUOUS, m_delay_length_integer, m_exciter_active, m_exciter_samples_remaining, m_exciter_type, m_segments, and value.