Ovis_3D_Position_Decoration_Set()
摘要
基于某个 Decoration 定义一个位置。
语法
Ovis_3D_Position_Decoration_Set (pos_ptr, deco_ptr, ratio)
| 参数 | 类型 | 说明 |
|---|---|---|
pos_ptr |
OvisT_3D_Position * |
指向位置的指针 |
deco_ptr |
OvisT_3D_Decoration * |
指向 Decoration 的指针 |
ratio |
unsigned char |
比例 |
返回类型
OvisT_Compcode
位置设置成功时返回 OvisC_Compcode_Success;否则返回 OvisC_Compcode_Failure。
头文件
ovis_decoration.h
详情
此函数基于指定的 Decoration 定义一个位置。对于"单点"位置的 Decoration(如球体、立方体或文本),位置即为该 Decoration 所在的位置。对于"双点"位置的 Decoration(如线或圆柱体),位置通过 ratio 参数定义。比例为 0 表示 Decoration 的"头",比例为 100 表示"尾"。0 到 100 之间的值定义头与尾之间的相应位置。当关联的 Decoration 随时间改变位置时,该位置会随之更新。
示例
OvisT_3D_Position pos;
OvisT_3D_Line * line;
/* … line created at some point */
/* Position is a quarter down the line */
Ovis_3D_Position_Decoration_Set (&pos, line, 25);
错误
- Position 参数为 NIL。
- Decoration 为 NIL。
- 比例值无效(
<value>)。有效值介于 0 到 100 之间。
参考
- 使用函数
Ovis_Entity_Position_Get()可将 3D 位置设为实体的当前位置,但当实体移动时该位置值不会更新。