Polyline## Polyline 控件

基础显示

• Show View Controls
  控制是否在 Viewer 中显示路径、中心点、尺寸和其他交互控制。

  

• Antialias
  开启后线条边缘会更平滑，但渲染成本会略微增加。

• Level
  透明度调整。

• Soft Edge
  控制线条边缘柔化程度。默认值为 0。

• Thickness
  控制基础线宽。最终线宽会结合该值与宽度曲线共同计算。

路径与细分

• Smoothness
  控制 Bezier / B-Spline 路径内部的采样平滑度。数值越高，曲线和拐角处的近似会更细腻。

• Subdivision
  控制最终曲线由多少采样点组成。较长的线段会按比例生成更多点。

• Adaptive Distribution
  根据宽度曲线控制细分点在路径上的分布方式。

  0 表示均匀分布，不根据线宽重新分配采样点。

  数值大于 0 时，会向较粗的线段区域分配更多采样点。

  数值小于 0 时，会向较细的线段区域分配更多采样点。

  当宽度曲线变化较明显，并且希望粗线或细线区域获得更多采样细节时，可以使用该参数。

线条样式

• Border Style
  选择线条类型：Solid、Wave、Dash、Dot。

• Line Cap
  在 Solid / Wave 模式中，选择线段端头样式：Round、Flat、Point。
  Round 为圆头，Flat 为平头，Point 为尖头。

  

• Spacing
  在 Wave / Dash / Dot 模式中，控制波浪、虚线线段或点之间的间距。

• Dash Length
  在 Dash 模式中，控制单个虚线线段的长度。

• Offset
  在 Wave / Dash / Dot 模式中，控制样式沿路径的偏移。
  在 Wave 模式中，该偏移会让波浪沿路径流动，而不是简单平移波形。

• Wave Offset
  在 Wave 模式中，控制波浪相位偏移。
  可用于微调波峰和波谷的位置。

• Wave Curve Mode
  控制波浪强度曲线按可见长度计算，还是按完整路径计算。 类似Width Curve Mode，做动画时有用。

• Wave Curve
  使用曲线控制波浪强度沿路径的变化。

宽度、长度与偏移

• Width Curve Mode
  控制宽度曲线按可见长度计算，还是按完整路径计算。

• Width Curve
  使用曲线控制线宽沿路径的变化。

• Length
  控制可见路径范围的起始位置。

• Length End
  控制可见路径范围的结束位置。

• Offset Mode
  控制可见路径范围在偏移时是否循环。

• Offset
  控制可见线段沿完整路径移动的位置。

• Loop
  当 Offset 超过路径末端后，线段会从路径起点继续出现。适合制作循环流动动画。

• Once
  当 Offset 超过路径末端后，线段不会循环。当前线段会在路径末端消失，适合制作一次性的描边或扫过动画。

变换与形状

• Center
  控制图形位置。

• Size
  控制 Bezier / B-Spline 路径的整体缩放。Circle 和 Rectangle 使用独立的宽度与高度控制。

• Pivot
  控制缩放和旋转的参考点。

• Z Rotation
  控制路径旋转角度。

• Curve Type
  选择路径类型：Bezier、B-Spline、Circle、Rectangle。

• Overlap Order
  控制线段重叠时，是路径起点绘制在上方，还是路径终点绘制在上方。

• Width
  在 Circle 和 Rectangle 模式中，控制图形宽度。

• Height
  在 Circle 和 Rectangle 模式中，控制图形高度。

• Corner Radius
  在 Rectangle 模式中，控制矩形圆角半径。默认值为 0。