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+)

Seeds the delay line with a triangle. A string seed has its average removed, because the lumped loop would otherwise hold it as a DC offset. Position affects spectral content: 0.5 = center (warm), near 0/1 = bridge (bright).

Definition at line 303 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;
    if (len < 2)
        return;
 
    const auto pluck_sample = std::clamp(
        static_cast<size_t>(position * static_cast<double>(len)), size_t { 1 }, len - 1);
    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());
 
    std::vector<double> shape(len);
    for (size_t s = 0; s < len; ++s) {
        if (s <= pluck_sample) {
            shape[s] = effective_strength * static_cast<double>(s)
                / static_cast<double>(pluck_sample);
        } else {
            shape[s] = effective_strength * static_cast<double>(len - s)
                / static_cast<double>(len - pluck_sample);
        }
    }
 
    double offset = 0.0;
    if (seg.mode == WaveguideSegment::PropagationMode::UNIDIRECTIONAL) {
        offset = std::accumulate(shape.begin(), shape.end(), 0.0) / static_cast<double>(len);
    }
 
    for (const double value : shape) {
        seg.p_plus.push(value - offset);
    }
 
    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, offset, position, MayaFlux::Nodes::Network::WaveguideNetwork::WaveguideSegment::UNIDIRECTIONAL, and value.