SooperLooper 技术文档

1. 安装指南

SooperLooper 是一款实时循环采样器，支持 Linux/Unix 和 OS X 平台。以下是安装步骤：

对于 Linux/Unix 用户：

1. 首先确保安装了以下依赖包：

   • JACK (版本 >= 0.80)
   • wxWidgets (版本 2.6.x, 2.8, 或 3.x)
   • liblo (版本 >= 0.18)
   • sigc++ (版本 >= 2)
   • libsndfile
   • libsamplerate
   • ncurses
   • libxml2
   • RubberBand
   • fftw3 (由 RubberBand 需要)

2. 克隆项目仓库并编译：

   git clone https://github.com/jessechappell/sooperlooper.git
   cd sooperlooper
   mkdir build && cd build
   cmake ..
   make
   

3. 运行 make install 命令以安装。

对于 OS X 用户：

1. 下载并安装 JACK-OS X。
2. 下载并解压 SooperLooper 的 OS X 包。
3. 双击应用程序以启动 GUI 和引擎。

2. 项目的使用说明

SooperLooper 的主要引擎是可执行文件 sooperlooper。可以使用 GUI slgui 或基于控制台的测试客户端 slconsole 来与引擎通信。

• 运行 sooperlooper -h 获取命令行选项帮助。
• 使用 MIDI 绑定文件选项 -m，并查看示例 oxy8.slb 和 midiwizard.slb 来编写自己的配置。

引擎可以通过 MIDI 控制，Linux 使用 ALSA 序列器接口，OS X 使用 CoreMidi。通过右键菜单选择学习选项来绑定学习式控制。在按钮或滑块上点击鼠标中键是开始学习的快捷方式。可以通过 GUI 中的 MIDI 绑定窗口编辑、加载和保存 MIDI 绑定。

3. 项目 API 使用文档

SooperLooper 提供了 OSC 接口，实现了对引擎的网络透明控制。以下是 API 的基本使用方法：

• 使用 OSC 消息控制引擎的各个功能。
• OSC 接口地址通常为 localhost，端口默认为 9953。
• 示例：使用 OSC 消息启动循环录音。

{
  "address": "/sooperlooper/record",
  "args": []
}

• 更多 API 详细信息可以在项目文档中找到。

4. 项目安装方式

Linux/Unix：

1. 通过源代码编译和安装，如上所述。

OS X：

1. 下载并安装预编译的 OS X 包。

请确保正确安装所有依赖项，并遵循上述安装指南。如有疑问，请参考项目文档或联系开发者社区。

---

本文档提供了 SooperLooper 的安装、使用和 API 的基本介绍，帮助用户更好地理解和操作这款实时循环采样器。