Ovis_Group_Create()
摘要
创建一个 Ovis 组。
语法
Ovis_Group_Create (group_name, comment, parent_group, show_initially, destroy_callback, user_state)
| 参数 | 类型 | 说明 |
|---|---|---|
group_name |
const char * |
组名称 |
comment |
const char * |
指定注释 |
parent_group |
OvisT_Group * |
父组 |
show_initially |
OvisT_Boolean |
指定组是否初始即显示 |
destroy_callback |
OvisT_Group_State_Destroy_Proc |
用户自定义过程,用于销毁与该对象关联的数据并释放其内存 |
user_state |
void * |
与组关联的用户自定义状态 |
返回类型
OvisT_Group *
新创建的组
头文件
ovis_entity.h
详情
该函数创建一个 Ovis 组并指定该组的各项属性。组提供了显示或隐藏一组相关实体的能力,以避免动画中出现过多的图形信息。组可以包含任意数量的实体以及其他组。存在一个不可销毁的根组。显示一个组会显示其实体与子组(递归显示);隐藏一个组会隐藏其实体与子组(递归隐藏)。
示例
OvisT_Group * group;
group = Ovis_Group_Create ("friendly forces",
"Hold entities belonging to blue group",
OvisC_True, OPC_NIL, OPC_NIL, OPC_NIL);
错误
- 未提供组名称。
参考
- 使用函数
Ovis_Root_Group_Get()可以找到根组。 - 使用函数
Ovis_Group_Destroy()可以销毁组。