opencascade 源码学习 XmlDrivers-XmlDrivers

OpenCASCADE 中的 XmlDrivers 是用于处理 XML 格式的 CAD 数据持久化模块，属于 OCAF（Open CASCADE Application Framework） 的一部分。它允许将 OCAF 文档（包含 CAD 数据、属性、关系等）序列化为 XML 文件，或从 XML 文件反序列化加载数据。以下是 XmlDrivers 的基本用法和步骤：

1. 核心功能

保存 OCAF 文档：将 TDocStd_Document 保存为 XML 文件。
加载 OCAF 文档：从 XML 文件恢复 TDocStd_Document。
支持数据类型：几何形状、颜色、层、名称等属性。

2. 使用步骤

(1) 初始化 XmlDrivers 插件

在使用 XmlDrivers 前，需注册 XML 格式的驱动到 OCAF 应用程序中。通常通过以下方式初始化：

#include <XmlDrivers.hxx>
#include <Plugin_Macro.hxx>// 注册 XML 驱动
Handle(Message_Messenger) aMsgMgr = Message::DefaultMessenger();
XmlDrivers::DefineFormat(aMsgMgr);

(2) 创建 OCAF 应用程序

创建支持 XML 持久化的 OCAF 应用程序对象：

#include <TDocStd_Application.hxx>Handle(TDocStd_Application) app = TDocStd_Application::GetInstance();

(3) 保存文档到 XML

将 OCAF 文档保存为 XML 文件：

#include <TDocStd_Document.hxx>
#include <PCDM_StoreStatus.hxx>// 创建新文档
Handle(TDocStd_Document) doc;
app->NewDocument("XmlOcaf", doc);// ... 在此向文档中添加数据（形状、属性等） ...// 保存文档
TCollection_ExtendedString xmlFilePath = "/path/to/save.xml";
PCDM_StoreStatus status = app->SaveAs(doc, xmlFilePath);if (status == PCDM_SS_OK) {std::cout << "文档保存成功！" << std::endl;
}

(4) 从 XML 加载文档

从 XML 文件恢复 OCAF 文档：

Handle(TDocStd_Document) restoredDoc;
TCollection_ExtendedString xmlFilePath = "/path/to/save.xml";// 加载文档
if (app->Open(xmlFilePath, restoredDoc) == PCDM_RS_OK) {std::cout << "文档加载成功！" << std::endl;
}// ... 使用恢复的文档数据 ...

3. 关键类与 API

XmlDrivers：提供 XML 驱动的注册方法 DefineFormat()。
TDocStd_Application：OCAF 应用程序，管理文档生命周期。
TDocStd_Document：存储 CAD 数据和属性的文档对象。
PCDM_Reader/PCDM_Writer：XML 读写器的基类，实际使用 XmlDrivers 的具体实现。

4. 示例代码（完整流程）

		Handle(Poly_Triangulation) aResMesh;// Some code to generate or create a valid mesh object// aResMesh = transferTriangleWithPointNormalsUVIndices(aTriangleWithPointNormalsUVIndices, aPoints, aPointsSize, anUVPoints, aPreparedNorms, myScaleUnit);BRep_Builder aBuilder;// Tool to work with shapesTopoDS_Face aFace = TopoDS::Face(shas.GetThis());// New TopoDS_Shape objectaBuilder.MakeFace(aFace, aResMesh);// Now we have a TopoDS_Shape, that can be used to set for a XBF document// The next code to set a shape to the DocumentHandle(TDocStd_Document) aDoc;Handle(TDocStd_Application) anApp = new TDocStd_Application;// Initialize standard document formats at creation - they should// be available even if this DRAW plugin is not loaded by pload commandStdLDrivers::DefineFormat(anApp);BinLDrivers::DefineFormat(anApp);XmlLDrivers::DefineFormat(anApp);StdDrivers::DefineFormat(anApp);BinDrivers::DefineFormat(anApp);XmlDrivers::DefineFormat(anApp);TCollection_ExtendedString format;anApp->NewDocument(format,aDoc);Handle(XCAFDoc_ShapeTool) aShTool =new  XCAFDoc_ShapeTool();//aShTool->Set(aDoc->Main());aShTool->SetShape(aDoc->Main(),aFace);// Additionally you can link a color and another attributes.// Write a Gltf(glb)RWGltf_CafReader aReader;TCollection_AsciiString ddd = "d:/test.glb";Message_ProgressRange ddddddd;aReader.Perform(ddd, ddddddd);