Pyo文档（二）实例

"""
01-audio-server.py - 引导音频服务器。

服务器对象要在所有别的音频对象之前生成。
服务器对象负责与音频与midi驱动程序通信，
还负责跟踪处理链条。
"""
from pyo import *

# 生成服务器（Server）对象，使用缺省参数。
# 请看手册，看如何更改采样率、缓冲大小、声道数，
# 或别的全局设置。
s = Server()

# 引导服务器。此步骤使音频与midi流初始化。
# 音频与midi配置（如果有）必须在此回调之前完成。
s.boot()

# 开动服务器。此步骤激活服务器的处理循环。
s.start()

# 这里放置处理链条...

# 服务器对象提供一个图形用户界面，通过
# `gui()`方法。其目的在于保持程序激活，
# 期间计算采样需要耗时。如果用`locals`字典作
# 参数，用户可以不断地从GUI发送命令到
# Python解释器。
s.gui(locals())

"""
02-sine-tone.py - 音频编程的"hello world"！

本脚本简单地播放一个1000Hz正弦声音。
"""
from pyo import *

# 生成、引导服务器。
# 用户要从GUI发送`start`命令。译注：
# 用GUI上的`start`按钮，或在GUI的
# 解释器单元格中输入`s.start()`脚本。
s = Server().boot()
# 降低增益到20 dB。
s.amp = 0.1

# 生成正弦波播放器。
# `out()`方法开动处理过程
# 并把信号发送到输出。
a = Sine().out()

# 打开服务器的图形界面。
s.gui(locals())

"""
03-parallel-proc.py - 单个资源的多重处理。

本例展示如何同时播放不同的音频对象。
所有处理对象（即调整音频资源的东西）的
第一个参数都叫“输入/input”。此参数接收
音频对象，以用于处理。

注意，输入变量给到处理对象，而调用
每个对象的`out()`方法将发送其采样到输出。
"""
from pyo import *

s = Server().boot()
s.amp = 0.1

# 生成正弦波，作为资源以供处理。
a = Sine()

# 通过一个泛音器传递正弦波。
hr = Harmonizer(a).out()

# 同时通过一个合唱起。
ch = Chorus(a).out()

# 同时通过一个移频器。
sh = FreqShift(a).out()

s.gui(locals())

"""
04-serial-proc.py - 链接单个资源的多个处理。

本例展示如何链接单个资源的多个处理。
所有处理对象（即调整音频资源的东西）的
第一个参数都叫“输入/input”。此参数接收
音频对象，以用于处理。

注意输入变量给到了每个泛音器。
"""
from pyo import *

s = Server().boot()
s.amp = 0.1

# 生成一个正弦波，用作处理资源。
a = Sine().out()

# 通过一个泛音器传递正弦波。
h1 = Harmonizer(a).out()

# 然后泛化的音通过另一个泛音器。
h2 = Harmonizer(h1).out()

# 然后又。。。
h3 = Harmonizer(h2).out()

# 然后又。。。
h4 = Harmonizer(h3).out()

s.gui(locals())

"""
05-output-channels.py - 发送信号到不同的物理输出。

选择输出声道（以接收声音）的最简单方法，是把它作为`out()`方法的
第一个参数。实际中，`out()`方法的签名如下：

`.out(chnl=0, inc=1, dur=0, delay=0)`

`chnl`是输出，这是对象的第一个声道（流）要发送到的地方。
`inc`是给别的声道的输出增量。`dur`是处理过程的持续时间，以秒计。
持续时间为0，表示一直播放。`delay`是激活处理前的延迟，以秒计。
"""
from pyo import *

s = Server().boot()
s.amp = 0.1

# 生成一个资源（白噪音）
n = Noise()

# 发送低频（地狱1000Hz）到左声道
lp = ButLP(n).out()

# 发送高频（高于1000Hz）到右声道
hp = ButHP(n).out(1)

s.gui(locals())

"""
01-fixed-control.py - 用数字作参数。

要控制音频对象的行为，可在初始化时
传值给参数。
"""
from pyo import *

s = Server().boot()
s.amp = 0.1

# 设置基础频率
freq = 200

# 模拟三角波形，方法是添加奇次泛音（奇次谐波），
# 其振幅与泛音数字的平方之倒数成比例。
h1 = Sine(freq=freq, mul=1).out()
h2 = Sine(freq=freq*3, phase=0.5, mul=1./pow(3,2)).out()
h3 = Sine(freq=freq*5, mul=1./pow(5,2)).out()
h4 = Sine(freq=freq*7, phase=0.5, mul=1./pow(7,2)).out()
h5 = Sine(freq=freq*9, mul=1./pow(9,2)).out()
h6 = Sine(freq=freq*11, phase=0.5, mul=1./pow(11,2)).out()

# 显示最终波形
sp = Scope(h1+h2+h3+h4+h5+h6)

s.gui(locals())

"""
02-dynamic-control.py - 以图形控制参数。

使用Pyo，便于快速尝试一些参数联合体，
要用的控制窗口已经为有每个对象都配置好了。
要打开控制窗口，只要在你想要控制的对象上面，
调用`ctrl()`方法。
"""
from pyo import *

s = Server().boot()
s.amp = 0.1

# 生成两个对象，都有很酷的参数，对象各对应一个声道。
a = FM().out()
b = FM().out(1)

# 打开控制窗口
a.ctrl(title="Frequency modulation left channel")
b.ctrl(title="Frequency modulation right channel")

s.gui(locals())