🎨 Unity SpriteShape 技术文档

1. SpriteShapeProfile

作用：定义精灵形状的外观和资源配置，用于生成地形或封闭图形。

常用属性

• Use Sprite Borders
  是否使用精灵边框（九宫格拉伸）。
• Texture
  用于填充实心部分的纹理（必须设置为 Repeat 平铺模式）。
• Offset
  纹理偏移量。
• Angle Ranges
  • Start：起始角度
  • End：结束角度
  • Order：优先级（Sprite 相交时，优先级高的显示在前面）
  • Sprites：指定角度范围内的精灵列表
• Corners
  • 外部角精灵
  • 内部角精灵

使用场景

• 开放图形（如路径、河流）。
• 封闭图形（如岛屿、地块）。

---

2. SpriteShapeRenderer

作用：负责精灵形状的渲染，包括材质、颜色和排序。

常用属性

• Color
  设置渲染颜色。
• Mask Interaction
  遮罩交互规则。
• Fill Material / Edge Material
  填充材质与边缘材质。
• Sorting Layer / Order in Layer
  控制渲染层级与顺序。

使用场景

• 控制 SpriteShape 的外观表现。
• 与其它 Sprite 交互时调整显示顺序。

---

3. SpriteShapeController

作用：控制 SpriteShape 的形状、质量和交互逻辑。

常用属性

• Profile
  使用的 SpriteShapeProfile 文件。
• Detail
  精灵形状的质量（高/中/低）。
• Is Open Ended
  是否开放（不封闭）。
• Adaptive UV
  自适应 UV：宽度够时平铺，不够时拉伸。
• Optimize Geometry
  优化三角形数量，减少渲染开销。
• Enable Tangents
  是否启用切线计算（着色器需要时勾选）。
• Corner Threshold
  拐角阈值，达到角度时使用角精灵。
• Stretch UV
  是否拉伸 UV。
• Pixel Per Unit
  Unity 单位对应多少像素。
• Worldspace UV
  使用世界坐标的 UV 填充纹理。

编辑模式下的属性

• Tangent Mode
  • 顶点模式：点两侧不构成曲线
  • 切线模式：点两侧构成曲线，可调节弧度
  • 左右切线模式：分别控制左右两侧切线弧度
• Position
  控制点的局部坐标位置。
• Height
  控制点左右两侧精灵图片的高度。
• Corner
  是否使用角度图片（Disabled / Automatic）。
• Sprite Variant
  指定使用的精灵图片。
• Snapping
  是否开启捕捉控制点。

---

4. 碰撞器生成

SpriteShape 可以自动生成碰撞器：

• Edge Collider 2D
  用于开放路径。
• Polygon Collider 2D + Composite Collider 2D
  用于封闭图形，需勾选 Used By Composite。

---

📌 总结

• SpriteShapeProfile：定义外观和资源。
• SpriteShapeRenderer：负责渲染和排序。
• SpriteShapeController：控制形状、质量和交互逻辑。

---