Lib.rs

总的来说，new函数提供了一种方便的方法来创建Surge超级振荡器的新实例，具有默认设置和关键系统资源的句柄。通过提供灵活且易于使用的初始化过程，Surge超级振荡器能够为广泛的音乐制作应用提供高级合成功能和高质量输出信号。

29> /file surge-rs/surgeosc-super/src/params.rs

当然，我很乐意帮忙。

SurgeSuperOscillator是更大的Surge合成系统的一个强大组件，可以描述为一个高度参数化、高质量的采样保持振荡器。该振荡器旨在以高精度和灵活性产生复杂波形，对于任何音乐家或声音设计师来说都是一种宝贵工具。

要开始使用SurgeSuperOscillator，您需要使用init函数对其进行初始化。此函数设置振荡器的初始状态，包括其参数和缓冲区。一旦振荡器初始化完成，您就可以使用new函数创建其新实例。

SurgeSuperOscillator 具有高度参数化，具有广泛的参数可以用来调整其行为。这些参数包括 Shape、Width、SubWidth、SubLevel、SyncPitch、UniSpread、UniCount 和 Character。每个参数都有一个默认值、最小和最大值，以及一个值类型，这决定了可以用来调整它的数据类型。可以使用 set_param() 函数设置振荡器的参数。

振荡器还可以进行调制，这意味着可以使用调制源（如LFO和包络）动态调整其参数。函数 moverate() 确定每个参数可以调制的速率。

SurgeSuperOscillator 是一个复杂的算法，涉及许多数学计算，包括卷积和冲激响应。这些计算针对高性能和低延迟进行了优化，使振荡器能够实时产生复杂的波形。

总之，SurgeSuperOscillator 是一个高度参数化、高质量的样本和保持振荡器，旨在以高精度和灵活性产生复杂的波形。其众多参数和可调性使其成为音乐家和声音设计师的强大工具，其优化的算法确保了低延迟和高性能。

30> /file surge-rs/surgeosc-super/src/set.rs

SurgeSuperOscillator 有几个函数用于设置其属性。

get_character() 函数返回振荡器的当前 CharacterMode。

set_rate_all(rate: f32) 函数设置振荡器中多个滞后处理器的速率，包括 l_pw、l_pw2、l_shape、l_sub 和 l_sync。

clear_tracking() 函数将 last_level 和 elapsed_time 数组的值设置为零。

set_coeff_by_character(mode: CharacterMode) 函数根据振荡器的当前 CharacterMode 设置滤波器系数。滤波器系数决定了振荡器输出的色彩，不同的模式产生更温暖、中性或明亮的音色。该函数根据当前采样率计算滤波器系数，并将它们设置为 coeff_b0、coeff_b1 和 coeff_a1 变量。

31> /file surge-rs/surgeosc-super/src/set_pitch.rs

set_pitch 方法用于在赫兹中设置 SurgeSuperOscillator 的音高。它接受两个参数：pitch，它是赫兹中的目标音高，以及一个布尔标志 is_display，它确定音高是否用于显示目的。

如果 is_display 为 true，则该方法将 n_unison 参数设置为 1，表示只有一个振荡器。否则，它将 n_unison 参数设置为由 UniCount 参数指定的值，该参数确定要使用的振荡器数量。

该方法使用update_lagvals函数更新滞后值，该函数根据当前音高值计算滞后值。然后，它遍历每个振荡器，并根据Retrigger参数和is_display标志设置其状态。如果Retrigger为true或is_display为true，则重置振荡器的状态并将last_level值设置为-0.4。否则，根据UniSpread参数和随机值计算失谐值，并根据此值设置振荡器的状态。

该方法还为每个振荡器重置了其他几个参数，包括dc_uni、state、pwidth、driftlfo和driftlfo2。

32> /file surge-rs/surgeosc-super/src/sso.rs

SurgeSuperOscillator是一种振荡器类型，通过组合多个更简单的波形来生成复杂的波形，使用各种参数来塑造和调制生成的声音。振荡器使用blitter技术生成其输出，这是一种生成带限波形的技巧。SSOParamArrayRT类型用于存储和管理振荡器的参数，这些参数可以实时调制。

振荡器具有设置和控制其行为的许多属性和方法。例如，它有一个set_pitch方法来设置其音高，一个set_rate_all方法来设置所有内部调制器的速率，以及一个clear_tracking方法来重置其跟踪值。它还具有控制其声音生成各种方面的属性，如漂移、FM深度和波形形状。

振荡器通过结合Rust代码和内联汇编（使用inline_asm!宏）来实现，这允许它在保持跨平台可移植性的同时实现高性能。代码使用各种优化技术，如循环展开和SIMD指令，以进一步提高性能。

33> /file surge-rs/surgeosc-super/src/update_lagvals.rs

此代码为SurgeSuperOscillator结构定义了update_lagvals函数的实现。

update_lagvals函数更新振荡器使用的几个内部Lag对象的价值。这些对象模拟低通滤波器，以平滑各种振荡器参数（如Width和Shape）的变化。

函数首先使用macro_rules语法定义的宏从self.params数组中检索这些参数的值。该宏简单地返回指定参数的值。

接下来，函数使用每个Lag对象的新值方法，使用new_value方法更新sync、pw、pw2、shape和sub的新值。limit_range函数用于确保这些参数的值在有效范围内。

该函数随后使用存储在 self.tuner 的 TunerHandle 对象的 n2p_tuningctr 方法来计算音高乘数 pp。该方法将 MIDI 音符编号转换为频率比率。此频率比率添加到 sync 参数，并使用 n2p_tuningctr 方法转换回音高乘数。

该函数计算振荡器的采样率倒数乘以 4 并将其存储在 invt 变量中。

最后，该函数通过取 SSO_INTEGRATOR_HPF 常数和 SSO_HPF_CYCLE_LOSS 的 invt 次幂的最小值来计算由存储在 self.li_hpf 的 LiPolPs 对象使用的高通滤波器的值。此值传递给 LiPolPs 对象的 set_target 方法以更新其内部状态。

如果 is_init 为 true，则该函数调用每个 Lag 和 LiPolPs 对象的 instantize 方法来重置其内部状态。

34> /file surge-rs/surgeosc-super/src/process/process.rs

此代码定义了 process_block 函数，用于 SurgeSuperOscillator 类型，该函数实现了 OscillatorProcess 特性。此函数用于生成振荡器的音频样本块。

在函数开始时，根据传递给参数的配置设置振荡器的 pitch 和 drift 字段。然后根据 pitch 字段设置 blitter.pitchmult_inv 和 blitter.pitchmult 字段，并调用 update_lagvals 函数根据当前参数值更新内部滞后处理器。

接下来，根据是否启用频率调制，调用 process_block_fm 或 process_block_nofm 函数。这些函数根据当前的振荡器参数生成音频样本块并将它们写入振荡器的 blitter 缓冲区。

在生成音频样本后，使用 li_hpf LipolPs 处理器对该块应用高通滤波器。然后，将高通滤波器的输出乘以当前的音高衰减和直流偏移衰减系数。

最后，将生成的音频样本存储在振荡器的 blitter 缓冲区中，并更新缓冲区位置以准备下一个块。

35> /file surge-rs/surgeosc-super/src/process/no_fm.rs

此函数在未使用 FM 调制时处理振荡器的样本块。它接受一个 OscillatorProcessBlockCfg 结构体作为输入，其中包含有关音高、漂移、立体声状态以及是否使用 FM 的信息。该函数首先根据过采样块大小和音高计算要覆盖的相位空间量。然后，对于振荡器的 blitter 中的每个声音，它生成样本并填充缓冲区，直到振荡器和同步状态至少覆盖了所需数量的相位空间。最后，它处理生成的样本。

如果 self.l_sync.v 大于 0，则表示同步活动，函数将填充 syncstate 遍历，直到覆盖所需的相位空间量。否则，它将填充 oscstate 遍历。通过调用 convolute 函数来填充声音的缓冲区。一旦生成了足够的样本以覆盖所需的相位空间，函数将处理生成的样本。

36> /file surge-rs/surgeosc-super/src/process/handle_wrap.rs

此函数处理缓冲区环绕，当缓冲区位置达到缓冲区末尾时。在这种情况下，函数将重叠的样本从缓冲区末尾复制到缓冲区开始处。它使用 SIMD 指令以 4 个样本的块来加载和存储样本。

首先，它定义一个常量 SZ，为 FIR_IPOL_N（插值滤波器阶数）除以 4。然后，它创建了重叠_l、重叠_r（用于立体声模式）和 dcoverlap 的大小的 SSE 寄存器数组，以存储重叠样本。

然后，函数使用 _mm_setzero_ps() 创建一个零 SSE 寄存器。

在循环中，它使用 _mm_load_ps() 从缓冲区末尾加载样本到 overlap_l、overlap_r 和 dcoverlap。然后，它使用 _mm_store_ps() 将这些样本存储到缓冲区的开始处。存储后，它还通过存储零 SSE 寄存器来清除缓冲区末尾的样本。

如果启用立体声模式，它将重复此过程以 overlap_r。

37> /file surge-rs/surgeosc-super/src/process/fm.rs

process_block_fm 方法在启用 FM 时处理振荡器的块。对于块中的每个样本，它检索 master_osc 的值，并计算 FM 乘数 `fmmul = limit_range(1.0 + cfg.fm_depth

• master_osc, 0.1, 1.9). 然后计算要覆盖的相位空间量 as a = self.blitter.pitchmult * fmmul`。

对于和声中的每个声音，该方法进入一个循环，填充振荡器缓冲区和 FM 调制缓冲区，直到要覆盖的相位空间量大于振荡器当前状态或同步状态。在循环运行期间，将 fm_mul_inv 设置为 FM 乘数的倒数以避免除法。最后，方法从振荡器状态和同步状态中减去相位空间量，并处理块。

38> /file surge-rs/surgeosc-super/src/process/block.rs

此代码似乎正在实现使用 Surge 的 SuperOscillator 算法的数字振荡器的核心处理逻辑。SuperOscillator 生成多个彼此略微失调的波形副本，以创建丰富、厚重的声音。该算法使用称为过采样的技术来减少混叠，这在波形以过低的速率采样时发生。

process_block 方法被调用来处理样本块。该方法接受一个 OscillatorProcessBlockCfg 参数，其中包含块处理的配置信息。在 process_block 方法内部，更新了振荡器的几个内部参数，然后根据是否使用频率调制调用 process_block_fm 或 process_block_nofm。

在 process_block_fm 中，算法生成多个彼此略有失调的波形副本，并对它们应用频率调制。该方法使用嵌套循环按样本逐个处理块，并为每个样本调用 convolute 方法来生成输出信号。

在 process_block_nofm 中，算法生成多个波形副本，不应用频率调制。该方法还使用嵌套循环逐个处理块样本，并为每个样本调用 convolute 方法以生成输出信号。

调用 maybe_handle_wrap 方法来处理输出缓冲区环绕到缓冲区开头的情况。该方法将前一个缓冲区末尾的重叠样本复制到新缓冲区的开头，以确保输出信号的连续性。

为块中的每个样本调用 do_block 方法，并对振荡器执行核心处理。它对波形应用高通滤波器，减去直流偏移，并应用字符滤波器来塑造输出信号。然后将生成的信号存储在输出缓冲区中。该方法还处理立体声情况，为左右通道生成两个信号。

39> /file surge-rs/surgeosc-super/src/convolute/stereo.rs

此函数通过 sinc 函数对振荡器的立体声输出进行卷积，以对波形进行插值。函数接受以下参数

• g：应用于左通道的增益。

• g_r：应用于右通道的增益。

• delay：应用于 sinc 函数的样本延迟。

• m：开始卷积的 sinc 表格的索引。

• lipol128：包含 lipshitz 值的 __m128 向量。

函数首先将左右增益加载到 __m128 向量中，并重新排列它们的值，以便向量的每个元素都包含相同的增益值。然后函数遍历 FIR 插值缓冲区中的每个样本（oscbuffer_l 和 oscbuffer_r 数组末尾的 FIR_IPOL_N 个样本），并从 sinc 表中加载相应的样本。然后函数将加载的/ sinc 值乘以包含当前样本 Lipshitz 值的 lipol128 向量。然后函数将生成的 sinc 值乘以左右增益值，并将它们分别加到 oscbuffer_l 和 oscbuffer_r 数组中的当前样本值。最后，使用 _mm_storeu_ps 将更新的样本值存储回 oscbuffer_l 和 oscbuffer_r 数组。

40> /file surge-rs/surgeosc-super/src/convolute/mono.rs

好的，如果还有其他我可以帮助的地方，请告诉我！

41> /file surge-rs/surgeosc-super/src/convolute/get_t.rs

这是 SurgeSuperOscillator 结构中的 get_t 函数的实现。它接受两个浮点值，sync 和 detune，并返回一个包含两个浮点值的元组，t 和 t_inv。

get_t函数首先检查absolute标志是否设置在SSOParam::UniSpread参数中。如果是，它通过将detune乘以逆音高倍数并基于音符号和sync值进行缩放来计算note变量。逆音高倍数是通过使用tuner对象的n2pinv函数计算的，该函数以MIDI音符号作为输入，返回其频率的倒数（赫兹）。然后，使用n2pinv函数将得到的note值转换回逆频率，并以t的形式返回。

如果absolute标志没有设置，get_t函数简单地加上sync和detune，然后将结果传递给tuner对象的n2pinv_tuningctr函数，该函数也返回频率的倒数（赫兹）。

最后，以元组的形式返回t及其逆t_inv。

42> /file surge-rs/surgeosc-super/src/convolute/get_g.rs

这是Surge合成器项目中的一段Rust代码。它定义了SurgeSuperOscillator结构体的某些方法，该结构体是振荡器模块实现的一部分。

convolve_stereo方法使用给定的滤波器核卷积立体声音信号的左右缓冲区中的音频数据，输出信号也是立体声。该方法使用了SSE（Streaming SIMD Extensions）指令集，这是一组可以用于同时执行多个数据元素的并行操作的指令集。这允许更有效地处理音频信号。

convolve_mono方法类似于convolve_stereo，但用于卷积单声道音频信号与滤波器核。

get_t方法根据振荡器的当前音高和微调设置计算振荡器的当前时间位置。

get_delay方法根据振荡器的频率调制和在周期中的位置计算应该应用于音频信号的延迟样本数。

impulse_zero、impulse_one、impulse_two和impulse_three方法用于生成用于生成方波、锯齿波和子波形的4-脉冲周期。这些方法计算每个脉冲的高度以及从先前的脉冲到当前脉冲的级别变化。

get_g方法根据波形类型和子周期位置计算当前4-脉冲周期的脉冲级别变化，并在需要时应用立体声声像。

43> /file surge-rs/surgeosc-super/src/convolute/convolute.rs

convolute函数是Convolute特质的成员方法，该方法为SurgeSuperOscillator结构体实现。它执行振荡器波形单个样本与滤波器核的sinc函数的卷积。

函数接受一个ConvolutionCfg参数，指定音色索引、立体声标志和FM标志。它首先计算当前样本的微调值、波形形状（wf）和子周期相位（sub），以及指示相空间中当前位置的ipos值。如果启用同步，则使用同步状态而不是振荡器状态来计算ipos值。

函数随后根据FM标志和ipos，以及用于计算需要与当前样本卷积的滤波器核的分数部分的m和lipol128值来计算延迟值。

接下来，函数调用get_g方法来计算当前样本的级别变化（g），如果启用了立体声输出，则将此变化应用到左右通道。最后，函数调用convolve_mono或convolve_stereo来执行与滤波器核的sinc函数的实际卷积。

如果未设置CONVOLVE_NODC，函数还将计算当前样本的直流偏移，并使用此值更新dc_uni缓冲区和dcbuffer。最后，函数更新振荡器状态和下一个样本的状态机。