Ovis_3D_Decoration_Offset_Get()
摘要
返回对象在 3D 视图中的偏移数据。
语法
Ovis_3D_Decoration_Offset_Get (dec_ptr, x_m_ptr, y_m_ptr, z_m_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
dec_ptr |
OvisT_3D_Decoration * |
偏移 |
x_m_ptr |
double * |
相对起始点的 X 偏移(以米计) |
y_m_ptr |
double * |
相对起始点的 Y 偏移(以米计) |
z_m_ptr |
double * |
相对起始点的 Z 偏移(以米计) |
返回类型
OvisT_Compcode
若所提供的对象是有效的偏移,返回 OvisC_Compcode_Success;否则返回 OvisC_Compcode_Failure。所有 3D 装饰对象默认偏移为 (0, 0, 0)。
头文件
ovis_decoration.h
详情
该函数以米为单位返回 3D 装饰对象 X、Y、Z 坐标的偏移。
示例
OvisT_3D_Cylinder * sphere;
Double x, y, z;
/* … sphere created at some point */
Ovis_3D_Decoration_Offset_Get (sphere, &x, &y, &z);
错误
- 装饰对象为 NIL。
- 装饰对象类型不支持 3D 偏移。
- 'x' 偏移值的返回地址为 NIL。
- 'y' 偏移值的返回地址为 NIL。
- 'z' 偏移值的返回地址为 NIL。
参考
- 使用函数
Ovis_3D_Decoration_Offset_Set()可设置装饰对象的偏移。