Tidal 项目技术文档

1. 安装指南

1.1 系统要求

• 操作系统：支持 Windows、macOS 和 Linux。
• 依赖软件：需要安装 Haskell 和 SuperCollider。

1.2 安装步骤

1. 安装 Haskell：

   • 访问 Haskell 官方网站，下载并安装适合你操作系统的 Haskell 版本。
   • 安装完成后，确保 Haskell 的 cabal 工具可用。

2. 安装 SuperCollider：

   • 访问 SuperCollider 官方网站，下载并安装适合你操作系统的 SuperCollider 版本。
   • 安装完成后，启动 SuperCollider 并运行以下代码以安装 TidalCycles 插件：

     Quarks.install("SuperDirt");
     Quarks.install("Vowel");
     

3. 安装 TidalCycles：

   • 打开终端或命令行工具，运行以下命令安装 TidalCycles：

     cabal update
     cabal install tidal
     

4. 配置 SuperCollider：

   • 启动 SuperCollider，运行以下代码以启动 SuperDirt：

     SuperDirt.start;
     

2. 项目的使用说明

2.1 启动 TidalCycles

• 打开你喜欢的文本编辑器（如 Atom、VSCode 等），安装 TidalCycles 插件。
• 在编辑器中新建一个文件，输入以下代码以启动 TidalCycles：

  import Sound.Tidal.Context
  

2.2 编写和运行代码

• 使用 TidalCycles 的语言编写算法模式代码，例如：

  d1 $ sound "bd sn"
  

• 运行代码，TidalCycles 将实时生成音乐。

3. 项目API使用文档

3.1 基本语法

• d1, d2, ..., d9：定义不同的音轨。
• sound：指定声音样本。
• note：指定音高。
• speed：指定播放速度。

3.2 示例代码

• 播放简单的节奏：

  d1 $ sound "bd hh sn hh"
  

• 播放带有音高的旋律：

  d2 $ note "c3 e3 g3"
  

4. 项目安装方式

4.1 通过 Cabal 安装

• 使用 Haskell 的 cabal 工具安装 TidalCycles：

  cabal update
  cabal install tidal
  

4.2 通过源码安装

• 克隆 TidalCycles 的 GitHub 仓库：

  git clone https://github.com/tidalcycles/Tidal.git
  

• 进入项目目录并编译安装：

  cd Tidal
  cabal install
  

通过以上步骤，你可以顺利安装并使用 TidalCycles 进行实时算法音乐创作。