setPivot 操作

语法

• setPivot(axisMap, cornerIndex)

参数

1. axisMap - 选择器
   用于定义旧范围轴向新枢轴（和范围）映射的选择器。

   • xyz - 保留当前方向，即在拐角 0（原点，请参阅下面的视觉参考线）处，新 x 轴的指向与旧范围 x 轴一致，新 y 轴的指向与旧范围 y 轴一致，新 z 轴的指向与旧范围 z 轴一致。
   • yzx - 在拐角 0 处，新 x 轴的指向与旧范围 z 轴一致，新 y 轴的指向与旧范围 x 轴一致，新 z 轴的指向与旧范围 x 轴一致。
   • zxy - 在拐角 0 处，新 x 轴的指向与旧范围 y 轴一致，新 y 轴的指向与旧范围 z 轴一致，新 z 轴的指向与旧范围 x 轴一致。
2. cornerIndex - 浮点型
   介于 [0,7] 之间的整数值，用于选择 scope 拐角之一作为新 pivot.p。

描述

setPivot 操作用于重定位和重定向当前形状的 pivot。 新方向基于当前形状的 scope 轴、axisMap 选择器和 cornerIndex。

新 pivot.p 将位于当前形状 scope 的选定拐角 (cornerIndex) 处，枢轴将旋转为所有轴指向范围内部。

新 scope 将不会进行平移和旋转（相对于枢轴），并且保持在同一位置（采用世界坐标），但轴不同。 geometry 将投影到新 scope（即以世界坐标的形式保持在同一位置）。

相关内容

• alignScopeToAxes 操作
• alignScopeToGeometry 操作
• alignScopeToGeometryBBox 操作
• 枢轴属性
• 范围属性

示例

视觉参考线

有关执行 setPivot 操作之前的当前形状范围，请参见右图。 编号表示拐角索引。
执行 setPivot(xyz, v) 之后的枢轴，其中 v = cornerIndex。 请记住枢轴的方向：在拐角 0 处，轴与原始范围轴相同；在其他所有拐角处，y 的方向与原始范围的 y 轴相同（或负向）。 其他轴定向为与某一范围轴重合。
执行 setPivot(yzx, v) 之后的枢轴，其中 v = cornerIndex. 请记住枢轴的方向：在拐角 0 中，范围轴 xyz 替换为轴 yzx。
执行 setPivot(zxy, v) 之后的枢轴，其中 v = cornerIndex。 请记住枢轴的方向：在拐角 0 中，范围轴 xyz 替换为轴 zxy。