opencascade AIS_LightSource 光源的交互对象源码学习 opencascade AIS_KindOfInteractive 交互式对象类型源码学习原创

前言

光源的交互对象。每种类型的光源都有自己的表示方式：

环境光以球形在视图角落显示；
定位光源由球形或标记表示；
聚光灯由圆锥表示；
定向光由箭头集合在视图角落表示。此外，可以显示光源名称，并且单击表示将启用/禁用光源。

方法

AIS_LightSource（AIS光源）类用于初始化光源，并通过复制Graphic3d_CLight的设置来实现。该类提供了一系列成员函数用于设置和获取光源的属性，以及计算光源的显示和选择。

AcceptDisplayMode()：虚拟函数，用于确定指定的显示模式是否受支持。
ArcSize()：返回灵敏球弧的大小，默认为20像素。
Compute()：计算光源的显示模式。
computeAmbient()：计算环境光源的显示。
computeDirectional()：计算定向光源的显示。
computePositional()：计算定位光源的显示。
ComputeSelection()：填充选择。
computeSpot()：计算聚光灯光源的显示。
IsZoomable()：返回是否允许缩放。
Light()：返回光源。
MarkerImage()：返回光源图标。
MarkerType()：返回光源图标的类型。
NbArrows()：返回要显示的定向光源箭头的数量，默认为5。
NbSplitsArrow()：返回箭头的镶嵌级别，默认为20。
NbSplitsQuadric()：返回二次曲面的镶嵌级别，默认为30。
ProcessDragging()：拖动对象。
SetArcSize()：设置灵敏球弧的大小。
SetDisplayName()：显示/隐藏光源名称。
SetDisplayRange()：显示/隐藏光源范围。
SetDraggable()：设置是否允许拖动。
SetLight()：设置光源。
setLocalTransformation()：设置本地转换。
SetMarkerImage()：设置光源图标。
SetMarkerType()：设置光源图标的类型。
SetNbArrows()：设置要显示的箭头数量。
SetNbSplitsArrow()：设置箭头的镶嵌级别。
SetNbSplitsQuadric()：设置二次曲面的镶嵌级别。
SetSize()：设置显示的大小。
SetSwitchOnClick()：设置点击鼠标是否开关灯光。
SetZoomable()：设置是否允许缩放。
Size()：返回显示的大小。
ToDisplayName()：返回是否显示光源名称。
ToDisplayRange()：返回是否显示光源范围。
ToSwitchOnClick()：返回是否点击鼠标开关灯光。
Type()：返回对象的类型。
updateLightAspects()：更新光源的颜色。
updateLightLocalTransformation()：基于光源类型更新本地转换。
updateLightTransformPersistence()：基于光源类型更新转换持久性。

示例

下面是使用AIS_LightSource的简单示例：

#include <AIS_LightSource.hxx>
#include <Graphic3d_CLight.hxx>

int main() {
    // 创建光源对象
    Handle(Graphic3d_CLight) lightSource = new Graphic3d_CLight();

    // 初始化AIS_LightSource对象
    Handle(AIS_LightSource) aisLight = new AIS_LightSource(lightSource);

    // 设置光源大小
    aisLight->SetSize(50.0);

    // 设置光源是否可拖动
    aisLight->SetDraggable(true);

    // 设置光源名称是否显示
    aisLight->SetDisplayName(true);

    // 设置光源范围是否显示
    aisLight->SetDisplayRange(true);

    // 设置点击鼠标是否开关灯光
    aisLight->SetSwitchOnClick(true);

    // 设置光源图标
    // 注意：这里的图标类型和图标文件路径需要根据实际情况设置
    Handle(Graphic3d_MarkerImage) markerImage = ...; // 设置图标
    aisLight->SetMarkerImage(markerImage, true); // 设置启用状态的图标

    // 设置光源的其他属性...

    // 在视图中显示光源
    // 注意：这里的View是指的OpenCASCADE的3D视图
    Handle(V3d_View) view = ...; // 获取视图对象
    view->SetLightOn(); // 打开光源
    view->Viewer()->AddLight(aisLight); // 将光源添加到视图中

    // 进行视图更新或者重绘等操作

    return 0;
}

这个示例演示了如何创建和初始化AIS_LightSource对象，并设置其属性，然后将其添加到3D视图中显示。在实际应用中，您需要根据您的需求和具体情况来设置光源的属性和图标。

`AIS_KindOfInteractive` 前言

AIS_KindOfInteractive 是 OpenCASCADE 应用程序框架（Application Interactive Services, AIS）中的一个枚举类型，用于定义交互对象的类型。这些交互对象在 3D 场景中用于表示几何形状、注释和其他可视元素。不同类型的交互对象具有不同的行为和属性。
在这里插入图片描述

枚举值

以下是 AIS_KindOfInteractive 枚举类型的常见值及其用途：

AIS_KOI_None
- 表示没有指定交互对象类型。
AIS_KOI_Datum
- 表示基准元素，如坐标系、点、线或平面。
AIS_KOI_Shape
- 表示几何形状，如点、边、面、体等。
AIS_KOI_Object
- 表示一般对象，可以是几何形状的组合或复杂的图元。
AIS_KOI_Relation
- 表示几何关系，如对齐、约束等。
AIS_KOI_Dimension
- 表示尺寸标注，如长度、角度等。
AIS_KOI_Attribute
- 表示对象的属性或元数据。
AIS_KOI_Unknown
- 表示未知类型的交互对象。

用法示例

以下示例展示了如何使用 AIS_KindOfInteractive 枚举类型来创建和处理不同类型的交互对象。

#include <AIS_Shape.hxx>
#include <AIS_Point.hxx>
#include <AIS_InteractiveContext.hxx>
#include <AIS_KindOfInteractive.hxx>
#include <BRepPrimAPI_MakeBox.hxx>
#include <gp_Pnt.hxx>

void CreateInteractiveObjects(const Handle(AIS_InteractiveContext)& context)
{
    // 创建一个几何形状（立方体）
    TopoDS_Shape box = BRepPrimAPI_MakeBox(10.0, 10.0, 10.0).Shape();
    Handle(AIS_Shape) aisBox = new AIS_Shape(box);
    aisBox->SetColor(Quantity_NOC_RED);

    // 将几何形状添加到交互上下文
    context->Display(aisBox, Standard_True);

    // 创建一个点
    gp_Pnt point(5.0, 5.0, 5.0);
    Handle(AIS_Point) aisPoint = new AIS_Point(new Geom_CartesianPoint(point));
    aisPoint->SetColor(Quantity_NOC_BLUE);

    // 将点添加到交互上下文
    context->Display(aisPoint, Standard_True);
    
    // 检查对象类型
    if (aisBox->Type() == AIS_KOI_Shape) {
        std::cout << "The object is a shape." << std::endl;
    }
    if (aisPoint->Type() == AIS_KOI_Datum) {
        std::cout << "The object is a datum." << std::endl;
    }
}

int main()
{
    // 创建一个交互上下文（具体的初始化略）
    Handle(V3d_Viewer) viewer = ...;
    Handle(AIS_InteractiveContext) context = new AIS_InteractiveContext(viewer);

    // 创建和显示交互对象
    CreateInteractiveObjects(context);

    return 0;
}