Bootstrap

opencascade AIS_InteractiveContext源码学习8 trihedron display attributes

AIS_InteractiveContext

在这里插入图片描述

前言

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

trihedron display attributes

三维坐标系(trihedron)显示属性通常包括以下内容:

  1. 颜色:设置三维坐标系的颜色,以便在图形中清晰可见。

  2. 线型:定义三维坐标系的线条样式,例如实线、虚线或其他类型。

  3. 线宽:指定三维坐标系线条的宽度,影响其在图形中的视觉效果。

  4. 箭头样式:控制坐标轴末端箭头的样式,以指示方向。

  5. 坐标轴长度:设置坐标轴的长度,以适应图形的比例。

  6. 标记:可选择在坐标轴上添加刻度或标签,以显示坐标值。

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

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. 最大弦偏差:控制网格细分过程中,曲线或曲面上弦的最大偏差。较小的偏差值会生成更精细的三角形。

  2. 最大角度偏差:定义三角形中允许的最大角度变化,以确保生成的三角形在视觉上不会过于扭曲。

  3. 相对偏差:相对于对象大小的偏差值,允许在不同尺寸的对象上保持一致的细分质量。

  4. 绝对偏差:固定的偏差值,不受对象尺寸影响。

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

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。

简单示例

HLR (Hidden Line Removal) display attributes

HLR(隐藏线去除)显示属性是指在计算机图形学中,特别是在 CAD(计算机辅助设计)和 3D 建模应用程序中,用于控制如何渲染或去除隐藏线的设置和参数。以下是与 HLR 显示相关的一些关键属性:

  1. 偏差系数:此属性设置线(通常是边缘或轮廓)可以偏离直线的容忍度,超出此容忍度后该线将被视为隐藏。这会影响隐藏线去除的准确性。

  2. 最大弦偏差:定义线段(弦)从真实曲线或表面边缘可以允许的最大偏差。该参数对于确定何时打断线段以实现更准确的渲染至关重要。

  3. 阴影显示模式:指定在去除隐藏线时对象表面的渲染方式。该模式通常涉及将表面分解为三角形或其他基本图元,以计算光的反射和阴影。

  4. 三角形形成:描述如何从曲线和表面的弦形成三角形,以便于隐藏线去除。三角形是一种常见的图元,因为它们易于计算和渲染。

  5. 相对偏差:允许相对于正在渲染的对象的大小指定偏差。该参数有助于在不同规模的对象之间实现一致的视觉质量。

这些属性共同确保在 CAD 和类似应用程序中 3D 对象的表示既视觉准确又计算高效,通过选择性去除隐藏线,同时保持可见边缘和表面的完整性。

1:HiddenLineAspect

初始化默认绘图工具(或 Drawer)中的隐藏线外观。默认值为:颜色:Quantity_NOC_YELLOW,线型:Aspect_TOL_DASH,宽度:1。

2:SetHiddenLineAspect

设置隐藏线外观 anAspect。Aspect 定义了 HLR 投影中隐藏线的显示属性。

3:DrawHiddenLine

如果隐藏线要绘制,则返回 Standard_True。默认情况下,隐藏线不被绘制。

4:EnableDrawHiddenLine

初始化默认绘图工具(或 Drawer)中的隐藏线外观。默认值为:颜色:Quantity_NOC_YELLOW,线型:Aspect_TOL_DASH,宽度:1。

5:DisableDrawHiddenLine

初始化默认绘图工具(或 Drawer)中的隐藏线外观。默认值为:颜色:Quantity_NOC_YELLOW,线型:Aspect_TOL_DASH,宽度:1。

iso-line display attributes

ISO 线显示属性通常指用于控制 ISO 线(等值线)在图形界面中呈现的设置。以下是一些常见的 ISO 线显示属性:

  1. 颜色:设置 ISO 线的颜色,以便在图形中清晰可见。

  2. 线型:定义 ISO 线的样式,比如实线、虚线或其他类型。

  3. 线宽:指定 ISO 线的宽度,影响其在图形中的视觉效果。

  4. 透明度:控制 ISO 线的透明度,使其可以与其他图形元素相互作用。

  5. 间距:定义相邻 ISO 线之间的距离,这对于等值线的密度和可读性非常重要。

  6. 标签:可选择显示 ISO 线的标签,以标识对应的数值或类别。

这些属性有助于增强数据可视化效果,使得 ISO 线在不同的应用中更具可读性和美观性。

1:SetIsoNumber

设置显示的 U 和 V 等参数的数量。

2:IsoNumber

返回显示的 U 和 V 等参数的数量。

3:IsoOnPlane

方法1:如果启用了在平面上绘制等参数,则返回 True。如果 <forUIsos> 为 False,则不绘制。
方法2:如果启用了在平面上绘制等参数,则返回 True。

4:IsoOnTriangulation

方法1:如果启用了在三角剖分算法上绘制等值线,则返回 true。
方法2:启用或禁用特定对象的等值线三角剖分构建。如果禁用三角剖分构建,默认的平面构建器将为给定对象计算等值线。
方法3:启用或禁用默认绘图工具的等值线三角剖分构建。如果禁用三角剖分构建,默认的平面构建器将为给定对象计算等值线。

来源:网址
继续obsolete methods

;