XFace

Inherited from XGeometry,

Inherited by NULL

Friend class GeometryManager,

Description

XFace封装了几何面的数据及其方法，其类型标识名为“CGEOFACE”(以CGEO为前缀）。几何面是由若干边构成的封闭曲面，是划分面网格的对象基础。XFace从XGeometry继承并重新实现了适用于面的方法。

Members

• XBoundBox m_dBoundBox
• RGBAColor m_BakColor
• XRenderData m_RenderData
• XItemPtrArray<XGeometry, 2>
• XItemPtrArray<XGeometry, m_UpperList
• vector<ElemPtr> m_pSolidElems
• vector<int> m_pSolidFacetId

Public interface

• static void enableFineFacetNormal(bool b)
• XFace(ulong id,XMemPool * pHashPool = 0)
• ~XFace()
• void updateBoundbox()
• real getArea() const
• int countTess() const
• void buildRenderData_WithIndex(const float * rvalue = NULL, bool bUseSolidElemCode = false)
• void buildRenderData_Polygon(bool bUseSolidElemCode = false)
• void buildRenderDataFVM(bool bUseSolidElemCode = false)
• void buildRenderData(bool bUseSolidElemCode = false)
• void updateElemEncode(bool bAsSolid = false)
• const XRenderData * getRenderData() const
• void updateRenderData(const float * colorValue, int colorLoc, const float * deformX, const float * deformY, const float * deformZ, const int * elemNodeIndex = NULL)
• void updateRenderDataFVM(const RenderContext * rc)
• void updateTexData(TexElementManager * texMgr)
• const XBoundBox & getBoundBox() const
• void normalizeBoundBox(const real * origin, real scale)
• void restoreBoundBox(const real * origin, real scale)
• void copyBoundBox(const XFace * f)
• void clear(ClearFlag f = Clear_All)
• const XGeometry * getUpperEntity(int index) const
• const XSolid * getFirstParentBody() const
• bool isUpperEntity(const XGeometry * pBody) const
• int getUpperCount() const
• void addUpperEntity(const XGeometry * pBody)
• void removeUpperEntity(const XGeometry *pBody)
• void write(XBinaryIO * io)const
• ErrorCode read(GeometryManager * esmgr, XBinaryIO * io)
• void updateAfterRenumber(TypeID tid)

XBoundBox m_dBoundBox

几何面的包围盒

RGBAColor m_BakColor

几何面的颜色备份，用于修改颜色时保存旧的颜色以方便恢复之前的颜色。

XRenderData m_RenderData

几何面的视图数据

XItemPtrArray<XGeometry, 2> m_UpperList

几何面的父拓扑对象数组

vector<ElemPtr> m_pSolidElems

面单元所对应的体单元数组

vector<int> m_pSolidFacetId

面单元在所对应的体单元的面号数组

static void enableFineFacetNormal(bool b)

• function: 是否以精细模式计算面法向（精细模式下会耗用更多的计算资源）
• parameters:
  1. [i]bool b: 是否精细模式
• return value: 无

XFace(ulong id,XMemPool * pHashPool = 0)

• function: 构造函数
• parameters:
  1. [i]ulong id: 对象ID
  2. [i]XMemPool * pHashPool = 0: 内存池
• return value: 无

~XFace()

• function: 析构函数
• parameters: NULL
• return value: 无

void updateBoundbox()

• function: 更新几何面的包围盒
• parameters: NULL
• return value: 无

double getArea() const

• function: 计算几何面的面积
• parameters: NULL
• return value: 几何面的面积

int countTess() const

• function: 获取几何面的三角片个数
• parameters: NULL
• return value: 几何面的三角片个数

void buildRenderDataFVM(bool bUseSolidElemCode = false)

• function: 构建有限体积法下的几何面渲染视图数据
• parameters:
  1. [i]bool bUseSolidElemCode = false: 是否使用体单元编码渲染，在旋转体单元模式下设置为true
• return value: 无

void buildRenderData(bool bUseSolidElemCode = false)

• function: 构建几何面的渲染视图数据
• parameters:
  1. [i]bool bUseSolidElemCode = false: 是否使用体单元编码渲染，在旋转体单元模式下设置为true
• return value: 无

void updateElemEncode(bool bAsSolid = false)

• function: 更新视图数据中的单元颜色编码
• parameters:
  1. [i]bool bAsSolid = false: 是否使用体单元编码渲染，在旋转体单元模式下设置为true
• return value: 无

const XRenderData * getRenderData() const

• function: 获取几何面的渲染视图数据
• parameters: NULL
• return value: 无

void updateRenderData(const float * colorValue, int colorLoc, const float * deformX, const float * deformY, const float * deformZ, const int * elemNodeIndex = NULL)

• function: 更新几何面的渲染视图数据
• parameters:
  1. [i]const float * colorValue: 渲染数值地址
  2. [i] int colorLoc: 渲染数值的位置（积分点、单元节点或节点）
  3. [i] const float * deformX: X变形分量数组地址
  4. [i] const float * deformY: Y变形分量数组地址
  5. [i] const float * deformZ: Z变形分量数组地址
  6. [i] const int * elemNodeIndex = NULL: 单元节点数组索引
• return value: 无

void updateRenderDataFVM(const RenderContext * rc)

• function: 更新几何面的渲染视图数据
• parameters:
  1. [i]const RenderContext * rc: 渲染数据上下文
• return value: 无

void updateTexData(TexElementManager * texMgr)

• function: 更新几何面的渲染纹理数据
• parameters:
  1. [i]TexElementManager * texMgr: 纹理对象管理器
• return value: 无

const XBoundBox & getBoundBox() const

• function: 获取几何面的包围盒
• parameters: NULL
• return value: 几何面的包围盒

void normalizeBoundBox(const real * origin, real scale)

• function: 归一化几何面的包围盒
• parameters:
  1. [i]const real * origin: 归一化基准点
  2. [i] real scale: 归一化系数
• return value: 无

void restoreBoundBox(const real * origin, real scale)

• function: 归一化之后恢复几何面的原始包围盒
• parameters:
  1. [i]const real * origin: 归一化基准点
  2. [i] real scale: 归一化系数
• return value: 无

void copyBoundBox(const XFace * f)

• function: 拷贝几何面对象的包围盒
• parameters:
  1. [i]const XFace * f: 参考几何面对象
• return value: 无

void clear(ClearFlag f = Clear_All)

• function: 清空几何面的数据
• parameters:
  1. [i]ClearFlag f = Clear_All: 清空标记
• return value: 无

const XGeometry * getUpperEntity(int index) const

• function: 重新实现XGeometry的getUpperEntity方法，获取第index个父拓扑对象
• parameters:
  1. [i]int index: 父拓扑对象序号
• return value: 父拓扑对象

const XSolid * getFirstParentBody() const

• function: 获取第一个父拓扑对象
• parameters: NULL
• return value: 第一个父拓扑对象

bool isUpperEntity(const XGeometry * pBody) const

• function: 判断pBody是否为几何面对象的父拓扑对象
• parameters:
  1. [i]const XGeometry * pBody: 几何拓扑对象
• return value: pBody为几何面对象的父拓扑对象返回true，否则返回false

int getUpperCount() const

• function: 获取父拓扑对象的个数
• parameters: NULL
• return value: 父拓扑对象的个数

void addUpperEntity(const XGeometry * pBody)

• function: 添加父拓扑对象
• parameters:
  1. [i]const XGeometry * pBody: 父拓扑对象
• return value: 无

void removeUpperEntity(const XGeometry *pBody)

• function: 删除父拓扑对象
• parameters:
  1. [i]const XGeometry *pBody: 父拓扑对象
• return value: 无

void write(XBinaryIO * io)const

• function: 将几何面对象写入到二进制文件中
• parameters:
  1. [i]XBinaryIO * io: 二进制文件句柄
• return value: 无

ErrorCode read(GeometryManager * esmgr, XBinaryIO * io)

• function: 从二进制文件中读取几何对象数据
• parameters:
  1. [i]GeometryManager * esmgr: 几何对象管理器
  2. [i] XBinaryIO * io: 二进制文件句柄
• return value: 成功读取返回Error_None,否则返回相应错误码

void updateAfterRenumber(TypeID tid)

• function: 在对模型对象重编号之后调用，用以更新对重编号对象的引用
• parameters:
  1. [i]TypeID tid: 重编号的对象类型
• return value: 无