opencascade AIS_Shape源码学习【重中之重】

已于 2024-08-18 15:29:30 修改
阅读量1.3k 收藏 17
点赞数 48
分类专栏： Opencascade源码学习 文章标签： 学习 opencascade 几何学
于 2024-08-01 08:45:00 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/weixin_45751713/article/details/140834561
版权

opencascade AIS_Shape

前言

//! 一个用于管理形状展示和选择的框架。
//! AIS_Shape是交互对象，大多数应用程序都会使用它。
//! 提供了标准函数，允许您在开放的局部上下文中准备选择形状的组成元素 -
//! 顶点、边、面等。这些特定于“Shape”类型对象的选择模式被称为标准激活模式。
//! 这些模式仅在开放的局部上下文中考虑，并且仅对重新定义虚拟方法
//! AcceptShapeDecomposition并返回true的交互对象起作用。
//! 还提供了多个高级函数。其中包括管理继承形状类的偏差角度和偏差系数的函数 -
//! 这些服务允许您选择一种类型的形状交互对象以获得更高的绘图精度。
//! 在这种情况下，与上述偏差角度和系数函数对应的Prs3d_Drawer::IsOwn…函数会返回true，
//! 表示特定对象有可用的本地设置。
//!
//! 此类允许使用每个面的底层表面的本机UV参数空间在形状上映射纹理
//! （这意味着纹理将在所有面上视觉上重复显示）。
//! 为了生成纹理坐标，在计算AIS_Shaded显示模式中的呈现之前，应设置适当的着色属性：
//! @code
//! Handle(AIS_Shape) aPrs = new AIS_Shape();
//! aPrs->Attributes()->SetupOwnShadingAspect();
//! aPrs->Attributes()->ShadingAspect()->Aspect()->SetTextureMapOn();
//! aPrs->Attributes()->ShadingAspect()->Aspect()->SetTextureMap (new Graphic3d_Texture2Dmanual (Graphic3d_NOT_2D_ALUMINUM));
//! @endcode
//! 纹理本身在参数范围(0,1)x(0,1)内进行参数化。

在这里插入图片描述

此类重中之重

1

初始化形状对象，构建由线、边和顶点组成的形状。
Standard_EXPORT AIS_Shape(const TopoDS_Shape& shap);

2

返回索引0。此值指 SHAPE，来自 TopAbs_ShapeEnum。
virtual Standard_Integer Signature() const Standard_OVERRIDE { return 0; }

3

返回 Interactive Object 的类型作为 Object。
virtual AIS_KindOfInteractive Type() const Standard_OVERRIDE { return AIS_KindOfInteractive_Shape; }

4

如果交互对象接受形状分解，则返回 true。
virtual Standard_Boolean AcceptShapeDecomposition() const Standard_OVERRIDE { return Standard_True; }

5

返回指定的显示模式是否被支持。
virtual Standard_Boolean AcceptDisplayMode(const Standard_Integer theMode) const Standard_OVERRIDE { return theMode >= 0 && theMode <= 2; }

6

返回此形状对象。
const TopoDS_Shape& Shape() const { return myshape; }

7

构造一个具体形状对象的实例 theShape。
void SetShape(const TopoDS_Shape& theShape)；

8

SetShape() 的别名。
void Set(const TopoDS_Shape& theShape) { SetShape(theShape); }

9

为此特定形状设置偏差系数的本地值。
Standard_EXPORT Standard_Boolean SetOwnDeviationCoefficient();

10

为此特定形状设置偏差角度的本地值。
Standard_EXPORT Standard_Boolean SetOwnDeviationAngle();

11

为此特定形状设置偏差系数的本地值。
Standard_EXPORT void SetOwnDeviationCoefficient(const Standard_Real aCoefficient);

12

这会计算一个新的角度和偏差值 anAngle，并将这些值设置到我的 Drawer 中，使其成为形状的本地值。
Standard_EXPORT void SetAngleAndDeviation(const Standard_Real anAngle);

13

返回用户设置的角度初始值。
Standard_EXPORT Standard_Real UserAngle() const;

14

设置 myOwnDeviationAngle 字段在 Prs3d_Drawer 中，并重新计算呈现。
Standard_EXPORT void SetOwnDeviationAngle(const Standard_Real anAngle);

15

如果偏差系数 aCoefficient 和先前的偏差系数 aPreviousCoefficient 的值已经设置，则返回 true 并返回这些值。如果这些值尚未设置，则返回 false。
Standard_EXPORT Standard_Boolean OwnDeviationCoefficient(Standard_Real& aCoefficient, Standard_Real& aPreviousCoefficient) const;

16

如果偏差角度 anAngle 和先前的偏差角度 aPreviousAngle 的值已经设置，则返回 true 并返回这些值。如果这些值尚未设置，则返回 false。
Standard_EXPORT Standard_Boolean OwnDeviationAngle(Standard_Real& anAngle, Standard_Real& aPreviousAngle) const;

17

设置形状使用的 HLR 算法类型。
void SetTypeOfHLR(const Prs3d_TypeOfHLR theTypeOfHLR) { myDrawer->SetTypeOfHLR(theTypeOfHLR); }

18

获取使用的 HLR 算法类型。
Prs3d_TypeOfHLR TypeOfHLR() const { return myDrawer->TypeOfHLR(); }

19

设置重建复合形状中的颜色 aColor。通过以下 Drawer 方法对外观进行操作：

  • 自由边界：Prs3d_Drawer_FreeBoundaryAspect，
  • 等值线：Prs3d_Drawer_UIsoAspect、Prs3dDrawer_VIsoAspect，
  • 共享边界：Prs3d_Drawer_UnFreeBoundaryAspect，
  • 着色：Prs3d_Drawer_ShadingAspect，
  • 隐藏线模式下的可见线颜色：Prs3d_Drawer_SeenLineAspect，
  • 隐藏线模式下的隐藏线颜色：Prs3d_Drawer_HiddenLineAspect。
    Standard_EXPORT virtual void SetColor(const Quantity_Color& theColor) Standard_OVERRIDE;
20

删除重建复合形状中的颜色设置。
Standard_EXPORT virtual void UnsetColor() Standard_OVERRIDE;

21

设置重建复合形状中的线宽度值 aValue。改变线的外观。
Standard_EXPORT virtual void SetWidth(const Standard_Real aValue) Standard_OVERRIDE;

22

删除重建复合形状中的线宽度设置。
Standard_EXPORT virtual void UnsetWidth() Standard_OVERRIDE;

23

允许在重建复合形状中为材料 aName 设置设置。
Standard_EXPORT virtual void SetMaterial(const Graphic3d_MaterialAspect& aName) Standard_OVERRIDE;

24

删除重建复合形状中的材料设置。
Standard_EXPORT virtual void UnsetMaterial() Standard_OVERRIDE;

25

设置重建复合形状中的透明度值 aValue。
Standard_EXPORT virtual void SetTransparency(const Standard_Real aValue = 0.6) Standard_OVERRIDE;

26

删除重建复合形状中的透明度设置。
Standard_EXPORT virtual void UnsetTransparency() Standard_OVERRIDE;

27

构造一个边界框，用于重建复合拓扑形状的呈现。
Standard_EXPORT virtual const Bnd_Box& BoundingBox();

28

AIS_InteractiveObject 定义了另一个虚拟方法 BoundingBox，它与上面的方法不同；保持其可见性。
using AIS_InteractiveObject::BoundingBox;

29

根据当前表面模型，返回形状的颜色属性。
Standard_EXPORT virtual void Color(Quantity_Color& aColor) const Standard_OVERRIDE;

30

根据当前表面模型，返回形状的材料名称属性。
Standard_EXPORT virtual Graphic3d_NameOfMaterial Material() const Standard_OVERRIDE;

31

根据当前表面模型，返回形状的透明度属性。
Standard_EXPORT virtual Standard_Real Transparency() const Standard_OVERRIDE;

32

返回指定选择模式的形状类型。
static TopAbs_ShapeEnum SelectionType(const Standard_Integer theSelMode)
{
switch (theSelMode)
{
case 1: return TopAbs_VERTEX;
case 2: return TopAbs_EDGE;
case 3: return TopAbs_WIRE;
case 4: return TopAbs_FACE;
case 5: return TopAbs_SHELL;
case 6: return TopAbs_SOLID;
case 7: return TopAbs_COMPSOLID;
case 8: return TopAbs_COMPOUND;
case 0: return TopAbs_SHAPE;
}
return TopAbs_SHAPE;
}

33

返回指定形状类型的选择模式。
static Standard_Integer SelectionMode(const TopAbs_ShapeEnum theShapeType)
{
switch (theShapeType)
{
case TopAbs_VERTEX: return 1;
case TopAbs_EDGE: return 2;
case TopAbs_WIRE: return 3;
case TopAbs_FACE: return 4;
case TopAbs_SHELL: return 5;
case TopAbs_SOLID: return 6;
case TopAbs_COMPSOLID: return 7;
case TopAbs_COMPOUND: return 8;
case TopAbs_SHAPE: return 0;
}
return 0;
}

34

返回纹理重复的 UV 值；默认为 (1, 1)。
const gp_Pnt2d& TextureRepeatUV() const { return myUVRepeat; }

35

设置每个面上纹理的重复次数。纹理本身在 (0,1) x (0,1) 的参数空间内。
要为要纹理化的形状的每个面设置 UV 空间的参数化 (Umin,Umax) x (Vmin,Vmax)。
void SetTextureRepeatUV(const gp_Pnt2d& theRepeatUV) { myUVRepeat = theRepeatUV; }

36

返回纹理原点的 UV 位置；默认为 (0, 0)。
const gp_Pnt2d& TextureOriginUV() const { return myUVOrigin; }

37

使用此方法更改纹理的原点。
Texel (0,0) 将映射到表面 (myUVOrigin.X(), myUVOrigin.Y())。
void SetTextureOriginUV(const gp_Pnt2d& theOriginUV) { myUVOrigin = theOriginUV; }

38

返回 UV 坐标的比例因子；默认为 (1, 1)。
const gp_Pnt2d& TextureScaleUV() const { return myUVScale; }

39

使用此方法缩放纹理（按照面的百分比）。
您可以为 U 和 V 都指定一个比例因子。
示例：如果将 ScaleU 和 ScaleV 设置为 0.5，并启用纹理重复，
纹理将在每个方向上的面上出现两次。
void SetTextureScaleUV(const gp_Pnt2d& theScaleUV) { myUVScale = theScaleUV; }

40

计算正常的呈现。
Standard_EXPORT virtual void Compute(const Handle(PrsMgr_PresentationManager)& thePrsMgr,
const Handle(Prs3d_Presentation)& thePrs,
const Standard_Integer theMode) Standard_OVERRIDE;

41

计算投影呈现。
virtual void computeHLR(const Handle(Graphic3d_Camera)& theProjector,
const Handle(TopLoc_Datum3D)& theTrsf,
const Handle(Prs3d_Presentation)& thePrs) Standard_OVERRIDE

42

计算选择。
Standard_EXPORT virtual void ComputeSelection(const Handle(SelectMgr_Selection)& theSelection,
const Standard_Integer theMode) Standard_OVERRIDE;

创建自有的外观（如果不存在），并设置颜色。
如果已创建新的外观，则返回 TRUE。
bool setColor(const Handle(Prs3d_Drawer)& theDrawer, const Quantity_Color& theColor)

43

创建自有的外观（如果不存在），并设置宽度。
####//! @return 如果已创建新的外观，则返回 TRUE。
Standard_EXPORT bool setWidth(const Handle(Prs3d_Drawer)& theDrawer, const Standard_Real theWidth) const;

44

设置透明度。
Standard_EXPORT void setTransparency(const Handle(Prs3d_Drawer)& theDrawer, const Standard_Real theValue) const;

45

设置材料。
void setMaterial(const Handle(Prs3d_Drawer)& theDrawer, const Graphic3d_MaterialAspect& theMaterial, const Standard_Boolean theToKeepColor, const Standard_Boolean theToKeepTransp) const;

46

替换抽屉链接的已计算组的外观为新的自有值。
Standard_EXPORT void replaceWithNewOwnAspects();

47

计算指定形状的 HLR 呈现。
Standard_EXPORT static void computeHlrPresentation(const Handle(Graphic3d_Camera)& theProjector,
const Handle(Prs3d_Presentation)& thePrs,
const TopoDS_Shape& theShape,
const Handle(Prs3d_Drawer)& theDrawer);

48

将我的内容转储到流中。
void DumpJson(Standard_OStream& theOStream, Standard_Integer theDepth = -1）

用法用例

OpenCascade中的AIS_Shape类用于管理和显示几何形状。以下是一个简单的示例，展示如何创建和使用AIS_Shape类来显示一个简单的立方体：

#include <AIS_Shape.hxx>
#include <AIS_InteractiveContext.hxx>
#include <AIS_Drawer.hxx>
#include <TopoDS_Shape.hxx>
#include <TopoDS.hxx>
#include <BRepPrimAPI_MakeBox.hxx>
#include <Graphic3d_NameOfMaterial.hxx>
#include <Quantity_Color.hxx>
#include <Quantity.hxx>

int main()
{
    // 创建一个简单的立方体形状
    BRepPrimAPI_MakeBox boxMaker(10.0, 20.0, 30.0);
    TopoDS_Shape cube = boxMaker.Shape();

    // 创建一个AIS_Shape对象并设置形状
    Handle(AIS_Shape) aisShape = new AIS_Shape(cube);

    // 设置显示属性
    aisShape->SetColor(Quantity_Color(Quantity_NOC_RED));
    aisShape->SetMaterial(Graphic3d_NOM_PLASTIC);

    // 创建一个交互上下文
    Handle(AIS_InteractiveContext) context = new AIS_InteractiveContext();

    // 将AIS_Shape对象添加到交互上下文中
    context->Display(aisShape, Standard_True);

    // 进入事件循环
    context->UpdateCurrentViewer();

    // 退出程序
    return 0;
}

示例解释：

  1. 包含必要的头文件：

    • AIS_Shape.hxx: 包含AIS_Shape类的声明。
    • AIS_InteractiveContext.hxx: 包含AIS_InteractiveContext类的声明，用于管理交互对象。
    • 其他一些OpenCascade的核心类和函数。

  2. 创建立方体形状：
    使用BRepPrimAPI_MakeBox类创建一个立方体形状，并获取其TopoDS_Shape表示。

  3. 创建AIS_Shape对象：
    使用AIS_Shape类的构造函数，将上一步创建的立方体形状传递进去。

  4. 设置显示属性：
    使用SetColor方法设置形状的颜色为红色，并使用SetMaterial方法设置材质为塑料。

  5. 创建交互上下文：
    使用AIS_InteractiveContext类创建一个交互上下文对象，用于管理和显示交互对象。

  6. 显示形状：
    使用Display方法将AIS_Shape对象添加到交互上下文中显示。

  7. 事件循环：
    调用UpdateCurrentViewer方法进入事件循环，等待用户交互。

  8. 程序退出：
    当用户关闭应用程序时，事件循环结束，程序退出。

这个示例演示了如何使用OpenCascade的AIS_Shape类来创建、显示和交互一个简单的几何形状（立方体）。

参考

一只小小汤圆
关注
专栏目录
OpenCascade中文帮助文档.zip_-baijiahao_OPENCASCADE中文_opencascade文档_中文_
07-14
开源软件opencascade的中文文档，对于想要研究三维软件开源代码的童鞋很有帮助。
opencascade TopoDS_Shape源码学习【重中之重】
汤圆
08-08 1438
描述了一个形状，它 引用了一个基础形状，该基础形状有可能被赋予一个位置和方向 为基础形状提供了一个位置，定义了它在本地坐标系中的位置为基础形状提供了一个方向，这是从几何学的角度（而不是相对于其他形状的方向）来定义的。注意：如果一个形状引用的基础形状的形状列表为空，则该形状被视为空。
opencascade(OCC)选择模型的点、线、面
qq_39433050的博客
05-16 1224
在模型上电机右键后可以看到，鼠标所在的平面变成了前面设置的粉色，平面选择完成。后设置模型选择属性。
Windows系统下QT+OpenCasCAD仿真开发
热门推荐
千人斩的博客
11-23 1万+
背景 最近开发了一个六自由度机械臂调姿平台的控制软件，集成了API激光跟踪仪和KUKA机器人，实现了根据产品的测量位姿驱动仿真环境中模型并且实现模型间的碰撞检测。 其中KUKA机器人的控制可以参考笔者以前的博客： https://blog.csdn.net/iamqianrenzhan/article/details/103115580 关于API激光跟踪仪的基本使用方法，将会在后续博客中介绍。本...
如何把TopoDS对象转成AIS对象
Ausma的博客
02-22 437
如何把TopoDS对象转成AIS对象
在OCC中，如何设置AIS_InteractiveContxt同一对象多个AIS_Shape的高亮优先级
Ausma的博客
03-06 599
在OCC中，如何设置AIS_InteractiveContxt同一对象多个AIS_Shape的高亮优先级
OpenCASCADE源码分析：总论
国产CAx(CAD/CAE/CAM)软件研发
04-04 1345
OpenCASCADE是20世纪90年代由法国Matra Datavision公司开发的一款开源三维曲面/实体造型引擎，目前，国内许多CAE软件将其用作几何模块的开发。 本文拟从系统设计的角度，对OpenCASCADE架构(主要组件与关键流程)进行概要性总结。
pythonocc基础：AIS_Shape类简介
m0_65073612的博客
05-16 586
AIS_Shape是PythonOCC中模块的一个关键类，它代表了可交互式的形状（Interactive Shape）。这个类主要用于在图形用户界面中展示和操作边界表示（BRep）几何形状，比如进行选择、高亮显示、动态反馈等交互功能。AIS_Shape为开发者提供了一种方式，将纯粹的几何实体转换为具备交互能力的图形对象，这对于创建CAD/CAM/CAE应用、教育工具、可视化软件等具有重要意义。
OCCT使用指南：Visualization
weixin_44897632的博客
11-22 2594
应用程序交互服务允许以简单透明的方式在查看器中管理演示和动态选择。管理可视化和选择的中心实体是交互式上下文。它连接到主查看器。默认情况下，交互上下文从中性点开始，每个可选择对象作为一个整体被选中，但用户可能会激活特定对象的局部选择，以使对象的部分可选择。本地/全局选择通过为每个显示对象激活的选择模式列表来管理，选择模式为0(默认选择模式)，通常意味着全局(整个对象)选择。交互对象是实体，它是可视化的和可选择的。
occt_overview_OpenCascade_overview_源码
10-04
本资源"occt_overview_OpenCascade_overview_源码"是OpenCASCADE官方提供的帮助文档，旨在帮助开发者和使用者更深入地理解其类库和函数的功能与用法。 OpenCASCADE的核心优势在于它提供了一整套强大的几何建模工具...
opencascade源码及编译安装文档
08-25
OCC主要用于开发二维和三维几何建模应用程序，包括通用的或专业的计算机辅助设计CAD系统、制造或分析领域的应用程序、仿真应用程序或图形演示工具。OCC通过有机组织的C++库文件提供了六个模块。...
AIS-ColorScale示例 可以显示多颜色
05-26
颜色刻度由矩形颜色条（由固定数量的颜色区间组成）、可选标签和标题构成。标签可以放置在区间的边界处，也可以放置在每个区间的中间。颜色和标签可以自动定义或由用户设置。自动标签根据刻度的数值范围、刻度类型...
OPENCASCADE通过鼠标在界面中点击在模型中创建点.txt
07-31
OPENCASCADE通过鼠标在界面中点击在模型中创建点，测试可用！网上只是给了方法，我在这实现了下，基于QT！看不懂可以留言私信！
Opencascade源码学习之模型数据
younggung的博客
03-24 2579
Opencascade源码学习之模型数据
OpenCascade源码剖析：Standard_Transient根类
leizhengshenglzs的博客
03-07 959
Standard_Transient是OCCT继承体系最顶层的根类，Standard_Transient类主要提供了三个机制，内存分配，RTTI和引用计数。
2、Opencascade基础类分析(含代码示例)【基础篇】
sswai的博客
09-27 4042
opencascade 基础类分析 含部分代码
Opencascade源码学习之模型算法_TKO模块文件介绍
younggung的博客
05-26 1360
Opencascade源码学习之模型数据_TKO模块文件介绍
OpenCASCADE可视化：应用交互服务之本地选择
希望我的博客，能帮上你解决学习中工作中所遇到的问题
08-05 743
OpenCASCADE可视化：应用交互服务之本地选择选择模式过滤器选择例子 选择模式 本地选择由索引（选择模式）定义。应在此类的文档中检查由特定交互对象实现的选择模式及其含义。参见，例如，MeshVS_SelectionModeFlags为MeshVS_Mesh对象。 AIS_Shape是最常用的交互对象。它提供 API 来管理对形状组成元素的选择操作（顶点、边、面等的选择）。特定形状类型 ( TopAbs_ShapeEnum )的选择模式由方法AIS_Shape::SelectionMode() 返回。
批量归一化 BN(Batch Normalization) (减少重复学习 - 加速损失收敛) + 代码实现 ——笔记2.15《动手学深度学习》
最新发布
科研汪小陈的博客
11-08 1130
批量归一化固定小批量中的均值和方差，然后学习出适合的偏移和缩放； 可以加速收敛速度（比如以前学习率是0.01，现在用了批量归一化后，可以调到0.1） 不会出现之前：学习率太大的话，上面 (靠近损失的梯度) 会炸掉； 不会出现之前：学习率太小的话，下面 (靠近数据的模型参数) 会学不动； 每一个层的输出都通过均值方差放在一起了，上下层的分布都差不多是正态分布； 但一般不改变模型精度
如何获取opencascade IntTools_FaceFace的结果
10-24
在OpenCASCADE技术栈中，IntTools_FaceFace是一个工具类，它主要用于处理几何模型中的面（Face）。如果你想从IntTools_FaceFace操作中获取结果，通常会涉及到以下几个步骤： 1. **创建IntTools_FaceFace实例**： 首先，你需要包含必要的头文件，并通过`TopoDS_Shape`或`BRep_Builder`等对象创建一个IntTools_FaceFace的实例。 ```cpp #include <TopTools/IntTools.hxx> IntTools_FaceFace face_face_tool; ``` 2. **执行操作**： 使用提供的函数，比如`Split`, `Merge`, 或者其他的IntTools FaceFace方法来进行你要的操作。例如，如果你想要合并两个面，可以这样做： ```cpp TopoDS_Shape source_shape, target_shape; // ... (设置source_shape和target_shape) face_face_tool.PerformMerge(source_shape, target_shape); ``` 3. **检查结果**： 操作后，你可以检查`face_face_tool.Status()`来了解操作是否成功。如果成功，可能会返回一个表示新形状的`TopoDS_Shape`。 4. **获取结果数据**： 如果需要具体的面信息，如边、点或其他属性，你可以使用`face_face_tool.NewShape()`来访问修改后的结果，然后使用相应的OpenCASCADE功能提取所需的数据。 ```cpp TopoDS_Shape result = face_face_tool.NewShape(); // ... (进一步处理result) ```
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值