| scardoc;Objectives |
| Functions |
| Objective_AddAreaHighlight( LuaTable objTable, Marker/Position/Group pos, AreaType OPT_areatype, Real OPT_scale, Table OPT_color, Real OPT_alpha ) | |
|
在指定点周围添加地图高亮区域【功能：地图标记】 AreaType is AT_CIRCLE (the default) or AT_SQUARE. Color is a table with three values for red, green and blue - i.e. {255, 0, 0}. |
|
| Source: [E:\P4Share\engine\assets\engine\scar\core_objectives.scar] (709) | |
| Objective_AddGroundReticule( LuaTable objTable, Marker/Pos position, Real OPT_size, BP OPT_reticuleBlueprint, String OPT_hintpointTemplate ) | |
|
在世界中指定位置的地面添加视觉标记，返回标记ID【功能：地面标记】 The reticule blueprint (the circle on the ground) and the hintpoint template (the arrow) are by defualt taken from the objective type, but you can override them or set them to false to turn that element off. |
|
| Source: [E:\P4Share\engine\assets\engine\scar\core_objectives.scar] (1117) | |
| Objective_AddHealthBar( LuaTable objTable, EGroupID group , Boolean OPT_onlyWhenDamaged, Integer OPT_barIndex, String OPT_text ) | |
|
在指定位置为小队或实体添加生命值条。生命值条会随单位生命值变化而更新。可通过Objective_RemoveHealthBar或完成/失败目标来移除【功能：生命值条显示】 If you want to use one of the "global" progress bars (if your project supports them), supply the relevant barIndex value and text string to show alongside it. |
|
| Source: [E:\P4Share\engine\assets\engine\scar\core_objectives.scar] (1211) | |
| Objective_AddPing( LuaTable objectiveTable, Position pos ) | |
|
为目标添加战术地图标记【功能：战术地图标记】 |
|
| Source: [E:\P4Share\engine\assets\engine\scar\core_objectives.scar] (1064) | |
| Objective_AddTimerBar( LuaTable objTable, Integer OPT_barIndex, String OPT_text ) | |
|
为目标计时器添加计时条，自动更新。可通过Objective_RemoveTimerBar或完成/失败目标来移除【功能：计时条显示】 Requires a timer to have been started with Objective_StartTimer to work. If you want to use one of the "global" progress bars (if your project supports them), supply the relevant barIndex value and text string to show alongside it. |
|
| Source: [E:\P4Share\engine\assets\engine\scar\core_objectives.scar] (1280) | |
| Objective_AddUIElements( LuaTable objTable, Position pos, Boolean OPT_ping, String OPT_hintpointText, Boolean OPT_worldArrow, Real OPT_objectiveArrowOffset, Entity/Squad/Position OPT_objectiveArrowFacing, Integer OPT_actionType, String OPT_iconName, String OPT_templateName ) | |
|
在指定位置添加多个UI元素。'pos'可以是编组/实体/小队/标记。worldArrow添加指向世界中物体的3D箭头。hintpointText添加鼠标悬停时显示的提示点。如果添加箭头或提示点，该物体将被2D HUD箭头指向。objectiveArrowOffset是应用于箭头位置的偏移量（可指定高度偏移或3D位置偏移）【功能：UI元素添加】 |
|
| Source: [E:\P4Share\engine\assets\engine\scar\core_objectives.scar] (765) | |
| Objective_AreAllPrimaryObjectivesComplete( ) | |
|
返回所有主要目标是否已完成【功能：目标状态检查】 |
|
| Source: [E:\P4Share\engine\assets\engine\scar\core_objectives.scar] (656) | |
| Objective_AreSubObjectivesComplete( LuaTable objTable, Boolean all ) | |
|
返回给定目标的所有或任意子目标是否已完成【功能：子目标状态检查】 |
|
| Source: [E:\P4Share\engine\assets\engine\scar\core_objectives.scar] (534) | |
| Objective_AreSubObjectivesExpired( LuaTable objTable, Boolean all ) | |
|
返回给定目标的所有或任意子目标是否已过期【功能：子目标状态检查】 |
|
| Source: [E:\P4Share\engine\assets\engine\scar\core_objectives.scar] (580) | |
| Objective_AreSubObjectivesFailed( LuaTable objTable, Boolean all ) | |
|
返回给定目标的所有或任意子目标是否已失败【功能：子目标状态检查】 |
|
| Source: [E:\P4Share\engine\assets\engine\scar\core_objectives.scar] (557) | |
| Objective_BlinkUIElements( LuaTable objTable, Integer elementID ) | |
|
通过闪烁UI元素来引起注意。这会使提示点和屏幕外箭头闪烁，但小地图标记和其他元素保持不变【功能：UI闪烁效果】 |
|
| Source: [E:\P4Share\engine\assets\engine\scar\core_objectives.scar] (958) | |
| Objective_Complete( LuaTable objTable, Boolean OPT_showTitle, Boolean OPT_playIntel ) | |
|
完成目标并从列表中移除（如果是子目标，则标记为完成但保持可见直到父目标结束）【功能：目标完成】 Automatically removes any elements added with Objective_AddUIElements(). The showTitle and playIntel flags let you control whether the titlecard and Intel_Complete event are played (default: true). |
|
| Source: [E:\P4Share\engine\assets\engine\scar\core_objectives.scar] (237) | |
| Objective_Expire( LuaTable objTable, Boolean OPT_showTitle, Boolean OPT_playIntel ) | |
|
使目标过期并从列表中移除（如果是子目标，则标记为过期但保持可见直到父目标结束）【功能：目标过期】 Automatically removes any elements added with Objective_AddUIElements(). The showTitle and playIntel flags let you control whether the titlecard and Intel_Expire event are played (default: true). |
|
| Source: [E:\P4Share\engine\assets\engine\scar\core_objectives.scar] (308) | |
| Objective_Fail( LuaTable objTable, Boolean OPT_showTitle, Boolean OPT_playIntel ) | |
|
使目标失败并从列表中移除（如果是子目标，则标记为失败但保持可见直到父目标结束）【功能：目标失败】 Automatically removes any elements added with Objective_AddUIElements(). The showTitle and playIntel flags let you control whether the titlecard and Intel_Fail event are played (default: true). |
|
| Source: [E:\P4Share\engine\assets\engine\scar\core_objectives.scar] (275) | |
| Objective_GetCounter( LuaTable objTable ) | |
|
返回与此目标关联的当前计数值【功能：获取计数器】 |
|
| Source: [E:\P4Share\engine\assets\engine\scar\core_objectives.scar] (1503) | |
| Objective_GetSubObjectives( LuaTable objTable ) | |
|
返回给定目标的所有子目标列表【功能：获取子目标】 |
|
| Source: [E:\P4Share\engine\assets\engine\scar\core_objectives.scar] (515) | |
| Objective_GetTimerSeconds( LuaTable objTable ) | |
|
返回计时器上的秒数（剩余时间或已用时间，取决于计时器类型）【功能：获取计时器秒数】 |
|
| Source: [E:\P4Share\engine\assets\engine\scar\core_objectives.scar] (1416) | |
| Objective_IncreaseCounter( LuaTable objTable, Integer OPT_amount ) | |
|
增加UI中与此目标关联的计数器。可指定增加的数量【功能：增加计数器】 |
|
| Source: [E:\P4Share\engine\assets\engine\scar\core_objectives.scar] (1467) | |
| Objective_IsComplete( LuaTable objTable ) | |
|
返回目标是否已完成【功能：目标状态检查】 |
|
| Source: [E:\P4Share\engine\assets\engine\scar\core_objectives.scar] (502) | |
| Objective_IsCounterSet( LuaTable objTable ) | |
|
如果已为此目标设置计数器则返回true【功能：计数器状态检查】 |
|
| Source: [E:\P4Share\engine\assets\engine\scar\core_objectives.scar] (1516) | |
| Objective_IsExpired( LuaTable objTable ) | |
|
返回目标是否已过期【功能：目标状态检查】 |
|
| Source: [E:\P4Share\engine\assets\engine\scar\core_objectives.scar] (616) | |
| Objective_IsFailed( LuaTable objTable ) | |
|
返回目标是否已失败【功能：目标状态检查】 |
|
| Source: [E:\P4Share\engine\assets\engine\scar\core_objectives.scar] (603) | |
| Objective_IsStarted( LuaTable objTable ) | |
|
返回目标是否已开始。已完成和失败/过期的目标也会返回true【功能：目标状态检查】 |
|
| Source: [E:\P4Share\engine\assets\engine\scar\core_objectives.scar] (629) | |
| Objective_IsTimerSet( LuaTable objTable ) | |
|
如果已为此目标设置计时器则返回true【功能：计时器状态检查】 |
|
| Source: [E:\P4Share\engine\assets\engine\scar\core_objectives.scar] (1435) | |
| Objective_IsVisible( LuaTable objTable ) | |
|
返回目标是否可见【功能：目标可见性检查】 |
|
| Source: [E:\P4Share\engine\assets\engine\scar\core_objectives.scar] (642) | |
| Objective_PauseTimer( LuaTable objTable ) | |
|
暂停目标的计时器。如果未设置计时器则不执行任何操作【功能：暂停计时器】 |
|
| Source: [E:\P4Share\engine\assets\engine\scar\core_objectives.scar] (1379) | |
| Objective_Register( LuaTable objTable, PlayerID/TeamID OPT_owner ) | |
|
"注册"一个目标。是Objective_Create的包装函数，带有其他功能【功能：目标注册】 Includes pings as defined by the objective table created in the main scar file. You can pass in a team or player, so that the objective only applies to it. |
|
| Source: [E:\P4Share\engine\assets\engine\scar\core_objectives.scar] (96) | |
| Objective_RemoveGroundReticule( ) | |
|
通过ID移除现有的地面标记【功能：移除地面标记】 |
|
| Source: [E:\P4Share\engine\assets\engine\scar\core_objectives.scar] (1181) | |
| Objective_RemoveHealthBar( LuaTable objectiveTable, Element healthBarID ) | |
|
移除生命值条监视器【功能：移除生命值条】 |
|
| Source: [E:\P4Share\engine\assets\engine\scar\core_objectives.scar] (1310) | |
| Objective_RemovePing( LuaTable objectiveTable, Integer PingID ) | |
|
从目标移除战术地图标记【功能：移除战术标记】 |
|
| Source: [E:\P4Share\engine\assets\engine\scar\core_objectives.scar] (1093) | |
| Objective_RemoveProgressBar( LuaTable objTable ) | |
|
移除此目标的进度条【功能：移除进度条】 |
|
| Source: [E:\P4Share\engine\assets\engine\scar\core_objectives.scar] (1561) | |
| Objective_RemoveTimerBar( LuaTable objectiveTable, Element timerBarID ) | |
|
移除计时条监视器【功能：移除计时条】 |
|
| Source: [E:\P4Share\engine\assets\engine\scar\core_objectives.scar] (1323) | |
| Objective_RemoveUIElements( LuaTable objTable, Integer elementID ) | |
|
移除由Objective_AddUIElements添加的一组UI元素【功能：移除UI元素】 |
|
| Source: [E:\P4Share\engine\assets\engine\scar\core_objectives.scar] (871) | |
| Objective_ResumeTimer( LuaTable objTable ) | |
|
恢复目标的计时器。如果未设置计时器则不执行任何操作【功能：恢复计时器】 |
|
| Source: [E:\P4Share\engine\assets\engine\scar\core_objectives.scar] (1391) | |
| Objective_SetAlwaysShowDetails( LuaTable objTable, Boolean title, Boolean hud_arrow, Boolean hintpoints ) | |
|
设置此目标是否始终显示详细文本、HUD箭头或提示点。同一时间只能有一个目标强制显示HUD箭头。如果为hud_arrow传入'nil'则不影响其行为【功能：设置详细显示】 |
|
| Source: [E:\P4Share\engine\assets\engine\scar\core_objectives.scar] (1585) | |
| Objective_SetCounter( LuaTable objTable, Real current, Real OPT_maximum ) | |
|
设置UI中与此目标关联的计数器。可提供'最大值'以显示为"1/5"格式【功能：设置计数器】 |
|
| Source: [E:\P4Share\engine\assets\engine\scar\core_objectives.scar] (1447) | |
| Objective_SetProgressBar( LuaTable objTable, Real value, Boolean OPT_flashing, Integer OPT_barIndex, String OPT_text ) | |
|
为此目标显示进度条，值为0.0（空）到1.0（满）的百分比。可通过Objective_RemoveProgressBar或完成/失败任务来移除【功能：设置进度条】 If you want to use one of the "global" progress bars (if your project supports them), supply the relevant barIndex value and text string to show alongside it. |
|
| Source: [E:\P4Share\engine\assets\engine\scar\core_objectives.scar] (1530) | |
| Objective_Show( LuaTable objective_table, Boolean on/off, Boolean ShowTitle ) | |
|
在UI和战术地图中显示或隐藏目标【功能：目标显示控制】 |
|
| Source: [E:\P4Share\engine\assets\engine\scar\core_objectives.scar] (363) | |
| Objective_Start( LuaTable objTable, Boolean OPT_showTitle, Boolean OPT_playIntel ) | |
|
向玩家显示目标并激活它【功能：启动目标】 Includes pings and FOW as defined by the SetupUI() function. The showTitle and playIntel flags let you control whether the titlecard and Intel_Start event are played (default: true). |
|
| Source: [E:\P4Share\engine\assets\engine\scar\core_objectives.scar] (204) | |
| Objective_StartTimer( LuaTable objTable, Integer direction, Real OPT_initialTime, Real OPT_flashThreshold ) | |
|
启动UI中与此目标关联的计时器。'direction'参数使用COUNT_DOWN（倒计时）或COUNT_UP（正计时）【功能：启动计时器】 |
|
| Source: [E:\P4Share\engine\assets\engine\scar\core_objectives.scar] (1344) | |
| Objective_Stop( LuaTable objTable ) | |
|
停止正在进行的目标并将其恢复到等待开始状态【功能：停止目标】 |
|
| Source: [E:\P4Share\engine\assets\engine\scar\core_objectives.scar] (337) | |
| Objective_StopCounter( LuaTable objTable ) | |
|
停止目标的计数器。如果未设置计数器则不执行任何操作【功能：停止计数器】 |
|
| Source: [E:\P4Share\engine\assets\engine\scar\core_objectives.scar] (1491) | |
| Objective_StopTimer( LuaTable objTable ) | |
|
停止目标的计时器。如果未设置计时器则不执行任何操作【功能：停止计时器】 |
|
| Source: [E:\P4Share\engine\assets\engine\scar\core_objectives.scar] (1403) | |
| Objective_TogglePings( LuaTable objective_table, Boolean on/off ) | |
|
切换小地图标记的开关状态【功能：切换小地图标记】 |
|
| Source: [E:\P4Share\engine\assets\engine\scar\core_objectives.scar] (699) | |
| Objective_TriggerTitleCard( ) | |
|
仅可在目标的情报开始/完成/失败/过期事件内部调用。目标标题卡将在事件中的此时点显示【功能：触发标题卡】 If you omit this call, the titlecard will appear at the end of the event by default. You also do not have to wrap this with CTRL and WAIT stuff - it does all of the internally. |
|
| Source: [E:\P4Share\engine\assets\engine\scar\core_objectives.scar] (417) | |
| Objective_UpdateText( LuaTable objTable, String new_title, String new_description, Boolean OPT_showTitle, Boolean OPT_immediate ) | |
|
更新目标的标题和描述。如果只想设置其中一个，为另一个传入nil【功能：更新目标文本】 Use the immediate flag to make this change happen immediately, bypassing the queue that objective updates normally sit in (i.e. you're updating the objective's title in the middle of its PreStart() function!) |
|
| Source: [E:\P4Share\engine\assets\engine\scar\core_objectives.scar] (385) | |