csound

Csound 的Rust绑定。

文档可在这里找到

目录

1. 安装
   1. Linux/BSDs
   2. macOS
   3. Windows
2. 入门
3. 许可
4. 贡献

安装

要构建Csound绑定或任何依赖于此软件包的项目，您至少需要Csound 6.11，不支持早期版本。默认情况下（唯一支持的方式），此软件包将尝试动态链接到系统范围内的libcsound64。

Linux/BSDs

您可以使用您的发行版软件包管理器安装Csound，或者如果您的软件包管理器有一个不支持版本的Csound（<6.11），您必须从源代码构建它。

在Debian/Ubuntu上，可以使用以下命令安装Csound：

# Make sure the version of this package is >= 6.11
$ apt-get install libcsound64-6.0 libcsound64-dev

此外，您也可以从源代码编译并安装（推荐）

# First, install all the csound's dependencies
$ apt-get install build-essential libportaudio2 portaudio19-dev cmake /
flex bison libsndfile1-dev libsndfile1

然后，克隆csound的源代码

# Clone Csound from its repository
$ git clone https://github.com/csound/csound.git

编译并安装库。

# Clone Csound from its repository
$ cd csound/
$ cmake . && make && sudo make install
$ sudo ldconfig

Csound将被安装在/usr/local/lib，build.rs脚本将在这里查找csound的二进制文件。因此，如果您在bashrc中导出此路径或编写正确的pkg-config文件，这可能是一个好主意。

macOS

请随意提交一个pull request，其中包含应用于构建脚本和关于如何使用此软件包以及如何使用csound的本地库的说明的变化。

Windows

下载适用于windows的csound安装程序，按照安装步骤操作。

1. 找到您的csound安装目录（通常为C:\Program Files\Csound6_x64）
2. 打开命令提示符（确保以管理员身份运行，以便您能够添加系统环境变量）。
3. 按如下方式设置环境变量

$ setx CSOUND_LIB_DIR "C:\\Program Files\\Csound6_x64\\lib"

4. 重新启动命令提示符以重新加载环境变量，然后使用以下命令检查是否已正确添加。

$ echo %CSOUND_LIB_DIR%

您应该看到您的Csound库安装路径。

入门

API参考可在此找到此处

要开始使用Csound-rs，您需要了解一些关于Csound的基本概念，然后再尝试使用这些绑定。请查看Csound网站上的“入门”页面 入门。此外，在rust目录中还有csound api的示例。

Csound的rust示例

熟悉Csound的简单方法就是探索示例。要获取示例，我们只需要克隆这个存储库。

# Clone Csound from its repository
$ git clone https://github.com/neithanmo/csound-rs.git

现在，进入存储库目录

# Clone Csound from its repository
$ cd csound-rs

要运行示例1到10，只需

# Runs the example 5
$ cargo run --release --example example5

示例11需要一些依赖项，但您可以通过调用它们的Cargo.toml文件上的cargo来运行它们

# Runs the example 11
$ cd examples/example11
$ cargo --release build
$ cargo run

许可

csound-rs许可协议为以下之一

• Apache许可证2.0版，(LICENSE-APACHE或http://apache.ac.cn/licenses/LICENSE-2.0)
• MIT许可证(LICENSE-MIT或http://opensource.org/licenses/MIT)

任选其一。

Csound本身根据较宽松的通用公共许可证版本2.1或（根据您的选择）任何后续版本进行许可：https://www.gnu.org/licenses/lgpl-2.1.html

贡献

欢迎以拉取请求的形式提供任何类型的贡献。

除非您明确声明，否则您提交给csound-rs的任何贡献，根据Apache-2.0许可证定义，将作为上述双重许可，不附加任何额外条款或条件。