---
id: "mnsll60q-0j911u"
name: "Paper.js API: Point 和 Size 参数规范"
type: "reference"
project: "foliko-poster-plugin"
tags: [paper.js, bug-fix, api-usage, poster-plugin]
created: "2026-04-10"
---
**Paper.js 创建图形时 point/size 参数必须使用对象而非数组**

**Why 重要：**
- Paper.js 中 Path.Rectangle、PointText 等图形构造函数的 `point` 参数需要是 `paper.Point` 对象，不是 `[x, y]` 数组
- `size` 参数需要是 `paper.Size` 对象，不是 `[width, height]` 数组
- 错误用法不会报错，但图形不会正确渲染

**How to apply：**
```javascript
// ✅ 正确写法
new paper.Path.Rectangle({
  point: new paper.Point(x, y),
  size: new paper.Size(width, height)
})

new paper.PointText({
  point: new paper.Point(x, y),
  content: 'text'
})

// ❌ 错误写法（不会报错但无效）
new paper.Path.Rectangle({
  point: [x, y],
  size: [width, height]
})
```

**涉及文件：** `.agent/plugins/poster-plugin/components/button.js`