opencascade AIS_TextLabel源码学习【重要】

opencascade AIS_TextLabel
opencascade 显示文字

前言

显示文字

方法

1

默认构造函数
Standard_EXPORT AIS_TextLabel();

2

//! 对支持的显示模式返回TRUE。
AcceptDisplayMode (const Standard_Integer theMode) const Standard_OVERRIDE { return theMode == 0; }

3

设置整个文本的颜色。
void SetColor (const Quantity_Color& theColor) ;

4

//! 设置透明度在[0, 1]范围内。
void SetTransparency (const Standard_Real theValue) ;

5

//! 取消透明设置。
virtual void UnsetTransparency() Standard_OVERRIDE { SetTransparency (0.0); }

6

材料对文本标签没有影响。
void SetMaterial (const Graphic3d_MaterialAspect& ) Standard_OVERRIDE {}

7

设置文本。
void SetText (const TCollection_ExtendedString& theText);

8

设置位置。
Standard_EXPORT void SetPosition (const gp_Pnt& thePosition);

9

设置水平对齐。
void SetHJustification (const Graphic3d_HorizontalTextAlignment theHJust);

10

设置垂直对齐。
void SetVJustification (const Graphic3d_VerticalTextAlignment theVJust);

11

设置角度。
Standard_EXPORT void SetAngle (const Standard_Real theAngle);

12

设置可缩放属性。
void SetZoomable (const Standard_Boolean theIsZoomable);

13

设置高度。
void SetHeight (const Standard_Real theHeight);

14

设置字体特性。
void SetFontAspect (const Font_FontAspect theFontAspect);

15

设置字体。
void SetFont (Standard_CString theFont);

17

在模型3D空间中设置标签方向。
Standard_EXPORT void SetOrientation3D (const gp_Ax2& theOrientation);

18

重置模型3D空间中的标签方向。
void UnsetOrientation3D ();

19

返回位置。
gp_Pnt& Position() const;

20

//! 返回标签文本。
TCollection_ExtendedString& Text() const { return myText; }

21

返回标签文本的字体。
const TCollection_AsciiString& FontName() const;

22

//! 返回标签文本的字体特性。
Standard_EXPORT Font_FontAspect FontAspect() const;

23

返回模型3D空间中的标签方向。
gp_Ax2& Orientation3D() const;

24

//! 如果当前文本放置模式使用模型3D空间中的文本方向，则返回true。
Standard_Boolean HasOrientation3D() const;

25

void SetFlipping (const Standard_Boolean theIsFlipping);

26

Standard_Boolean HasFlipping() const;

27

如果文本使用位置作为附加点，则返回标志。
Standard_Boolean HasOwnAnchorPoint() const { return myHasOwnAnchorPoint; }

28

设置文本是否使用位置作为附加点。
void SetOwnAnchorPoint (const Standard_Boolean theOwnAnchorPoint) { myHasOwnAnchorPoint = theOwnAnchorPoint; }

29

定义文本的显示类型。

TODT_NORMAL 默认显示。仅文本。
TODT_SUBTITLE 文本下方有副标题。
TODT_DEKALE 文本以3D风格显示。
TODT_BLEND 文本以XOR方式显示。
TODT_DIMENSION 文本下方的尺寸线将不可见。
void SetDisplayType (const Aspect_TypeOfDisplayText theDisplayType);

30

//! 修改TODT_SUBTITLE文本显示类型的副标题颜色
//! 和TODT_DEKALE文本显示类型的背景颜色。
Standard_EXPORT void SetColorSubTitle (const Quantity_Color& theColor);

31

//! 返回文本呈现格式化程序；默认情况下为NULL，表示将使用标准文本格式化程序。
const Handle(Font_TextFormatter)& TextFormatter() const { return myFormatter; }

32

//! 设置文本的呈现格式化程序。默认为空。
void SetTextFormatter (const Handle(Font_TextFormatter)& theFormatter) { myFormatter = theFormatter; }

33

//! 计算
Standard_EXPORT virtual void Compute (const Handle(PrsMgr_PresentationManager)& theprsMgr,
const Handle(Prs3d_Presentation)& thePrs,
const Standard_Integer theMode) Standard_OVERRIDE;

34

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

35

//! 计算标签中心、宽度和高度
Standard_EXPORT Standard_Boolean calculateLabelParams (const gp_Pnt& thePosition,gp_Pnt& theCenterOfLabel,
Standard_Real& theWidth, Standard_Real& theHeight) const;

36

//! 计算标签变换
Standard_EXPORT gp_Trsf calculateLabelTrsf (const gp_Pnt& thePosition, gp_Pnt& theCenterOfLabel) const;

用法示例

OpenCascade中的AIS_TextLabel类用于在3D场景中显示文本标签，以下是一个简单的用法示例：

#include <AIS_TextLabel.hxx>
#include <Prs3d_TextAspect.hxx>
#include <Quantity_Color.hxx>
#include <gp_Pnt.hxx>
#include <Graphic3d_AspectText3d.hxx>
#include <Graphic3d_VerticalTextAlignment.hxx>
#include <Graphic3d_HorizontalTextAlignment.hxx>

void createTextLabel(const gp_Pnt& position, const TCollection_ExtendedString& text) {
    // 创建AIS_TextLabel对象
    Handle(AIS_TextLabel) textLabel = new AIS_TextLabel();

    // 设置文本内容
    textLabel->SetText(text);

    // 设置文本位置
    textLabel->SetPosition(position);

    // 设置文本的颜色
    Quantity_Color color(1.0, 0.0, 0.0, Quantity_TOC_RGB);  // 红色
    textLabel->SetColor(color);

    // 设置文本的垂直和水平对齐方式
    textLabel->SetHJustification(Graphic3d_HTA_LEFT);  // 水平左对齐
    textLabel->SetVJustification(Graphic3d_VTA_BOTTOM);  // 垂直底部对齐

    // 设置文本的高度
    textLabel->SetHeight(15.0);  // 设置文本高度为15个单位

    // 添加文本标签到场景显示中
    // 假设prsMgr是PrsMgr_PresentationManager的一个实例，thePrs是Prs3d_Presentation的一个实例
    prsMgr->SetView(thePrs);
    textLabel->Compute(prsMgr, thePrs, 0);
}

int main() {
    // 创建一个示例的点位置
    gp_Pnt position(0.0, 0.0, 0.0);

    // 创建一个示例的文本内容
    TCollection_ExtendedString text("Hello, OpenCascade!");

    // 创建文本标签并添加到场景中显示
    createTextLabel(position, text);

    return 0;
}

在上面的示例中，我们首先创建了一个AIS_TextLabel对象，并设置了文本内容、位置、颜色、对齐方式和高度等属性。然后将文本标签通过Compute方法添加到场景中显示。这个示例展示了如何使用AIS_TextLabel类在OpenCascade中显示文本标签。

参考