mirror of
https://github.com/FlightControl-Master/MOOSE.git
synced 2025-08-15 10:47:21 +00:00
3213 lines
91 KiB
HTML
3213 lines
91 KiB
HTML
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
<html>
|
|
<head>
|
|
<link rel="stylesheet" href="stylesheet.css" type="text/css"/>
|
|
</head>
|
|
<body>
|
|
<div id="container">
|
|
<div id="product">
|
|
<div id="product_logo"></div>
|
|
<div id="product_name"><big><b></b></big></div>
|
|
<div id="product_description"></div>
|
|
</div>
|
|
<div id="main">
|
|
<div id="navigation">
|
|
<h2>Modules</h2>
|
|
<ul><li>
|
|
<a href="index.html">index</a>
|
|
</li></ul>
|
|
<ul>
|
|
<li><a href="AI_Balancer.html">AI_Balancer</a></li>
|
|
<li><a href="AI_Cap.html">AI_Cap</a></li>
|
|
<li><a href="AI_Cas.html">AI_Cas</a></li>
|
|
<li><a href="AI_Patrol.html">AI_Patrol</a></li>
|
|
<li><a href="Account.html">Account</a></li>
|
|
<li><a href="Airbase.html">Airbase</a></li>
|
|
<li><a href="AirbasePolice.html">AirbasePolice</a></li>
|
|
<li><a href="Assign.html">Assign</a></li>
|
|
<li><a href="Base.html">Base</a></li>
|
|
<li><a href="Cargo.html">Cargo</a></li>
|
|
<li><a href="CleanUp.html">CleanUp</a></li>
|
|
<li><a href="Client.html">Client</a></li>
|
|
<li><a href="CommandCenter.html">CommandCenter</a></li>
|
|
<li>Controllable</li>
|
|
<li><a href="Database.html">Database</a></li>
|
|
<li><a href="Detection.html">Detection</a></li>
|
|
<li><a href="DetectionManager.html">DetectionManager</a></li>
|
|
<li><a href="Escort.html">Escort</a></li>
|
|
<li><a href="Event.html">Event</a></li>
|
|
<li><a href="Fsm.html">Fsm</a></li>
|
|
<li><a href="Group.html">Group</a></li>
|
|
<li><a href="Identifiable.html">Identifiable</a></li>
|
|
<li><a href="Menu.html">Menu</a></li>
|
|
<li><a href="Message.html">Message</a></li>
|
|
<li><a href="MissileTrainer.html">MissileTrainer</a></li>
|
|
<li><a href="Mission.html">Mission</a></li>
|
|
<li><a href="Movement.html">Movement</a></li>
|
|
<li><a href="Object.html">Object</a></li>
|
|
<li><a href="Point.html">Point</a></li>
|
|
<li><a href="Positionable.html">Positionable</a></li>
|
|
<li><a href="Process_JTAC.html">Process_JTAC</a></li>
|
|
<li><a href="Process_Pickup.html">Process_Pickup</a></li>
|
|
<li><a href="Route.html">Route</a></li>
|
|
<li><a href="ScheduleDispatcher.html">ScheduleDispatcher</a></li>
|
|
<li><a href="Scheduler.html">Scheduler</a></li>
|
|
<li><a href="Scoring.html">Scoring</a></li>
|
|
<li><a href="Sead.html">Sead</a></li>
|
|
<li><a href="Set.html">Set</a></li>
|
|
<li><a href="Smoke.html">Smoke</a></li>
|
|
<li><a href="Spawn.html">Spawn</a></li>
|
|
<li><a href="Static.html">Static</a></li>
|
|
<li><a href="Task.html">Task</a></li>
|
|
<li><a href="Task_A2G.html">Task_A2G</a></li>
|
|
<li><a href="Task_PICKUP.html">Task_PICKUP</a></li>
|
|
<li><a href="Task_SEAD.html">Task_SEAD</a></li>
|
|
<li><a href="Unit.html">Unit</a></li>
|
|
<li><a href="Utils.html">Utils</a></li>
|
|
<li><a href="Zone.html">Zone</a></li>
|
|
<li><a href="routines.html">routines</a></li>
|
|
</ul>
|
|
</div>
|
|
<div id="content">
|
|
<h1>Module <code>Controllable</code></h1>
|
|
|
|
<p>This module contains the CONTROLLABLE class.</p>
|
|
|
|
|
|
|
|
<h1>1) <a href="Controllable.html##(CONTROLLABLE)">Controllable#CONTROLLABLE</a> class, extends <a href="Positionable.html##(POSITIONABLE)">Positionable#POSITIONABLE</a></h1>
|
|
<p>The <a href="Controllable.html##(CONTROLLABLE)">Controllable#CONTROLLABLE</a> class is a wrapper class to handle the DCS Controllable objects:</p>
|
|
|
|
<ul>
|
|
<li>Support all DCS Controllable APIs.</li>
|
|
<li>Enhance with Controllable specific APIs not in the DCS Controllable API set.</li>
|
|
<li>Handle local Controllable Controller.</li>
|
|
<li>Manage the "state" of the DCS Controllable.</li>
|
|
</ul>
|
|
|
|
<h2>1.1) CONTROLLABLE constructor</h2>
|
|
<p>The CONTROLLABLE class provides the following functions to construct a CONTROLLABLE instance:</p>
|
|
|
|
<ul>
|
|
<li><a href="##(CONTROLLABLE).New">CONTROLLABLE.New</a>(): Create a CONTROLLABLE instance.</li>
|
|
</ul>
|
|
|
|
<h2>1.2) CONTROLLABLE task methods</h2>
|
|
<p>Several controllable task methods are available that help you to prepare tasks.
|
|
These methods return a string consisting of the task description, which can then be given to either a <a href="Controllable.html##(CONTROLLABLE).PushTask">Controllable#CONTROLLABLE.PushTask</a> or <a href="Controllable.html##(SetTask)">Controllable#SetTask</a> method to assign the task to the CONTROLLABLE.
|
|
Tasks are specific for the category of the CONTROLLABLE, more specific, for AIR, GROUND or AIR and GROUND.
|
|
Each task description where applicable indicates for which controllable category the task is valid.
|
|
There are 2 main subdivisions of tasks: Assigned tasks and EnRoute tasks.</p>
|
|
|
|
<h3>1.2.1) Assigned task methods</h3>
|
|
|
|
<p>Assigned task methods make the controllable execute the task where the location of the (possible) targets of the task are known before being detected.
|
|
This is different from the EnRoute tasks, where the targets of the task need to be detected before the task can be executed.</p>
|
|
|
|
<p>Find below a list of the <strong>assigned task</strong> methods:</p>
|
|
|
|
<ul>
|
|
<li><a href="##(CONTROLLABLE).TaskAttackControllable">CONTROLLABLE.TaskAttackControllable</a>: (AIR) Attack a Controllable.</li>
|
|
<li><a href="##(CONTROLLABLE).TaskAttackMapObject">CONTROLLABLE.TaskAttackMapObject</a>: (AIR) Attacking the map object (building, structure, e.t.c).</li>
|
|
<li><a href="##(CONTROLLABLE).TaskAttackUnit">CONTROLLABLE.TaskAttackUnit</a>: (AIR) Attack the Unit.</li>
|
|
<li><a href="##(CONTROLLABLE).TaskBombing">CONTROLLABLE.TaskBombing</a>: (AIR) Delivering weapon at the point on the ground.</li>
|
|
<li><a href="##(CONTROLLABLE).TaskBombingRunway">CONTROLLABLE.TaskBombingRunway</a>: (AIR) Delivering weapon on the runway.</li>
|
|
<li><a href="##(CONTROLLABLE).TaskEmbarking">CONTROLLABLE.TaskEmbarking</a>: (AIR) Move the controllable to a Vec2 Point, wait for a defined duration and embark a controllable.</li>
|
|
<li><a href="##(CONTROLLABLE).TaskEmbarkToTransport">CONTROLLABLE.TaskEmbarkToTransport</a>: (GROUND) Embark to a Transport landed at a location.</li>
|
|
<li><a href="##(CONTROLLABLE).TaskEscort">CONTROLLABLE.TaskEscort</a>: (AIR) Escort another airborne controllable. </li>
|
|
<li><a href="##(CONTROLLABLE).TaskFAC_AttackControllable">CONTROLLABLE.TaskFAC_AttackControllable</a>: (AIR + GROUND) The task makes the controllable/unit a FAC and orders the FAC to control the target (enemy ground controllable) destruction.</li>
|
|
<li><a href="##(CONTROLLABLE).TaskFireAtPoint">CONTROLLABLE.TaskFireAtPoint</a>: (GROUND) Fire some or all ammunition at a VEC2 point.</li>
|
|
<li><a href="##(CONTROLLABLE).TaskFollow">CONTROLLABLE.TaskFollow</a>: (AIR) Following another airborne controllable.</li>
|
|
<li><a href="##(CONTROLLABLE).TaskHold">CONTROLLABLE.TaskHold</a>: (GROUND) Hold ground controllable from moving.</li>
|
|
<li><a href="##(CONTROLLABLE).TaskHoldPosition">CONTROLLABLE.TaskHoldPosition</a>: (AIR) Hold position at the current position of the first unit of the controllable.</li>
|
|
<li><a href="##(CONTROLLABLE).TaskLand">CONTROLLABLE.TaskLand</a>: (AIR HELICOPTER) Landing at the ground. For helicopters only.</li>
|
|
<li><a href="##(CONTROLLABLE).TaskLandAtZone">CONTROLLABLE.TaskLandAtZone</a>: (AIR) Land the controllable at a <a href="##(CONTROLLABLE).TaskOrbitCircle">CONTROLLABLE.TaskOrbitCircle</a>: (AIR) Orbit at the current position of the first unit of the controllable at a specified alititude.</li>
|
|
<li><a href="##(CONTROLLABLE).TaskOrbitCircleAtVec2">CONTROLLABLE.TaskOrbitCircleAtVec2</a>: (AIR) Orbit at a specified position at a specified alititude during a specified duration with a specified speed.</li>
|
|
<li><a href="##(CONTROLLABLE).TaskRefueling">CONTROLLABLE.TaskRefueling</a>: (AIR) Refueling from the nearest tanker. No parameters.</li>
|
|
<li><a href="##(CONTROLLABLE).TaskRoute">CONTROLLABLE.TaskRoute</a>: (AIR + GROUND) Return a Misson task to follow a given route defined by Points.</li>
|
|
<li><a href="##(CONTROLLABLE).TaskRouteToVec2">CONTROLLABLE.TaskRouteToVec2</a>: (AIR + GROUND) Make the Controllable move to a given point.</li>
|
|
<li><a href="##(CONTROLLABLE).TaskRouteToVec3">CONTROLLABLE.TaskRouteToVec3</a>: (AIR + GROUND) Make the Controllable move to a given point.</li>
|
|
<li><a href="##(CONTROLLABLE).TaskRouteToZone">CONTROLLABLE.TaskRouteToZone</a>: (AIR + GROUND) Route the controllable to a given zone.</li>
|
|
<li><a href="##(CONTROLLABLE).TaskReturnToBase">CONTROLLABLE.TaskReturnToBase</a>: (AIR) Route the controllable to an airbase.</li>
|
|
</ul>
|
|
|
|
<h3>1.2.2) EnRoute task methods</h3>
|
|
|
|
<p>EnRoute tasks require the targets of the task need to be detected by the controllable (using its sensors) before the task can be executed:</p>
|
|
|
|
<ul>
|
|
<li><a href="##(CONTROLLABLE).EnRouteTaskAWACS">CONTROLLABLE.EnRouteTaskAWACS</a>: (AIR) Aircraft will act as an AWACS for friendly units (will provide them with information about contacts). No parameters.</li>
|
|
<li><a href="##(CONTROLLABLE).EnRouteTaskEngageControllable">CONTROLLABLE.EnRouteTaskEngageControllable</a>: (AIR) Engaging a controllable. The task does not assign the target controllable to the unit/controllable to attack now; it just allows the unit/controllable to engage the target controllable as well as other assigned targets.</li>
|
|
<li><a href="##(CONTROLLABLE).EnRouteTaskEngageTargets">CONTROLLABLE.EnRouteTaskEngageTargets</a>: (AIR) Engaging targets of defined types.</li>
|
|
<li><a href="##(CONTROLLABLE).EnRouteTaskEWR">CONTROLLABLE.EnRouteTaskEWR</a>: (AIR) Attack the Unit.</li>
|
|
<li><a href="##(CONTROLLABLE).EnRouteTaskFAC">CONTROLLABLE.EnRouteTaskFAC</a>: (AIR + GROUND) The task makes the controllable/unit a FAC and lets the FAC to choose a targets (enemy ground controllable) around as well as other assigned targets.</li>
|
|
<li><a href="##(CONTROLLABLE).EnRouteTaskFAC_EngageControllable">CONTROLLABLE.EnRouteTaskFAC_EngageControllable</a>: (AIR + GROUND) The task makes the controllable/unit a FAC and lets the FAC to choose the target (enemy ground controllable) as well as other assigned targets.</li>
|
|
<li><a href="##(CONTROLLABLE).EnRouteTaskTanker">CONTROLLABLE.EnRouteTaskTanker</a>: (AIR) Aircraft will act as a tanker for friendly units. No parameters.</li>
|
|
</ul>
|
|
|
|
<h3>1.2.3) Preparation task methods</h3>
|
|
|
|
<p>There are certain task methods that allow to tailor the task behaviour:</p>
|
|
|
|
<ul>
|
|
<li><a href="##(CONTROLLABLE).TaskWrappedAction">CONTROLLABLE.TaskWrappedAction</a>: Return a WrappedAction Task taking a Command.</li>
|
|
<li><a href="##(CONTROLLABLE).TaskCombo">CONTROLLABLE.TaskCombo</a>: Return a Combo Task taking an array of Tasks.</li>
|
|
<li><a href="##(CONTROLLABLE).TaskCondition">CONTROLLABLE.TaskCondition</a>: Return a condition section for a controlled task.</li>
|
|
<li><a href="##(CONTROLLABLE).TaskControlled">CONTROLLABLE.TaskControlled</a>: Return a Controlled Task taking a Task and a TaskCondition.</li>
|
|
</ul>
|
|
|
|
<h3>1.2.4) Obtain the mission from controllable templates</h3>
|
|
|
|
<p>Controllable templates contain complete mission descriptions. Sometimes you want to copy a complete mission from a controllable and assign it to another:</p>
|
|
|
|
<ul>
|
|
<li><a href="##(CONTROLLABLE).TaskMission">CONTROLLABLE.TaskMission</a>: (AIR + GROUND) Return a mission task from a mission template.</li>
|
|
</ul>
|
|
|
|
<h2>1.3) CONTROLLABLE Command methods</h2>
|
|
<p>Controllable <strong>command methods</strong> prepare the execution of commands using the <a href="##(CONTROLLABLE).SetCommand">CONTROLLABLE.SetCommand</a> method:</p>
|
|
|
|
<ul>
|
|
<li><a href="##(CONTROLLABLE).CommandDoScript">CONTROLLABLE.CommandDoScript</a>: Do Script command.</li>
|
|
<li><a href="##(CONTROLLABLE).CommandSwitchWayPoint">CONTROLLABLE.CommandSwitchWayPoint</a>: Perform a switch waypoint command.</li>
|
|
</ul>
|
|
|
|
<h2>1.4) CONTROLLABLE Option methods</h2>
|
|
<p>Controllable <strong>Option methods</strong> change the behaviour of the Controllable while being alive.</p>
|
|
|
|
<h3>1.4.1) Rule of Engagement:</h3>
|
|
|
|
<ul>
|
|
<li><a href="##(CONTROLLABLE).OptionROEWeaponFree">CONTROLLABLE.OptionROEWeaponFree</a> </li>
|
|
<li><a href="##(CONTROLLABLE).OptionROEOpenFire">CONTROLLABLE.OptionROEOpenFire</a></li>
|
|
<li><a href="##(CONTROLLABLE).OptionROEReturnFire">CONTROLLABLE.OptionROEReturnFire</a></li>
|
|
<li><a href="##(CONTROLLABLE).OptionROEEvadeFire">CONTROLLABLE.OptionROEEvadeFire</a></li>
|
|
</ul>
|
|
|
|
<p>To check whether an ROE option is valid for a specific controllable, use:</p>
|
|
|
|
<ul>
|
|
<li><a href="##(CONTROLLABLE).OptionROEWeaponFreePossible">CONTROLLABLE.OptionROEWeaponFreePossible</a> </li>
|
|
<li><a href="##(CONTROLLABLE).OptionROEOpenFirePossible">CONTROLLABLE.OptionROEOpenFirePossible</a></li>
|
|
<li><a href="##(CONTROLLABLE).OptionROEReturnFirePossible">CONTROLLABLE.OptionROEReturnFirePossible</a></li>
|
|
<li><a href="##(CONTROLLABLE).OptionROEEvadeFirePossible">CONTROLLABLE.OptionROEEvadeFirePossible</a></li>
|
|
</ul>
|
|
|
|
<h3>1.4.2) Rule on thread:</h3>
|
|
|
|
<ul>
|
|
<li><a href="##(CONTROLLABLE).OptionROTNoReaction">CONTROLLABLE.OptionROTNoReaction</a></li>
|
|
<li><a href="##(CONTROLLABLE).OptionROTPassiveDefense">CONTROLLABLE.OptionROTPassiveDefense</a></li>
|
|
<li><a href="##(CONTROLLABLE).OptionROTEvadeFire">CONTROLLABLE.OptionROTEvadeFire</a></li>
|
|
<li><a href="##(CONTROLLABLE).OptionROTVertical">CONTROLLABLE.OptionROTVertical</a></li>
|
|
</ul>
|
|
|
|
<p>To test whether an ROT option is valid for a specific controllable, use:</p>
|
|
|
|
<ul>
|
|
<li><a href="##(CONTROLLABLE).OptionROTNoReactionPossible">CONTROLLABLE.OptionROTNoReactionPossible</a></li>
|
|
<li><a href="##(CONTROLLABLE).OptionROTPassiveDefensePossible">CONTROLLABLE.OptionROTPassiveDefensePossible</a></li>
|
|
<li><a href="##(CONTROLLABLE).OptionROTEvadeFirePossible">CONTROLLABLE.OptionROTEvadeFirePossible</a></li>
|
|
<li><a href="##(CONTROLLABLE).OptionROTVerticalPossible">CONTROLLABLE.OptionROTVerticalPossible</a></li>
|
|
</ul>
|
|
|
|
<hr/>
|
|
|
|
|
|
<h2>Global(s)</h2>
|
|
<table class="function_list">
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="#CONTROLLABLE">CONTROLLABLE</a></td>
|
|
<td class="summary">
|
|
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
<h2><a id="#(CONTROLLABLE)">Type <code>CONTROLLABLE</code></a></h2>
|
|
<table class="function_list">
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).ClassName">CONTROLLABLE.ClassName</a></td>
|
|
<td class="summary">
|
|
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).CommandDoScript">CONTROLLABLE:CommandDoScript(DoScript)</a></td>
|
|
<td class="summary">
|
|
<p>Do Script command</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).CommandStopRoute">CONTROLLABLE:CommandStopRoute(StopRoute, Index)</a></td>
|
|
<td class="summary">
|
|
<p>Perform stop route command</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).CommandSwitchWayPoint">CONTROLLABLE:CommandSwitchWayPoint(FromWayPoint, ToWayPoint)</a></td>
|
|
<td class="summary">
|
|
<p>Perform a switch waypoint command</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).ControllableName">CONTROLLABLE.ControllableName</a></td>
|
|
<td class="summary">
|
|
<p>The name of the controllable.</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).CopyRoute">CONTROLLABLE:CopyRoute(Begin, End, Randomize, Radius)</a></td>
|
|
<td class="summary">
|
|
<p>Return the route of a controllable by using the <a href="Database.html##(DATABASE)">Database#DATABASE</a> class.</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).DCSControllable">CONTROLLABLE.DCSControllable</a></td>
|
|
<td class="summary">
|
|
<p>The DCS controllable class.</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).EnRouteTaskAWACS">CONTROLLABLE:EnRouteTaskAWACS()</a></td>
|
|
<td class="summary">
|
|
<p>(AIR) Aircraft will act as an AWACS for friendly units (will provide them with information about contacts).</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).EnRouteTaskEWR">CONTROLLABLE:EnRouteTaskEWR()</a></td>
|
|
<td class="summary">
|
|
<p>(GROUND) Ground unit (EW-radar) will act as an EWR for friendly units (will provide them with information about contacts).</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).EnRouteTaskEngageGroup">CONTROLLABLE:EnRouteTaskEngageGroup(AttackGroup, Priority, WeaponType, WeaponExpend, AttackQty, Direction, Altitude, AttackQtyLimit)</a></td>
|
|
<td class="summary">
|
|
<p>(AIR) Engaging a controllable.</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).EnRouteTaskEngageTargets">CONTROLLABLE:EnRouteTaskEngageTargets(Distance, TargetTypes, Priority)</a></td>
|
|
<td class="summary">
|
|
<p>(AIR) Engaging targets of defined types.</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).EnRouteTaskEngageUnit">CONTROLLABLE:EnRouteTaskEngageUnit(EngageUnit, Priority, GroupAttack, WeaponExpend, AttackQty, Direction, Altitude, Visible, ControllableAttack)</a></td>
|
|
<td class="summary">
|
|
<p>(AIR) Search and attack the Unit.</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).EnRouteTaskFAC">CONTROLLABLE:EnRouteTaskFAC(Radius, Priority)</a></td>
|
|
<td class="summary">
|
|
<p>(AIR + GROUND) The task makes the controllable/unit a FAC and lets the FAC to choose a targets (enemy ground controllable) around as well as other assigned targets.</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).EnRouteTaskFAC_EngageGroup">CONTROLLABLE:EnRouteTaskFAC_EngageGroup(AttackGroup, Priority, WeaponType, Designation, Datalink)</a></td>
|
|
<td class="summary">
|
|
<p>(AIR + GROUND) The task makes the controllable/unit a FAC and lets the FAC to choose the target (enemy ground controllable) as well as other assigned targets.</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).EnRouteTaskTanker">CONTROLLABLE:EnRouteTaskTanker()</a></td>
|
|
<td class="summary">
|
|
<p>(AIR) Aircraft will act as a tanker for friendly units.</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).GetDetectedTargets">CONTROLLABLE:GetDetectedTargets(DetectVisual, DetectOptical, DetectRadar, DetectIRST, DetectRWR, DetectDLINK)</a></td>
|
|
<td class="summary">
|
|
<p>Return the detected targets of the controllable.</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).GetLife">CONTROLLABLE:GetLife()</a></td>
|
|
<td class="summary">
|
|
<p>Returns the health.</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).GetTaskMission">CONTROLLABLE:GetTaskMission()</a></td>
|
|
<td class="summary">
|
|
<p>Return the mission template of the controllable.</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).GetTaskRoute">CONTROLLABLE:GetTaskRoute()</a></td>
|
|
<td class="summary">
|
|
<p>Return the mission route of the controllable.</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).GetUnits">CONTROLLABLE:GetUnits()</a></td>
|
|
<td class="summary">
|
|
<p>Returns the UNITs wrappers of the DCS Units of the Controllable (default is a GROUP).</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).GetWayPoints">CONTROLLABLE:GetWayPoints()</a></td>
|
|
<td class="summary">
|
|
<p>Get the current WayPoints set with the WayPoint functions( Note that the WayPoints can be nil, although there ARE waypoints).</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).IsTargetDetected">CONTROLLABLE:IsTargetDetected(DCSObject)</a></td>
|
|
<td class="summary">
|
|
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).New">CONTROLLABLE:New(ControllableName)</a></td>
|
|
<td class="summary">
|
|
<p>Create a new CONTROLLABLE from a DCSControllable</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).OptionROEHoldFire">CONTROLLABLE:OptionROEHoldFire()</a></td>
|
|
<td class="summary">
|
|
<p>Holding weapons.</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).OptionROEHoldFirePossible">CONTROLLABLE:OptionROEHoldFirePossible()</a></td>
|
|
<td class="summary">
|
|
<p>Can the CONTROLLABLE hold their weapons?</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).OptionROEOpenFire">CONTROLLABLE:OptionROEOpenFire()</a></td>
|
|
<td class="summary">
|
|
<p>Openfire.</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).OptionROEOpenFirePossible">CONTROLLABLE:OptionROEOpenFirePossible()</a></td>
|
|
<td class="summary">
|
|
<p>Can the CONTROLLABLE attack designated targets?</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).OptionROEReturnFire">CONTROLLABLE:OptionROEReturnFire()</a></td>
|
|
<td class="summary">
|
|
<p>Return fire.</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).OptionROEReturnFirePossible">CONTROLLABLE:OptionROEReturnFirePossible()</a></td>
|
|
<td class="summary">
|
|
<p>Can the CONTROLLABLE attack returning on enemy fire?</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).OptionROEWeaponFree">CONTROLLABLE:OptionROEWeaponFree()</a></td>
|
|
<td class="summary">
|
|
<p>Weapon free.</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).OptionROEWeaponFreePossible">CONTROLLABLE:OptionROEWeaponFreePossible()</a></td>
|
|
<td class="summary">
|
|
<p>Can the CONTROLLABLE attack targets of opportunity?</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).OptionROTEvadeFire">CONTROLLABLE:OptionROTEvadeFire()</a></td>
|
|
<td class="summary">
|
|
<p>Evade on fire.</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).OptionROTEvadeFirePossible">CONTROLLABLE:OptionROTEvadeFirePossible()</a></td>
|
|
<td class="summary">
|
|
<p>Can the CONTROLLABLE evade on enemy fire?</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).OptionROTNoReaction">CONTROLLABLE:OptionROTNoReaction()</a></td>
|
|
<td class="summary">
|
|
<p>No evasion on enemy threats.</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).OptionROTNoReactionPossible">CONTROLLABLE:OptionROTNoReactionPossible()</a></td>
|
|
<td class="summary">
|
|
<p>Can the CONTROLLABLE ignore enemy fire?</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).OptionROTPassiveDefense">CONTROLLABLE:OptionROTPassiveDefense()</a></td>
|
|
<td class="summary">
|
|
<p>Evasion passive defense.</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).OptionROTPassiveDefensePossible">CONTROLLABLE:OptionROTPassiveDefensePossible()</a></td>
|
|
<td class="summary">
|
|
<p>Can the CONTROLLABLE evade using passive defenses?</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).OptionROTVertical">CONTROLLABLE:OptionROTVertical()</a></td>
|
|
<td class="summary">
|
|
<p>Evade on fire using vertical manoeuvres.</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).OptionROTVerticalPossible">CONTROLLABLE:OptionROTVerticalPossible()</a></td>
|
|
<td class="summary">
|
|
<p>Can the CONTROLLABLE evade on fire using vertical manoeuvres?</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).PopCurrentTask">CONTROLLABLE:PopCurrentTask()</a></td>
|
|
<td class="summary">
|
|
<p>Popping current Task from the controllable.</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).PushTask">CONTROLLABLE:PushTask(DCSTask, WaitTime)</a></td>
|
|
<td class="summary">
|
|
<p>Pushing Task on the queue from the controllable.</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).Route">CONTROLLABLE:Route(GoPoints)</a></td>
|
|
<td class="summary">
|
|
<p>Make the controllable to follow a given route.</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).RouteReturnToAirbase">CONTROLLABLE:RouteReturnToAirbase(ReturnAirbase, Speed)</a></td>
|
|
<td class="summary">
|
|
<p>(AIR) Return the Controllable to an <a href="Airbase.html##(AIRBASE)">Airbase#AIRBASE</a>
|
|
A speed can be given in km/h.</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).SetCommand">CONTROLLABLE:SetCommand(DCSCommand)</a></td>
|
|
<td class="summary">
|
|
<p>Executes a command action</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).SetTask">CONTROLLABLE:SetTask(DCSTask, WaitTime)</a></td>
|
|
<td class="summary">
|
|
<p>Clearing the Task Queue and Setting the Task on the queue from the controllable.</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).TaskAttackGroup">CONTROLLABLE:TaskAttackGroup(AttackGroup, WeaponType, WeaponExpend, AttackQty, Direction, Altitude, AttackQtyLimit)</a></td>
|
|
<td class="summary">
|
|
<p>(AIR) Attack a Controllable.</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).TaskAttackMapObject">CONTROLLABLE:TaskAttackMapObject(Vec2, WeaponType, WeaponExpend, AttackQty, Direction, ControllableAttack)</a></td>
|
|
<td class="summary">
|
|
<p>(AIR) Attacking the map object (building, structure, e.t.c).</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).TaskAttackUnit">CONTROLLABLE:TaskAttackUnit(AttackUnit, GroupAttack, WeaponExpend, AttackQty, Direction, Altitude, Visible, ControllableAttack)</a></td>
|
|
<td class="summary">
|
|
<p>(AIR) Attack the Unit.</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).TaskBombing">CONTROLLABLE:TaskBombing(Vec2, WeaponType, WeaponExpend, AttackQty, Direction, ControllableAttack)</a></td>
|
|
<td class="summary">
|
|
<p>(AIR) Delivering weapon at the point on the ground. </p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).TaskBombingRunway">CONTROLLABLE:TaskBombingRunway(Airbase, WeaponType, WeaponExpend, AttackQty, Direction, ControllableAttack)</a></td>
|
|
<td class="summary">
|
|
<p>(AIR) Delivering weapon on the runway.</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).TaskCombo">CONTROLLABLE:TaskCombo(DCSTasks)</a></td>
|
|
<td class="summary">
|
|
<p>Return a Combo Task taking an array of Tasks.</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).TaskCondition">CONTROLLABLE:TaskCondition(time, userFlag, userFlagValue, condition, duration, lastWayPoint)</a></td>
|
|
<td class="summary">
|
|
<p>Return a condition section for a controlled task.</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).TaskControlled">CONTROLLABLE:TaskControlled(DCSTask, DCSStopCondition)</a></td>
|
|
<td class="summary">
|
|
<p>Return a Controlled Task taking a Task and a TaskCondition.</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).TaskEmbarkToTransport">CONTROLLABLE:TaskEmbarkToTransport(Point, Radius)</a></td>
|
|
<td class="summary">
|
|
<p>Move to a defined Vec2 Point, and embark to a controllable when arrived within a defined Radius.</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).TaskEmbarking">CONTROLLABLE:TaskEmbarking(Point, Duration, EmbarkingControllable)</a></td>
|
|
<td class="summary">
|
|
<p>(AIR) Move the controllable to a Vec2 Point, wait for a defined duration and embark a controllable.</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).TaskEscort">CONTROLLABLE:TaskEscort(EscortControllable, Vec3, LastWaypointIndex, EngagementDistanceMax, TargetTypes, FollowControllable, EngagementDistance)</a></td>
|
|
<td class="summary">
|
|
<p>(AIR) Escort another airborne controllable.</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).TaskFAC_AttackGroup">CONTROLLABLE:TaskFAC_AttackGroup(AttackGroup, WeaponType, Designation, Datalink)</a></td>
|
|
<td class="summary">
|
|
<p>(AIR + GROUND) The task makes the controllable/unit a FAC and orders the FAC to control the target (enemy ground controllable) destruction.</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).TaskFireAtPoint">CONTROLLABLE:TaskFireAtPoint(Vec2, Radius, AmmoCount)</a></td>
|
|
<td class="summary">
|
|
<p>(GROUND) Fire at a VEC2 point until ammunition is finished.</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).TaskFollow">CONTROLLABLE:TaskFollow(FollowControllable, Vec3, LastWaypointIndex)</a></td>
|
|
<td class="summary">
|
|
<p>(AIR) Following another airborne controllable.</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).TaskFunction">CONTROLLABLE:TaskFunction(WayPoint, WayPointIndex, FunctionString, FunctionArguments)</a></td>
|
|
<td class="summary">
|
|
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).TaskHold">CONTROLLABLE:TaskHold()</a></td>
|
|
<td class="summary">
|
|
<p>(GROUND) Hold ground controllable from moving.</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).TaskHoldPosition">CONTROLLABLE:TaskHoldPosition(Duration)</a></td>
|
|
<td class="summary">
|
|
<p>(AIR) Hold position at the current position of the first unit of the controllable.</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).TaskLandAtVec2">CONTROLLABLE:TaskLandAtVec2(Point, Duration)</a></td>
|
|
<td class="summary">
|
|
<p>(AIR HELICOPTER) Landing at the ground.</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).TaskLandAtZone">CONTROLLABLE:TaskLandAtZone(Zone, Duration, RandomPoint)</a></td>
|
|
<td class="summary">
|
|
<p>(AIR) Land the controllable at a @{Zone#ZONE_RADIUS).</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).TaskMission">CONTROLLABLE:TaskMission(TaskMission)</a></td>
|
|
<td class="summary">
|
|
<p>(AIR + GROUND) Return a mission task from a mission template.</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).TaskOrbitCircle">CONTROLLABLE:TaskOrbitCircle(Altitude, Speed)</a></td>
|
|
<td class="summary">
|
|
<p>(AIR) Orbit at the current position of the first unit of the controllable at a specified alititude.</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).TaskOrbitCircleAtVec2">CONTROLLABLE:TaskOrbitCircleAtVec2(Point, Altitude, Speed)</a></td>
|
|
<td class="summary">
|
|
<p>(AIR) Orbit at a specified position at a specified alititude during a specified duration with a specified speed.</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).TaskRefueling">CONTROLLABLE:TaskRefueling()</a></td>
|
|
<td class="summary">
|
|
<p>(AIR) Refueling from the nearest tanker.</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).TaskRoute">CONTROLLABLE:TaskRoute(Points)</a></td>
|
|
<td class="summary">
|
|
<p>Return a Misson task to follow a given route defined by Points.</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).TaskRouteToVec2">CONTROLLABLE:TaskRouteToVec2(Point, Speed)</a></td>
|
|
<td class="summary">
|
|
<p>(AIR + GROUND) Make the Controllable move to fly to a given point.</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).TaskRouteToVec3">CONTROLLABLE:TaskRouteToVec3(Point, Speed)</a></td>
|
|
<td class="summary">
|
|
<p>(AIR + GROUND) Make the Controllable move to a given point.</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).TaskRouteToZone">CONTROLLABLE:TaskRouteToZone(Zone, Randomize, Speed, Formation)</a></td>
|
|
<td class="summary">
|
|
<p>(AIR + GROUND) Route the controllable to a given zone.</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).TaskWrappedAction">CONTROLLABLE:TaskWrappedAction(DCSCommand, Index)</a></td>
|
|
<td class="summary">
|
|
<p>Return a WrappedAction Task taking a Command.</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).WayPointExecute">CONTROLLABLE:WayPointExecute(WayPoint, WaitTime)</a></td>
|
|
<td class="summary">
|
|
<p>Executes the WayPoint plan.</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).WayPointFunction">CONTROLLABLE:WayPointFunction(WayPoint, WayPointIndex, WayPointFunction, ...)</a></td>
|
|
<td class="summary">
|
|
<p>Registers a waypoint function that will be executed when the controllable moves over the WayPoint.</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).WayPointFunctions">CONTROLLABLE.WayPointFunctions</a></td>
|
|
<td class="summary">
|
|
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).WayPointInitialize">CONTROLLABLE:WayPointInitialize(WayPoints)</a></td>
|
|
<td class="summary">
|
|
<p> Retrieve the controllable mission and allow to place function hooks within the mission waypoint plan.</p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE).WayPoints">CONTROLLABLE.WayPoints</a></td>
|
|
<td class="summary">
|
|
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="name" nowrap="nowrap"><a href="##(CONTROLLABLE)._GetController">CONTROLLABLE:_GetController()</a></td>
|
|
<td class="summary">
|
|
<p>Get the controller for the CONTROLLABLE.</p>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<h2>Global(s)</h2>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<em><a href="##(CONTROLLABLE)">#CONTROLLABLE</a></em>
|
|
<a id="CONTROLLABLE" >
|
|
<strong>CONTROLLABLE</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
|
|
|
|
</dd>
|
|
</dl>
|
|
<h2><a id="#(Controllable)" >Type <code>Controllable</code></a></h2>
|
|
|
|
<h2><a id="#(CONTROLLABLE)" >Type <code>CONTROLLABLE</code></a></h2>
|
|
|
|
<p>The CONTROLLABLE class</p>
|
|
|
|
<h3>Field(s)</h3>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<em>#string</em>
|
|
<a id="#(CONTROLLABLE).ClassName" >
|
|
<strong>CONTROLLABLE.ClassName</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).CommandDoScript" >
|
|
<strong>CONTROLLABLE:CommandDoScript(DoScript)</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>Do Script command</p>
|
|
|
|
<h3>Parameter</h3>
|
|
<ul>
|
|
<li>
|
|
|
|
<p><code><em>#string DoScript </em></code>: </p>
|
|
|
|
</li>
|
|
</ul>
|
|
<h3>Return value</h3>
|
|
|
|
<p><em><a href="##(DCSCommand)">#DCSCommand</a>:</em></p>
|
|
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).CommandStopRoute" >
|
|
<strong>CONTROLLABLE:CommandStopRoute(StopRoute, Index)</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>Perform stop route command</p>
|
|
|
|
<h3>Parameters</h3>
|
|
<ul>
|
|
<li>
|
|
|
|
<p><code><em>#boolean StopRoute </em></code>: </p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em> Index </em></code>: </p>
|
|
|
|
</li>
|
|
</ul>
|
|
<h3>Return value</h3>
|
|
|
|
<p><em><a href="Dcs.DCSTasking.Task.html##(Task)">Dcs.DCSTasking.Task#Task</a>:</em></p>
|
|
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).CommandSwitchWayPoint" >
|
|
<strong>CONTROLLABLE:CommandSwitchWayPoint(FromWayPoint, ToWayPoint)</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>Perform a switch waypoint command</p>
|
|
|
|
<h3>Parameters</h3>
|
|
<ul>
|
|
<li>
|
|
|
|
<p><code><em>#number FromWayPoint </em></code>: </p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#number ToWayPoint </em></code>: </p>
|
|
|
|
</li>
|
|
</ul>
|
|
<h3>Return value</h3>
|
|
|
|
<p><em><a href="Dcs.DCSTasking.Task.html##(Task)">Dcs.DCSTasking.Task#Task</a>:</em></p>
|
|
|
|
|
|
<h3>Usage:</h3>
|
|
<pre class="example"><code>--- This test demonstrates the use(s) of the SwitchWayPoint method of the GROUP class.
|
|
HeliGroup = GROUP:FindByName( "Helicopter" )
|
|
|
|
--- Route the helicopter back to the FARP after 60 seconds.
|
|
-- We use the SCHEDULER class to do this.
|
|
SCHEDULER:New( nil,
|
|
function( HeliGroup )
|
|
local CommandRTB = HeliGroup:CommandSwitchWayPoint( 2, 8 )
|
|
HeliGroup:SetCommand( CommandRTB )
|
|
end, { HeliGroup }, 90
|
|
)</code></pre>
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<em>#string</em>
|
|
<a id="#(CONTROLLABLE).ControllableName" >
|
|
<strong>CONTROLLABLE.ControllableName</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>The name of the controllable.</p>
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).CopyRoute" >
|
|
<strong>CONTROLLABLE:CopyRoute(Begin, End, Randomize, Radius)</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>Return the route of a controllable by using the <a href="Database.html##(DATABASE)">Database#DATABASE</a> class.</p>
|
|
|
|
<h3>Parameters</h3>
|
|
<ul>
|
|
<li>
|
|
|
|
<p><code><em>#number Begin </em></code>:
|
|
The route point from where the copy will start. The base route point is 0.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#number End </em></code>:
|
|
The route point where the copy will end. The End point is the last point - the End point. The last point has base 0.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#boolean Randomize </em></code>:
|
|
Randomization of the route, when true.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#number Radius </em></code>:
|
|
When randomization is on, the randomization is within the radius.</p>
|
|
|
|
</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<em><a href="Dcs.DCSWrapper.Controllable.html##(Controllable)">Dcs.DCSWrapper.Controllable#Controllable</a></em>
|
|
<a id="#(CONTROLLABLE).DCSControllable" >
|
|
<strong>CONTROLLABLE.DCSControllable</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>The DCS controllable class.</p>
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).EnRouteTaskAWACS" >
|
|
<strong>CONTROLLABLE:EnRouteTaskAWACS()</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>(AIR) Aircraft will act as an AWACS for friendly units (will provide them with information about contacts).</p>
|
|
|
|
|
|
<p>No parameters.</p>
|
|
|
|
<h3>Return value</h3>
|
|
|
|
<p><em><a href="Dcs.DCSTasking.Task.html##(Task)">Dcs.DCSTasking.Task#Task</a>:</em>
|
|
The DCS task structure.</p>
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).EnRouteTaskEWR" >
|
|
<strong>CONTROLLABLE:EnRouteTaskEWR()</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>(GROUND) Ground unit (EW-radar) will act as an EWR for friendly units (will provide them with information about contacts).</p>
|
|
|
|
|
|
<p>No parameters.</p>
|
|
|
|
<h3>Return value</h3>
|
|
|
|
<p><em><a href="Dcs.DCSTasking.Task.html##(Task)">Dcs.DCSTasking.Task#Task</a>:</em>
|
|
The DCS task structure.</p>
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).EnRouteTaskEngageGroup" >
|
|
<strong>CONTROLLABLE:EnRouteTaskEngageGroup(AttackGroup, Priority, WeaponType, WeaponExpend, AttackQty, Direction, Altitude, AttackQtyLimit)</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>(AIR) Engaging a controllable.</p>
|
|
|
|
|
|
<p>The task does not assign the target controllable to the unit/controllable to attack now; it just allows the unit/controllable to engage the target controllable as well as other assigned targets.</p>
|
|
|
|
<h3>Parameters</h3>
|
|
<ul>
|
|
<li>
|
|
|
|
<p><code><em><a href="Wrapper.Controllable.html##(CONTROLLABLE)">Wrapper.Controllable#CONTROLLABLE</a> AttackGroup </em></code>:
|
|
The Controllable to be attacked.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#number Priority </em></code>:
|
|
All en-route tasks have the priority parameter. This is a number (less value - higher priority) that determines actions related to what task will be performed first. </p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#number WeaponType </em></code>:
|
|
(optional) Bitmask of weapon types those allowed to use. If parameter is not defined that means no limits on weapon usage.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em><a href="Dcs.DCSTypes.html##(AI.Task.WeaponExpend)">Dcs.DCSTypes#AI.Task.WeaponExpend</a> WeaponExpend </em></code>:
|
|
(optional) Determines how much weapon will be released at each attack. If parameter is not defined the unit / controllable will choose expend on its own discretion.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#number AttackQty </em></code>:
|
|
(optional) This parameter limits maximal quantity of attack. The aicraft/controllable will not make more attack than allowed even if the target controllable not destroyed and the aicraft/controllable still have ammo. If not defined the aircraft/controllable will attack target until it will be destroyed or until the aircraft/controllable will run out of ammo.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em><a href="Dcs.DCSTypes.html##(Azimuth)">Dcs.DCSTypes#Azimuth</a> Direction </em></code>:
|
|
(optional) Desired ingress direction from the target to the attacking aircraft. Controllable/aircraft will make its attacks from the direction. Of course if there is no way to attack from the direction due the terrain controllable/aircraft will choose another direction.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em><a href="Dcs.DCSTypes.html##(Distance)">Dcs.DCSTypes#Distance</a> Altitude </em></code>:
|
|
(optional) Desired attack start altitude. Controllable/aircraft will make its attacks from the altitude. If the altitude is too low or too high to use weapon aircraft/controllable will choose closest altitude to the desired attack start altitude. If the desired altitude is defined controllable/aircraft will not attack from safe altitude.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#boolean AttackQtyLimit </em></code>:
|
|
(optional) The flag determines how to interpret attackQty parameter. If the flag is true then attackQty is a limit on maximal attack quantity for "AttackControllable" and "AttackUnit" tasks. If the flag is false then attackQty is a desired attack quantity for "Bombing" and "BombingRunway" tasks.</p>
|
|
|
|
</li>
|
|
</ul>
|
|
<h3>Return value</h3>
|
|
|
|
<p><em><a href="Dcs.DCSTasking.Task.html##(Task)">Dcs.DCSTasking.Task#Task</a>:</em>
|
|
The DCS task structure.</p>
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).EnRouteTaskEngageTargets" >
|
|
<strong>CONTROLLABLE:EnRouteTaskEngageTargets(Distance, TargetTypes, Priority)</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>(AIR) Engaging targets of defined types.</p>
|
|
|
|
<h3>Parameters</h3>
|
|
<ul>
|
|
<li>
|
|
|
|
<p><code><em><a href="Dcs.DCSTypes.html##(Distance)">Dcs.DCSTypes#Distance</a> Distance </em></code>:
|
|
Maximal distance from the target to a route leg. If the target is on a greater distance it will be ignored. </p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em><a href="Dcs.DCSTypes.html##(AttributeNameArray)">Dcs.DCSTypes#AttributeNameArray</a> TargetTypes </em></code>:
|
|
Array of target categories allowed to engage. </p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#number Priority </em></code>:
|
|
All enroute tasks have the priority parameter. This is a number (less value - higher priority) that determines actions related to what task will be performed first. </p>
|
|
|
|
</li>
|
|
</ul>
|
|
<h3>Return value</h3>
|
|
|
|
<p><em><a href="Dcs.DCSTasking.Task.html##(Task)">Dcs.DCSTasking.Task#Task</a>:</em>
|
|
The DCS task structure.</p>
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).EnRouteTaskEngageUnit" >
|
|
<strong>CONTROLLABLE:EnRouteTaskEngageUnit(EngageUnit, Priority, GroupAttack, WeaponExpend, AttackQty, Direction, Altitude, Visible, ControllableAttack)</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>(AIR) Search and attack the Unit.</p>
|
|
|
|
<h3>Parameters</h3>
|
|
<ul>
|
|
<li>
|
|
|
|
<p><code><em><a href="Wrapper.Unit.html##(UNIT)">Wrapper.Unit#UNIT</a> EngageUnit </em></code>:
|
|
The UNIT.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#number Priority </em></code>:
|
|
(optional) All en-route tasks have the priority parameter. This is a number (less value - higher priority) that determines actions related to what task will be performed first. </p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#boolean GroupAttack </em></code>:
|
|
(optional) If true, all units in the group will attack the Unit when found.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em><a href="Dcs.DCSTypes.html##(AI.Task.WeaponExpend)">Dcs.DCSTypes#AI.Task.WeaponExpend</a> WeaponExpend </em></code>:
|
|
(optional) Determines how much weapon will be released at each attack. If parameter is not defined the unit / controllable will choose expend on its own discretion.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#number AttackQty </em></code>:
|
|
(optional) This parameter limits maximal quantity of attack. The aicraft/controllable will not make more attack than allowed even if the target controllable not destroyed and the aicraft/controllable still have ammo. If not defined the aircraft/controllable will attack target until it will be destroyed or until the aircraft/controllable will run out of ammo.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em><a href="Dcs.DCSTypes.html##(Azimuth)">Dcs.DCSTypes#Azimuth</a> Direction </em></code>:
|
|
(optional) Desired ingress direction from the target to the attacking aircraft. Controllable/aircraft will make its attacks from the direction. Of course if there is no way to attack from the direction due the terrain controllable/aircraft will choose another direction.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em><a href="Dcs.DCSTypes.html##(Distance)">Dcs.DCSTypes#Distance</a> Altitude </em></code>:
|
|
(optional) Desired altitude to perform the unit engagement.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#boolean Visible </em></code>:
|
|
(optional) Unit must be visible.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#boolean ControllableAttack </em></code>:
|
|
(optional) Flag indicates that the target must be engaged by all aircrafts of the controllable. Has effect only if the task is assigned to a controllable, not to a single aircraft.</p>
|
|
|
|
</li>
|
|
</ul>
|
|
<h3>Return value</h3>
|
|
|
|
<p><em><a href="Dcs.DCSTasking.Task.html##(Task)">Dcs.DCSTasking.Task#Task</a>:</em>
|
|
The DCS task structure.</p>
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).EnRouteTaskFAC" >
|
|
<strong>CONTROLLABLE:EnRouteTaskFAC(Radius, Priority)</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>(AIR + GROUND) The task makes the controllable/unit a FAC and lets the FAC to choose a targets (enemy ground controllable) around as well as other assigned targets.</p>
|
|
|
|
|
|
<p>The killer is player-controlled allied CAS-aircraft that is in contact with the FAC.
|
|
If the task is assigned to the controllable lead unit will be a FAC. </p>
|
|
|
|
<h3>Parameters</h3>
|
|
<ul>
|
|
<li>
|
|
|
|
<p><code><em><a href="Dcs.DCSTypes.html##(Distance)">Dcs.DCSTypes#Distance</a> Radius </em></code>:
|
|
The maximal distance from the FAC to a target.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#number Priority </em></code>:
|
|
All en-route tasks have the priority parameter. This is a number (less value - higher priority) that determines actions related to what task will be performed first. </p>
|
|
|
|
</li>
|
|
</ul>
|
|
<h3>Return value</h3>
|
|
|
|
<p><em><a href="Dcs.DCSTasking.Task.html##(Task)">Dcs.DCSTasking.Task#Task</a>:</em>
|
|
The DCS task structure.</p>
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).EnRouteTaskFAC_EngageGroup" >
|
|
<strong>CONTROLLABLE:EnRouteTaskFAC_EngageGroup(AttackGroup, Priority, WeaponType, Designation, Datalink)</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>(AIR + GROUND) The task makes the controllable/unit a FAC and lets the FAC to choose the target (enemy ground controllable) as well as other assigned targets.</p>
|
|
|
|
|
|
<p>The killer is player-controlled allied CAS-aircraft that is in contact with the FAC.
|
|
If the task is assigned to the controllable lead unit will be a FAC. </p>
|
|
|
|
<h3>Parameters</h3>
|
|
<ul>
|
|
<li>
|
|
|
|
<p><code><em><a href="Wrapper.Controllable.html##(CONTROLLABLE)">Wrapper.Controllable#CONTROLLABLE</a> AttackGroup </em></code>:
|
|
Target CONTROLLABLE.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#number Priority </em></code>:
|
|
All en-route tasks have the priority parameter. This is a number (less value - higher priority) that determines actions related to what task will be performed first. </p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#number WeaponType </em></code>:
|
|
Bitmask of weapon types those allowed to use. If parameter is not defined that means no limits on weapon usage. </p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em><a href="Dcs.DCSTypes.html##(AI.Task.Designation)">Dcs.DCSTypes#AI.Task.Designation</a> Designation </em></code>:
|
|
(optional) Designation type.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#boolean Datalink </em></code>:
|
|
(optional) Allows to use datalink to send the target information to attack aircraft. Enabled by default. </p>
|
|
|
|
</li>
|
|
</ul>
|
|
<h3>Return value</h3>
|
|
|
|
<p><em><a href="Dcs.DCSTasking.Task.html##(Task)">Dcs.DCSTasking.Task#Task</a>:</em>
|
|
The DCS task structure.</p>
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).EnRouteTaskTanker" >
|
|
<strong>CONTROLLABLE:EnRouteTaskTanker()</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>(AIR) Aircraft will act as a tanker for friendly units.</p>
|
|
|
|
|
|
<p>No parameters.</p>
|
|
|
|
<h3>Return value</h3>
|
|
|
|
<p><em><a href="Dcs.DCSTasking.Task.html##(Task)">Dcs.DCSTasking.Task#Task</a>:</em>
|
|
The DCS task structure.</p>
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).GetDetectedTargets" >
|
|
<strong>CONTROLLABLE:GetDetectedTargets(DetectVisual, DetectOptical, DetectRadar, DetectIRST, DetectRWR, DetectDLINK)</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>Return the detected targets of the controllable.</p>
|
|
|
|
|
|
<p>The optional parametes specify the detection methods that can be applied.
|
|
If no detection method is given, the detection will use all the available methods by default.</p>
|
|
|
|
<h3>Parameters</h3>
|
|
<ul>
|
|
<li>
|
|
|
|
<p><code><em>#boolean DetectVisual </em></code>:
|
|
(optional)</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#boolean DetectOptical </em></code>:
|
|
(optional)</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#boolean DetectRadar </em></code>:
|
|
(optional)</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#boolean DetectIRST </em></code>:
|
|
(optional)</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#boolean DetectRWR </em></code>:
|
|
(optional)</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#boolean DetectDLINK </em></code>:
|
|
(optional)</p>
|
|
|
|
</li>
|
|
</ul>
|
|
<h3>Return value</h3>
|
|
|
|
<p><em>#table:</em>
|
|
DetectedTargets</p>
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).GetLife" >
|
|
<strong>CONTROLLABLE:GetLife()</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>Returns the health.</p>
|
|
|
|
|
|
<p>Dead controllables have health <= 1.0.</p>
|
|
|
|
<h3>Return values</h3>
|
|
<ol>
|
|
<li>
|
|
|
|
<p><em>#number:</em>
|
|
The controllable health value (unit or group average).</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><em>#nil:</em>
|
|
The controllable is not existing or alive. </p>
|
|
|
|
</li>
|
|
</ol>
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).GetTaskMission" >
|
|
<strong>CONTROLLABLE:GetTaskMission()</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>Return the mission template of the controllable.</p>
|
|
|
|
<h3>Return value</h3>
|
|
|
|
<p><em>#table:</em>
|
|
The MissionTemplate
|
|
TODO: Rework the method how to retrieve a template ...</p>
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).GetTaskRoute" >
|
|
<strong>CONTROLLABLE:GetTaskRoute()</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>Return the mission route of the controllable.</p>
|
|
|
|
<h3>Return value</h3>
|
|
|
|
<p><em>#table:</em>
|
|
The mission route defined by points.</p>
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).GetUnits" >
|
|
<strong>CONTROLLABLE:GetUnits()</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>Returns the UNITs wrappers of the DCS Units of the Controllable (default is a GROUP).</p>
|
|
|
|
<h3>Return value</h3>
|
|
|
|
<p><em><a href="##(list)">#list</a>:</em>
|
|
Wrapper.Unit#UNIT> The UNITs wrappers.</p>
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).GetWayPoints" >
|
|
<strong>CONTROLLABLE:GetWayPoints()</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>Get the current WayPoints set with the WayPoint functions( Note that the WayPoints can be nil, although there ARE waypoints).</p>
|
|
|
|
<h3>Return value</h3>
|
|
|
|
<p><em>#table:</em>
|
|
WayPoints If WayPoints is given, then return the WayPoints structure.</p>
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).IsTargetDetected" >
|
|
<strong>CONTROLLABLE:IsTargetDetected(DCSObject)</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
|
|
|
|
<h3>Parameter</h3>
|
|
<ul>
|
|
<li>
|
|
|
|
<p><code><em> DCSObject </em></code>: </p>
|
|
|
|
</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).New" >
|
|
<strong>CONTROLLABLE:New(ControllableName)</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>Create a new CONTROLLABLE from a DCSControllable</p>
|
|
|
|
<h3>Parameter</h3>
|
|
<ul>
|
|
<li>
|
|
|
|
<p><code><em><a href="Dcs.DCSWrapper.Controllable.html##(Controllable)">Dcs.DCSWrapper.Controllable#Controllable</a> ControllableName </em></code>:
|
|
The DCS Controllable name</p>
|
|
|
|
</li>
|
|
</ul>
|
|
<h3>Return value</h3>
|
|
|
|
<p><em><a href="##(CONTROLLABLE)">#CONTROLLABLE</a>:</em>
|
|
self</p>
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).OptionROEHoldFire" >
|
|
<strong>CONTROLLABLE:OptionROEHoldFire()</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>Holding weapons.</p>
|
|
|
|
<h3>Return value</h3>
|
|
|
|
<p><em><a href="Wrapper.Controllable.html##(CONTROLLABLE)">Wrapper.Controllable#CONTROLLABLE</a>:</em>
|
|
self</p>
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).OptionROEHoldFirePossible" >
|
|
<strong>CONTROLLABLE:OptionROEHoldFirePossible()</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>Can the CONTROLLABLE hold their weapons?</p>
|
|
|
|
<h3>Return value</h3>
|
|
|
|
<p><em>#boolean:</em></p>
|
|
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).OptionROEOpenFire" >
|
|
<strong>CONTROLLABLE:OptionROEOpenFire()</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>Openfire.</p>
|
|
|
|
<h3>Return value</h3>
|
|
|
|
<p><em><a href="##(CONTROLLABLE)">#CONTROLLABLE</a>:</em>
|
|
self</p>
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).OptionROEOpenFirePossible" >
|
|
<strong>CONTROLLABLE:OptionROEOpenFirePossible()</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>Can the CONTROLLABLE attack designated targets?</p>
|
|
|
|
<h3>Return value</h3>
|
|
|
|
<p><em>#boolean:</em></p>
|
|
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).OptionROEReturnFire" >
|
|
<strong>CONTROLLABLE:OptionROEReturnFire()</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>Return fire.</p>
|
|
|
|
<h3>Return value</h3>
|
|
|
|
<p><em><a href="##(CONTROLLABLE)">#CONTROLLABLE</a>:</em>
|
|
self</p>
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).OptionROEReturnFirePossible" >
|
|
<strong>CONTROLLABLE:OptionROEReturnFirePossible()</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>Can the CONTROLLABLE attack returning on enemy fire?</p>
|
|
|
|
<h3>Return value</h3>
|
|
|
|
<p><em>#boolean:</em></p>
|
|
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).OptionROEWeaponFree" >
|
|
<strong>CONTROLLABLE:OptionROEWeaponFree()</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>Weapon free.</p>
|
|
|
|
<h3>Return value</h3>
|
|
|
|
<p><em><a href="##(CONTROLLABLE)">#CONTROLLABLE</a>:</em>
|
|
self</p>
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).OptionROEWeaponFreePossible" >
|
|
<strong>CONTROLLABLE:OptionROEWeaponFreePossible()</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>Can the CONTROLLABLE attack targets of opportunity?</p>
|
|
|
|
<h3>Return value</h3>
|
|
|
|
<p><em>#boolean:</em></p>
|
|
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).OptionROTEvadeFire" >
|
|
<strong>CONTROLLABLE:OptionROTEvadeFire()</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>Evade on fire.</p>
|
|
|
|
<h3>Return value</h3>
|
|
|
|
<p><em><a href="##(CONTROLLABLE)">#CONTROLLABLE</a>:</em>
|
|
self</p>
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).OptionROTEvadeFirePossible" >
|
|
<strong>CONTROLLABLE:OptionROTEvadeFirePossible()</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>Can the CONTROLLABLE evade on enemy fire?</p>
|
|
|
|
<h3>Return value</h3>
|
|
|
|
<p><em>#boolean:</em></p>
|
|
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).OptionROTNoReaction" >
|
|
<strong>CONTROLLABLE:OptionROTNoReaction()</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>No evasion on enemy threats.</p>
|
|
|
|
<h3>Return value</h3>
|
|
|
|
<p><em><a href="##(CONTROLLABLE)">#CONTROLLABLE</a>:</em>
|
|
self</p>
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).OptionROTNoReactionPossible" >
|
|
<strong>CONTROLLABLE:OptionROTNoReactionPossible()</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>Can the CONTROLLABLE ignore enemy fire?</p>
|
|
|
|
<h3>Return value</h3>
|
|
|
|
<p><em>#boolean:</em></p>
|
|
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).OptionROTPassiveDefense" >
|
|
<strong>CONTROLLABLE:OptionROTPassiveDefense()</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>Evasion passive defense.</p>
|
|
|
|
<h3>Return value</h3>
|
|
|
|
<p><em><a href="##(CONTROLLABLE)">#CONTROLLABLE</a>:</em>
|
|
self</p>
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).OptionROTPassiveDefensePossible" >
|
|
<strong>CONTROLLABLE:OptionROTPassiveDefensePossible()</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>Can the CONTROLLABLE evade using passive defenses?</p>
|
|
|
|
<h3>Return value</h3>
|
|
|
|
<p><em>#boolean:</em></p>
|
|
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).OptionROTVertical" >
|
|
<strong>CONTROLLABLE:OptionROTVertical()</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>Evade on fire using vertical manoeuvres.</p>
|
|
|
|
<h3>Return value</h3>
|
|
|
|
<p><em><a href="##(CONTROLLABLE)">#CONTROLLABLE</a>:</em>
|
|
self</p>
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).OptionROTVerticalPossible" >
|
|
<strong>CONTROLLABLE:OptionROTVerticalPossible()</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>Can the CONTROLLABLE evade on fire using vertical manoeuvres?</p>
|
|
|
|
<h3>Return value</h3>
|
|
|
|
<p><em>#boolean:</em></p>
|
|
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).PopCurrentTask" >
|
|
<strong>CONTROLLABLE:PopCurrentTask()</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>Popping current Task from the controllable.</p>
|
|
|
|
<h3>Return value</h3>
|
|
|
|
<p><em><a href="Wrapper.Controllable.html##(CONTROLLABLE)">Wrapper.Controllable#CONTROLLABLE</a>:</em>
|
|
self</p>
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).PushTask" >
|
|
<strong>CONTROLLABLE:PushTask(DCSTask, WaitTime)</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>Pushing Task on the queue from the controllable.</p>
|
|
|
|
<h3>Parameters</h3>
|
|
<ul>
|
|
<li>
|
|
|
|
<p><code><em> DCSTask </em></code>: </p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em> WaitTime </em></code>: </p>
|
|
|
|
</li>
|
|
</ul>
|
|
<h3>Return value</h3>
|
|
|
|
<p><em><a href="Wrapper.Controllable.html##(CONTROLLABLE)">Wrapper.Controllable#CONTROLLABLE</a>:</em>
|
|
self</p>
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).Route" >
|
|
<strong>CONTROLLABLE:Route(GoPoints)</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>Make the controllable to follow a given route.</p>
|
|
|
|
<h3>Parameter</h3>
|
|
<ul>
|
|
<li>
|
|
|
|
<p><code><em>#table GoPoints </em></code>:
|
|
A table of Route Points.</p>
|
|
|
|
</li>
|
|
</ul>
|
|
<h3>Return value</h3>
|
|
|
|
<p><em><a href="##(CONTROLLABLE)">#CONTROLLABLE</a>:</em>
|
|
self</p>
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).RouteReturnToAirbase" >
|
|
<strong>CONTROLLABLE:RouteReturnToAirbase(ReturnAirbase, Speed)</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>(AIR) Return the Controllable to an <a href="Airbase.html##(AIRBASE)">Airbase#AIRBASE</a>
|
|
A speed can be given in km/h.</p>
|
|
|
|
|
|
<p>A given formation can be given.</p>
|
|
|
|
<h3>Parameters</h3>
|
|
<ul>
|
|
<li>
|
|
|
|
<p><code><em><a href="Wrapper.Airbase.html##(AIRBASE)">Wrapper.Airbase#AIRBASE</a> ReturnAirbase </em></code>:
|
|
The <a href="Airbase.html##(AIRBASE)">Airbase#AIRBASE</a> to return to.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#number Speed </em></code>:
|
|
(optional) The speed.</p>
|
|
|
|
</li>
|
|
</ul>
|
|
<h3>Return value</h3>
|
|
|
|
<p><em>#string:</em>
|
|
The route</p>
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).SetCommand" >
|
|
<strong>CONTROLLABLE:SetCommand(DCSCommand)</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>Executes a command action</p>
|
|
|
|
<h3>Parameter</h3>
|
|
<ul>
|
|
<li>
|
|
|
|
<p><code><em><a href="Dcs.DCSCommand.html##(Command)">Dcs.DCSCommand#Command</a> DCSCommand </em></code>: </p>
|
|
|
|
</li>
|
|
</ul>
|
|
<h3>Return value</h3>
|
|
|
|
<p><em><a href="##(CONTROLLABLE)">#CONTROLLABLE</a>:</em>
|
|
self</p>
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).SetTask" >
|
|
<strong>CONTROLLABLE:SetTask(DCSTask, WaitTime)</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>Clearing the Task Queue and Setting the Task on the queue from the controllable.</p>
|
|
|
|
<h3>Parameters</h3>
|
|
<ul>
|
|
<li>
|
|
|
|
<p><code><em> DCSTask </em></code>: </p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em> WaitTime </em></code>: </p>
|
|
|
|
</li>
|
|
</ul>
|
|
<h3>Return value</h3>
|
|
|
|
<p><em><a href="Wrapper.Controllable.html##(CONTROLLABLE)">Wrapper.Controllable#CONTROLLABLE</a>:</em>
|
|
self</p>
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).TaskAttackGroup" >
|
|
<strong>CONTROLLABLE:TaskAttackGroup(AttackGroup, WeaponType, WeaponExpend, AttackQty, Direction, Altitude, AttackQtyLimit)</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>(AIR) Attack a Controllable.</p>
|
|
|
|
<h3>Parameters</h3>
|
|
<ul>
|
|
<li>
|
|
|
|
<p><code><em><a href="Wrapper.Controllable.html##(CONTROLLABLE)">Wrapper.Controllable#CONTROLLABLE</a> AttackGroup </em></code>:
|
|
The Controllable to be attacked.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#number WeaponType </em></code>:
|
|
(optional) Bitmask of weapon types those allowed to use. If parameter is not defined that means no limits on weapon usage.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em><a href="Dcs.DCSTypes.html##(AI.Task.WeaponExpend)">Dcs.DCSTypes#AI.Task.WeaponExpend</a> WeaponExpend </em></code>:
|
|
(optional) Determines how much weapon will be released at each attack. If parameter is not defined the unit / controllable will choose expend on its own discretion.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#number AttackQty </em></code>:
|
|
(optional) This parameter limits maximal quantity of attack. The aicraft/controllable will not make more attack than allowed even if the target controllable not destroyed and the aicraft/controllable still have ammo. If not defined the aircraft/controllable will attack target until it will be destroyed or until the aircraft/controllable will run out of ammo.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em><a href="Dcs.DCSTypes.html##(Azimuth)">Dcs.DCSTypes#Azimuth</a> Direction </em></code>:
|
|
(optional) Desired ingress direction from the target to the attacking aircraft. Controllable/aircraft will make its attacks from the direction. Of course if there is no way to attack from the direction due the terrain controllable/aircraft will choose another direction.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em><a href="Dcs.DCSTypes.html##(Distance)">Dcs.DCSTypes#Distance</a> Altitude </em></code>:
|
|
(optional) Desired attack start altitude. Controllable/aircraft will make its attacks from the altitude. If the altitude is too low or too high to use weapon aircraft/controllable will choose closest altitude to the desired attack start altitude. If the desired altitude is defined controllable/aircraft will not attack from safe altitude.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#boolean AttackQtyLimit </em></code>:
|
|
(optional) The flag determines how to interpret attackQty parameter. If the flag is true then attackQty is a limit on maximal attack quantity for "AttackControllable" and "AttackUnit" tasks. If the flag is false then attackQty is a desired attack quantity for "Bombing" and "BombingRunway" tasks.</p>
|
|
|
|
</li>
|
|
</ul>
|
|
<h3>Return value</h3>
|
|
|
|
<p><em><a href="Dcs.DCSTasking.Task.html##(Task)">Dcs.DCSTasking.Task#Task</a>:</em>
|
|
The DCS task structure.</p>
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).TaskAttackMapObject" >
|
|
<strong>CONTROLLABLE:TaskAttackMapObject(Vec2, WeaponType, WeaponExpend, AttackQty, Direction, ControllableAttack)</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>(AIR) Attacking the map object (building, structure, e.t.c).</p>
|
|
|
|
<h3>Parameters</h3>
|
|
<ul>
|
|
<li>
|
|
|
|
<p><code><em><a href="Dcs.DCSTypes.html##(Vec2)">Dcs.DCSTypes#Vec2</a> Vec2 </em></code>:
|
|
2D-coordinates of the point the map object is closest to. The distance between the point and the map object must not be greater than 2000 meters. Object id is not used here because Mission Editor doesn't support map object identificators.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#number WeaponType </em></code>:
|
|
(optional) Bitmask of weapon types those allowed to use. If parameter is not defined that means no limits on weapon usage.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em><a href="Dcs.DCSTypes.html##(AI.Task.WeaponExpend)">Dcs.DCSTypes#AI.Task.WeaponExpend</a> WeaponExpend </em></code>:
|
|
(optional) Determines how much weapon will be released at each attack. If parameter is not defined the unit / controllable will choose expend on its own discretion.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#number AttackQty </em></code>:
|
|
(optional) This parameter limits maximal quantity of attack. The aicraft/controllable will not make more attack than allowed even if the target controllable not destroyed and the aicraft/controllable still have ammo. If not defined the aircraft/controllable will attack target until it will be destroyed or until the aircraft/controllable will run out of ammo.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em><a href="Dcs.DCSTypes.html##(Azimuth)">Dcs.DCSTypes#Azimuth</a> Direction </em></code>:
|
|
(optional) Desired ingress direction from the target to the attacking aircraft. Controllable/aircraft will make its attacks from the direction. Of course if there is no way to attack from the direction due the terrain controllable/aircraft will choose another direction.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#boolean ControllableAttack </em></code>:
|
|
(optional) Flag indicates that the target must be engaged by all aircrafts of the controllable. Has effect only if the task is assigned to a controllable, not to a single aircraft.</p>
|
|
|
|
</li>
|
|
</ul>
|
|
<h3>Return value</h3>
|
|
|
|
<p><em><a href="Dcs.DCSTasking.Task.html##(Task)">Dcs.DCSTasking.Task#Task</a>:</em>
|
|
The DCS task structure.</p>
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).TaskAttackUnit" >
|
|
<strong>CONTROLLABLE:TaskAttackUnit(AttackUnit, GroupAttack, WeaponExpend, AttackQty, Direction, Altitude, Visible, ControllableAttack)</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>(AIR) Attack the Unit.</p>
|
|
|
|
<h3>Parameters</h3>
|
|
<ul>
|
|
<li>
|
|
|
|
<p><code><em><a href="Wrapper.Unit.html##(UNIT)">Wrapper.Unit#UNIT</a> AttackUnit </em></code>:
|
|
The UNIT.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#boolean GroupAttack </em></code>:
|
|
(optional) If true, all units in the group will attack the Unit when found.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em><a href="Dcs.DCSTypes.html##(AI.Task.WeaponExpend)">Dcs.DCSTypes#AI.Task.WeaponExpend</a> WeaponExpend </em></code>:
|
|
(optional) Determines how much weapon will be released at each attack. If parameter is not defined the unit / controllable will choose expend on its own discretion.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#number AttackQty </em></code>:
|
|
(optional) This parameter limits maximal quantity of attack. The aicraft/controllable will not make more attack than allowed even if the target controllable not destroyed and the aicraft/controllable still have ammo. If not defined the aircraft/controllable will attack target until it will be destroyed or until the aircraft/controllable will run out of ammo.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em><a href="Dcs.DCSTypes.html##(Azimuth)">Dcs.DCSTypes#Azimuth</a> Direction </em></code>:
|
|
(optional) Desired ingress direction from the target to the attacking aircraft. Controllable/aircraft will make its attacks from the direction. Of course if there is no way to attack from the direction due the terrain controllable/aircraft will choose another direction.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em><a href="Dcs.DCSTypes.html##(Distance)">Dcs.DCSTypes#Distance</a> Altitude </em></code>:
|
|
(optional) Desired altitude to perform the unit engagement.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#boolean Visible </em></code>:
|
|
(optional) Unit must be visible.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#boolean ControllableAttack </em></code>:
|
|
(optional) Flag indicates that the target must be engaged by all aircrafts of the controllable. Has effect only if the task is assigned to a controllable, not to a single aircraft.</p>
|
|
|
|
</li>
|
|
</ul>
|
|
<h3>Return value</h3>
|
|
|
|
<p><em><a href="Dcs.DCSTasking.Task.html##(Task)">Dcs.DCSTasking.Task#Task</a>:</em>
|
|
The DCS task structure.</p>
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).TaskBombing" >
|
|
<strong>CONTROLLABLE:TaskBombing(Vec2, WeaponType, WeaponExpend, AttackQty, Direction, ControllableAttack)</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>(AIR) Delivering weapon at the point on the ground. </p>
|
|
|
|
<h3>Parameters</h3>
|
|
<ul>
|
|
<li>
|
|
|
|
<p><code><em><a href="Dcs.DCSTypes.html##(Vec2)">Dcs.DCSTypes#Vec2</a> Vec2 </em></code>:
|
|
2D-coordinates of the point to deliver weapon at.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#number WeaponType </em></code>:
|
|
(optional) Bitmask of weapon types those allowed to use. If parameter is not defined that means no limits on weapon usage.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em><a href="Dcs.DCSTypes.html##(AI.Task.WeaponExpend)">Dcs.DCSTypes#AI.Task.WeaponExpend</a> WeaponExpend </em></code>:
|
|
(optional) Determines how much weapon will be released at each attack. If parameter is not defined the unit / controllable will choose expend on its own discretion.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#number AttackQty </em></code>:
|
|
(optional) Desired quantity of passes. The parameter is not the same in AttackControllable and AttackUnit tasks. </p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em><a href="Dcs.DCSTypes.html##(Azimuth)">Dcs.DCSTypes#Azimuth</a> Direction </em></code>:
|
|
(optional) Desired ingress direction from the target to the attacking aircraft. Controllable/aircraft will make its attacks from the direction. Of course if there is no way to attack from the direction due the terrain controllable/aircraft will choose another direction.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#boolean ControllableAttack </em></code>:
|
|
(optional) Flag indicates that the target must be engaged by all aircrafts of the controllable. Has effect only if the task is assigned to a controllable, not to a single aircraft.</p>
|
|
|
|
</li>
|
|
</ul>
|
|
<h3>Return value</h3>
|
|
|
|
<p><em><a href="Dcs.DCSTasking.Task.html##(Task)">Dcs.DCSTasking.Task#Task</a>:</em>
|
|
The DCS task structure.</p>
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).TaskBombingRunway" >
|
|
<strong>CONTROLLABLE:TaskBombingRunway(Airbase, WeaponType, WeaponExpend, AttackQty, Direction, ControllableAttack)</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>(AIR) Delivering weapon on the runway.</p>
|
|
|
|
<h3>Parameters</h3>
|
|
<ul>
|
|
<li>
|
|
|
|
<p><code><em><a href="Wrapper.Airbase.html##(AIRBASE)">Wrapper.Airbase#AIRBASE</a> Airbase </em></code>:
|
|
Airbase to attack.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#number WeaponType </em></code>:
|
|
(optional) Bitmask of weapon types those allowed to use. If parameter is not defined that means no limits on weapon usage.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em><a href="Dcs.DCSTypes.html##(AI.Task.WeaponExpend)">Dcs.DCSTypes#AI.Task.WeaponExpend</a> WeaponExpend </em></code>:
|
|
(optional) Determines how much weapon will be released at each attack. If parameter is not defined the unit / controllable will choose expend on its own discretion.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#number AttackQty </em></code>:
|
|
(optional) This parameter limits maximal quantity of attack. The aicraft/controllable will not make more attack than allowed even if the target controllable not destroyed and the aicraft/controllable still have ammo. If not defined the aircraft/controllable will attack target until it will be destroyed or until the aircraft/controllable will run out of ammo.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em><a href="Dcs.DCSTypes.html##(Azimuth)">Dcs.DCSTypes#Azimuth</a> Direction </em></code>:
|
|
(optional) Desired ingress direction from the target to the attacking aircraft. Controllable/aircraft will make its attacks from the direction. Of course if there is no way to attack from the direction due the terrain controllable/aircraft will choose another direction.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#boolean ControllableAttack </em></code>:
|
|
(optional) Flag indicates that the target must be engaged by all aircrafts of the controllable. Has effect only if the task is assigned to a controllable, not to a single aircraft.</p>
|
|
|
|
</li>
|
|
</ul>
|
|
<h3>Return value</h3>
|
|
|
|
<p><em><a href="Dcs.DCSTasking.Task.html##(Task)">Dcs.DCSTasking.Task#Task</a>:</em>
|
|
The DCS task structure.</p>
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).TaskCombo" >
|
|
<strong>CONTROLLABLE:TaskCombo(DCSTasks)</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>Return a Combo Task taking an array of Tasks.</p>
|
|
|
|
<h3>Parameter</h3>
|
|
<ul>
|
|
<li>
|
|
|
|
<p><code><em><a href="Dcs.DCSTasking.Task.html##(TaskArray)">Dcs.DCSTasking.Task#TaskArray</a> DCSTasks </em></code>:
|
|
Array of <a href="DCSTasking.Task.html##(Task)">DCSTasking.Task#Task</a></p>
|
|
|
|
</li>
|
|
</ul>
|
|
<h3>Return value</h3>
|
|
|
|
<p><em><a href="Dcs.DCSTasking.Task.html##(Task)">Dcs.DCSTasking.Task#Task</a>:</em></p>
|
|
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).TaskCondition" >
|
|
<strong>CONTROLLABLE:TaskCondition(time, userFlag, userFlagValue, condition, duration, lastWayPoint)</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>Return a condition section for a controlled task.</p>
|
|
|
|
<h3>Parameters</h3>
|
|
<ul>
|
|
<li>
|
|
|
|
<p><code><em><a href="Dcs.DCSTime.html##(Time)">Dcs.DCSTime#Time</a> time </em></code>: </p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#string userFlag </em></code>: </p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#boolean userFlagValue </em></code>: </p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#string condition </em></code>: </p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em><a href="Dcs.DCSTime.html##(Time)">Dcs.DCSTime#Time</a> duration </em></code>: </p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#number lastWayPoint </em></code>:
|
|
return Dcs.DCSTasking.Task#Task</p>
|
|
|
|
</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).TaskControlled" >
|
|
<strong>CONTROLLABLE:TaskControlled(DCSTask, DCSStopCondition)</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>Return a Controlled Task taking a Task and a TaskCondition.</p>
|
|
|
|
<h3>Parameters</h3>
|
|
<ul>
|
|
<li>
|
|
|
|
<p><code><em><a href="Dcs.DCSTasking.Task.html##(Task)">Dcs.DCSTasking.Task#Task</a> DCSTask </em></code>: </p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em><a href="##(DCSStopCondition)">#DCSStopCondition</a> DCSStopCondition </em></code>: </p>
|
|
|
|
</li>
|
|
</ul>
|
|
<h3>Return value</h3>
|
|
|
|
<p><em><a href="Dcs.DCSTasking.Task.html##(Task)">Dcs.DCSTasking.Task#Task</a>:</em></p>
|
|
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).TaskEmbarkToTransport" >
|
|
<strong>CONTROLLABLE:TaskEmbarkToTransport(Point, Radius)</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>Move to a defined Vec2 Point, and embark to a controllable when arrived within a defined Radius.</p>
|
|
|
|
<h3>Parameters</h3>
|
|
<ul>
|
|
<li>
|
|
|
|
<p><code><em><a href="Dcs.DCSTypes.html##(Vec2)">Dcs.DCSTypes#Vec2</a> Point </em></code>:
|
|
The point where to wait.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#number Radius </em></code>:
|
|
The radius of the embarking zone around the Point.</p>
|
|
|
|
</li>
|
|
</ul>
|
|
<h3>Return value</h3>
|
|
|
|
<p><em><a href="Dcs.DCSTasking.Task.html##(Task)">Dcs.DCSTasking.Task#Task</a>:</em>
|
|
The DCS task structure.</p>
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).TaskEmbarking" >
|
|
<strong>CONTROLLABLE:TaskEmbarking(Point, Duration, EmbarkingControllable)</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>(AIR) Move the controllable to a Vec2 Point, wait for a defined duration and embark a controllable.</p>
|
|
|
|
<h3>Parameters</h3>
|
|
<ul>
|
|
<li>
|
|
|
|
<p><code><em><a href="Dcs.DCSTypes.html##(Vec2)">Dcs.DCSTypes#Vec2</a> Point </em></code>:
|
|
The point where to wait.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#number Duration </em></code>:
|
|
The duration in seconds to wait.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em><a href="##(CONTROLLABLE)">#CONTROLLABLE</a> EmbarkingControllable </em></code>:
|
|
The controllable to be embarked.</p>
|
|
|
|
</li>
|
|
</ul>
|
|
<h3>Return value</h3>
|
|
|
|
<p><em><a href="Dcs.DCSTasking.Task.html##(Task)">Dcs.DCSTasking.Task#Task</a>:</em>
|
|
The DCS task structure</p>
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).TaskEscort" >
|
|
<strong>CONTROLLABLE:TaskEscort(EscortControllable, Vec3, LastWaypointIndex, EngagementDistanceMax, TargetTypes, FollowControllable, EngagementDistance)</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>(AIR) Escort another airborne controllable.</p>
|
|
|
|
|
|
<p>The unit / controllable will follow lead unit of another controllable, wingmens of both controllables will continue following their leaders.
|
|
The unit / controllable will also protect that controllable from threats of specified types.</p>
|
|
|
|
<h3>Parameters</h3>
|
|
<ul>
|
|
<li>
|
|
|
|
<p><code><em><a href="Wrapper.Controllable.html##(CONTROLLABLE)">Wrapper.Controllable#CONTROLLABLE</a> EscortControllable </em></code>:
|
|
The controllable to be escorted.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em><a href="Dcs.DCSTypes.html##(Vec3)">Dcs.DCSTypes#Vec3</a> Vec3 </em></code>:
|
|
Position of the unit / lead unit of the controllable relative lead unit of another controllable in frame reference oriented by course of lead unit of another controllable. If another controllable is on land the unit / controllable will orbit around.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#number LastWaypointIndex </em></code>:
|
|
Detach waypoint of another controllable. Once reached the unit / controllable Follow task is finished.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#number EngagementDistanceMax </em></code>:
|
|
Maximal distance from escorted controllable to threat. If the threat is already engaged by escort escort will disengage if the distance becomes greater than 1.5 * engagementDistMax. </p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em><a href="Dcs.DCSTypes.html##(AttributeNameArray)">Dcs.DCSTypes#AttributeNameArray</a> TargetTypes </em></code>:
|
|
Array of AttributeName that is contains threat categories allowed to engage. </p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em> FollowControllable </em></code>: </p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em> EngagementDistance </em></code>: </p>
|
|
|
|
</li>
|
|
</ul>
|
|
<h3>Return value</h3>
|
|
|
|
<p><em><a href="Dcs.DCSTasking.Task.html##(Task)">Dcs.DCSTasking.Task#Task</a>:</em>
|
|
The DCS task structure.</p>
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).TaskFAC_AttackGroup" >
|
|
<strong>CONTROLLABLE:TaskFAC_AttackGroup(AttackGroup, WeaponType, Designation, Datalink)</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>(AIR + GROUND) The task makes the controllable/unit a FAC and orders the FAC to control the target (enemy ground controllable) destruction.</p>
|
|
|
|
|
|
<p>The killer is player-controlled allied CAS-aircraft that is in contact with the FAC.
|
|
If the task is assigned to the controllable lead unit will be a FAC. </p>
|
|
|
|
<h3>Parameters</h3>
|
|
<ul>
|
|
<li>
|
|
|
|
<p><code><em><a href="Wrapper.Controllable.html##(CONTROLLABLE)">Wrapper.Controllable#CONTROLLABLE</a> AttackGroup </em></code>:
|
|
Target CONTROLLABLE.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#number WeaponType </em></code>:
|
|
Bitmask of weapon types those allowed to use. If parameter is not defined that means no limits on weapon usage. </p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em><a href="Dcs.DCSTypes.html##(AI.Task.Designation)">Dcs.DCSTypes#AI.Task.Designation</a> Designation </em></code>:
|
|
(optional) Designation type.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#boolean Datalink </em></code>:
|
|
(optional) Allows to use datalink to send the target information to attack aircraft. Enabled by default. </p>
|
|
|
|
</li>
|
|
</ul>
|
|
<h3>Return value</h3>
|
|
|
|
<p><em><a href="Dcs.DCSTasking.Task.html##(Task)">Dcs.DCSTasking.Task#Task</a>:</em>
|
|
The DCS task structure.</p>
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).TaskFireAtPoint" >
|
|
<strong>CONTROLLABLE:TaskFireAtPoint(Vec2, Radius, AmmoCount)</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>(GROUND) Fire at a VEC2 point until ammunition is finished.</p>
|
|
|
|
<h3>Parameters</h3>
|
|
<ul>
|
|
<li>
|
|
|
|
<p><code><em><a href="Dcs.DCSTypes.html##(Vec2)">Dcs.DCSTypes#Vec2</a> Vec2 </em></code>:
|
|
The point to fire at.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em><a href="Dcs.DCSTypes.html##(Distance)">Dcs.DCSTypes#Distance</a> Radius </em></code>:
|
|
The radius of the zone to deploy the fire at.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#number AmmoCount </em></code>:
|
|
(optional) Quantity of ammunition to expand (omit to fire until ammunition is depleted).</p>
|
|
|
|
</li>
|
|
</ul>
|
|
<h3>Return value</h3>
|
|
|
|
<p><em><a href="Dcs.DCSTasking.Task.html##(Task)">Dcs.DCSTasking.Task#Task</a>:</em>
|
|
The DCS task structure.</p>
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).TaskFollow" >
|
|
<strong>CONTROLLABLE:TaskFollow(FollowControllable, Vec3, LastWaypointIndex)</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>(AIR) Following another airborne controllable.</p>
|
|
|
|
|
|
<p>The unit / controllable will follow lead unit of another controllable, wingmens of both controllables will continue following their leaders.
|
|
If another controllable is on land the unit / controllable will orbit around. </p>
|
|
|
|
<h3>Parameters</h3>
|
|
<ul>
|
|
<li>
|
|
|
|
<p><code><em><a href="Wrapper.Controllable.html##(CONTROLLABLE)">Wrapper.Controllable#CONTROLLABLE</a> FollowControllable </em></code>:
|
|
The controllable to be followed.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em><a href="Dcs.DCSTypes.html##(Vec3)">Dcs.DCSTypes#Vec3</a> Vec3 </em></code>:
|
|
Position of the unit / lead unit of the controllable relative lead unit of another controllable in frame reference oriented by course of lead unit of another controllable. If another controllable is on land the unit / controllable will orbit around.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#number LastWaypointIndex </em></code>:
|
|
Detach waypoint of another controllable. Once reached the unit / controllable Follow task is finished.</p>
|
|
|
|
</li>
|
|
</ul>
|
|
<h3>Return value</h3>
|
|
|
|
<p><em><a href="Dcs.DCSTasking.Task.html##(Task)">Dcs.DCSTasking.Task#Task</a>:</em>
|
|
The DCS task structure.</p>
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).TaskFunction" >
|
|
<strong>CONTROLLABLE:TaskFunction(WayPoint, WayPointIndex, FunctionString, FunctionArguments)</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
|
|
|
|
<h3>Parameters</h3>
|
|
<ul>
|
|
<li>
|
|
|
|
<p><code><em> WayPoint </em></code>: </p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em> WayPointIndex </em></code>: </p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em> FunctionString </em></code>: </p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em> FunctionArguments </em></code>: </p>
|
|
|
|
</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).TaskHold" >
|
|
<strong>CONTROLLABLE:TaskHold()</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>(GROUND) Hold ground controllable from moving.</p>
|
|
|
|
<h3>Return value</h3>
|
|
|
|
<p><em><a href="Dcs.DCSTasking.Task.html##(Task)">Dcs.DCSTasking.Task#Task</a>:</em>
|
|
The DCS task structure.</p>
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).TaskHoldPosition" >
|
|
<strong>CONTROLLABLE:TaskHoldPosition(Duration)</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>(AIR) Hold position at the current position of the first unit of the controllable.</p>
|
|
|
|
<h3>Parameter</h3>
|
|
<ul>
|
|
<li>
|
|
|
|
<p><code><em>#number Duration </em></code>:
|
|
The maximum duration in seconds to hold the position.</p>
|
|
|
|
</li>
|
|
</ul>
|
|
<h3>Return value</h3>
|
|
|
|
<p><em><a href="##(CONTROLLABLE)">#CONTROLLABLE</a>:</em>
|
|
self</p>
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).TaskLandAtVec2" >
|
|
<strong>CONTROLLABLE:TaskLandAtVec2(Point, Duration)</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>(AIR HELICOPTER) Landing at the ground.</p>
|
|
|
|
|
|
<p>For helicopters only.</p>
|
|
|
|
<h3>Parameters</h3>
|
|
<ul>
|
|
<li>
|
|
|
|
<p><code><em><a href="Dcs.DCSTypes.html##(Vec2)">Dcs.DCSTypes#Vec2</a> Point </em></code>:
|
|
The point where to land.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#number Duration </em></code>:
|
|
The duration in seconds to stay on the ground.</p>
|
|
|
|
</li>
|
|
</ul>
|
|
<h3>Return value</h3>
|
|
|
|
<p><em><a href="##(CONTROLLABLE)">#CONTROLLABLE</a>:</em>
|
|
self</p>
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).TaskLandAtZone" >
|
|
<strong>CONTROLLABLE:TaskLandAtZone(Zone, Duration, RandomPoint)</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>(AIR) Land the controllable at a @{Zone#ZONE_RADIUS).</p>
|
|
|
|
<h3>Parameters</h3>
|
|
<ul>
|
|
<li>
|
|
|
|
<p><code><em><a href="Core.Zone.html##(ZONE)">Core.Zone#ZONE</a> Zone </em></code>:
|
|
The zone where to land.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#number Duration </em></code>:
|
|
The duration in seconds to stay on the ground.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em> RandomPoint </em></code>: </p>
|
|
|
|
</li>
|
|
</ul>
|
|
<h3>Return value</h3>
|
|
|
|
<p><em><a href="##(CONTROLLABLE)">#CONTROLLABLE</a>:</em>
|
|
self</p>
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).TaskMission" >
|
|
<strong>CONTROLLABLE:TaskMission(TaskMission)</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>(AIR + GROUND) Return a mission task from a mission template.</p>
|
|
|
|
<h3>Parameter</h3>
|
|
<ul>
|
|
<li>
|
|
|
|
<p><code><em>#table TaskMission </em></code>:
|
|
A table containing the mission task.</p>
|
|
|
|
</li>
|
|
</ul>
|
|
<h3>Return value</h3>
|
|
|
|
<p><em><a href="Dcs.DCSTasking.Task.html##(Task)">Dcs.DCSTasking.Task#Task</a>:</em></p>
|
|
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).TaskOrbitCircle" >
|
|
<strong>CONTROLLABLE:TaskOrbitCircle(Altitude, Speed)</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>(AIR) Orbit at the current position of the first unit of the controllable at a specified alititude.</p>
|
|
|
|
<h3>Parameters</h3>
|
|
<ul>
|
|
<li>
|
|
|
|
<p><code><em>#number Altitude </em></code>:
|
|
The altitude to hold the position.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#number Speed </em></code>:
|
|
The speed flying when holding the position.</p>
|
|
|
|
</li>
|
|
</ul>
|
|
<h3>Return value</h3>
|
|
|
|
<p><em><a href="##(CONTROLLABLE)">#CONTROLLABLE</a>:</em>
|
|
self</p>
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).TaskOrbitCircleAtVec2" >
|
|
<strong>CONTROLLABLE:TaskOrbitCircleAtVec2(Point, Altitude, Speed)</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>(AIR) Orbit at a specified position at a specified alititude during a specified duration with a specified speed.</p>
|
|
|
|
<h3>Parameters</h3>
|
|
<ul>
|
|
<li>
|
|
|
|
<p><code><em><a href="Dcs.DCSTypes.html##(Vec2)">Dcs.DCSTypes#Vec2</a> Point </em></code>:
|
|
The point to hold the position.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#number Altitude </em></code>:
|
|
The altitude to hold the position.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#number Speed </em></code>:
|
|
The speed flying when holding the position.</p>
|
|
|
|
</li>
|
|
</ul>
|
|
<h3>Return value</h3>
|
|
|
|
<p><em><a href="##(CONTROLLABLE)">#CONTROLLABLE</a>:</em>
|
|
self</p>
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).TaskRefueling" >
|
|
<strong>CONTROLLABLE:TaskRefueling()</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>(AIR) Refueling from the nearest tanker.</p>
|
|
|
|
|
|
<p>No parameters.</p>
|
|
|
|
<h3>Return value</h3>
|
|
|
|
<p><em><a href="Dcs.DCSTasking.Task.html##(Task)">Dcs.DCSTasking.Task#Task</a>:</em>
|
|
The DCS task structure.</p>
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).TaskRoute" >
|
|
<strong>CONTROLLABLE:TaskRoute(Points)</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>Return a Misson task to follow a given route defined by Points.</p>
|
|
|
|
<h3>Parameter</h3>
|
|
<ul>
|
|
<li>
|
|
|
|
<p><code><em>#table Points </em></code>:
|
|
A table of route points.</p>
|
|
|
|
</li>
|
|
</ul>
|
|
<h3>Return value</h3>
|
|
|
|
<p><em><a href="Dcs.DCSTasking.Task.html##(Task)">Dcs.DCSTasking.Task#Task</a>:</em></p>
|
|
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).TaskRouteToVec2" >
|
|
<strong>CONTROLLABLE:TaskRouteToVec2(Point, Speed)</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>(AIR + GROUND) Make the Controllable move to fly to a given point.</p>
|
|
|
|
<h3>Parameters</h3>
|
|
<ul>
|
|
<li>
|
|
|
|
<p><code><em><a href="Dcs.DCSTypes.html##(Vec3)">Dcs.DCSTypes#Vec3</a> Point </em></code>:
|
|
The destination point in Vec3 format.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#number Speed </em></code>:
|
|
The speed to travel.</p>
|
|
|
|
</li>
|
|
</ul>
|
|
<h3>Return value</h3>
|
|
|
|
<p><em><a href="##(CONTROLLABLE)">#CONTROLLABLE</a>:</em>
|
|
self</p>
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).TaskRouteToVec3" >
|
|
<strong>CONTROLLABLE:TaskRouteToVec3(Point, Speed)</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>(AIR + GROUND) Make the Controllable move to a given point.</p>
|
|
|
|
<h3>Parameters</h3>
|
|
<ul>
|
|
<li>
|
|
|
|
<p><code><em><a href="Dcs.DCSTypes.html##(Vec3)">Dcs.DCSTypes#Vec3</a> Point </em></code>:
|
|
The destination point in Vec3 format.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#number Speed </em></code>:
|
|
The speed to travel.</p>
|
|
|
|
</li>
|
|
</ul>
|
|
<h3>Return value</h3>
|
|
|
|
<p><em><a href="##(CONTROLLABLE)">#CONTROLLABLE</a>:</em>
|
|
self</p>
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).TaskRouteToZone" >
|
|
<strong>CONTROLLABLE:TaskRouteToZone(Zone, Randomize, Speed, Formation)</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>(AIR + GROUND) Route the controllable to a given zone.</p>
|
|
|
|
|
|
<p>The controllable final destination point can be randomized.
|
|
A speed can be given in km/h.
|
|
A given formation can be given.</p>
|
|
|
|
<h3>Parameters</h3>
|
|
<ul>
|
|
<li>
|
|
|
|
<p><code><em><a href="Core.Zone.html##(ZONE)">Core.Zone#ZONE</a> Zone </em></code>:
|
|
The zone where to route to.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#boolean Randomize </em></code>:
|
|
Defines whether to target point gets randomized within the Zone.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#number Speed </em></code>:
|
|
The speed.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em><a href="Base.html##(FORMATION)">Base#FORMATION</a> Formation </em></code>:
|
|
The formation string.</p>
|
|
|
|
</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).TaskWrappedAction" >
|
|
<strong>CONTROLLABLE:TaskWrappedAction(DCSCommand, Index)</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>Return a WrappedAction Task taking a Command.</p>
|
|
|
|
<h3>Parameters</h3>
|
|
<ul>
|
|
<li>
|
|
|
|
<p><code><em><a href="Dcs.DCSCommand.html##(Command)">Dcs.DCSCommand#Command</a> DCSCommand </em></code>: </p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em> Index </em></code>: </p>
|
|
|
|
</li>
|
|
</ul>
|
|
<h3>Return value</h3>
|
|
|
|
<p><em><a href="Dcs.DCSTasking.Task.html##(Task)">Dcs.DCSTasking.Task#Task</a>:</em></p>
|
|
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).WayPointExecute" >
|
|
<strong>CONTROLLABLE:WayPointExecute(WayPoint, WaitTime)</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>Executes the WayPoint plan.</p>
|
|
|
|
|
|
<p>The function gets a WayPoint parameter, that you can use to restart the mission at a specific WayPoint.
|
|
Note that when the WayPoint parameter is used, the new start mission waypoint of the controllable will be 1!</p>
|
|
|
|
<h3>Parameters</h3>
|
|
<ul>
|
|
<li>
|
|
|
|
<p><code><em>#number WayPoint </em></code>:
|
|
The WayPoint from where to execute the mission.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#number WaitTime </em></code>:
|
|
The amount seconds to wait before initiating the mission.</p>
|
|
|
|
</li>
|
|
</ul>
|
|
<h3>Return value</h3>
|
|
|
|
<p><em><a href="##(CONTROLLABLE)">#CONTROLLABLE</a>:</em></p>
|
|
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).WayPointFunction" >
|
|
<strong>CONTROLLABLE:WayPointFunction(WayPoint, WayPointIndex, WayPointFunction, ...)</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>Registers a waypoint function that will be executed when the controllable moves over the WayPoint.</p>
|
|
|
|
<h3>Parameters</h3>
|
|
<ul>
|
|
<li>
|
|
|
|
<p><code><em>#number WayPoint </em></code>:
|
|
The waypoint number. Note that the start waypoint on the route is WayPoint 1!</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#number WayPointIndex </em></code>:
|
|
When defining multiple WayPoint functions for one WayPoint, use WayPointIndex to set the sequence of actions.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em>#function WayPointFunction </em></code>:
|
|
The waypoint function to be called when the controllable moves over the waypoint. The waypoint function takes variable parameters.</p>
|
|
|
|
</li>
|
|
<li>
|
|
|
|
<p><code><em> ... </em></code>: </p>
|
|
|
|
</li>
|
|
</ul>
|
|
<h3>Return value</h3>
|
|
|
|
<p><em><a href="##(CONTROLLABLE)">#CONTROLLABLE</a>:</em></p>
|
|
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<em></em>
|
|
<a id="#(CONTROLLABLE).WayPointFunctions" >
|
|
<strong>CONTROLLABLE.WayPointFunctions</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE).WayPointInitialize" >
|
|
<strong>CONTROLLABLE:WayPointInitialize(WayPoints)</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p> Retrieve the controllable mission and allow to place function hooks within the mission waypoint plan.</p>
|
|
|
|
|
|
<p> Use the method <a href="Controllable.html##(CONTROLLABLE)">Controllable#CONTROLLABLE</a> to define the hook functions for specific waypoints.
|
|
Use the method @{Controllable@CONTROLLABLE:WayPointExecute) to start the execution of the new mission plan.
|
|
Note that when WayPointInitialize is called, the Mission of the controllable is RESTARTED!</p>
|
|
|
|
<h3>Parameter</h3>
|
|
<ul>
|
|
<li>
|
|
|
|
<p><code><em>#table WayPoints </em></code>:
|
|
If WayPoints is given, then use the route.</p>
|
|
|
|
</li>
|
|
</ul>
|
|
<h3>Return value</h3>
|
|
|
|
<p><em><a href="##(CONTROLLABLE)">#CONTROLLABLE</a>:</em></p>
|
|
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<em></em>
|
|
<a id="#(CONTROLLABLE).WayPoints" >
|
|
<strong>CONTROLLABLE.WayPoints</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
|
|
|
|
</dd>
|
|
</dl>
|
|
<dl class="function">
|
|
<dt>
|
|
|
|
<a id="#(CONTROLLABLE)._GetController" >
|
|
<strong>CONTROLLABLE:_GetController()</strong>
|
|
</a>
|
|
</dt>
|
|
<dd>
|
|
|
|
<p>Get the controller for the CONTROLLABLE.</p>
|
|
|
|
<h3>Return value</h3>
|
|
|
|
<p><em><a href="Dcs.DCSController.html##(Controller)">Dcs.DCSController#Controller</a>:</em></p>
|
|
|
|
|
|
</dd>
|
|
</dl>
|
|
|
|
<h2><a id="#(DCSCommand)" >Type <code>DCSCommand</code></a></h2>
|
|
|
|
<h2><a id="#(DCSStopCondition)" >Type <code>DCSStopCondition</code></a></h2>
|
|
|
|
<h2><a id="#(list)" >Type <code>list</code></a></h2>
|
|
|
|
</div>
|
|
|
|
</div>
|
|
</body>
|
|
</html>
|