目录

软件介绍

安装

–| 1.下载软件 2.下载模型 3.启动软件 4.更新升级

基本操作

–| 1.生成一张图 2.词法规则 3.节点操作 4.AI作图原理 5.保存工程

高级功能

–| 1.使用Lora 2.使用ControlNet 3.使用Upscale 4.SetArea 5.用不同模型同时绘制多张图

附录

软件介绍

节点图是现代3D软件 如Unity、Unreal、Blender中常见的美术设计工具

ComfyUI 通过节点图控制AI生成平面作品

比起 WebUI 它的可控性和自由度更高 更适合商业化的设计场景 更适合设计师 而WebUI比较适合开发者

安装

1.下载软件

来到软件的Github页 GitHub – comfyanonymous/ComfyUI

点击 “Direct link to download”

下载后解压

2.下载模型

来到模型网站 Civitai.com 挑选中意的模型存档（模型左上角是CHECKPOINT）

点进去后下载模型本体(图中CP)

如果提示包含独立的VAE模型（如下图）还要下载它包含的VAE模型（点蓝色的VAE）

下载后放置到 软件解压的目录中.\ComfyUI_windows_portable\ComfyUI\models 里对应的文件夹里

（如 Checkpoint放在checkpoints文件夹里 vae放在vae文件夹里）

3.启动软件

软件解压的目录中:

run_cpu.bat 为启动CPU算图的版本（很慢）

run_nvidia_gpu.bat 为启动GPU算图的版本 只支持NVIDIA卡

（其他显卡根据Github上的提示手动配置）

打开后可能会出现下图中防火墙拦截的情况

按照图示允许即可

软件启动成功后会弹出命令行窗口 并自动打开浏览器

（如果没有自动打开浏览器 并且有报错信息 比如找不到xxx的话

修改一下解压后文件夹存放的路径即可 路径尽可能简单 最好全英文 不要有特殊字符 不要太深）

如果浏览器内容是空白的 需要更换Edge或Chrome浏览器访问 http://www.zhangxinhao.com:8188

4.更新升级

解压后文件夹内的 update 内的 bat 用来更新软件及其依赖

基本操作

1.生成一张图

在CheckpointLoaderSimple节点上选择刚才下载好的模型

分别在连到 positive 和 negative 的 CLIPTextEncode 里填入 正向提示语 和 负向提示语

点击右边的 Queue Prompt 就开始算图了 默认是512*512的尺寸

2.词法规则

2.1 正向与负向

提示语(prompt)有两种 正向的(positive) 和 负向的(negative)

正向提示语描述希望出现在图像里的元素，负向提示语表明不希望出现在图里的东西

2.2 内容类型

提示语 可以是一句话 如 “Standing On Narrow City Streets Crossword”

也可以是以逗号分隔的词 “masterpiece, pretty girl, long hair”

2.3 权重

权重影响该特征在图中占的比例 或者说 突显的程度

越靠前的提示语权重越大

也可以通加括号调整权重

小括号表示将权重调至当前 1.1 倍 可以迭代 如 ((cute))

大括号为 1.05 倍，中括号为 0.9 倍

也可以直接指定倍率 如 (cute:1.2)

2.4 指定步长

[girl:10] 从10步开始画女孩

[girl::20] 到20步停止停止画女孩

[[girl::20]:10] 从10步到20步画女孩

2.5 融合

xx AND yy 同时具有特性xx和yy (大写AND)

xx:1.05 AND yy:0.9 同时具有特性xx和yy 比例为xx1.05 yy0.9

[xx|yy] 融合特性xx和yy

[xx:yy:0.6] 以 前60%后40%的比例 融合特性xx和yy

[xx:yy:10] 以 前10步xx后面步yy 融合xx和yy

2.6 自定义提示词

Civitai 的资源中自定义提示词的左上角是Textual Inversion

下载下来 记住它的 Trigger words 触发词

下载后放到软件目录.\ComfyUI_windows_portable\ComfyUI\models 中的 embeddings 文件夹里

使用的时候直接填入Trigger word 触发词 就行了

2.7 学习其他人的提示词

Civitai 里大部分模型资源页的下方 都有网友分享的效果图

点开效果图 可以看到这张图用了什么提示语

尺寸、采样方式与步长等参数也会影响作图结果

3.节点操作

在节点上拖动可以拖动节点

在空白处拖动则会移动视图

鼠标滚轴放大缩小视图

在空白处双击 搜索并新建节点

在空白处右键 为 菜单

在节点上右键调出节点的菜单

每个节点都是 左边输入 右边输出

鼠标从 一个节点的输出 拖拽出来 连接到另一个节点的输入

拖拽期间 可以连接的地方会亮起来 如图

按 F11 切换全屏

4.AI作图原理

整个算法由三部分组成 文本翻译器 算图器 和 图片翻译器

首先 文本翻译器(CLIPTextEncode) 把提示语翻译成 AI 听得懂的语言

然后 算图器(KSampler)根据翻译过来的提示语 以 AI 自己的语言算图

最后 图片翻译器(VAEDecoder) 把AI语言里的图像翻译成人类能看懂的图片

三个部分 每一个部分都需要一个模型

所以 一个 Checkpoint 包含三个模型

MODEL 是算图器的模型 CLIP 是文本翻译器的模型 VAE 是图片翻译器的模型

文本翻译器节点需要输入一个 CLIP 模型

算图器 KSampler 节点需要输入一个算图器的模型(model) 以及两个文本提示语翻译后的结果(positive)(negative)

它还需要输入一个画布(latent _image) 这里用 EmptyLatentImage 节点生成的随机噪音就好

(画布可以包含先验信息)

图片翻译器 节点 需要输入算图的结果(samples) 与一个图片翻译器的模型(vae)

5.保存工程

在右边的菜单中 可以 保存 和 加载工程 也可以通过 Load Default 加载初始工程

 除此以外 ComfyUI 还会把工程存在导出的 PNG 文件的的元数据里

把PNG拖入节点视图 就可以直接加载生成这张图的原工程

高级功能

1.使用Lora模型

Lora模型 是一种在已有模型上进行微调的模型

Civitai 上选好模型 下载下来 同样要记住触发词 Trigger word

下载后放到软件目录.\ComfyUI_windows_portable\ComfyUI\models 中的 loras 目录里

右键菜单 点 Add Node 然后 loaders 里新增一个 LoraLoader 节点

选择刚下载的 Lora 模型后 把这个节点接在 CheckpointLoaderSimple 和其他节点之间 然后填入该Lora模型的触发词 就可以了

你可以直接在 LoraLoader 节点上调模型的权重 而不用通过<xx:0.9> 的提示词调整

2.使用ControlNet模型

ControlNet 让我们可以用 图片的方式 与 AI 沟通

来到 Civitai 下载对应的模型 搜索controlnet

2.1 姿势

模型页翻到 “版本” 的位置 选择 OpenPose 这个版本 下载

下载后放到软件目录.\ComfyUI_windows_portable\ComfyUI\models 中的 controlnet目录里

右键菜单 conditioning 里新建 ControlNetApply 节点

把它接在文本节点和 KSampler 节点之间

然而这个节点还需要其他两个输入 分别是 ControlNet模型 和 提示图

右键菜单 loaders 里 新建 ControlNetLoader节点

配置 openpose 模型

右键菜单 image 里 新建 LoadImage 节点

配置一张 提示图 就可以开始算图了 效果如下

你可以通过这个在线工具生成姿势图 open pose editor 空白处左键旋转 右键拖动 滚轴缩放 点生成图后点图下载 点骨骼扭动

2.2 线稿

线稿也是一样的 先下载模型 放到对应的目录里

节点上配置一下

就可以根据线稿或者涂鸦算图了

3.使用Upscale模型

算图的尺寸会对内容元素数量有影响 所以有时需要小尺寸上算完再放大

先下载用来放大的模型 JingyunLiang/SwinIR · GitHub 放到 upscale_models 里

右键 image 里 upscaling 里新建 ImageUpscaleWithModel 节点

把它连在 VAEDecode 和 SaveImage 节点之间

右键菜单 loaders 里面新建 UpscaleModelLoader 节点

配置下载好的模型

如图连接

可以看到已经从 512 放大到了 2048

也可以放大自定义图片 如下图配置

4.SetArea

我们可以设定不同特征在图像中作用于不同的区域

右键菜单 conditioning 里新建 ConditioningSetArea 节点

把它连在文本节点和 KSampler 节点之间

设定作用区域 这里xy是距离左边和顶部的距离

克隆 文本节点 和 ConditioningSetArea 节点 我们让左边和右边的描述不一样

右键菜单 conditioning 里新建一个 ConditioningCombine 节点

 如图连接 填上不同的词 效果如下

5.用不同模型同时绘制多张图

可以用同一组提示语应用于不同模型同时算图 如图

附录

CFG Scale 与 Step 对结果的影响

SDE

Euler A

以上

就是 音响没有很好的承载音乐感，或者说音响没有情感，尤其是在手机这类小设备的扬声器上很明显

为改善这个情况，我对“音乐感”做了一些研究，在这分享一点看法

1.“音乐感”与“硬件感”的关系

音乐感来自 在正确频率位置的乐音

一般来说，通过音量(EQ)减少噪音对乐音的掩蔽就可以强化音乐感

但是，有时候，你需要的频段里根本就没有乐音

这种情况，可以通过硬件的电气特性制造出某些频率位置的自然泛音

(PS：并不是所有硬件都会带来音乐感，有一些话放会让人声变亮，但不产生音乐感。)

2.硬件如何塑造“音乐感”

我通过多次实验发现，用来承载音乐感的频段的动态需要听上去像是一个共振的音尾

所以说需要的不仅是谐波，还需要有一个正确动态

而硬件里刚好就有一些元件可以塑造这种谐波与调制，这里以二极管为例

上图是某调音台中负责染色「温暖感」的电路

图的下方 左边是输入信号，右边是输出信号（声音在电路里以电压形式存在）

这个电路中制造硬件感的地方是左半部分的二极管（右半部分是放大）

如果增加其串联的电阻减少二极管流出的电流时，输出信号的形状就会接近输入信号（上图）

二极管不是输入信号就立刻导通的，而是需要达到阈值才能导通

而且导通后它的电压和电流不是线性的关系

这就导致流出的电流是非线性的，所以对输出信号的影响也是非线性的（如下图）

这种特殊的波形影响有以下两个特征：

1.产生的新频率与原始信号的频率强相关（泛音点）

2.在新泛音点的动态上有一些调制效果

听一下

原始信号（缺乏音乐感，有点不在调上的感觉）

–

算法模拟的硬件感（出现了音乐感）

–

NEVE调音台的硬件感（带有独特味道的音乐感）

3.软件模拟需要注意的地方

能够模拟硬件非线性的味道的插件有很多，比如Waves的NLS，需要注意，DRIVE控制的是谐波的多少

所以 Drive控制的重点不是增益 而是 硬件感&音乐感 的多少

4.其他方法制造“音乐感”

前面已经提到过，用来承载音乐感的频段的动态需要听上去像是一个共振的音尾

所以可以通过一些效果器制造这种类似动态，进而制造音乐感

1.用LFO制造出一个具有共振感拍频感的音响（比如LFOTool）

2.用upward压缩来放大信号里本来就具备的但很小声的音尾（比如OTT）

3.用同度/八度奏等配器方式制造频率交叠产生类似拍频感共振感的音响

以上☺️

一直以来，关于逆向音频插件的资料在国内外都很少，刚好本人最近接触到相关的东西，所以撰写此文分享插件Cracking技术

其实Cracking音频插件和Cracking软件思路大致是相同的，只不过音频插件是一个模块，本文的案例就是软件Cracking中常见的搜索字符串法

本文旨在为提升插件开发者水平而分享插件Cracking技术

正式使用，还请使用正版

0.准备工具

下载调试工具 x64dbg(开源软件)

设置取消全部的自动断点，点选项->选项

去掉事件下所有的勾

将 异常 -> Unknow exceptions -> 设定为 “不暂停”

0.准备被Cracking插件

这里 我写了一个简单的注册码验证的VST插件

下载后放到 C:\Program Files\Common Files\VST3 文件夹里

打开宿主加载（这里是测试用的Reaper）

1.明确目标

音频插件，本质是挂载在一个应用程序(宿主DAW)上的模块，而Cracking要做的事，则是通过调试工具找到并反汇编这个模块，进而分析修改并重新转存这个模块

2.信息收集 – 了解软件行为

为了方便我写了个注册机，你可以用它算出的注册码查看注册成功提示的信息

====================================== [注册机] ==================================

====================================== [注册机] ==================================

这是注册码正确的提示

这是注册码不正确的情况

记住正确会弹出 “You have successfully registered VSTCrackTutorials001” 的提示，后面会用到

3.实践分析 & 整理思路

打开x64dbg，点 文件 -> 附加

在进程中找到宿主DAW(测试用的Reaper)的进程,双击 或 右下角 “附加”

点击 “符号” 标签页

找到加载的 “vstcracktutorial001.vst3” 模块 （是一个状态为 Loaded 的 用户模块），双击

双击后会跳到反汇编窗口(CPU标签页)

现在可以通过搜索 注册成功提示的字符串 来定位 处理注册逻辑的代码 在内存中所在的区域，修改那个区域的数据，就可以影响程序的行为

（程序需要加载到内存中才能由CPU执行，程序加载到内存后会由一个相对进程的虚拟地址来定位）

标签页里点右键，点 搜索 -> 当前模块 -> 字符串

等待底部搜索进度条拉满后，在进度条上方的搜索框里搜索 “You have successfully registered VSTCrackTutorials001″（前面提到的 注册成功 弹出的信息） 里的内容

这里我只搜了一个 successfully

第二个是正确提示的内容，双击跳转到该位置的反汇编窗口

简单分析后可以看到有一个跳转跳过了成功（红线部分），这个应该就是关键跳

4.实行Cracking & 反馈验证调节

在该跳转的行上 点右键 二进制 -> 用NOP填充 （编程上相当于把这句在内存里注释掉）

然后输入错的注册码再点Register按钮，看看程序的反应

结果弹出了注册成功的框，说明Cracking成功了

5.维持访问

接下来需要把Cracking后的插件保存下来

在反汇编窗口(CPU标签页)点击 右键 -> 补丁

点右下角的修补文件，然后找个不需要管理员权限的位置存上就可以，会保存一个格式与原模块相同的文件 (这里是 .vst3)

（C:\Program Files\Common Files\VST3需要管理员权限）

（这里是把内存中修改的地址转换成了.vst3文件的文件偏移地址，然后把修改后的数据写进去，存为新的.vst3文件）

然后用刚存的 .vst3文件 替换掉 C:\Program Files\Common Files\VST3 里的原始.vst3文件，就完成Cracking了。

主要用到这些类： ImageComponent ImageCache BinaryData LookAndFeel Graphics

先找两张图，一张背景，一张旋钮。

把它们拖入JUCE的资源管理器里，Juce会自动把它创建为 Binary 的对象。

背景图像

声明要用到的 ImageComponent

绘制出来

旋钮

先写一个 LookAndFeel 类 继承自LookAndFeel_V3 后面这个V1-4随意


重写它的画旋钮的方法 把我们的图片画上去

声明旋钮以及 LookAndFeel 对象

连接旋钮与LookAndFeel对象，并绘制旋钮

这样就 OK 了

点击这里查看源码

]]> http://www.zhangxinhao.com/blog/3703 Mon, 08 Jun 2020 16:00:45 +0000 http://www.zhangxinhao.com/?p=3703 Read More]]>


在 Unity 中用自己写的音频效果给了我们在 Sound Design 上的更大的自由度，现在我们看看如何实现它。

 

JUCE 在 5.4 之后，增加了对 Unity 的支持，可以将工程作为 Unity 插件导出。

这其中有几个需要注意的点，

1.参数需要使用 AudioParameter （详见《音频开发进阶（一）》）, Unity 中 Inspector 中才能看的参数，而参数只有在 Unity 的 Inspector 里能看到才能与 C# 脚本交互。

2.如果你看过英文的资料，那些资料可和实际的情况有些不同。现在已经不用修改 hasEditor 回调的返回值，无论改不改用的都是 Unity 的 Slider。

 

我们之前在《音频开发进阶（一）》中，已经有一个现成的使用 AudioParameter 的工程，在里面下载好源码，直接拿来用。

 

打开以后，点工程文件

 

然后设置工程为Unity插件，并转到IDE打开

 

IDE里导出，(如果是 Xcode 的话 导出完会在 Products 文件夹里，Visual Studio 的导出位置详见《音频开发技术（二）》)

 

打开unity，Assets里面新建一个 Plugins 文件夹

 

然后把导出的插件放到这个文件夹里

 

然后新建一个 Audio Mixer

双击

双击音轨

就可以添加效果了，点 Add Effect 添加我们的插件

可以看到显示了 Gate Threshold 参数

 

 

在参数上右键，选择 暴露参数给脚本

这里可修改脚本里的参数名

 

然后就可以在脚本中通过  你的audioMixer.SetFloat(“暴露给脚本的参数名”，要设定的值)  交互了

 

]]> http://www.zhangxinhao.com/blog/3197 Sun, 07 Jun 2020 16:00:59 +0000 http://www.zhangxinhao.com/?p=3197 Read More]]>  

枫叶回忆

1. 1. 枫叶回忆

 

 

在音频开发的路上，你已经到达十级，现在是时候走出新手村，开始第一次转职了。

接下来有三条路线：信号处理、音频应用、KONTAKT音源。

你可以任选一条你喜欢的。

 

一、信号处理

信号处理关注音频效果的底层算法。
如果你是信号处理专业的学生、教育从业者、科学家、算法设计师、SDK开发者(音频类库)，或是想成为一个高手，这是最适合你的选择。

[小一段讲解滤波器的公式]

我推荐这本书，它讲述了必备的数学基础与大部分音频效果的原理，并且用JUCE做了演示：音频效果的理论、实现与应用 提取码: 4uqk | 这里是书中内容的源码实现

 

二、音频应用

音频应用关注制作成品效果器/软件。它更多使用成熟稳定的类库与接口，而较少关注算法。
如果你是效果器开发者、音频软件开发者这种追求稳定的，或者是希望短期内快速出一个演示Demo、毕业项目之类的，这是最合适的选择。

[JUCE实现的EQ]

点击下载上图插件源码

学习JUCE，乃至任何一个框架，最好的办法是观看官方的教程、查阅官方的开发文档。然后就是多看代码，Github上有不少优秀的项目可供学习。要开发界面成熟高端的音频应用，最好了解一下JUCE的图形库。
点击访问：JUCE官方教程  |  JUCE开发文档 | 上Github看相关的源码

 

三、KONTAKT音源

 

KONTAKT音源关注音响质量，编程上略为简单。
如果你相比编程更擅长录音技术、具有设备优势、总是在混音上有想法，那这是最好的选择。

[实用的KONTAKT音源]

KONTAKT可以通过看代码学习，加载任何一个KONTAKT音源，点扳手，再点Scirpt Editor里的Edit，可以看到代码，另外这里有两本KONTAKT编程的教程

Kontakt Script 简易教程  提取码: q5a3

Kontakt Script 官方参考手册 提取码: 8aqr

 

 
 

《音频开发技术/实战/进阶》教程 由 张新豪 于 2020年6月 创作，允许在注明出处与作者的前提下转载。

课程进度100%

]]> http://www.zhangxinhao.com/blog/3194 Sat, 06 Jun 2020 16:00:27 +0000 http://www.zhangxinhao.com/?p=3194 Read More]]>

JUCE 在 5.1 版本之后加入了 dsp 模块，从此可以通过调用接口的方式实现各种音频效果，降低了对开发者算法水平的要求。

确定目标

一个 EQ 效果器

收集信息

在开发文档中的 dsp 分区里，发现 Filter 是我想要的。

在查阅相关资料后,得知 Filter 对象 有三个接口需要调用 :
1.prepare(ProcessSpec&)- 在处理信号前调用，设定采样率等规格参数，必须调用
2.reset – 重置通道
3.process(ProcessContextReplacing或ProcessContextNonReplacing) – 处理信号

查到 ProcessorDuplicator 把一个处理器变成双声道立体声两个处理器，同时它为被代理的处理器(比如这里的 dsp::IIR:Filter ) 实现一种适配器的模式。这种模式中对 ProcessorDuplicator 的操作和对原处理器(比如这里的 Filter )的的操作极为类似。（在这里就是 ProcessorDuplicator 对应 Filter, ProcessorDuplicator 的参数字段 state 对应 Coefficients ）

整理思路

用 ProcessorDuplicator 代理 Filter，即 Filter 的 prepare、reset、process 都换成 ProcessorDuplicator 的。此外 ProcessorDuplicator 的 state 对象等同于 Filter 的 Coefficients的作用。

用 dsp::IIR::Coefficients::makePeakFilter 接口为 state（代理的Coefficients）参数赋值，用以设置滤波器参数。

在prepareToPlay中调用 prepare，releaseResources调用reset。

在Audio Plugin中 输出和输入同源，输入输出都是 getWritePoint 这个数组，所以 process 采用 ProcessContextReplacing 这个参数，而 ProcessContextReplacing 也需要一个AudioBlock参数才能初始化。
（ProssContextReplacint(AudioBlock(buffer))

付诸行动

先要在JUCE工程中勾选DSP模块，才能打开DSP功能使用 dsp 命名空间。

声明推子

1 2 3 4 5 6

// PluginEditor.h ...     MyEqAudioProcessor& processor;     Slider HF_Vol;  // 声明一个推子 <-     JUCE_DECLARE_NON_COPYABLE_WITH_LEAK_DETECTOR (MyEqAudioProcessorEditor) ...

让推子影响变量

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21

// PluginEditor.cpp ... MyEqAudioProcessorEditor::MyEqAudioProcessorEditor (MyEqAudioProcessor& p)     : AudioProcessorEditor (&p), processor (p) {     HF_Vol.setRange(0.01, 1, 0.01);     HF_Vol.setBounds(0, 0, 100, 50);     HF_Vol.setSliderStyle(Slider::SliderStyle::LinearHorizontal);     HF_Vol.setTextBoxStyle(Slider::TextBoxBelow, true, 100, 30);;     addAndMakeVisible(HF_Vol);     HF_Vol.onValueChange = [this]     {         *(processor.myFilter.state) = *(dsp::IIR::Coefficients<float>::makePeakFilter(processor.getSampleRate(),2400.0f,0.7f,HF_Vol.getValue()));       };     setSize (400, 300);     *(processor.myFilter.state) = *(dsp::IIR::Coefficients<float>::makePeakFilter(processor.getSampleRate(), 2400.0f, 0.7f, HF_Vol.getValue())); } ...

声明处理器

1 2 3 4 5 6

// PluginProcessor.h ...     void setStateInformation (const void* data, int sizeInBytes) override;     dsp::ProcessorDuplicator<dsp::IIR::Filter<float>, dsp::IIR::Coefficients<float>> myFilter;     // 声明一个处理器 <- private: ...

prepare 与 reset

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18

// PluginProcessor.cpp ... void MyEqAudioProcessor::prepareToPlay (double sampleRate, int samplesPerBlock) {     dsp::ProcessSpec ps;     ps.maximumBlockSize = samplesPerBlock;     ps.numChannels = getTotalNumOutputChannels();     ps.sampleRate = sampleRate;     myFilter.prepare(ps);     } void MyEqAudioProcessor::releaseResources() {     myFilter.reset(); } ...

处理器处理信号

1 2 3 4 5 6 7 8 9

// PluginProcessor.cpp ... void MyEqAudioProcessor::processBlock (AudioBuffer<float>& buffer, MidiBuffer& midiMessages) {     ScopedNoDenormals noDenormals;         myFilter.process(dsp::ProcessContextReplacing<float>(dsp::AudioBlock<float>(buffer))); } ...

这样就完成了

点击这里下载源码

课程进度90%

]]> http://www.zhangxinhao.com/blog/3192 Fri, 05 Jun 2020 16:00:31 +0000 http://www.zhangxinhao.com/?p=3192 Read More]]>  

框架的时代

 

如今，我们输出一行 “Hello World” 到屏幕上，已经不需要手动地把数据移动到显存里面了。一句简单地语句就可以搞定。高级程序语言本身就是一种框架。

不要重复发明轮子

当你要开发的功能 已经存在了成熟的框架，我劝你最好使用它们。

相比一个人从头开始写底层功能，现成的框架已经有了一段时间的积累，它们更稳定，更安全，优化更好，而且还方便。

当然如果你对某些功能有更深入的理解，或是为了长远的打算，编写一个框架也是件很了不起的事。

 

无论用什么框架开发，都离不开对开发文档的查阅

 

本节我们就了解一下 如何使用 JUCE 开发文档，编写一个 Reverb 混响插件。

 

1.明确需求

一个混响效果器

2.收集信息

 

我们先来到 JUCE的开发文档（点击打开）， 看看有没有用得上的东西。

网页里，按下Ctrl + F (Mac 上 Command + F)， 搜索 reverb 然后回车

找到这个，应该是我们想要的

点进去，看到 Description 里说了，先用 setSampleRate 接口准备一下，然后用 processStereo 或者 processMono 处理信号就行了

看完说明，就大概了解了它的用法。（以后我们接触的东西多了，就不用看说明了，这些方法大同小异）

然而现在我们还有一个需求没有得到解决，那就是调节参数。

继续寻找，在上方的 Member Functions 功能接口的描述中，看到了 setParameters 接口，它的传入参数是一个 ‘Parameters’ 类型 的东西，我们点一下那个 Parameters。

发现它是个结构体，里面的字段就是混响的参数，这些参数都是默认初始化过的。

好了，现在已经收集到需要的全部信息了。

 

3.整理思路

 

我们看到上面 Reverb 的文档中写的都是些成员方法，理所当然就想到实例化一个 Reverb 的对象来用，在JUCE里，这是不必要的。
Reverb 是来自JUCE库里的类，它的对象不用 new 不用 Reverb() 实例化创建，只要声明了它，JUCE 框架就会自动为我们注入一个合适的 Reverb 对象。所以把它当成结构体就可以了，【Reverb 对象声明完直接使用】。（这是一个好架构，它让开发者专注于业务逻辑，避免分心）

有别于其他语言，C++实例化对象是可以不new的。

一般来说对象都是保存在堆上，但C++可以通过这种不new的方式直接把它保存在栈上，这样实例化出来的对象只作用于函数内部，函数执行后就删除了。

 

setParameters 用到的参数是个结构体，值类型的声明后直接用就行了。

Reverb 对象需要在使用前调用一下 【setSampleRate】接口。在《音频开发实战（二）》的时候，我们使用了一个 getSampleRate 接口获取采样频率，而这个接口并不是每一次都有返回。为了更好的稳定性，我们选用PluginProcessor 的回调 【prepareToPlay (double sampleRate, int samplesPerBlock) 】中的采样频率。

最后在 processBlock 中用 【processStereo】 接口处理立体声，这个接口的传入的参数是 左边的信号序列指针，右边的信号序列指针，处理多少个点。
这三个参数刚好就是 buffer.getWritePointer(0), buffer.getWritePointer(1), buffer.getNumSamples()。

好了，我们已经知道怎么做了

 

4.付诸行动

 

-> 数据处理

首先在 processor 的头文件准备好 Reverb 对象 和 它的 参数结构体

1 2 3 4 5 6

// PluginProcessor.h ... Reverb reverbInstance; Reverb::Parameters reverbParameters; private: ...

然后在 prepareToPlay 回调里，调用 Reverb 对象的 setSampleRate 接口

1 2 3 4 5 6 7

// PluginProcessor.cpp ... void MyReverbAudioProcessor::prepareToPlay (double sampleRate, int samplesPerBlock) { reverbInstance.setSampleRate(sampleRate); } ...

在信号处理的回调 processBlock 中， 把 buffer 写入指针 和 采样点数量的信息 直接传给 Reverb 对象的 processStereo 接口。

1 2 3 4 5 6 7 8 9 10 11 12

// PluginProcessor.cpp ... void MyReverbAudioProcessor::processBlock (AudioBuffer& buffer, MidiBuffer& midiMessages) { ScopedNoDenormals noDenormals; for (auto sample = 0; sample < buffer.getNumSamples(); sample++) { reverbInstance.processStereo(buffer.getWritePointer(0), buffer.getWritePointer(1), buffer.getNumSamples()); } } ...

运算的部分就写完了。

那么 setParameters 在哪呢？ 我们还没有写，要知道processor的初始化是早于editor的，毕竟它是作为editor构造方法的参数被传入的，那既然 processor 中没有调用 setParameters 接口，在设置参数前没有参数的情况下 processStereo 被调用了怎么办呢。

没有关系，Reverb 已经为我们初始化了一个默认的结构体，这个默认的结构体里包含默认的参数值。

F12 到 Reverb 里看一下它的定义

 

-> 界面

在头文件里声明一个推子

1 2 3 4 5 6

// PluginEditor.h ... MyReverbAudioProcessor& processor; Slider RoomSize; JUCE_DECLARE_NON_COPYABLE_WITH_LEAK_DETECTOR (MyReverbAudioProcessorEditor) ...

我们已经知道了 Reverb::Parameters 是有默认值的，于是我们调整推子的位置到默认的参数的地方。

然后写推子监听方法：当推子位置改变时调节 reverbParameters 结构体，并把它应用到 reverbInstance 上。

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21

// PluginEditor.cpp ... MyReverbAudioProcessorEditor::MyReverbAudioProcessorEditor (MyReverbAudioProcessor& p) : AudioProcessorEditor (&p), processor (p) { RoomSize.setRange(0, 1, 0.01); RoomSize.setBounds(0, 0, 300, 50); RoomSize.setSliderStyle(Slider::SliderStyle::LinearHorizontal); RoomSize.setTextBoxStyle(Slider::TextBoxBelow,true,100,50); RoomSize.setValue(processor.reverbParameters.roomSize); RoomSize.onValueChange = [this] { processor.reverbParameters.roomSize = RoomSize.getValue(); processor.reverbInstance.setParameters(processor.reverbParameters); }; addAndMakeVisible(RoomSize); setSize (400, 300); } ...

 

这里 []{} 也就是 [](){}， C++ 中 Lambda 表达式的小括号 ‘()’ 没有参数时可以省略

 

5.验证 & 反馈调节

 

OK 没有任何问题

点击这里下载源码

课程进度80%

]]> http://www.zhangxinhao.com/blog/3188 Thu, 04 Jun 2020 16:00:18 +0000 http://www.zhangxinhao.com/?p=3188 Read More]]>

在《音频开发实战（三）》，我们讨论 KSP 脚本语言的时候， 谈及了 make_persistent 这个接口。

它的作用是让一个参数被系统自动保存，这样我们的参数就可以被记录在宿主软件的工程文件里，这个过程叫做 数据持久化。

在JUCE中，也是一样的，倘若我们的参数没有做过数据持久化，那么在工程下一次被打开时，所有参数都会全部消失，调好的旋钮、推子都会清零。

这一节，我们看一下JUCE中如何实现数据持久化，即如何保存应用的参数。

制作基本Gate门限器

新建一个 Audio Plugin 工程 MyGate -> IDE中打开

类似《音频开发实战（一）》中写音量推子那样，不同的是这次的运算：判断如果音量没有达到阈值，则不输出。

PluginEditor.h

1 2 3 4 5 6

//PluginEditor.h ...     MyGateAudioProcessor& processor;     Slider Threshold;   // 声明一个推子 <-     JUCE_DECLARE_NON_COPYABLE_WITH_LEAK_DETECTOR (MyGateAudioProcessorEditor) ...

PluginEditor.cpp

1 2 3 4 5 6 7 8 9 10 11 12 13 14

//PluginEditor.cpp ... MyGateAudioProcessorEditor::MyGateAudioProcessorEditor (MyGateAudioProcessor& p)     : AudioProcessorEditor (&p), processor (p) {     Threshold.setBounds(0, 0, 300, 100);     Threshold.setRange(0, 1, 0.01);     Threshold.setSliderStyle(Slider::SliderStyle::LinearHorizontal);     Threshold.setTextBoxStyle(Slider::TextBoxBelow,true,100,50);     Threshold.onValueChange = [this] {processor._threshold = Threshold.getValue(); };     addAndMakeVisible(Threshold);     setSize (400, 300); } ...

PluginProcessor.h

1 2 3 4 5 6

//PluginProcessor.h ...     void setStateInformation (const void* data, int sizeInBytes) override;     double _threshold = 0.0;     // 声明一个变量  <- private: ...

PluginProcessor.cpp

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17

//PluginProcessor.cpp ... void MyGateAudioProcessor::processBlock (AudioBuffer<float>& buffer, MidiBuffer& midiMessages) {     ScopedNoDenormals noDenormals;         auto* channelL = buffer.getWritePointer(0);     auto* channelR = buffer.getWritePointer(1);     for (auto sample = 0; sample < buffer.getNumSamples(); sample++)     {         channelL[sample] = std::abs(channelL[sample]) > _threshold ? channelL[sample] : 0;         channelR[sample] = std::abs(channelR[sample]) > _threshold ? channelR[sample] : 0;     } } ...

1.这里我用了一个三目运算符，意思是：【条件 ? 条件成立返回的值 ： 条件不成立返回的值】
2.为了方便，接收被赋值的变量时 我用了auto关键字，它就像是c#或js的 var 一样，能够自动判断类型。

验证

OK 没问题

持久化参数

改变参数的类型

我们先把 在 PluginProcessor 定义的变量 换成 JUCE 提供的 AudioParameterFloat 类型的指针. (同理还有 AudioParameterInt 等其他类型)

它在使用的时候和普通Float指针没区别。

PluginProcessor.h

1 2 3 4 5

//PluginProcessor.h ...     // double _threshold = 0.0;     AudioParameterFloat* _threshold; ...

从变量改成了指针，那用到它的地方就需要把它当作指针来使用，这样修改。

PlugiProcessor.h

1 2 3 4 5 6 7

//PlugiProcessor.h ...         // channelL[sample] = std::abs(channelL[sample]) > _threshold ? channelL[sample] : 0;         // channelR[sample] = std::abs(channelR[sample]) > _threshold ? channelR[sample] : 0;         channelL[sample] = std::abs(channelL[sample]) > *_threshold ? channelL[sample] : 0;         channelR[sample] = std::abs(channelR[sample]) > *_threshold ? channelR[sample] : 0; ...

还有这里也要修改。

PluginEditor.cpp

1 2 3 4 5

//PluginEditor.cpp ...     // Threshold.onValueChange = [this] {processor._threshold = Threshold.getValue(); };     Threshold.onValueChange = [this] {*(processor._threshold) = Threshold.getValue(); }; ...

我们希望每次重新打开工程的时候，界面上的推子的位置也是我们的保存的参数。来到 PluginEditor 的构造方法，加上这句。

PluginEditor.cpp

1 2 3 4 5 6

//PluginEditor.cpp ...     Threshold.onValueChange = [this] {*(processor._threshold) = Threshold.getValue(); };     Threshold.setValue(*(processor._threshold));          // 设置推子组件的值为保存的参数 <-     addAndMakeVisible(Threshold); ...

负责持久化的回调函数

记得在《音频开发技术（三）》中我们提到过，PluginProcessor中有一大堆方法都是可选功能吗。

持久化的回调函数就在这一大堆可选功能中，在其中找到 getStateInformation 和 setStateInformation 这两个回调。

getStateInformation 储存到插件的信息到内存
setStateInformation 从内存中提取插件的信息

getStateInformation 中用 MemoryOutputStream 对象的 writeFloat 方法

setStateInformation 中用 MemoryInputStream 对象的 readFloat 方法

现在编写代码。

PluginProcessor.cpp

1 2 3 4 5 6 7 8 9 10 11 12

//PluginProcessor.cpp ... void MyGateAudioProcessor::getStateInformation (MemoryBlock& destData) {     MemoryOutputStream(destData, true).writeFloat(*_threshold); } void MyGateAudioProcessor::setStateInformation (const void* data, int sizeInBytes) {     *_threshold = MemoryInputStream(data, static_cast<size_t>(sizeInBytes), false).readFloat(); } ...

生成导出试了一下，已经可以保存参数了。

持久化的细节

我们只是把插件的信息写到了内存中，而最终的持久化还是DAW宿主软件为我们做的。

宿主软件把内存中的信息编码保存在了工程文件中。

 

 

点击这里下载源码

课程进度70%

]]> http://www.zhangxinhao.com/blog/3128 Wed, 03 Jun 2020 16:00:30 +0000 http://www.zhangxinhao.com/?p=3128 Read More]]>  

这节，我们制作一个这样的音源

前言

说起上一节中能自主产生波形的合成器，我们不免想到和它相对的，利用人工录制的采样发声的采样器。

比起开发一个采样器来说，开发Kontakt是更好的选择。

编写采样器有一些底层的，现阶段没有必要了解的内容。

 

开发Kontakt?

可能在我们印象中，Kontakt的作用就是打开它然后选音色用，和编程没什么联系。

但实际上，Kontakt是一个可编程的采样器。两个重点：

1. 它是一个采样器。
2. 它可被编程。

 

重新认识Kontakt

打开Kontakt，不加载任何音色

点击那个保存样子的按钮，然后选New instrument新建一个乐器

然后就出现一个新的空乐器，点击扳手

然后就出现了 Kontakt采样器功能的界面, 我们平时用的各种Kontakt音源就是在这里被制作的

先看一下界面的最下面有四排：

| InstrumentBuses | InsertEffects | SendEffects | Modulation |

这四排是可以展开的标签页，点左边的三角就可以展开/关闭。

它们全是效果，用的地方不同。

 

再看界面的最上面有五个按钮：

| Instrument Options | Group Editor | Mapping Editor | Wave Editor | Script Editor |

它们分别是：

乐器设置、群组编辑器、映射编辑器、波形编辑器、脚本编辑器。

 

制作音源（设置背景）

先看看第一个按钮，点一下Instrument Options(乐器设置)

看到有个Instrument Wallpaper（乐器墙纸），那我们找张图

我在网上搜了张图，稍微P了一下，如下

图需要png或tga的格式

设置成Wallpaper，点扳手回到主界面

不管怎么说，背景改变了 （后期可以用代码控制界面大小来让背景显示的多一些）

 

制作音源（映射采样）

接下来点击第三个按钮：Mapping Editor（映射编辑器）

映射的意思是把采样（录音文件）对应到MIDI键盘上，当你某这个键的时候就播放上面对应的那个采样（录音文件）

我们先在左边的文件浏览器里找到我们准备的录音文件，我这里用的是洛天依的.wav格式的呼吸包做例子

从左边按住一个波形文件，拖动到对应的按键，我们看到现在这个音频对应了好几个键（这样的话这几个键按下去都是这同一个声）

没关系，保持拖动不要放开，把鼠标向下移动一些，它就收窄了。（或者松开然后拖拽白块的左右边界也能调节宽窄）

就这样把所有波形拖进来

按下键盘，有声音了！

 

力度分层：一个人大喊出来的声音和他平时说话的声音，除了音量不同，声音内容也是完全不同的，乐器也是如此。为了模拟乐器这种真实自然的效果，我们在音源制作中，常常会让一个按键对应多个录音文件，演奏时由力度决定采样器播放哪个音频文件。

力度体现在KONTAKT的映射编辑器里就是纵轴。刚才我们说过，映射块可以拖动左右边界调整映射到键盘的范围。其实这个映射块还可以上下拖动来调整这个录音文件对应的力度范围。

例如：图中选中的这个块（黄块）对应的力度是43-80

&

群组编辑器与波形编辑器：本例中并不需要使用它们，我简单介绍下用在什么地方。

-> 群组编辑器的一个作用是切换音色，一架钢琴，后盖盖上和打开是不同的音色，如果希望把这两种音色都涵盖到音源里，那么就要录两遍给两个群组。开盖一遍，合盖再一遍，这样我们拥有两组映射。我们用写代码切换群组的方式切换音源当前的音色。

群组还有一个用途是合成，有些音源是好几个麦克风录的，实现多个麦克风的声音合到一起的就是多个群组一起播放。

再有就是管弦音源会通过群组摆位实现一些效果。

-> 波形编辑器：调整波形，告诉采样器这个波形要怎么用。比如我们的录音文件就1s，但我们希望在按着它时它能发出持续的声音，不是1秒就没了。这就要用波形编辑器，在里面设置个Loop。这个编辑器里还有很多细节，影响音源精细程度。

制作音源（开始编程）

介绍完了前四个按钮，就只剩最后一个按钮了，Script Editor（脚本编辑器）

点开什么也没有，灰色的一个条，点这个灰条左下角的Edit打开编辑窗口

我们就在这个白框里写KSP脚本，写好点击右上角Apply应用脚本

 

-> 认识KSP脚本

 

接下来我们一起认识一下KSP脚本语言

 

变量

1 2 3 4 5 6 7 8 9 10

{这是一条注释} {数值变量} declare $x := 1                       {数值数组变量} declare %myArr[2]            %myArr[0] := 7 %myArr[1] := -10

点此查看更多变量

@myText – 字符串变量
!myArray[] – 字符串数组
const $myVariable – 数值常量
polyphonic $i – 也是数值变量。不同的是如果写在on note 里 多个音同时按下时 这个量对每一音都是独立的

界面组件

界面组件声明后会立即出现在界面上。
 

1 2 3 4 5

{旋钮：(0,100,1)的意思是取值0到100，每次移动1个单位。这里只是举个例子，可以自由调整} declare ui_knob $mySlider(0,100,1) {按钮：有按下和没按下的两种状态，可以直接用$myParam :=1设置它为按下的状态 } declare ui_button $myParam;

点此查看更多组件

ui_slider – 推子
ui_label – 纯文字
ui_menu – 下拉菜单
ui_switch – 切换开关(还是个按钮)
ui_table – 一个步进器 可以画力度、ARP之类的
ui_file_selector – 加载文件用的
ui_level_meter – 显示音量的电平表
ui_text_edit – 可输入文字的文本框
ui_value_edit – 可输入数值的数值框
ui_waveform – 波形显示器

回调方法

我们在 ‘音频开发技术（三）’里已经提到过，回调方法是框架让你写东西的地方，不同的回调会在不同的条件下被框架执行，你把功能写在里面，就可以在特定条件下执行你写在里面的功能。

KSP中所有代码必须写在回调方法里，外部没有写代码的地方

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18

on init {这里的代码在初始化时执行。你可以把初始化和构造方法理解为这个软件一打开就执行的代码} end on on note {这里的代码在有MIDI音符被按下时执行，类似游戏引擎中的KeyDown} end on on release {这里的代码在有MIDI音符被抬起时执行，类似游戏引擎的KeyUp} end on on ui_control {这里的代码在界面组件和用户交互时（拖动了推子，点了按钮等）执行} end on

内置变量

内置变量就是可以直接使用的变量，是系统定义并赋值的，我们通过它们从系统获取信息，比如当前哪个键被按着


了解内置变量前我们先了解一下MIDI，每次接收到MIDI信号都会触发on note回调函数，而每个MIDI信号被当成一个事件EVENT处理，每个事件都有自己的事件id，note number(哪一个键)和note velocity（力度），后两者都是0-127的数值。

1 2 3 4 5 6 7 8

{当前MIDI事件是哪个键被按下，返回0-127的数值,多用在on note里} $EVENT_NOTE {当前MIDI事件按下的键多少力度，返回0-127的数值,多用在on note里} $EVENT_VELOCITY {（常用）用来给set/get_engine_par接口指明调整/获取什么地方的参数 具体参数多是从KSP官方参考手册上查阅得来} $ENGINE_PAR_相应功能

点此查看更多内置变量

$EVENT_ID – 当前MIDI事件的ID，一些设计中会用到,多用在on note里
$PLAYED_VOICES_INST – 有多少个键在被按下
$NOTE_HELD – 音符正在被按着就是1，没被按着就是0
$ALL_GROUPS – 表示操作全部组，放在接口参数里用来操作全部的组

功能接口

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

{设置界面高度为几个格子} set_ui_height(4) {把界面组件放到指定格子的位置} move_control(界面组件,1,1) {在主音色窗口显示我们写的界面组件。写代码时预览窗会显示但回到主音色窗口就不显示，需要加这句} make_perfview {输出信息到Kontakt最下面的状态栏 一般用来Debug} message("输出信息") {设置旋钮显示的单位} set_knob_unit(界面组件，表示单位类型的内置变量) {设置旋钮默认的值} set_knob_defval(界面组件, 默认的值) {让kontakt自动保存和载入这个组件或变量的值} make_persistent(界面组件/变量) {设定指定的系统参数} set_engine_par(表示要调整的地方的内置变量，数值，作用于第几个Group，第几个效果器，哪个效果条) {获取指定的系统参数} get_engine_par(表示要获取的地方的内置变量，作用于第几个Group，第几个效果器，哪个效果条)

点此查看更多功能接口

set_key_color(按键MIDI编号，颜色) – 设置一个MIDI按键的颜色

play_note(哪个键，力度，样本偏移，持续多少毫秒) – 播放一个按键映射的采样，多用在on note里
ignore_event($EVENT_ID) – 无视当前MIDI事件，即按下去不发声，多用在on note里，之后常用play_note重定向

_get_engine_par_disp(表示要获取的地方的内置变量，作用于第几个Group，第几个效果器，哪个效果条) – 获取系统显示的参数

disallow_group(1) – 禁用或mute一个组，如果是全部组可用$ALL_GROUPS
allow_group(0) – 激活一个组

set_script_title("标题") – 设置代码编辑窗口的标题
set_ui_height_px(200) – 用像素设置界面高度
set_text(组件,新名) – 改显示名
set_knob_label() – 为旋钮设置显示内容

inc($myValue) – 自加，等同于$myValue = $myValue + 1
dec($myValue)) – 自减，等同于$myValue = $myValue – 1

wait(1000000) – 等待多少微秒，一秒等于1,000,000微秒

change_note($EVENT_ID, $EVENT_NOTE + 12) – 改变音高 本例中提高八度
change_velo($EVENT_ID, $EVENT_VELOCITY / 2) – 改变力度 本例中力度减半
change_pan($EVENT_ID, -1000, 0) – 移动摆位 本例中极左摆位
change_vol($EVENT_ID, -5000, 0) – 改变MIDI音量 本例中减少5db
change_tune($EVENT_ID, 50000, 0) – 改变音高偏移 本例中音高偏移50个cents

-> 格子
kontakt 的界面规格通常是由‘格子’来衡量的，而不是像素
来自 Toby Pitman 的图，演示了 Kontakt 的 ‘格子’，图中格子的 x, y 颠倒了，比如 1，2 那个位置的格子实际是 2，1

-> 哪个效果条
set_engine_par 和 get_engine_par 中最后一个参数的代表的不同效果条对应的值 Group:-1 Inseret:1 Send:0

流程控制

KSP中用来判断用的是’=’，用来赋值的是’:=’。

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16

on note     {  if  }     if($EVENT_VELOCITY>100)         message("力度大于100")     else         message("力度小于100")     end if     {  while  }     while($NOTE_HELD = 1)         message("MIDI按键正在被按着")     end while end on

点此查看更多流程控制

{ select }
select($EVENT_NOTE)
case 60
message("按了C3")
case 62
message("按了D3")
end select

查阅文档

真实开发中，我们需要一个字典一样的手册用来参考。
点此下载 Kontakt Script 官方参考手册 提取码: 8aqr
（若你所在的区域无法使用百度网盘，点击这里查看NI官网版本）
这手册像字典，不是用来看的，而是用来查的
下载下来，打开，然后按下快捷键 Ctrl + F (Mac是 command + F)
输入你要找的，比如 set_key_color，回车，阅读它的用法和各种颜色的代码。

-> 开始写代码

我说过KSP所有代码必须写在回调方法里，外部没有写代码的地方，那我们先写一个回调：

1 2	on init end on

这个回调里是在音源被加载/打开时被 kontakt 执行的
我们先用 make_perfview 打开音源显示界面组件的功能，然后用 set_ui_height() 调节一下界面高度

1 2 3 4 5 6

on init make_perfview set_ui_height(6) end on

点击代码框右上角Apply提交

再点扳手回到主界面看到，设置高度后背景显示出来了

界面

接着，我们定义一个旋钮，然后用 move_control 功能接口把它移动到 ‘1,3’ 位置的格子上


有个细节，kontakt 不用小数，而是用整数，表示 0% 到 100% 的 0-1 对应在 kontakt 里是 0-1 000 000 。
千分之称之为毫，千分之的千分之称为微，把 0-1 变成（0，1000000，1）这样的参数就达到了微分精度。
201x 年左右，一些银行的金融系统处理小数运算是先乘 100 算完然后除 100，这和编程语言的特性有关。kontakt 这么做可能是同样原因。

1 2 3 4 5 6 7 8

on init ... declare ui_knob $RevVol (0,1000000,1) move_control ($RevVol,1,3) end on

运行，出现了一个旋钮

同样地，定义四个旋钮

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17

on init ... declare ui_knob $RevVol (0,1000000,1) move_control ($RevVol,1,3) declare ui_knob $RevTime (0,1000000,1) move_control ($RevTime,1,5) declare ui_knob $DelayVol (0,1000000,1) move_control ($DelayVol,2,3) declare ui_knob $DelTime (0,1000000,1) move_control ($DelTime,2,5) end on

我们看到，这四个旋钮下方的数值都没有单位，用 set_knob_unit 功能接口为它们加上单位。
这接口怎么用呢，文档里搜一下，找到 $KNOB_UNIT_DB 和 $KNOB_UNIT_MS 参数 是我们需要的。

1 2 3 4 5 6 7 8 9 10 11 12

on init ... set_knob_unit ($RevVol,$KNOB_UNIT_DB) set_knob_unit ($DelayVol,$KNOB_UNIT_DB) set_knob_unit ($RevTime,$KNOB_UNIT_HZ) set_knob_unit ($DelTime,$KNOB_UNIT_HZ) end on

好了，现在就显示单位了

接下来我希望让 kontakt 保存这些旋钮，否则当用户关闭再打开这个工程时，这些旋钮全部会自动清零，无法保存在工程中。使用 make_persistent() 的功能接口，可以让某个组件被自动保存在工程中 (在编程中，这个步骤叫做 数据持久化)

1 2 3 4 5 6 7 8 9 10 11

on init ... make_persistent($RevVol) make_persistent($DelayVol) make_persistent($RevTime) make_persistent($DelTime) end on

好了，现在我们定义了控制混响音量和时长的旋钮，以及控制延迟音量和时长的旋钮，接下来要实现混响和延迟的功能。

Kontakt Script 实现音频效果的方式主要是 -> 挂上kontakt内置的效果器 -> 用代码控制内置效果器参数

我们先挂上效果器吧，有三个位置可以挂，Group, Insert, Send。自己根据需求挂不同地方，这里我把效果挂在 Insert 里。挂在不同的位置会影响到后面使用 set_engine_par 和 get_engine_par 的最后一个参数的不同。

set_engine_par 和 get_engine_par 中最后一个参数的代表的不同效果条对应的值 Group:-1 Inseret:1 Send:0



我们来到InsertEffects标签页，点第一个效果框右下角的加号，挂上一个 Delay

然后同理，在第二个效果框上挂一个 Reverb

然后点击 Delay, 我们看一下，下面这些 Delay 的参数也就是在代码中用 get_engine_par 和 set_engine_par 交互到的参数。

Reverb也是同理。
我们根据自己的混音经验预先调整好一些，然后选几个常用的让我们写的界面组件控制。

用界面控制效果器

现在编写让界面组件和效果器的参数交互的代码。

那么，要把代码写在什么地方呢？我之前说过，ksp 的代码只能写在回调方法里，之前的代码都是写在 on init 回调里的，这个回调只在一开始打开 kontakt 时执行。
如果要让一段代码在每次旋钮转动时就设定效果器的参数，那显然不能写在 on init 里。因为 on init 里的代码只在音源一打开的时候执行一次，之后就不再执行了。
细心的同学应该看到，在上面的‘ -> 认识KSP脚本 的 回调方法 里’，还有 on ui_control 这个回调，它在界面组件和用户发生交互时执行，那就把代码写在这个回调里。

1 2 3

on ui_control($RevVol)     set_engine_par($ENGINE_PAR_SEND_EFFECT_OUTPUT_GAIN, $RevVol, -1, 1, 1) end on

首先，我们用 on ui_control() 后面的括号指定了是当 $RevVol 这个旋钮转动时才执行它里面的代码

然后我们用了

set_engine_par

来看一下这个接口的参数：


1.第一个参数是指定设置系统哪一种参数，这里的 ‘$ENGINE_PAR_SEND_EFFECT_OUTPUT_GAIN’ 它告诉 kontakt，我要控制的是效果器 wet 量，也就是效果器的效果音的成分。

2.第二个参数，就是指把要设置的系统参数改成什么值，同样也是 0-1000000 的范围，这个范围在 kontakt 里代表 0% 到 100%。这里我们直接把旋钮扭到的值赋给 wet 量，也就是效果音的量。（这就之前为什么把旋钮的取值设定为从0-1000000 : declare ui_knob $RevVol (0,1000000,1)）

3.第三个参数为操作哪一个组，0代表第一个组，1代表第二个组，以此类推。这里我们的效果器是放在 Insert 里的，它作用于全局，不属于任何一个组，所以这里填上 -1。

4.第四个参数就是第几个效果块，英文管这叫slot中文是插槽的意思。看一下上面那张图，在 InsertEffects 标签页中，我们之在第一个插槽上挂的是Delay，第二个插槽上挂的Reverb。所以Reverb在第二个，那这里就写1。（0 代表第一个，1 代表第二个）

5.最后一个参数就是指在哪个效果条（标签页）里了，下面这张图在本文是第三次出现了。我是把效果器挂在InsertEffect标签页里的，这个标签页对应的的是1。这里就写1。

set_engine_par 和 get_engine_par 中最后一个参数的代表的不同效果条标签页所对应的值 Group: -1 Inseret: 1 Send: 0

好，以此类推，我们再连接第二个旋钮

1 2 3

on ui_control($RevTime)     set_engine_par($ENGINE_PAR_RV2_TIME, $RevTime, -1, 1, 1) end on

和第一个按钮的代码一样，只是把参数换成了 $ENGINE_PAR_RV2_TIME，这是我在操作手册中查到对应混响时间的参数。

接着连接控制Delay的两个旋钮。

1 2 3 4 5 6 7

on ui_control($DelayVol)     set_engine_par($ENGINE_PAR_SEND_EFFECT_OUTPUT_GAIN, $DelayVol, -1, 0, 1) end on on ui_control($DelTime)     set_engine_par($ENGINE_PAR_RDL_TIME, $DelTime, -1, 0, 1) end on

试一下，起效果了！

显示数值

等等，我们发现旋钮下方显示的值不太对，显示的是 0 – 1000000 的值，之前提到过，这个值在 kontakt 里 代表 0% 到 100%。

但是在 InsertEffects 里 Reverb 参数中的显示却是正确的。

于是我想把这里显示的值拿到旋钮下面显示，就用到这个接口：_get_engine_par_disp，它是获取系统参数显示出来的值，而不是对应 kontakt 的 0% 到 100% 的 0-1000000 的微分值。
获取到以后 用 set_knob_label 放到旋钮上显示

1 2 3

on ui_control($RevVol)     set_knob_label($RevVol, _get_engine_par_disp($ENGINE_PAR_SEND_EFFECT_OUTPUT_GAIN,-1,1,1)) end on

如此类推，应用到四个旋钮上，界面就全部搞定了。

练习：
已知如下接口可以设置效果器的旁通 bypass
set_engine_par($ENGINE_PAR_SEND_EFFECT_BYPASS, 0, -1, 1或0, 1) ：关
set_engine_par($ENGINE_PAR_SEND_EFFECT_BYPASS, 1, -1, 1或0, 1) ：开
你能否设计两个按钮来控制 reverb 和 delay 的旁通效果？

(答案见源码)

键盘色彩

我听了一下这个呼吸包，发现里面有一些呼吸声比较甜，还有一些则像是吸面条般的声音，我不知道是用在哪的。
然后我想把比较甜的声音标记出来，在键盘上面，把它们的位置标红。

这里用到 set_key_color 接口，打开手册查一下它

根据这些参数。我设置了一下整体键盘的色彩，之前在Ksp中更多功能接口里写了，inc($x) 是 $x 自加的意思 $x = $x + 1

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

on init ... declare $keys set_key_color(36, $KEY_COLOR_RED) set_key_color(38, $KEY_COLOR_MAGENTA) $keys := 40 while ($keys<52)     set_key_color($keys, $KEY_COLOR_NONE)     inc($keys) end while set_key_color(52, $KEY_COLOR_RED) set_key_color(53, $KEY_COLOR_MAGENTA) $keys := 54 while ($keys<72)     set_key_color($keys, $KEY_COLOR_GREEN)     inc($keys) end while set_key_color(72, $KEY_COLOR_RED) set_key_color(74, $KEY_COLOR_MAGENTA) $keys := 75 while ($keys<92)     set_key_color($keys, $KEY_COLOR_CYAN)     inc($keys) end while end on

Apply后，得到这样的效果

到这我们的音源就完成了。

扩展阅读

-> 如何录制多个Group 实现多套映射

我们之前在介绍 Group Editor 的时候提到过，多个 Group 可以实现音色切换、合成多个摆位的麦克风等功能。
这都是非常实用的功能，我们来看看是怎么做的。

1.先打开 Group Editor, 然后点击 Create Empty Group

 

2.选中新的 Group，双击可以重命名。

3.打开 Mapping Editor，先取消勾选 ‘AutoSel. Grp'(是默认选中的)，然后勾选 ‘Selected Groups only’。

现在映射窗口里就是新的组了。
点击 Group1 再点新创建的 Group, 就看见映射窗的内容不同了（如果做过映射）。

-> Wave Editor 怎么用

同样地，之前在介绍 Wave Editor 时，我提到过，这个编辑器可以实现让一段不持续的音无限持续延长的功能。
现代作品中，这个技术在弦乐和人声比较常见，我们来看一下具体怎么做。

1.先把其他Editor关了，就打开 Mapping Editor 和 Wave Editor 两个窗口。

2.在Mapping Editor 映射窗里中选中一个音频块，然后就在Wave Editor里看到它了。
接下来开启 Sample Loop 的开关，然后就出现了设置Loop范围的黄色的区域，接下来拖动黄色区域调整Loop的范围就行了。

工欲善其事，必先利其器

在 kontakt 的 Script Editor 里写代码，除了最后 Apply 时知道对错之外，中途就完全没有任何信息。
选用一款合适的文本编辑器，可以大大提升我们的效率和体验。它可以像个助理一样告诉你代码的对错，提示你各种接口的用法，以及帮你自动输入变量和接口。
我们可以在外界用文本编辑器写好代码，写完再放到 kontakt 的 Script Editor 里运行。

打开 Sublime Text官网 下载对应你的系统的 Sublime Text -> 安装 -> 打开

然后在 Sublime Text 中 按下 Shift + Ctrl + P (Mac是 shift + command + P) 出现一个输入框，输入 install，选中这个 回车 （或点击它）

等一会 出现这个界面，

点确定，然后再次按下 Shift + Ctrl + P，输入 install, 选择 Install Package
等一会，就会出现了一个新的空的输入框，在新的输入框里输入 ksp，选这个，回车（或点击它）

等一会弹出这个界面，整个就安装好了。

用的时候在右下角这里选上 KSP 类型

就有代码提示和自动补全了

 

 

后记

一切技术在理解了以后都是简单的。如果我们觉得一个东西很厉害很高端，那只说明我们不够了解它。

WE CAN KEEP IT SIMPLE BABY, LETS NO MAKE IT COMPLICATED.
LABELS ARE SO OVERRATED, LETS NO MAKE IT COMPLICATED.

Complicated – Dimitri Vegas & Like Mike / David Guetta / Kiiara

1. 1. Complicated – Dimitri Vegas & Like Mike / David Guetta / Kiiara

 

点击这里下载源码

课程进度60%

]]>