Coffee Physics 技术文档

1. 安装指南

在开始使用 Coffee Physics 之前，您需要确保已经安装了 CoffeeScript 环境。以下是安装步骤：

1. 安装 Node.js 和 npm（如果尚未安装）。
2. 使用 npm 安装 CoffeeScript 编译器：

   npm install -g coffeescript
   

3. 将 CoffeeScript 文件编译为 JavaScript：

   coffee --compile coffee/*.coffee
   

编译完成后，您可以在浏览器中运行生成的 JavaScript 文件。

2. 项目的使用说明

Coffee Physics 是一个轻量级的物理引擎，使用 CoffeeScript 编写。它的设计目标是简单易用，以下是一个快速示例：

# 创建一个使用 Verlet 积分方法的物理实例
var physics = new Physics()
physics.integrator = new Verlet()

# 设计粒子行为
var avoidMouse = new Attraction()
var pullToCenter = new Attraction()

# 允许粒子碰撞以增加趣味性
var collision = new Collision()

# 使用 Sketch.js 以简化操作
var example = Sketch.create({ container: document.body })

example.setup = ->
    for i in [0...200]
        # 创建粒子
        var particle = new Particle(Math.random())
        var position = new Vector(random(this.width), random(this.height))
        particle.setRadius(particle.mass * 10)
        particle.moveTo(position)

        # 使其可碰撞
        collision.pool.push(particle)

        # 应用行为
        particle.behaviours.push(avoidMouse, pullToCenter, collision)

        # 添加到模拟中
        physics.particles.push(particle)

    pullToCenter.target.x = this.width / 2
    pullToCenter.target.y = this.height / 2
    pullToCenter.strength = 120

    avoidMouse.setRadius(60)
    avoidMouse.strength = -1000

    example.fillStyle = '#ff00ff'

example.draw = ->
    # 进行模拟步骤
    physics.step()

    # 渲染粒子
    for i in [0...physics.particles.length]
        var particle = physics.particles[i]
        example.beginPath()
        example.arc(particle.pos.x, particle.pos.y, particle.radius, 0, Math.PI * 2)
        example.fill()

example.mousemove = ->
    avoidMouse.target.x = example.mouse.x
    avoidMouse.target.y = example.mouse.y

3. 项目API使用文档

以下是 Coffee Physics 的一些主要类和方法：

• Physics：物理引擎的实例，负责管理粒子和行为。

  • new Physics()：创建一个新的物理实例。
  • integrator：设置积分方法，例如 new Verlet()。
  • particles：物理实例中的粒子数组。

• Particle：代表一个粒子。

  • new Particle(mass)：创建一个新的粒子，其中 mass 是粒子的质量。
  • setRadius(radius)：设置粒子的半径。
  • moveTo(position)：将粒子移动到指定位置。

• Vector：表示二维向量。

  • new Vector(x, y)：创建一个新的向量。

• Attraction：表示吸引力行为。

  • setRadius(radius)：设置吸引力的作用半径。
  • strength：设置吸引力的强度。

• Collision：表示碰撞检测和行为。

  • pool：可碰撞粒子池。

4. 项目安装方式

Coffee Physics 的安装方式已在“安装指南”中详细说明。确保安装 CoffeeScript 编译器后，将 CoffeeScript 文件编译为 JavaScript，然后将其包含在您的 HTML 文件中。