HelixToolkit中TextVisual3D旋转异常：非原点位置位移加倍

我在插入带旋转对齐的TextVisual3D时发现，当原点为零点时一切正常，但原点不在零点时，旋转变换会导致文本位移距离翻倍。目前使用「Up」视图，UpDirection设为(0,1,0)来平铺文本，尝试多种方法都没解决问题。

相关代码如下：

var text = new TextVisual3D();
text.Foreground = Brushes.Cyan;

text.FontSize = size / 4;
text.Height = size * 2;
text.Text = value;
text.UpDirection = new Vector3D(0, 1, 0);
text.HorizontalAlignment = horizontal;
text.VerticalAlignment = vertical;
text.Position = origin.GetPoint3D();


if (Rotation != 0)
{
    var angle = Rotation.Round(0);
    if(angle.Abs() != 360)
    {
        var axis = new Vector3D(0,0,1);
        var matrix = text.Transform.Value;
        matrix.Rotate(new Quaternion(axis, angle));
        text.Transform = new MatrixTransform3D(matrix);
    }
}

return text;

实际效果 #

预期效果 #

问题原因 #

问题出在变换顺序：你先设置了Position（本质是平移变换），再直接对现有矩阵做旋转，此时旋转是围绕世界原点而非文本自身锚点进行的。当目标原点不在世界零点时，旋转会让文本绕世界原点周转，最终位移相当于两倍的原点距离。

修正方法 #

正确流程是：先把文本平移到世界原点，执行旋转，再平移回目标位置。这样旋转是围绕文本自身中心进行的，不会产生额外偏移。

修正后的代码：

var text = new TextVisual3D();
text.Foreground = Brushes.Cyan;

text.FontSize = size / 4;
text.Height = size * 2;
text.Text = value;
text.UpDirection = new Vector3D(0, 1, 0);
text.HorizontalAlignment = horizontal;
text.VerticalAlignment = vertical;
var targetPos = origin.GetPoint3D();

if (Rotation != 0)
{
    var angle = Rotation.Round(0);
    if (Math.Abs(angle) != 360)
    {
        var axis = new Vector3D(0, 0, 1);
        var transformGroup = new Transform3DGroup();
        
        // 1. 先平移到世界原点，消除位置对旋转的影响
        transformGroup.Children.Add(new TranslateTransform3D(-targetPos.X, -targetPos.Y, -targetPos.Z));
        // 2. 围绕自身锚点执行旋转
        transformGroup.Children.Add(new RotateTransform3D(new AxisAngleRotation3D(axis, angle)));
        // 3. 平移回目标位置
        transformGroup.Children.Add(new TranslateTransform3D(targetPos.X, targetPos.Y, targetPos.Z));
        
        text.Transform = transformGroup;
    }
}
// 无旋转时直接设置位置
else
{
    text.Position = targetPos;
}

return text;

补充说明 #

• 使用Transform3DGroup组合变换，严格控制顺序是3D变换中避免锚点偏移的标准操作。
• 旋转场景下不再单独设置Position，避免重复平移导致的位置错误。

内容的提问来源于stack exchange，提问作者xaotix