opencascade AIS_TexturedShape源码学习 贴纹理 原创
opencascade AIS_TexturedShape
opencascade 贴纹理
前言
//! 该类允许在形状上映射纹理。
//! 显示模式 AIS_WireFrame (0) 和 AIS_Shaded (1) 的行为与 AIS_Shape 中的行为相同，
//! 而新模式 2 (包围盒) 和 3 (纹理映射) 扩展了其功能。
//!
//! 纹理本身在 (0,1)x(0,1) 的参数空间内进行参数化。
//! 形状的每个位于 UV 空间中的面都具有以下参数：
//! - Umin - U 方向的起始位置
//! - Umax - U 方向的结束位置
//! - Vmin - V 方向的起始位置
//! - Vmax - V 方向的结束位置
//! 每个面都被三角化，并且每个节点被分配一个纹素。
//! 面片然后使用纹理的线性插值填充每个 ‘三个纹素’ 之间的区域。
//! 用户可以控制：
//! - 纹理在面上的重复次数
//! - 纹理原点的位置
//! - 纹理的缩放因子
该类用于在形状上进行纹理映射，介绍了纹理的参数化方式、面的参数化、三角化和纹理映射的基本原理，以及用户可以控制的几个关键因素。
方法
1
初始化带纹理的形状。
Standard_EXPORT AIS_TexturedShape (const TopoDS_Shape& theShape);
2
//! 设置纹理源。 可以指定纹理图像的路径或标准预定义纹理之一。
//! 接受的文件类型与 Image_AlienPixMap 中使用的类型相同，如 rgb、png、jpg 等。
//! 若要指定标准预定义纹理， 应包含 Graphic3d_NameOfTexture2D 枚举索引。
//! 使用此方法设置纹理源会重置源像素图（如果之前设置过）。
Standard_EXPORT virtual void SetTextureFileName (const TCollection_AsciiString& theTextureFileName);
3
//! 设置纹理源。 指定图像数据。
//! 注意，数据应按从底向上的顺序排列，图形驱动程序将忽略 Image_PixMap::IsTopDown() 标志。
//! 使用此方法设置纹理源会重置源文件名（如果之前设置过）。
Standard_EXPORT virtual void SetTexturePixMap (const Handle(Image_PixMap)& theTexturePixMap);
3
//! @return 控制纹理映射的标志（用于显示模式 3）
Standard_Boolean TextureMapState() const { return myToMapTexture; }
4
//! 启用纹理映射
Standard_EXPORT void SetTextureMapOn();
5
//! 禁用纹理映射
Standard_EXPORT void SetTextureMapOff();
6
//! @return 纹理文件的路径
Standard_CString TextureFile() const { return myTextureFile.ToCString(); }
7
//! @return 纹理映射的源像素图
const Handle(Image_PixMap)& TexturePixMap() const { return myTexturePixMap; }
8
public: //! @name 修改纹理映射属性的方法
9
//! 使用此方法显示带纹理的形状，而无需重新计算整个表示。
//! 当仅更改纹理内容时使用此方法。
//! 如果其他参数（例如：缩放因子、纹理原点、纹理重复等）发生了变化，则必须重新计算整个表示：
//! @code
//! if (myShape->DisplayMode() == 3)
//! {
//! myAISContext->RecomputePrsOnly (myShape);
//! }
//! else
//! {
//! myAISContext->SetDisplayMode (myShape, 3, Standard_False);
//! myAISContext->Display (myShape, Standard_True);
//! }
//! @endcode
Standard_EXPORT void UpdateAttributes();
10
//! 设置颜色。
Standard_EXPORT virtual void SetColor (const Quantity_Color& theColor) Standard_OVERRIDE;
11
//! 移除颜色设置。
Standard_EXPORT virtual void UnsetColor() Standard_OVERRIDE;
12
//! 设置材料方面。
Standard_EXPORT virtual void SetMaterial (const Graphic3d_MaterialAspect& theAspect) Standard_OVERRIDE;
13
//! 移除材料方面设置。
Standard_EXPORT virtual void UnsetMaterial() Standard_OVERRIDE;
14
//! 启用纹理调制
Standard_EXPORT void EnableTextureModulate();
15
//! 禁用纹理调制
Standard_EXPORT void DisableTextureModulate();
17
//! @return 纹理重复标志
Standard_Boolean TextureRepeat() const { return myToRepeat; }
18
//! @return 纹理重复的 U 值
Standard_Real URepeat() const { return myUVRepeat.X(); }
19
//! @return 纹理重复的 V 值
Standard_Real VRepeat() const { return myUVRepeat.Y(); }
20
//! 设置每个面上的纹理重复次数。纹理本身在 (0,1)x(0,1) 的参数空间内进行参数化。
//! 要纹理化的形状的每个面在 UV 空间中为 (Umin,Umax) x (Vmin,Vmax) 进行参数化。
//! 如果 RepeatYN 设置为 false，则纹理坐标被夹在面的 (0,1)x(0,1) 范围内。
Standard_EXPORT void SetTextureRepeat (const Standard_Boolean theToRepeat,
const Standard_Real theURepeat = 1.0,
const Standard_Real theVRepeat = 1.0);
21
//! @return 如果纹理 UV 原点已修改，则返回 true
Standard_Boolean TextureOrigin() const { return myIsCustomOrigin; }
22
//! @return 纹理原点的 U 位置（默认为 0.0）
Standard_Real TextureUOrigin() const { return myUVOrigin.X(); }
23
//! @return 纹理原点的 V 位置（默认为 0.0）
Standard_Real TextureVOrigin() const { return myUVOrigin.Y(); }
24
//! 使用此方法更改纹理的原点。纹素 (0,0) 将映射到表面 (UOrigin,VOrigin)
Standard_EXPORT void SetTextureOrigin (const Standard_Boolean theToSetTextureOrigin,
const Standard_Real theUOrigin = 0.0,
const Standard_Real theVOrigin = 0.0);
25
//! @return 如果应用纹理映射的比例因子，则返回 true
Standard_Boolean TextureScale() const { return myToScale; }
26
//! @return U 坐标的比例因子（默认为 1.0）
Standard_Real TextureScaleU() const { return myUVScale.X(); }
27
//! @return V 坐标的比例因子（默认为 1.0）
Standard_Real TextureScaleV() const { return myUVScale.Y(); }
28
//! 使用此方法缩放纹理（面的百分比）。
//! 您可以为 U 和 V 分别指定一个比例因子。
//! 例如：如果将 ScaleU 和 ScaleV 设置为 0.5 并启用纹理重复，
//! 则纹理将在每个方向上在面上显示两次。
Standard_EXPORT void SetTextureScale (const Standard_Boolean theToSetTextureScale,
const Standard_Real theScaleU = 1.0,
const Standard_Real theScaleV = 1.0);
29
//! @return 如果请求显示三角形，则返回 true
Standard_Boolean ShowTriangles() const { return myToShowTriangles; }
30
//! 使用此方法显示形状的三角化（用于调试等）。
Standard_EXPORT void ShowTriangles (const Standard_Boolean theToShowTriangles);
31
//! @return 如果启用了纹理颜色调制，则返回 true
Standard_Boolean TextureModulate() const { return myModulate; }
32
//! 如果支持指定的显示模式（扩展 AIS_Shape 的显示模式 3），则返回 true。
virtual Standard_Boolean AcceptDisplayMode (const Standard_Integer theMode) const Standard_OVERRIDE { return theMode >= 0 && theMode <= 3; }
用法用例
OpenCascade中的AIS_TexturedShape类用于在形状上应用纹理，以下是一个简单的用法示例：
#include <AIS_TexturedShape.hxx>
#include <Graphic3d_AspectFillArea3d.hxx>
#include <TopoDS.hxx>
#include <TopExp_Explorer.hxx>
#include <BRep_Builder.hxx>
#include <BRepPrimAPI_MakeBox.hxx>
#include <AIS_InteractiveContext.hxx>
#include <Quantity_Color.hxx>
#include <Aspect_TypeOfFacingModel.hxx>
void createTexturedShape(const Handle(AIS_InteractiveContext)& context) {
// 创建一个长方体作为示例形状
BRep_Builder builder;
TopoDS_Shape shape;
BRepPrimAPI_MakeBox box(gp_Pnt(-50, -50, -50), gp_Pnt(50, 50, 50));
shape = box.Shape();
// 创建AIS_TexturedShape对象
Handle(AIS_TexturedShape) texturedShape = new AIS_TexturedShape(shape);
// 设置纹理文件（示例使用路径指定纹理图像）
texturedShape->SetTextureFileName("path/to/texture.png");
// 设置纹理映射属性
texturedShape->SetTextureMapOn();
texturedShape->SetTextureRepeat(true, 2.0, 1.0); // 设置纹理在 U 方向重复两次，在 V 方向重复一次
texturedShape->SetTextureScale(true, 0.5, 0.5); // 缩放纹理大小为原来的一半
// 将AIS_TexturedShape添加到交互上下文中显示
context->Display(texturedShape, Standard_True);
}
int main() {
// 创建OpenCascade交互上下文
Handle(AIS_InteractiveContext) context = new AIS_InteractiveContext();
// 创建带纹理的形状并显示
createTexturedShape(context);
// 进入主事件循环或其他逻辑...
return 0;
}
在上述示例中，我们首先创建了一个简单的长方体形状，并将其作为示例形状。然后，我们创建了一个AIS_TexturedShape对象，并设置了纹理文件的路径，以及纹理的映射属性，包括重复次数和缩放因子。最后，我们将AIS_TexturedShape对象添加到交互上下文中显示。这个示例展示了如何使用AIS_TexturedShape类在OpenCascade中创建和显示带纹理的形状。
