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_TypeFiltervoid exampleUsage()
{// 假设已有一个特定的交互对象种类定义AIS_KindOfInteractive givenKind = AIS_KOI_Dimension;// 初始化一个类型过滤器，使用给定的种类AIS_TypeFilter typeFilter(givenKind);// 假设有一个 SelectMgr_EntityOwner 对象 anEntityOwnerHandle(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_XRTrackedDevicevoid 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);}
}
解释说明
-
AIS_TypeFilter 使用:
AIS_TypeFilter类用于定义和应用类型过滤器，确保只有符合特定类型条件的交互对象才能被操作或显示。
-
AIS_XRTrackedDevice 使用:
AIS_XRTrackedDevice类用于创建和管理被跟踪的XR设备的可视化表示。它可以接受三角形网格和纹理对象作为参数，用来构建设备的外观。- 可以使用其设置方法，如
SetRole、SetLaserColor和SetLaserLength，来定义和调整设备的角色、激光颜色和长度等属性。
-
场景管理:
- 示例中展示了如何结合使用
AIS_TypeFilter和AIS_XRTrackedDevice，确保只有符合特定类型条件的XR设备可被添加到场景中进行显示或操作。
- 示例中展示了如何结合使用
在实际应用中，你可以根据具体需求调整和扩展这些示例代码，以实现更复杂的XR设备管理和可视化功能。
参考