cl-collider 项目使用教程

1. 目录结构及介绍

cl-collider 是一个用于 Common Lisp 的 SuperCollider 客户端。以下是项目的目录结构及其简单介绍：

• osc/：包含处理 OSC (Open Sound Control) 消息的相关代码。
• ugens/：包含实现 SuperCollider 单元生成器（UGens）的 Common Lisp 代码。
• .gitignore：指定 Git 忽略的文件和目录。
• LICENCE：项目的许可协议文件。
• README.md：项目的介绍和说明文件。
• buffer.lisp：实现缓冲区管理的代码。
• bus.lisp：实现音频总线控制的代码。
• cl-collider.asd：Common Lisp 系统的定义文件，用于快速加载项目。
• id-map.lisp：实现 ID 映射的代码。
• operators.lisp：实现操作符的代码。
• package.lisp：定义项目包的代码。
• scheduler.lisp：实现调度器的代码。
• server-options.lisp：服务器选项配置代码。
• server.lisp：实现 SuperCollider 服务器通信的代码。
• slynk-extensions.lisp：为 Slynk 提供扩展功能的代码。
• swank-extensions.lisp：为 Swank 提供扩展功能的代码。
• synthdef.lisp：实现合成器定义的代码。
• ugen.lisp：实现 SuperCollider 单元生成器的代码。
• util.lisp：包含一些实用工具的代码。

2. 项目的启动文件介绍

项目的启动主要是通过 cl-collider.asd 文件来完成的。这个文件定义了一个 Common Lisp 系统，它包含了项目中所有的文件，使得你可以通过简单的命令来加载整个项目。

在 Common Lisp 环境中，你可以使用以下命令来加载 cl-collider 系统：

(ql:quickload "cl-collider")

加载完成后，你可以在 Common Lisp 环境中使用该系统的功能。

3. 项目的配置文件介绍

cl-collider 项目的配置主要通过几个全局变量来进行，这些变量定义了 SuperCollider 服务器的路径、插件路径和合成器定义路径等。

以下是一些主要的配置变量：

• *sc-synth-program*：SuperCollider 合成器程序的路径。
• *sc-plugin-paths*：SuperCollider 插件搜索路径的列表。
• *sc-synthdefs-path*：合成器定义文件（SynthDef）的路径。

你可以在加载系统后，根据实际情况设置这些变量：

(setf *sc-synth-program* "/path/to/scsynth")
(setf *sc-plugin-paths* (list "/path/to/plugin_path" "/path/to/extension_plugin_path"))
(setf *sc-synthdefs-path* "/path/to/synthdefs_path")

完成这些配置后，你就可以使用 cl-collider 与 SuperCollider 服务器进行通信，并创建音乐和声音效果了。