opencascade 源码学习 XmlDrivers-XmlDrivers

news2025/3/26 6:34:06

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 shapes
		TopoDS_Face aFace = TopoDS::Face(shas.GetThis());
		// New TopoDS_Shape object
	
		aBuilder.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 Document
		Handle(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 command
		StdLDrivers::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);