Choreograph 技术文档

1. 安装指南

Choreograph 是一个简单、现代的 C++ 动画和时间库。在开始使用前，请确保您的开发环境满足以下要求：

• 现代的 C++ 编译器，支持 C++11 特性。已知兼容的编译器包括 Apple LLVM 6.0 (Clang 600) 和 Visual Studio 2013。

安装步骤如下：

1. 将 Choreograph 的头文件包含到您的项目的搜索路径中。
2. 将 .cpp 文件添加到您的项目中（可以通过拖拽的方式添加）。
3. 如果您使用的是 Cinder 框架，可以通过 Tinderbox 创建新项目，并将 Choreograph 作为模块包含进去。

Choreograph 本身没有第三方依赖。

2. 项目使用说明

Choreograph 允许您通过创建动画短语 (Phrases) 并组合成序列 (Sequences)，进而应用到一个时间线上来描述运动。以下是一个基本的使用示例：

// 创建一个应用于变量的序列。
timeline.apply( &variable )
  .then<RampTo>( value, 1.0f, EaseInOutQuad() )
  .then<RampTo>( other_value, 0.5f );

您还可以使用更复杂的短语，包括程序和累加器，以实现更丰富的动画效果。

3. 项目 API 使用文档

以下是一些关键概念的简要说明：

• Phrase: 定义了随时间变化的值，例如 "在三秒内上下弹跳"。
• Sequence: 是短语的集合，用于构建动画。
• Motion: 将序列连接到输出值，具有开始、结束和更新状态。
• Output: 一种模板，用于安全地动画化任何类型。
• Cue: 在特定时间点调用的函数，用于触发事件。
• Timeline: 管理一组时间线项目（包括运动和提示）。

具体 API 的使用方法，请参考项目中的示例和文档。

4. 项目安装方式

安装方式已在“安装指南”部分详细说明。简要概括如下：

• 确保您的编译器支持 C++11。
• 将头文件添加到项目搜索路径。
• 将 .cpp 文件添加到项目中。
• 如果使用 Cinder，可以通过 Tinderbox 添加 Choreograph 作为模块。

通过以上步骤，您可以开始使用 Choreograph 库来创建动画。