Ovis_Entity_Property_Set()
摘要
设置 Ovis 实体的属性。
语法
Ovis_Entity_Property_Set (ent_ptr, property, value)
| 参数 | 类型 | 说明 |
|---|---|---|
ent_ptr |
OvisT_Entity * |
指定实体 |
property |
OvisT_Entity_Property |
目标属性,取表 21 中的某个值 |
value |
const char * |
属性值,取表 21 中的某个值 |
返回类型
OvisT_Compcode
若属性设置成功,返回 OvisC_Compcode_Success;否则返回 OvisC_Compcode_Failure。
头文件
ovis_entity.h
详情
该函数设置 Ovis 实体的状态。如果 3D 模型支持,3D Network Visualizer 会利用属性来调整实体的 3D 表示。
例如,某个模型可能提供两个版本,分别表示完好和被摧毁的车辆。在这种情况下,如果损伤为无或轻微,则使用完好的表示;如果损伤为中等或被摧毁,则使用被摧毁的表示。另一方面,如果一个模型有四个版本,分别对应四种损伤状态,则会为每种损伤状态显示相应的版本。
在 3D Network Visualizer 中,可以右键单击某个实体并查看其信息,从而查看属性。表 21 列出了表示实体属性及其取值的符号常量。
表 21:Ovis 实体属性与属性值
| 属性 | 值 |
|---|---|
OvisC_Entity_Property_Damage |
OVISC_ENTITY_PROPERTY_DAMAGE_NONE OVISC_ENTITY_PROPERTY_DAMAGE_SLIGHT OVISC_ENTITY_PROPERTY_DAMAGE_MODERATE OVISC_ENTITY_PROPERTY_DAMAGE_DESTROYED |
OvisC_Entity_Property_Trail_State |
OVISC_ENTITY_PROPERTY_TRAIL_NONE OVISC_ENTITY_PROPERTY_TRAIL_SMALL OVISC_ENTITY_PROPERTY_TRAIL_MEDIUM OVISC_ENTITY_PROPERTY_TRAIL_LARGE |
OvisC_Entity_Property_Hatch_State |
OVISC_ENTITY_PROPERTY_HATCH_NONE OVISC_ENTITY_PROPERTY_HATCH_CLOSED OVISC_ENTITY_PROPERTY_HATCH_POPPED OVISC_ENTITY_PROPERTY_HATCH_POPPED_PERSON OVISC_ENTITY_PROPERTY_HATCH_OPEN OVISC_ENTITY_PROPERTY_HATCH_OPEN_PERSON |
OvisC_Entity_Property_Lights_State |
OVISC_ENTITY_PROPERTY_LIGHTS_NONE OVISC_ENTITY_PROPERTY_LIGHTS_RUNNING OVISC_ENTITY_PROPERTY_LIGHTS_NAVIGATION OVISC_ENTITY_PROPERTY_LIGHTS_FORMATION |
OvisC_Entity_Property_Smoke_Plume |
OVISC_ENTITY_PROPERTY_ON OVISC_ENTITY_PROPERTY_OFF |
OvisC_Entity_Property_Engine_Smoke |
OVISC_ENTITY_PROPERTY_ON OVISC_ENTITY_PROPERTY_OFF |
OvisC_Entity_Property_Flames_Present |
OVISC_ENTITY_PROPERTY_ON OVISC_ENTITY_PROPERTY_OFF |
OvisC_Entity_Property_Camouflage_Type |
OVISC_ENTITY_PROPERTY_CAMOUFLAGE_FOREST OVISC_ENTITY_PROPERTY_CAMOUFLAGE_DESERT OVISC_ENTITY_PROPERTY_CAMOUFLAGE_WINTER |
OvisC_Entity_Property_Primary_Weapon OvisC_Entity_Property_Secondary_Weapon |
OVISC_ENTITY_PROPERTY_WEAPON_STATE_NONE OVISC_ENTITY_PROPERTY_WEAPON_STATE_STOWED OVISC_ENTITY_PROPERTY_WEAPON_STATE_DEPLOYED OVISC_ENTITY_PROPERTY_WEAPON_STATE_IN_FIRE |
OvisC_Entity_Property_Antenna_Raised |
OVISC_ENTITY_PROPERTY_ON OVISC_ENTITY_PROPERTY_OFF |
示例
OvisT_Entity * entity;
/* … entity created at some point */
Ovis_Entity_Property_Set (entity, OvisC_Entity_Property_Flames_Present,
OVISC_ENTITY_PROPERTY_ON);
错误
- 实体为 NIL。
参考
- 使用函数 Ovis_Entity_Property_Get() 获取实体属性的值。