opencascade AIS_TypeFilter AIS_XRTrackedDevice源码学习

opencascade AIS_TypeFilter

前言

通过它们的类型选择交互对象。该过滤器会对本地上下文中的每个交互对象提出问题，
以确定它是否具有非空的所有者，并且如果是，则检查它是否是所需类型。
如果对象在每种情况下都返回 true，则保留该对象。否则，将其拒绝。
默认情况下，交互对象的类型为 None，签名为 0。类型过滤器指定了一
个类型的选择范围，可以在任何级别上枚举类型或种类。这个选择可以是
交互对象的种类、维度、单位，或者轴、平面或属性的类型。
如果要为您的交互对象指定特定的类型和签名，必须重新定义两个虚拟方法：
Type 和 Signature。
此过滤器在中立点和开放的本地上下文中均可使用。
在收集器视图中，只能在打开本地上下文时对位置过滤器积极响应的交互
对象进行定位。
当关闭本地上下文时，所有临时交互对象都将被删除，与上下文相关的所有
选择模式都将取消，并且所有内容过滤器都将被清空。

方法

1

初始化类型过滤器，使用给定的种类aGivenKind。
AIS_TypeFilter(const AIS_KindOfInteractive aGivenKind);

2

如果临时对象不是交互对象，或者交互对象的类型与过滤器中存储的类型不同，
则返回False。
virtual Standard_Boolean IsOk (const Handle(SelectMgr_EntityOwner)& anobj)；

用法示例

在OpenCASCADE中，AIS_TypeFilter是用于过滤特定类型交互对象的类。这个类通常用于与视图选择管理器（SelectMgr）一起工作，以便在3D场景中选择和操作特定类型的对象。以下是一个简单的示例，展示了如何使用AIS_TypeFilter类来初始化和应用过滤器：

#include <AIS_TypeFilter.hxx>
#include <AIS_KindOfInteractive.hxx>
#include <SelectMgr_EntityOwner.hxx>

// 示例函数，演示如何使用AIS_TypeFilter

void exampleUsage()
{
    // 假设已有一个特定的交互对象种类定义
    AIS_KindOfInteractive givenKind = AIS_KOI_Dimension;

    // 初始化一个类型过滤器，使用给定的种类
    AIS_TypeFilter typeFilter(givenKind);

    // 假设有一个 SelectMgr_EntityOwner 对象 anEntityOwner
    Handle(SelectMgr_EntityOwner) anEntityOwner = ...; // 获取实际的 EntityOwner 对象

    // 检查该 EntityOwner 是否符合过滤器条件
    Standard_Boolean isOk = typeFilter.IsOk(anEntityOwner);

    if (isOk)
    {
        // 如果符合过滤器条件，执行相应的操作
        // 例如，选择该交互对象进行特定的操作
        // 在实际应用中，通常会将符合过滤器条件的对象添加到选择集中或进行其他操作
        // 例如：
        // mySelection->Add(anEntityOwner);
        // 或者
        // Handle(AIS_InteractiveObject) interactiveObject = anEntityOwner->Selectable();
        // 进行交互对象的其他操作
    }
    else
    {
        // 如果不符合过滤器条件，可以进行相应的处理
        // 例如，忽略或者进行其他处理
    }
}

在这个示例中：

• 首先，我们定义了一个AIS_KindOfInteractive类型的变量 givenKind，它表示我们希望过滤的交互对象的种类。
• 然后，我们通过 AIS_TypeFilter typeFilter(givenKind); 初始化了一个类型过滤器，这样它就会过滤出具有特定种类的交互对象。
• 接着，我们假设有一个 SelectMgr_EntityOwner 类型的对象 anEntityOwner，通过调用 typeFilter.IsOk(anEntityOwner); 来检查该对象是否符合过滤条件。
• 最后，根据 IsOk 的返回结果，我们可以对符合过滤条件的交互对象执行相应的操作。

在实际应用中，你可以根据具体需求定制不同的 AIS_KindOfInteractive 类型和相应的操作，以实现对交互对象的选择和处理。
参考

opencascade AIS_XRTrackedDevice

前言

“被跟踪的XR设备的辅助纹理网格呈现”

方法

1

主构造函数。
AIS_XRTrackedDevice(const Handle(Graphic3d_ArrayOfTriangles)& theTris,
const Handle(Image_Texture)& theTexture);

2

空构造函数。
AIS_XRTrackedDevice();

3

返回设备角色。
Aspect_XRTrackedDeviceRole Role() const { return myRole; }

4

设置设备角色。
void SetRole(Aspect_XRTrackedDeviceRole theRole) { myRole = theRole; }

5

返回激光颜色。
const Quantity_Color& LaserColor() const { return myLaserColor; }

6

设置激光颜色。
Standard_EXPORT void SetLaserColor(const Quantity_Color& theColor);

7

返回激光长度。
Standard_ShortReal LaserLength() const { return myLaserLength; }

8

设置激光长度。
Standard_EXPORT void SetLaserLength(Standard_ShortReal theLength);

9

返回单位比例因子。
Standard_ShortReal UnitFactor() const { return myUnitFactor; }

10

设置单位比例因子。
void SetUnitFactor(Standard_ShortReal theFactor) { myUnitFactor = theFactor; }

用法示例

OpenCASCADE中的 AIS_TypeFilter 和 AIS_XRTrackedDevice 是用于管理和显示3D图形对象的类。AIS_TypeFilter 用于过滤特定类型的交互对象，而 AIS_XRTrackedDevice 则可能用于表示和管理被跟踪的XR设备的可视化。以下是一个简单的示例，展示如何结合使用这两个类来管理和显示XR设备的虚拟表示：

示例代码

#include <AIS_TypeFilter.hxx>
#include <AIS_XRTrackedDevice.hxx>
#include <Graphic3d_ArrayOfTriangles.hxx>
#include <Image_Texture.hxx>

// 示例函数，演示如何使用AIS_TypeFilter和AIS_XRTrackedDevice

void exampleUsage()
{
    // 假设已经创建了一个用于管理交互对象的类型过滤器，例如筛选特定种类的交互对象
    AIS_TypeFilter typeFilter(/* 指定所需的种类参数 */);

    // 假设有一个用于被跟踪XR设备的三角形网格数组和纹理
    Handle(Graphic3d_ArrayOfTriangles) tris = ...; // 创建三角形网格数组
    Handle(Image_Texture) texture = ...; // 创建纹理对象

    // 创建一个AIS_XRTrackedDevice对象来表示被跟踪的XR设备
    AIS_XRTrackedDevice trackedDevice(tris, texture);

    // 设置XR设备的角色
    trackedDevice.SetRole(/* 指定角色参数 */);

    // 设置XR设备的激光颜色和长度
    Quantity_Color laserColor(/* 设置激光颜色参数 */);
    trackedDevice.SetLaserColor(laserColor);
    trackedDevice.SetLaserLength(/* 设置激光长度参数 */);

    // 假设需要将XR设备对象添加到场景中，并且仅在满足类型过滤器条件时才添加
    if (typeFilter.IsOk(/* 指定要添加的交互对象 */))
    {
        // 将XR设备对象添加到场景中的适当位置
        // 例如：
        // myAISContext->Display(trackedDevice, Standard_True);
    }
}

解释说明

1. AIS_TypeFilter 使用:

   • AIS_TypeFilter 类用于定义和应用类型过滤器，确保只有符合特定类型条件的交互对象才能被操作或显示。

2. AIS_XRTrackedDevice 使用:

   • AIS_XRTrackedDevice 类用于创建和管理被跟踪的XR设备的可视化表示。它可以接受三角形网格和纹理对象作为参数，用来构建设备的外观。
   • 可以使用其设置方法，如 SetRole、SetLaserColor 和 SetLaserLength，来定义和调整设备的角色、激光颜色和长度等属性。

3. 场景管理:

   • 示例中展示了如何结合使用 AIS_TypeFilter 和 AIS_XRTrackedDevice，确保只有符合特定类型条件的XR设备可被添加到场景中进行显示或操作。

在实际应用中，你可以根据具体需求调整和扩展这些示例代码，以实现更复杂的XR设备管理和可视化功能。

参考