XT Document

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== XModel ======

**//Inherited from//**  [[class::domain::nitem|NItem]],

**//Inherited by//**  NULL

**//Friend class//**  ModelManager,

**//Description//**

XModel封装了一个完整模型的所有信息。一个模型主要包含三个层次的信息，第一个层次是装配信息，即零部件与零部件的装配关系，便于用户对整个模型的访问与管理；第二个层次是几何拓扑信息，一个零部件包含若干顶层几何体，而顶层几何体又分别包含若干下一级几何体（如体包含若干面，面包含若干边，边包含最多两个顶点）；第三个层次是网格信息，模型的几何面在视图上都以离散的三角片（三角单元）表达，几何边在视图上以离散的线段（线单元）表达，几何顶点以离散的点（点单元）表达，在截面视图上，以离散的体单元表达截面细节。可参考[[http://xdoc.com/doku.php?id=reference:modeling|模型的结构示意图]]。

XModel与大多数其他数据对象不一样，它本身包含了若干对象管理器，包括部件管理器、几何管理器、节点管理器、网格管理器，在一个模型内，部件（包括装配体）、几何实体（体、线、面、点）、节点、网格都有各自唯一的ID，这些管理器不能被XDocument直接访问，因此访问节点、网格、几何实体与部件都首先需要访问XModel，然后再通过XModel提供的接口访问具体的数据对象。

XT从底层构建了undo、redo机制，这套机制对访问和修改数据对象做了区分，其中访问通过getItem接口完成，数据的改动可通过3个接口完成，其中createItem用于增加数据，removeItem用于删除数据，checkOutItem用于修改已有的数据。XModel内部数据的访问和改动也完全遵守这套机制，createNode、createPart、createElement、createGeometry用于增加数据，removeNode、removeElement、removePart、removeGeometry用于删除数据，checkOutNode、checkOutElement、checkOutPart、checkOutGeometry用于修改已有的数据。

为了更方便的访问遍历特定拓扑类型的几何，XModel在几何管理器中为每个拓扑类型都构建了一套哈希表，通过指定拓扑类型，XModel就可以直接绑定其相应的访问迭代器。

XModel可以为不同部件设置不同的角色，不同角色的部件被置于不同的装配树根节点下，装配树根节点在创建XModel对象时自动生成，它的ID为0，因此不能通过ModelCompoenentManager来访问它，只能通过getAssemblyRoot接口访问。目前部件支持Normal和Auxiliary两种角色。

**//Members//**
  * XBoundBox [[xmodel#m_dboundbox|m_dBoundBox]]
  * const XAssembly * [[xmodel#m_passemblyroot|m_pAssemblyRoot]]
  * const XAssembly * [[xmodel#m_pauxiliaryroot|m_pAuxiliaryRoot]]
  * XMemPool * [[xmodel#m_phashpool|m_pHashPool]]
  * XMemPool * [[xmodel#m_pgeneralpool|m_pGeneralPool]]
  * real [[xmodel#m_dtscale|m_dTScale]]
  * bool [[xmodel#m_bgldataready|m_bGLDataReady]]
  * bool [[xmodel#m_bvisible|m_bVisible]]
  * int [[xmodel#m_idomainhdlidbase|m_iDomainHdlIDBase]]
  * OpnRecorder * [[xmodel#m_precorder|m_pRecorder]]
  * NodeManager * [[xmodel#m_pnodemgr|m_pNodeMgr]]
  * ElementManager * [[xmodel#m_pelemmgr|m_pElemMgr]]
  * GeometryManager * [[xmodel#m_pelsetmgr|m_pElsetMgr]]
  * PartManager * [[xmodel#m_ppartmgr|m_pPartMgr]]
  * PartSnapshotManager * [[xmodel#m_ppssmgr|m_pPSSMgr]]
**//Public interface//**
  * [[xmodel#xmodel1|XModel]](ulong mid)
  * [[xmodel#~xmodel|~XModel]]()
  * void [[xmodel#init|init]](OpnRecorder * rec = NULL)
  * const XPart * [[xmodel#getpart|getPart]](ulong id)const
  * XNode * [[xmodel#checkoutnode|checkOutNode]](const XNode * n)
  * XElement * [[xmodel#checkoutelement|checkOutElement]](const XElement * e)
  * XElement * [[xmodel#checkoutelement|checkOutElement]](ulong id)
  * XPart * [[xmodel#checkoutpart|checkOutPart]](ulong id)
  * XPart * [[xmodel#checkoutpart|checkOutPart]](const XPart * p)
  * void [[xmodel#bindpartsnapshotmanager|bindPartSnapshotManager]](PartSnapshotManager * pssMgr)
  * PartManager * [[xmodel#getpartmanager|getPartManager]]()
  * NodeManager * [[xmodel#getnodemanager|getNodeManager]]()
  * ElementManager * [[xmodel#getelemmanager|getElemManager]]()
  * GeometryManager * [[xmodel#getgeometrymanager|getGeometryManager]]()
  * const XAssembly * [[xmodel#getassemblyroot|getAssemblyRoot]]() const
  * const XAssembly * [[xmodel#getauxiliaryroot|getAuxiliaryRoot]]() const
  * const XGeometry * [[xmodel#getgeometry|getGeometry]](ulong id)const
  * XGeometry * [[xmodel#checkoutgeometry|checkOutGeometry]](ulong id)
  * XGeometry * [[xmodel#checkoutgeometry|checkOutGeometry]](const XGeometry *g)
  * const ElementSet * [[xmodel#getelementset|getElementSet]](ulong id)const
  * void [[xmodel#bindpartiterator|bindPartIterator]](HashIterator * pIter) const
  * void [[xmodel#bindnodeiterator|bindNodeIterator]](HashIterator * pIter)const
  * void [[xmodel#bindelementiterator|bindElementIterator]](HashIterator * pIter)const
  * void [[xmodel#bindgeometryiterator|bindGeometryIterator]](HashIterator * pIter)const
  * void [[xmodel#bindgeometryiterator|bindGeometryIterator]](HashIterator * pIter,TypeID gt)const
  * void [[xmodel#removegeometry|removeGeometry]](const XGeometry * g)
  * void [[xmodel#removeelementset|removeElementSet]](const ElementSet * es)
  * XGeometry * [[xmodel#creategeometry|createGeometry]](TypeID t,ulong id = 0,XGeometry * parent = 0)
  * ElementSet [[xmodel#*createelementset|*createElementSet]](int entitySize = 8,ulong id = 0)
  * XNode * [[xmodel#createnode|createNode]](const real * coord,ulong nid = 0)
  * XAssembly * [[xmodel#createassembly|createAssembly]](const char * name, ulong id, XAssembly * parent, bool bAuxiliary = false)
  * XPart * [[xmodel#createpart|createPart]](const char * name, ulong id, XAssembly * parent, bool bAuxiliary = false)
  * void [[xmodel#removenode|removeNode]](const XNode * pNode)
  * void [[xmodel#movenode|moveNode]](const XNode * n, const real * coord)
  * NodePtr [[xmodel#getnode|getNode]](ulong id) const
  * XElement * [[xmodel#createelement|createElement]](TypeID et, const NodePtr* pNodes,ulong eid = 0,XGeometry * entity = 0, bool bUpdateNodeElemLink = true)
  * void [[xmodel#removeelement|removeElement]](XElement * pElement, bool bDeleteFreeNode = true)
  * void [[xmodel#replaceelemnode|replaceElemNode]](XElement* pElem,const XNode * old, const XNode * new_node,bool notDetachOld = false)
  * void [[xmodel#resetelemnodes|resetElemNodes]](XElement* pElem,const XNode <nowiki>**</nowiki> ns)
  * void [[xmodel#setelemnode|setElemNode]](XElement* pElem,int index, const XNode * new_node)
  * void [[xmodel#updatenodeelementlink|updateNodeElementLink]](bool bKeepOld)
  * void [[xmodel#updatenodeelementlink|updateNodeElementLink]](vector<const XPart *> * parts, bool bKeepOld)
  * void [[xmodel#updatenodeelementlink|updateNodeElementLink]](vector<const XGeometry *> * geoms, bool bKeepOld)
  * void [[xmodel#addcellfacet|addCellFacet]](ElemPtr pFacet, XElement * cell)
  * void [[xmodel#removecellfacet|removeCellFacet]](ElemPtr facet, XElement * cell)
  * void [[xmodel#setpolylinenodes|setPolylineNodes]](const XNode <nowiki>**</nowiki> ns, int cnt, XElement* pElem)
  * void [[xmodel#setpolygonnodes|setPolygonNodes]](const XNode <nowiki>**</nowiki> ns, int cnt, XElement* pElem)
  * void [[xmodel#setcellfacets|setCellFacets]](const XElement <nowiki>**</nowiki> facets, int cnt, XElement* pElem)
  * ElemPtr [[xmodel#getelement|getElement]](ulong id) const
  * void [[xmodel#removepart|removePart]](const XPart * pPart)
  * int [[xmodel#getpartcount|getPartCount]](bool bExcludeAsb = true) const
  * int [[xmodel#getelementcount|getElementCount]]()const
  * int [[xmodel#getnodecount|getNodeCount]]()const
  * int [[xmodel#getsurfaceelementcount|getSurfaceElementCount]]()const
  * int [[xmodel#getgeometrycount|getGeometryCount]](TypeID gt)const
  * int [[xmodel#getgeometrycount|getGeometryCount]]() const
  * int [[xmodel#getelementsetcount|getElementSetCount]]()const
  * void [[xmodel#attachelemtogeom|attachElemToGeom]](XGeometry * g, XElement * el)
  * void [[xmodel#detachelemfromgeom|detachElemFromGeom]](XGeometry * g, XElement * el)
  * void [[xmodel#attachparttoassembly|attachPartToAssembly]](XAssembly * asb, XPart * p)
  * void [[xmodel#detachpartfromassembly|detachPartFromAssembly]](XAssembly * asb, XPart * p)
  * void [[xmodel#attachpartsnapshot|attachPartSnapshot]](XPart * p, XPartSnapshot * asb)
  * void [[xmodel#detachpartsnapshot|detachPartSnapshot]](XPart * p, XPartSnapshot * asb)
  * void [[xmodel#attachgeomtopart|attachGeomToPart]](XGeometry * g, XPart * p)
  * void [[xmodel#detachgeomfrompart|detachGeomFromPart]](XGeometry * g, XPart * p)
  * void [[xmodel#attachgeomchild|attachGeomChild]](XGeometry * g, const XGeometry * child)
  * void [[xmodel#detachgeomchild|detachGeomChild]](XGeometry * g, const XGeometry * child)
  * void [[xmodel#clear|clear]]()
  * void [[xmodel#clearviewdata|clearViewData]]()
  * void [[xmodel#updateviewdata|updateViewData]]()
  * bool [[xmodel#isviewdataready|isViewDataReady]]() const
  * ulong [[xmodel#getnextgeometryid|getNextGeometryId]]()
  * ulong [[xmodel#getnextelementid|getNextElementId]]()
  * ulong [[xmodel#getnextnodeid|getNextNodeId]]()
  * const XBoundBox & [[xmodel#getboundbox|getBoundBox]]() const
  * void [[xmodel#normalizeboundbox|normalizeBoundBox]](const real * origin, real scale)
  * void [[xmodel#restoreboundbox|restoreBoundBox]](const real * origin, real scale)
  * void [[xmodel#updateboundbox|updateBoundBox]]()
  * void [[xmodel#setpartvisible|setPartVisible]](ulong id,bool bVisible)
  * void [[xmodel#setgeomvisible|setGeomVisible]](ulong id, bool bVisible)
  * XVertex* [[xmodel#getvertexbynode|getVertexByNode]](XNode * pNode)
  * void [[xmodel#createdefaultpart|createDefaultPart]]()
  * void [[xmodel#write|write]](XBinaryIO * io) const
  * void [[xmodel#writeforpost|writeForPost]](XBinaryIO * io) const
  * void [[xmodel#save|save]](const char * fname) const
  * bool [[xmodel#load|load]](const char * fname)
  * void [[xmodel#saveh5|saveH5]](const char * fname) const
  * bool [[xmodel#loadh5|loadH5]](const char * fname)
  * ErrorCode [[xmodel#read|read]](XBinaryIO * io)
  * ErrorCode [[xmodel#readforpost|readForPost]](XBinaryIO * io)
  * void [[xmodel#write|write]](XH5IO * io, H5Obj * grp) const
  * bool [[xmodel#read|read]](XH5IO * io, H5Obj * grp)
  * void [[xmodel#copy|copy]](XModel * mdl)
  * bool [[xmodel#isvisible|isVisible]]() const
  * void [[xmodel#setvisible|setVisible]](bool b)
  * void [[xmodel#updateafterrenumber|updateAfterRenumber]](TypeID tid)
  * void [[xmodel#setgldataready|setGLDataReady]](bool bReady)
  * real [[xmodel#getnormalizedscale|getNormalizedScale]]()
  * void [[xmodel#setnormalizedscale|setNormalizedScale]](real s)
  * OpnRecorder * [[xmodel#getrecorder|getRecorder]]()
  * void [[xmodel#updatefacecolorbypart|updateFaceColorByPart]](const XPart * p)
  * void [[xmodel#setgeomvisible|setGeomVisible]](const XGeometry * g, bool bVisible)
**//Private interface//**
  * void [[xmodel#writenodes|writeNodes]](XBinaryIO * io) const
  * ErrorCode [[xmodel#readnodes|readNodes]](XBinaryIO * io,int cnt)
  * void [[xmodel#writeelements|writeElements]](XBinaryIO * io) const
  * ErrorCode [[xmodel#readelements|readElements]](XBinaryIO * io)
  * void [[xmodel#writeassembly|writeAssembly]](XBinaryIO * io, TreeNode * pItem = 0) const
  * ErrorCode [[xmodel#readassembly|readAssembly]](XBinaryIO * io, TreeNode * pItem = 0)
  * void [[xmodel#writenodesforpost|writeNodesForPost]](XBinaryIO * io) const
  * ErrorCode [[xmodel#readnodesforpost|readNodesForPost]](XBinaryIO * io,int cnt)
  * void [[xmodel#writeelementsforpost|writeElementsForPost]](XBinaryIO * io) const
  * ErrorCode [[xmodel#readelementsforpost|readElementsForPost]](XBinaryIO * io)

----

{{anchor:m_dboundbox}}
**XBoundBox m_dBoundBox**

模型的包围盒

{{anchor:m_passemblyroot}}
**const XAssembly * m_pAssemblyRoot**

模型装配树根节点

{{anchor:m_pauxiliaryroot}}
**const XAssembly * m_pAuxiliaryRoot**

模型辅助树根节点

{{anchor:m_phashpool}}
**XMemPool * m_pHashPool**

模型哈希内存池，被模型内部的各种管理器共享使用

{{anchor:m_pgeneralpool}}
**XMemPool * m_pGeneralPool**

模型通用内存池

{{anchor:m_dtscale}}
**real m_dTScale**

模型特征尺度，近似等于模型包围盒的最大尺寸，在很多计算的场合用于将坐标归一化处理

{{anchor:m_bgldataready}}
**bool m_bGLDataReady**

模型视图数据是否构建好的标志

{{anchor:m_bvisible}}
**bool m_bVisible**

模型是否可见

{{anchor:m_idomainhdlidbase}}
**int m_iDomainHdlIDBase**

模型的起始域ID，由于模型内部的管理器并不是单一管理器，在需要undo、redo的场合，以该ID索引模型内部对象数据的变动。

{{anchor:m_precorder}}
**OpnRecorder * m_pRecorder**

模型数据操作记录器

{{anchor:m_pnodemgr}}
**NodeManager * m_pNodeMgr**

模型节点管理器，由模型构建，非单一管理器

{{anchor:m_pelemmgr}}
**ElementManager * m_pElemMgr**

模型单元管理器，由模型构建，非单一管理器

{{anchor:m_pelsetmgr}}
**GeometryManager * m_pElsetMgr**

模型几何管理器，由模型构建，非单一管理器

{{anchor:m_ppartmgr}}
**PartManager * m_pPartMgr**

模型部件管理器，由模型构建，非单一管理器

{{anchor:m_ppssmgr}}
**PartSnapshotManager * m_pPSSMgr**

部件快照管理器，单一管理器，外部构建

----

{{anchor:xmodel1}}
**XModel(ulong mid)**
  *function: 构造函数
  *parameters: 
    - [i]ulong mid: 模型ID
  *return value: 无

{{anchor:~xmodel}}
**~XModel()**
  *function: 析构函数
  *parameters: NULL
  *return value: 无

{{anchor:init}}
**void init(OpnRecorder * rec = NULL)**
  *function: 初始化模型的域ID，以支持undo、redo操作。构建模型后必须显示调用。
  *parameters: 
    - [i]OpnRecorder * rec = NULL: 模型数据操作记录器，可为空（此时undo、redo将不被支持，可提高执行效率）
  *return value: 无

{{anchor:getpart}}
**const XPart * getPart(ulong id)const **
  *function: 访问模型部件
  *parameters: 
    - [i]ulong id: 部件ID
  *return value: 模型部件指针

{{anchor:checkoutnode}}
**XNode * checkOutNode(const XNode * n) **
  *function: 以可修改的模式访问模型节点
  *parameters: 
    - [i]const XNode * n: 节点常指针（不可修改）
  *return value: 节点指针（可修改）

{{anchor:checkoutelement}}
**XElement * checkOutElement(const XElement * e) **
  *function: 以可修改的模式访问模型单元
  *parameters: 
    - [i]const XElement * e: 单元常指针（不可修改）
  *return value: 单元指针（可修改）

{{anchor:checkoutelement}}
**XElement * checkOutElement(ulong id)**
  *function: 以可修改的模式访问模型单元
  *parameters: 
    - [i]ulong id: 单元ID
  *return value: 单元指针（可修改）

{{anchor:checkoutpart}}
**XPart * checkOutPart(ulong id) **
  *function: 以可修改的模式访问模型部件
  *parameters: 
    - [i]ulong id: 部件ID
  *return value: 部件指针（可修改）

{{anchor:checkoutpart}}
**XPart * checkOutPart(const XPart * p) **
  *function: 以可修改的模式访问模型节点
  *parameters: 
    - [i]const XPart * p: 节点常指针（不可修改）
  *return value: 节点指针（可修改）

{{anchor:bindpartsnapshotmanager}}
**void bindPartSnapshotManager(PartSnapshotManager * pssMgr)**
  *function: 绑定部件快照管理器，用于在某些场景下构建部件快照
  *parameters: 
    - [i]PartSnapshotManager * pssMgr: 部件快照管理器
  *return value: 无

{{anchor:getpartmanager}}
**PartManager * getPartManager()**
  *function: 获取模型部件管理器
  *parameters: NULL
  *return value: 模型部件管理器

{{anchor:getnodemanager}}
**NodeManager * getNodeManager()**
  *function: 获取模型节点管理器
  *parameters: NULL
  *return value: 

{{anchor:getelemmanager}}
**ElementManager * getElemManager()**
  *function: 获取模型单元管理器
  *parameters: NULL
  *return value: 

{{anchor:getgeometrymanager}}
**GeometryManager * getGeometryManager()**
  *function: 获取模型几何管理器
  *parameters: NULL
  *return value: 

{{anchor:getassemblyroot}}
**const XAssembly * getAssemblyRoot() const**
  *function: 获取模型装配树根节点
  *parameters: NULL
  *return value: 模型装配树根节点

{{anchor:getauxiliaryroot}}
**const XAssembly * getAuxiliaryRoot() const**
  *function: 获取模型辅助树根节点
  *parameters: NULL
  *return value: 模型辅助树根节点

{{anchor:getgeometry}}
**const XGeometry * getGeometry(ulong id)const **
  *function: 访问模型几何
  *parameters: 
    - [i]ulong id: 模型几何ID
  *return value: 模型几何指针（不可修改）

{{anchor:checkoutgeometry}}
**XGeometry * checkOutGeometry(ulong id) **
  *function: 以可修改的模式访问模型几何
  *parameters: 
    - [i]ulong id: 模型几何ID
  *return value: 模型几何指针（可修改）

{{anchor:checkoutgeometry}}
**XGeometry * checkOutGeometry(const XGeometry *g) **
  *function: 以可修改的模式访问模型几何
  *parameters: 
    - [i]const XGeometry *g: 模型几何指针（不可修改）
  *return value: 模型几何指针（可修改）

{{anchor:bindpartiterator}}
**void bindPartIterator(HashIterator * pIter) const**
  *function: 绑定模型部件遍历迭代器
  *parameters: 
    - [i]HashIterator * pIter: 部件遍历迭代器
  *return value: 无

{{anchor:bindnodeiterator}}
**void bindNodeIterator(HashIterator * pIter)const**
  *function: 绑定模型节点遍历迭代器
  *parameters: 
    - [i]HashIterator * pIter: 节点遍历迭代器
  *return value: 无

{{anchor:bindelementiterator}}
**void bindElementIterator(HashIterator * pIter)const**
  *function: 绑定模型单元遍历迭代器
  *parameters: 
    - [i]HashIterator * pIter: 单元遍历迭代器
  *return value: 无

{{anchor:bindgeometryiterator}}
**void bindGeometryIterator(HashIterator * pIter)const**
  *function: 绑定模型几何遍历迭代器
  *parameters: 
    - [i]HashIterator * pIter: 几何遍历迭代器
  *return value: 无

{{anchor:bindgeometryiterator}}
**void bindGeometryIterator(HashIterator * pIter,TypeID gt)const**
  *function: 指定拓扑类型绑定模型几何遍历迭代器，只有拓扑类型一致的几何会被遍历到
  *parameters: 
    - [i]HashIterator * pIter: 指定拓扑类型的遍历迭代器
    - [i]TypeID gt: 拓扑类型
  *return value: 无

{{anchor:removegeometry}}
**void removeGeometry(const XGeometry * g)**
  *function: 删除模型几何对象
  *parameters: 
    - [i]const XGeometry * g: 模型几何对象
  *return value: 无

{{anchor:creategeometry}}
**XGeometry * createGeometry(TypeID t,ulong id = 0,XGeometry * parent = 0)**
  *function: 创建模型几何对象
  *parameters: 
    - [i]TypeID t: 拓扑类型
    - [i]ulong id = 0: 几何ID，为0时将使用管理器记录的NextID
    - [i]XGeometry * parent = 0: 父拓扑
  *return value: 模型几何对象

{{anchor:createnode}}
**XNode * createNode(const real * coord,ulong nid = 0)**
  *function: 创建模型节点
  *parameters: 
    - [i]const real * coord: 节点坐标
    - [i]ulong nid = 0: 节点ID，为0时将使用管理器记录的NextID
  *return value: 模型节点对象指针

{{anchor:createassembly}}
**XAssembly * createAssembly(const char * name, ulong id, XAssembly * parent, bool bAuxiliary = false)**
  *function: 创建模型装配体
  *parameters: 
    - [i]const char * name: 装配体名字
    - [i] ulong id: 装配体ID，为0时将使用部件管理器记录的NextID
    - [i] XAssembly * parent: 父装配体
    - [i] bool bAuxiliary = false: 是否为辅助对象，默认否
  *return value: 装配体对象指针

{{anchor:createpart}}
**XPart * createPart(const char * name, ulong id, XAssembly * parent, bool bAuxiliary = false)**
  *function: 创建模型部件对象
  *parameters: 
    - [i]const char * name: 部件名字
    - [i] ulong id: 部件ID，为0时将使用部件管理器记录的NextID
    - [i] XAssembly * parent: 父装配体，为空时父装配体自动被设置为相应的根节点
    - [i] bool bAuxiliary = false: 是否为辅助对象，默认否
  *return value: 模型部件对象指针

{{anchor:removenode}}
**void removeNode(const XNode * pNode)**
  *function: 删除模型节点
  *parameters: 
    - [i]const XNode * pNode: 模型节点
  *return value: 无

{{anchor:movenode}}
**void moveNode(const XNode * n, const real * coord)**
  *function: 移动模型节点到新位置（自动更新与节点相关的视图数据）
  *parameters: 
    - [i]const XNode * n: 模型节点
    - [i] const real * coord: 新的坐标
  *return value: 无

{{anchor:getnode}}
**NodePtr getNode(ulong id) const**
  *function: 访问模型节点
  *parameters: 
    - [i]ulong id: 模型节点ID
  *return value: 模型节点指针（不可修改）

{{anchor:createelement}}
**XElement * createElement(TypeID et, const NodePtr* pNodes,ulong eid = 0,XGeometry * entity = 0, bool bUpdateNodeElemLink = true)**
  *function: 创建模型单元对象
  *parameters: 
    - [i]TypeID et: 单元类型
    - [i] const NodePtr* pNodes: 单元节点指针数组
    - [i]ulong eid = 0: 单元ID，为0时将使用单元管理器记录的NextID
    - [i]XGeometry * entity = 0: 单元所属几何对象
    - [i] bool bUpdateNodeElemLink = true: 是否更新节点的单元链接表
  *return value: 模型单元对象指针

{{anchor:removeelement}}
**void removeElement(XElement * pElement, bool bDeleteFreeNode = true)**
  *function: 删除模型单元
  *parameters: 
    - [i]XElement * pElement: 单元指针
    - [i] bool bDeleteFreeNode = true: 是否删除自由节点（节点的单元链接表为空）
  *return value: 无

{{anchor:replaceelemnode}}
**void replaceElemNode(XElement* pElem,const XNode * old, const XNode * new_node,bool notDetachOld = false)**
  *function: 替换单元节点
  *parameters: 
    - [i]XElement* pElem: 单元指针
    - [i]const XNode * old: 被替换的单元节点
    - [i] const XNode * new_node: 替换后的单元节点
    - [i]bool notDetachOld = false: 是否不解除替换前的节点单元绑定关系，默认解除
  *return value: 无

{{anchor:resetelemnodes}}
**void resetElemNodes(XElement* pElem,const XNode <nowiki>**</nowiki> ns)**
  *function: 重置单元节点
  *parameters: 
    - [i]XElement* pElem: 单元指针
    - [i]const XNode <nowiki>**</nowiki> ns: 单元节点数组
  *return value: 无

{{anchor:setelemnode}}
**void setElemNode(XElement* pElem,int index, const XNode * new_node)**
  *function: 设置单元节点
  *parameters: 
    - [i]XElement* pElem: 单元指针
    - [i]int index: 节点序号
    - [i] const XNode * new_node: 单元节点指针
  *return value: 无

{{anchor:updatenodeelementlink}}
**void updateNodeElementLink(bool bKeepOld)**
  *function: 更新节点的单元链接表
  *parameters: 
    - [i]bool bKeepOld: 是否保持已有的单元链接表而不是完全重建
  *return value: 无

{{anchor:updatenodeelementlink}}
**void updateNodeElementLink(vector<const XPart *> * parts, bool bKeepOld)**
  *function: 更新指定部件数组内节点的单元链接表
  *parameters: 
    - [i]vector<const XPart *> * parts: 指定部件数组
    - [i] bool bKeepOld: 是否保持已有的单元链接表而不是完全重建
  *return value: 无

{{anchor:updatenodeelementlink}}
**void updateNodeElementLink(vector<const XGeometry *> * geoms, bool bKeepOld)**
  *function: 更新指定几何数组内节点的单元链接表
  *parameters: 
    - [i]vector<const XGeometry *> * geoms: 指定几何数组
    - [i] bool bKeepOld: 是否保持已有的单元链接表而不是完全重建
  *return value: 无

{{anchor:addcellfacet}}
**void addCellFacet(ElemPtr pFacet, XElement * cell)**
  *function: 为cell单元添加面单元（有限体积法中使用）
  *parameters: 
    - [i]ElemPtr pFacet: 面单元（一般为Polygon或者Polyline单元）
    - [i] XElement * cell: Cell单元
  *return value: 无

{{anchor:removecellfacet}}
**void removeCellFacet(ElemPtr facet, XElement * cell)**
  *function: 删除Cell单元的面
  *parameters: 
    - [i]ElemPtr facet: Cell面单元（一般为Polygon或者Polyline单元）
    - [i] XElement * cell: Cell单元
  *return value: 无

{{anchor:setpolylinenodes}}
**void setPolylineNodes(const XNode <nowiki>**</nowiki> ns, int cnt, XElement* pElem)**
  *function: 设置多折线单元的节点
  *parameters: 
    - [i]const XNode <nowiki>**</nowiki> ns: 节点数组
    - [i] int cnt: 节点个数
    - [i] XElement* pElem:多折线单元指针 
  *return value: 无

{{anchor:setpolygonnodes}}
**void setPolygonNodes(const XNode <nowiki>**</nowiki> ns, int cnt, XElement* pElem)**
  *function: 设置多边形单元的节点
  *parameters: 
    - [i]const XNode <nowiki>**</nowiki> ns: 节点数组
    - [i] int cnt: 节点个数
    - [i] XElement* pElem: 多边形单元指针
  *return value: 无

{{anchor:setcellfacets}}
**void setCellFacets(const XElement <nowiki>**</nowiki> facets, int cnt, XElement* pElem)**
  *function: 设置Cell单元的面信息
  *parameters: 
    - [i]const XElement <nowiki>**</nowiki> facets: Cell单元面数组
    - [i] int cnt: 面的个数
    - [i] XElement* pElem: Cell单元数组
  *return value: 无

{{anchor:getelement}}
**ElemPtr getElement(ulong id) const**
  *function: 访问模型单元
  *parameters: 
    - [i]ulong id: 单元ID
  *return value: 模型单元指针（不可修改）

{{anchor:removepart}}
**void removePart(const XPart * pPart)**
  *function: 删除模型部件
  *parameters: 
    - [i]const XPart * pPart: 模型部件指针
  *return value: 无

{{anchor:getpartcount}}
**int getPartCount(bool bExcludeAsb = true) const**
  *function: 获取模型部件个数
  *parameters: 
    - [i]bool bExcludeAsb = true: 是否包含装配体
  *return value: 模型部件个数

{{anchor:getelementcount}}
**int getElementCount()const**
  *function: 获取模型单元个数
  *parameters: NULL
  *return value: 模型单元个数

{{anchor:getnodecount}}
**int getNodeCount()const**
  *function: 获取模型节点个数
  *parameters: NULL
  *return value: 模型节点个数

{{anchor:getsurfaceelementcount}}
**int getSurfaceElementCount()const**
  *function: 获取模型面单元个数
  *parameters: NULL
  *return value: 模型面单元个数

{{anchor:getgeometrycount}}
**int getGeometryCount(TypeID gt)const**
  *function: 获取指定拓扑类型的模型几何对象个数
  *parameters: 
    - [i]TypeID gt: 拓扑类型
  *return value: 模型几何对象个数

{{anchor:getgeometrycount}}
**int getGeometryCount() const**
  *function: 获取全部模型几何对象个数
  *parameters: NULL
  *return value: 全部模型几何对象个数

{{anchor:attachelemtogeom}}
**void attachElemToGeom(XGeometry * g, XElement * el)**
  *function: 绑定几何对象与单元对象的从属关系
  *parameters: 
    - [i]XGeometry * g: 模型几何对象
    - [i] XElement * el: 模型单元对象
  *return value: 无

{{anchor:detachelemfromgeom}}
**void detachElemFromGeom(XGeometry * g, XElement * el)**
  *function: 解除几何对象与单元对象的从属关系
  *parameters: 
    - [i]XGeometry * g: 模型几何对象
    - [i] XElement * el: 模型单元对象
  *return value: 无

{{anchor:attachparttoassembly}}
**void attachPartToAssembly(XAssembly * asb, XPart * p)**
  *function: 绑定装配体与部件的从属关系
  *parameters: 
    - [i]XAssembly * asb: 模型装配体对象
    - [i] XPart * p: 模型部件对象
  *return value: 无

{{anchor:detachpartfromassembly}}
**void detachPartFromAssembly(XAssembly * asb, XPart * p)**
  *function: 解除装配体与部件的从属关系
  *parameters: 
    - [i]XAssembly * asb: 模型装配体对象
    - [i] XPart * p: 模型部件对象
  *return value: 无

{{anchor:attachpartsnapshot}}
**void attachPartSnapshot(XPart * p, XPartSnapshot * asb)**
  *function: 绑定部件与部件快照对象的从属关系
  *parameters: 
    - [i]XPart * p: 模型部件对象
    - [i] XPartSnapshot * asb: 部件快照对象
  *return value: 无

{{anchor:detachpartsnapshot}}
**void detachPartSnapshot(XPart * p, XPartSnapshot * asb)**
  *function: 解除部件与部件快照对象的从属关系
  *parameters: 
    - [i]XPart * p: 模型部件对象
    - [i] XPartSnapshot * asb: 部件快照对象
  *return value: 无

{{anchor:attachgeomtopart}}
**void attachGeomToPart(XGeometry * g, XPart * p)**
  *function: 绑定几何对象与部件对象的从属关系
  *parameters: 
    - [i]XGeometry * g: 模型几何对象
    - [i] XPart * p: 模型部件对象
  *return value: 无

{{anchor:detachgeomfrompart}}
**void detachGeomFromPart(XGeometry * g, XPart * p)**
  *function: 解除几何对象与部件对象的从属关系
  *parameters: 
    - [i]XGeometry * g: 模型几何对象
    - [i] XPart * p: 模型部件对象
  *return value: 无

{{anchor:attachgeomchild}}
**void attachGeomChild(XGeometry * g, const XGeometry * child)**
  *function: 绑定几何对象的拓扑从属关系
  *parameters: 
    - [i]XGeometry * g: 模型几何父对象
    - [i] const XGeometry * child: 模型几何子对象
  *return value: 无

{{anchor:detachgeomchild}}
**void detachGeomChild(XGeometry * g, const XGeometry * child)**
  *function: 解除几何对象的拓扑从属关系
  *parameters: 
    - [i]XGeometry * g: 模型几何父对象
    - [i] const XGeometry * child: 模型几何子对象
  *return value: 无

{{anchor:clear}}
**void clear()**
  *function: 清空模型并重置模型为初始状态
  *parameters: NULL
  *return value: 无

{{anchor:clearviewdata}}
**void clearViewData()**
  *function: 清空模型视图数据
  *parameters: NULL
  *return value: 无

{{anchor:updateviewdata}}
**void updateViewData()**
  *function: 更新构建模型视图数据
  *parameters: NULL
  *return value: 无

{{anchor:isviewdataready}}
**bool isViewDataReady() const**
  *function: 判断模型视图数据是否已准备好
  *parameters: NULL
  *return value: 如已准备好返回true，否则返回false

{{anchor:getnextgeometryid}}
**ulong getNextGeometryId()**
  *function: 获取模型几何对象下一个可用的ID
  *parameters: NULL
  *return value: 模型几何对象下一个可用的ID

{{anchor:getnextelementid}}
**ulong getNextElementId()**
  *function: 获取模型单元对象下一个可用的ID
  *parameters: NULL
  *return value: 模型单元对象下一个可用的ID

{{anchor:getnextnodeid}}
**ulong getNextNodeId()**
  *function: 获取模型节点对象下一个可用的ID
  *parameters: NULL
  *return value: 模型节点对象下一个可用的ID

{{anchor:getboundbox}}
**const XBoundBox & getBoundBox() const**
  *function: 获取模型的包围盒
  *parameters: NULL
  *return value: 模型的包围盒

{{anchor:normalizeboundbox}}
**void normalizeBoundBox(const real * origin, real scale)**
  *function: 归一化模型包围盒
  *parameters: 
    - [i]const real * origin: 归一化基准点
    - [i] real scale: 归一化系数
  *return value: 无

{{anchor:restoreboundbox}}
**void restoreBoundBox(const real * origin, real scale)**
  *function: 恢复模型包围盒（一般在归一化完成计算之后调用）
  *parameters: 
    - [i]const real * origin: 归一化基准点
    - [i] real scale: 归一化系数
  *return value: 无

{{anchor:updateboundbox}}
**void updateBoundBox()**
  *function: 更新模型包围盒
  *parameters: NULL
  *return value: 无

{{anchor:setpartvisible}}
**void setPartVisible(ulong id,bool bVisible)**
  *function: 设置部件的可见性
  *parameters: 
    - [i]ulong id: 部件ID
    - [i]bool bVisible: 是否可见
  *return value: 无

{{anchor:setgeomvisible}}
**void setGeomVisible(ulong id, bool bVisible)**
  *function: 设置几何对象的可见性
  *parameters: 
    - [i]ulong id: 几何对象ID
    - [i] bool bVisible: 是否可见
  *return value: 无

{{anchor:getvertexbynode}}
**XVertex* getVertexByNode(XNode * pNode)**
  *function: 获取节点上的几何顶点对象
  *parameters: 
    - [i]XNode * pNode: 模型节点对象
  *return value: 如节点上由几何顶点存在，返回该几何对象，否则返回空

{{anchor:createdefaultpart}}
**void createDefaultPart()**
  *function: 构建默认的模型部件，一般在导入网格（网格数据没有部件装配关系）后使用
  *parameters: NULL
  *return value: 无

{{anchor:write}}
**void write(XBinaryIO * io) const**
  *function: 将模型数据写入到二进制文件中
  *parameters: 
    - [i]XBinaryIO * io: 二进制文件句柄
  *return value: 

{{anchor:save}}
**void save(const char * fname) const**
  *function: 将模型数据保存到文件中
  *parameters: 
    - [i]const char * fname: 文件路径
  *return value: 无

{{anchor:load}}
**bool load(const char * fname)**
  *function: 从文件中载入模型数据
  *parameters: 
    - [i]const char * fname: 文件路径
  *return value: 成功载入返回true，否则返回false

{{anchor:saveh5}}
**void saveH5(const char * fname) const**
  *function: 将模型数据保存到HDF5文件中
  *parameters: 
    - [i]const char * fname: HDF5文件路径
  *return value: 无

{{anchor:loadh5}}
**bool loadH5(const char * fname)**
  *function: 从HDF5文件中载入模型数据
  *parameters: 
    - [i]const char * fname: HDF5文件路径
  *return value: 成功载入返回true，否则返回false

{{anchor:read}}
**ErrorCode read(XBinaryIO * io)**
  *function: 从二进制文件中读取模型数据
  *parameters: 
    - [i]XBinaryIO * io: 二进制文件句柄
  *return value: 成功读取返回Error_None，否则返回相应错误码

{{anchor:write}}
**void write(XH5IO * io, H5Obj * grp) const**
  *function: 将模型数据写入到HDF5文件中
  *parameters: 
    - [i]XH5IO * io: 二进制文件句柄
    - [i] H5Obj * grp: 对应的HDF5节点
  *return value: 无

{{anchor:read}}
**bool read(XH5IO * io, H5Obj * grp)**
  *function: 从HDF5文件中读取模型数据
  *parameters: 
    - [i]XH5IO * io: HDF5文件句柄
    - [i] H5Obj * grp: 对应的HDF5节点
  *return value: 成功读取返回true，否则返回false

{{anchor:copy}}
**void copy(XModel * mdl)**
  *function: 将另外一个模型的数据复制到本模型中
  *parameters: 
    - [i]XModel * mdl: 被复制的模型对象
  *return value: 无

{{anchor:isvisible}}
**bool isVisible() const**
  *function: 模型是否可见
  *parameters: NULL
  *return value: 模型可见返回true，否则返回false

{{anchor:setvisible}}
**void setVisible(bool b)**
  *function: 设置模型的可见性
  *parameters: 
    - [i]bool b: 是否可见
  *return value: 无

{{anchor:updateafterrenumber}}
**void updateAfterRenumber(TypeID tid)**
  *function: 在对模型对象重编号之后调用，用以更新对重编号对象的引用
  *parameters: 
    - [i]TypeID tid: 重编号的对象类型
  *return value: 

{{anchor:setgldataready}}
**void setGLDataReady(bool bReady)**
  *function: 设置模型视图数据是否准备完毕
  *parameters: 
    - [i]bool bReady: 模型视图数据是否准备完成
  *return value: 无

{{anchor:getnormalizedscale}}
**real getNormalizedScale()**
  *function: 获取模型归一化系数
  *parameters: NULL
  *return value: 模型归一化系数

{{anchor:setnormalizedscale}}
**void setNormalizedScale(real s)**
  *function: 设置模型归一化系数
  *parameters: 
    - [i]real s: 模型归一化系数
  *return value: 无

{{anchor:getrecorder}}
**OpnRecorder * getRecorder()**
  *function: 获取模型数据操作记录器
  *parameters: NULL
  *return value: 模型数据操作记录器

{{anchor:updatefacecolorbypart}}
**void updateFaceColorByPart(const XPart * p)**
  *function: 根据所属部件更新面的颜色
  *parameters: 
    - [i]const XPart * p: 模型部件对象
  *return value:无 

{{anchor:setgeomvisible}}
**void setGeomVisible(const XGeometry * g, bool bVisible)**
  *function: 设置几何可见性
  *parameters: 
    - [i]const XGeometry * g: 模型几何对象
    - [i] bool bVisible: 是否可见
  *return value: 无

----

{{anchor:writenodes}}
**void writeNodes(XBinaryIO * io) const**
  *function: 将模型节点数据写入到二进制文件中
  *parameters: 
    - [i]XBinaryIO * io: 二进制文件句柄
  *return value: 无

{{anchor:readnodes}}
**ErrorCode readNodes(XBinaryIO * io,int cnt)**
  *function: 从二进制文件中读取模型节点数据
  *parameters: 
    - [i]XBinaryIO * io: 二进制文件句柄
    - [i]int cnt: 节点个数
  *return value: 成功读取返回Error_None, 否则返回相应错误码

{{anchor:writeelements}}
**void writeElements(XBinaryIO * io) const**
  *function: 将模型单元数据写入到二进制文件中
  *parameters: 
    - [i]XBinaryIO * io: 二进制文件句柄
  *return value: 无

{{anchor:readelements}}
**ErrorCode readElements(XBinaryIO * io)**
  *function: 从二进制文件中读取模型单元数据
  *parameters: 
    - [i]XBinaryIO * io: 二进制文件句柄
  *return value: 成功读取返回Error_None, 否则返回相应错误码

{{anchor:writeassembly}}
**void writeAssembly(XBinaryIO * io, TreeNode * pItem = 0) const**
  *function: 将装配体数据写入到二进制文件中
  *parameters: 
    - [i]XBinaryIO * io: 二进制文件句柄
    - [i] TreeNode * pItem = 0: 装配体对应的树节点
  *return value: 无

{{anchor:readassembly}}
**ErrorCode readAssembly(XBinaryIO * io, TreeNode * pItem = 0)**
  *function: 从二进制文件中读取装配体
  *parameters: 
    - [i]XBinaryIO * io: 二进制文件句柄
    - [i] TreeNode * pItem = 0: 装配体对应的树节点
  *return value: 成功读取返回Error_None, 否则返回相应错误码
XT Document

User Tools

Site Tools

Page Tools
