XDatum

Inherited from NItem,

Inherited by XCoordSystem,XDatumPlane,XDatumAxis

Friend class DatumManager,

Description

XDatum是XT中所有基准对象的基类，它封装了基准对象的通用接口，它的类型标识前缀为“CDTM”，分别由坐标系、基准面、基准轴从该基类继承。

XDatum定义了局部基准空间，任何参照它的对象都可以通过XDatum提供的方法计算获取对象在局部空间里的位置。它预定义了6个基准轴（X+,X-,Y+,Y-,Z+, Z-)和6个基准面（XOY，YOZ，ZOX,YOX, ZOY, XOZ）.

Members

• const XCoordSystem * m_pRefCoord

Public interface

• static TypeID getDatumType(const char * str)
• static const char * getDatumString(TypeID type)
• XDatum(ulong id, TypeID type)
• void setReference(const XCoordSystem * cs)
• const XCoordSystem * getReference() const
• void write(XBinaryIO * io)
• ErrorCode read(XBinaryIO * io, DatumManager * mgr)

---

const XCoordSystem * m_pRefCoord

基准参考坐标系

---

static TypeID getDatumType(const char * str)

• function: 静态函数，获取基准类型
• parameters:
  1. [i]const char * str: 类型字符串
• return value: 基准类型（为6个基准轴或者6个基准平面之一）

static const char * getDatumString(TypeID type)

• function: 静态函数，获取基准类型字符串
• parameters:
  1. [i]TypeID type: 基准类型（为6个基准轴或者6个基准平面之一）
• return value: 基准类型字符串

XDatum(ulong id, TypeID type)

• function: 构造函数
• parameters:
  1. [i]ulong id: 对象ID
  2. [i] TypeID type: 对象类型
• return value: 无

void setReference(const XCoordSystem * cs)

• function: 设置参考坐标系
• parameters:
  1. [i]const XCoordSystem * cs: 参考坐标系
• return value: 无

const XCoordSystem * getReference() const

• function: 获取参考坐标系
• parameters: NULL
• return value: 参考坐标系

void write(XBinaryIO * io)

• function: 基类接口，将基准对象写入到二进制文件中
• parameters:
  1. [i]XBinaryIO * io: 二进制文件句柄
• return value: 无

ErrorCode read(XBinaryIO * io, DatumManager * mgr)

• function: 基类接口，从二进制文件中读取基准对象数据
• parameters:
  1. [i]XBinaryIO * io: 二进制文件句柄
  2. [i] DatumManager * mgr: 基准对象管理器
• return value: 如成功读取返回Error_None, 否则返回相应错误码