opencascade AIS_InteractiveContext源码学习8 trihedron display attributes

AIS_InteractiveContext

在这里插入图片描述

前言

交互上下文（Interactive Context）允许您在一个或多个视图器中管理交互对象的图形行为和选择。类方法使这一操作非常透明。需要记住的是，对于已经被交互上下文识别的交互对象，必须使用上下文方法进行修改。如果交互对象尚未加载到交互上下文中，您才能直接调用交互对象的方法。

trihedron display attributes

三维坐标系（trihedron）显示属性通常包括以下内容：

颜色：设置三维坐标系的颜色，以便在图形中清晰可见。
线型：定义三维坐标系的线条样式，例如实线、虚线或其他类型。
线宽：指定三维坐标系线条的宽度，影响其在图形中的视觉效果。
箭头样式：控制坐标轴末端箭头的样式，以指示方向。
坐标轴长度：设置坐标轴的长度，以适应图形的比例。
标记：可选择在坐标轴上添加刻度或标签，以显示坐标值。

这些属性有助于增强三维坐标系的可读性和视觉效果，使其在不同应用中更加清晰和易于理解。

1：SetTrihedronSize

设置三维坐标系的大小 aSize。用于更改三维坐标系默认显示值 100 毫米。若在您自定义的交互对象中使用此函数，则需要调用新类的 Compute 函数。这将重新计算每个显示的三维坐标系的呈现。

2：PlaneSize

如果 X 方向的长度 XSize 与 Y 方向的长度 YSize 相同，则返回 true。
在 AIS_InteractiveContext 中，SetTrihedronSize 用于设置三维坐标系的大小。这一方法通常在需要自定义显示大小的场合使用。

用法示例

以下是使用 AIS_InteractiveContext::SetTrihedronSize 的示例代码：

#include <AIS_InteractiveContext.hxx>
#include <AIS_Trihedron.hxx>

// 设置三维坐标系的大小
void SetTrihedronSize(AIS_InteractiveContext& context, Standard_Real size) {
    // 创建三维坐标系对象
    Handle(AIS_Trihedron) trihedron = new AIS_Trihedron();
    
    // 设置坐标系的大小
    context.SetTrihedronSize(size);
    
    // 显示三维坐标系
    context.Display(trihedron, Standard_True); // 第一个参数是形状，第二个是是否立即更新视图
}

// 调用示例
// AIS_InteractiveContext context; // 假设交互上下文已经创建
// SetTrihedronSize(context, 100.0); // 设置大小为 100.0 毫米

参数

size：指定三维坐标系的大小（通常以毫米为单位）。

通过这种方式，可以在 OpenCascade 的交互上下文中灵活调整三维坐标系的显示大小，适应不同的可视化需求。

tessellation deviation properties for automatic triangulation

在 OpenCascade 中，网格细分（tessellation）偏差属性用于控制自动三角剖分的精度和表现。这些属性帮助定义如何将几何形状转化为三角形网格。以下是一些常见的网格细分偏差属性：

最大弦偏差：控制网格细分过程中，曲线或曲面上弦的最大偏差。较小的偏差值会生成更精细的三角形。
最大角度偏差：定义三角形中允许的最大角度变化，以确保生成的三角形在视觉上不会过于扭曲。
相对偏差：相对于对象大小的偏差值，允许在不同尺寸的对象上保持一致的细分质量。
绝对偏差：固定的偏差值，不受对象尺寸影响。

通过调整这些属性，可以优化渲染效果和性能，确保在不同场景中平衡细节和计算资源。

1：SetDeviationCoefficient

设置偏差系数 theCoefficient。曲线或曲面的绘制是基于最大弦偏差。偏差系数用于阴影显示模式，形状被分解为三角形，这些三角形用于计算物体表面的光反射。三角形由形状中曲线的弦构成。偏差系数 theCoefficient 定义了弦可以偏离曲线切线的最大角度。如果达到此限制，则开始新的三角形。该偏差是绝对的，通过方法 SetMaximalChordialDeviation 设置，默认值为 0.001。然而，在绘制形状时，您可以要求相对偏差。此偏差为：SizeOfObject * DeviationCoefficient。

2：SetDeviationAngle

设置偏差系数 theCoefficient。曲线或曲面的绘制基于最大弦偏差。偏差系数用于阴影显示模式，形状被分解为三角形，这些三角形用于计算物体表面的光反射。三角形由形状中曲线的弦构成。偏差系数 theCoefficient 定义了弦可以偏离曲线切线的最大角度。一旦达到此限制，就会开始新的三角形。该偏差是绝对的，通过方法 SetMaximalChordialDeviation 设置，默认值为 0.001。然而，在绘制形状时，您可以请求相对偏差，此偏差为：SizeOfObject * DeviationCoefficient。

3：SetAngleAndDeviation

调用 AIS_Shape 的 SetAngleAndDeviation 方法，以同时设置角度和偏差系数。

4：SetDeviationCoefficient

设置偏差系数 theCoefficient。曲线或曲面的绘制基于最大弦偏差。偏差系数用于阴影显示模式，形状被分解为三角形，这些三角形用于计算物体表面的光反射。三角形由形状中曲线的弦构成。偏差系数 theCoefficient 定义了弦可以偏离曲线切线的最大角度。如果达到此限制，则开始新的三角形。该偏差是绝对的，通过方法 SetMaximalChordialDeviation 设置，默认值为 0.001。然而，在绘制形状时，您可以请求相对偏差，此偏差为：SizeOfObject * DeviationCoefficient。

5：DeviationCoefficient ()

返回偏差系数。曲线或曲面的绘制基于最大弦偏差。偏差系数用于阴影显示模式，形状被分解为三角形，这些三角形用于计算物体表面的光反射。三角形由形状中曲线的弦构成。偏差系数定义了弦可以偏离曲线切线的最大角度。一旦达到此限制，就会开始新的三角形。该偏差是绝对的，通过 Prs3d_Drawer::SetMaximalChordialDeviation 设置，默认值为 0.001。然而，在绘制形状时，您可以请求相对偏差，此偏差为：SizeOfObject * DeviationCoefficient。

6：DeviationAngle

设置偏差系数 theCoefficient。曲线或曲面的绘制是基于最大弦偏差。偏差系数用于阴影显示模式，形状被分解为三角形，这些三角形用于计算物体表面的光反射。三角形由形状中曲线的弦构成。偏差系数 theCoefficient 定义了弦可以偏离曲线切线的最大角度。如果达到此限制，则开始新的三角形。该偏差是绝对的，通过方法 SetMaximalChordialDeviation 设置，默认值为 0.001。然而，在绘制形状时，您可以请求相对偏差，此偏差为：SizeOfObject * DeviationCoefficient。