MOOSE/docs/Documentation/Identifiable.html
FlightControl_Master b7183023c9 Documentation
2017-11-22 06:23:58 +01:00

589 lines
15 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_A2A.html">AI_A2A</a></li>
<li><a href="AI_A2A_Cap.html">AI_A2A_Cap</a></li>
<li><a href="AI_A2A_Dispatcher.html">AI_A2A_Dispatcher</a></li>
<li><a href="AI_A2A_GCI.html">AI_A2A_GCI</a></li>
<li><a href="AI_A2A_Patrol.html">AI_A2A_Patrol</a></li>
<li><a href="AI_Bai.html">AI_Bai</a></li>
<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_Formation.html">AI_Formation</a></li>
<li><a href="AI_Patrol.html">AI_Patrol</a></li>
<li><a href="ATC_Ground.html">ATC_Ground</a></li>
<li><a href="Account.html">Account</a></li>
<li><a href="Airbase.html">Airbase</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><a href="Controllable.html">Controllable</a></li>
<li><a href="DCSAirbase.html">DCSAirbase</a></li>
<li><a href="DCSCoalitionObject.html">DCSCoalitionObject</a></li>
<li><a href="DCSCommand.html">DCSCommand</a></li>
<li><a href="DCSController.html">DCSController</a></li>
<li><a href="DCSGroup.html">DCSGroup</a></li>
<li><a href="DCSObject.html">DCSObject</a></li>
<li><a href="DCSTask.html">DCSTask</a></li>
<li><a href="DCSTypes.html">DCSTypes</a></li>
<li><a href="DCSUnit.html">DCSUnit</a></li>
<li><a href="DCSVec3.html">DCSVec3</a></li>
<li><a href="DCSWorld.html">DCSWorld</a></li>
<li><a href="DCSZone.html">DCSZone</a></li>
<li><a href="DCScountry.html">DCScountry</a></li>
<li><a href="DCStimer.html">DCStimer</a></li>
<li><a href="DCStrigger.html">DCStrigger</a></li>
<li><a href="Database.html">Database</a></li>
<li><a href="Designate.html">Designate</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="Goal.html">Goal</a></li>
<li><a href="Group.html">Group</a></li>
<li>Identifiable</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="Protect.html">Protect</a></li>
<li><a href="Radio.html">Radio</a></li>
<li><a href="Rat.html">Rat</a></li>
<li><a href="Route.html">Route</a></li>
<li><a href="Scenery.html">Scenery</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="Settings.html">Settings</a></li>
<li><a href="Smoke.html">Smoke</a></li>
<li><a href="Spawn.html">Spawn</a></li>
<li><a href="SpawnStatic.html">SpawnStatic</a></li>
<li><a href="Spot.html">Spot</a></li>
<li><a href="Static.html">Static</a></li>
<li><a href="StaticObject.html">StaticObject</a></li>
<li><a href="Task.html">Task</a></li>
<li><a href="TaskZoneCapture.html">TaskZoneCapture</a></li>
<li><a href="Task_A2A.html">Task_A2A</a></li>
<li><a href="Task_A2A_Dispatcher.html">Task_A2A_Dispatcher</a></li>
<li><a href="Task_A2G.html">Task_A2G</a></li>
<li><a href="Task_A2G_Dispatcher.html">Task_A2G_Dispatcher</a></li>
<li><a href="Task_Cargo.html">Task_Cargo</a></li>
<li><a href="Task_PICKUP.html">Task_PICKUP</a></li>
<li><a href="Unit.html">Unit</a></li>
<li><a href="UserFlag.html">UserFlag</a></li>
<li><a href="UserSound.html">UserSound</a></li>
<li><a href="Utils.html">Utils</a></li>
<li><a href="Velocity.html">Velocity</a></li>
<li><a href="Zone.html">Zone</a></li>
<li><a href="ZoneCaptureCoalition.html">ZoneCaptureCoalition</a></li>
<li><a href="ZoneGoal.html">ZoneGoal</a></li>
<li><a href="ZoneGoalCargo.html">ZoneGoalCargo</a></li>
<li><a href="ZoneGoalCoalition.html">ZoneGoalCoalition</a></li>
<li><a href="env.html">env</a></li>
<li><a href="land.html">land</a></li>
<li><a href="routines.html">routines</a></li>
</ul>
</div>
<div id="content">
<h1>Module <code>Identifiable</code></h1>
<p><strong>Wrapper</strong> -- IDENTIFIABLE is an intermediate class wrapping DCS Object class derived Objects.</p>
<hr/>
<h3>Author: <strong>Sven Van de Velde (FlightControl)</strong></h3>
<h3>Contributions:</h3>
<hr/>
<h2>Global(s)</h2>
<table class="function_list">
<tr>
<td class="name" nowrap="nowrap"><a href="#IDENTIFIABLE">IDENTIFIABLE</a></td>
<td class="summary">
<h1>IDENTIFIABLE class, extends <a href="Object.html##(OBJECT)">Object#OBJECT</a></h1>
<p>The IDENTIFIABLE class is a wrapper class to handle the DCS Identifiable objects:</p>
<ul>
<li>Support all DCS Identifiable APIs.</li>
</ul>
</td>
</tr>
</table>
<h2><a id="#(IDENTIFIABLE)">Type <code>IDENTIFIABLE</code></a></h2>
<table class="function_list">
<tr>
<td class="name" nowrap="nowrap"><a href="##(IDENTIFIABLE).GetCallsign">IDENTIFIABLE:GetCallsign()</a></td>
<td class="summary">
<p>Gets the CallSign of the IDENTIFIABLE, which is a blank by default.</p>
</td>
</tr>
<tr>
<td class="name" nowrap="nowrap"><a href="##(IDENTIFIABLE).GetCategory">IDENTIFIABLE:GetCategory()</a></td>
<td class="summary">
<p>Returns category of the DCS Identifiable.</p>
</td>
</tr>
<tr>
<td class="name" nowrap="nowrap"><a href="##(IDENTIFIABLE).GetCategoryName">IDENTIFIABLE:GetCategoryName()</a></td>
<td class="summary">
<p>Returns the DCS Identifiable category name as defined within the DCS Identifiable Descriptor.</p>
</td>
</tr>
<tr>
<td class="name" nowrap="nowrap"><a href="##(IDENTIFIABLE).GetCoalition">IDENTIFIABLE:GetCoalition()</a></td>
<td class="summary">
<p>Returns coalition of the Identifiable.</p>
</td>
</tr>
<tr>
<td class="name" nowrap="nowrap"><a href="##(IDENTIFIABLE).GetCoalitionName">IDENTIFIABLE:GetCoalitionName()</a></td>
<td class="summary">
<p>Returns the name of the coalition of the Identifiable.</p>
</td>
</tr>
<tr>
<td class="name" nowrap="nowrap"><a href="##(IDENTIFIABLE).GetCountry">IDENTIFIABLE:GetCountry()</a></td>
<td class="summary">
<p>Returns country of the Identifiable.</p>
</td>
</tr>
<tr>
<td class="name" nowrap="nowrap"><a href="##(IDENTIFIABLE).GetDesc">IDENTIFIABLE:GetDesc()</a></td>
<td class="summary">
<p>Returns Identifiable descriptor.</p>
</td>
</tr>
<tr>
<td class="name" nowrap="nowrap"><a href="##(IDENTIFIABLE).GetName">IDENTIFIABLE:GetName()</a></td>
<td class="summary">
<p>Returns DCS Identifiable object name.</p>
</td>
</tr>
<tr>
<td class="name" nowrap="nowrap"><a href="##(IDENTIFIABLE).GetThreatLevel">IDENTIFIABLE:GetThreatLevel()</a></td>
<td class="summary">
</td>
</tr>
<tr>
<td class="name" nowrap="nowrap"><a href="##(IDENTIFIABLE).GetTypeName">IDENTIFIABLE:GetTypeName()</a></td>
<td class="summary">
<p>Returns the type name of the DCS Identifiable.</p>
</td>
</tr>
<tr>
<td class="name" nowrap="nowrap"><a href="##(IDENTIFIABLE).IdentifiableName">IDENTIFIABLE.IdentifiableName</a></td>
<td class="summary">
<p>The name of the identifiable.</p>
</td>
</tr>
<tr>
<td class="name" nowrap="nowrap"><a href="##(IDENTIFIABLE).IsAlive">IDENTIFIABLE:IsAlive()</a></td>
<td class="summary">
<p>Returns if the Identifiable is alive.</p>
</td>
</tr>
<tr>
<td class="name" nowrap="nowrap"><a href="##(IDENTIFIABLE).New">IDENTIFIABLE:New(IdentifiableName)</a></td>
<td class="summary">
<p>Create a new IDENTIFIABLE from a DCSIdentifiable</p>
</td>
</tr>
</table>
<h2>Global(s)</h2>
<dl class="function">
<dt>
<em><a href="##(IDENTIFIABLE)">#IDENTIFIABLE</a></em>
<a id="IDENTIFIABLE" >
<strong>IDENTIFIABLE</strong>
</a>
</dt>
<dd>
<h1>IDENTIFIABLE class, extends <a href="Object.html##(OBJECT)">Object#OBJECT</a></h1>
<p>The IDENTIFIABLE class is a wrapper class to handle the DCS Identifiable objects:</p>
<ul>
<li>Support all DCS Identifiable APIs.</li>
</ul>
<ul>
<li>Enhance with Identifiable specific APIs not in the DCS Identifiable API set.</li>
<li>Manage the "state" of the DCS Identifiable.</li>
</ul>
<h2>IDENTIFIABLE constructor</h2>
<p>The IDENTIFIABLE class provides the following functions to construct a IDENTIFIABLE instance:</p>
<ul>
<li><a href="##(IDENTIFIABLE).New">IDENTIFIABLE.New</a>(): Create a IDENTIFIABLE instance.</li>
</ul>
</dd>
</dl>
<h2><a id="#(Identifiable)" >Type <code>Identifiable</code></a></h2>
<h2><a id="#(IDENTIFIABLE)" >Type <code>IDENTIFIABLE</code></a></h2>
<h3>Field(s)</h3>
<dl class="function">
<dt>
<a id="#(IDENTIFIABLE).GetCallsign" >
<strong>IDENTIFIABLE:GetCallsign()</strong>
</a>
</dt>
<dd>
<p>Gets the CallSign of the IDENTIFIABLE, which is a blank by default.</p>
<h3>Return value</h3>
<p><em>#string:</em>
The CallSign of the IDENTIFIABLE.</p>
</dd>
</dl>
<dl class="function">
<dt>
<a id="#(IDENTIFIABLE).GetCategory" >
<strong>IDENTIFIABLE:GetCategory()</strong>
</a>
</dt>
<dd>
<p>Returns category of the DCS Identifiable.</p>
<h3>Return value</h3>
<p><em><a href="Dcs.DCSWrapper.Object.html##(Object.Category)">Dcs.DCSWrapper.Object#Object.Category</a>:</em>
The category ID</p>
</dd>
</dl>
<dl class="function">
<dt>
<a id="#(IDENTIFIABLE).GetCategoryName" >
<strong>IDENTIFIABLE:GetCategoryName()</strong>
</a>
</dt>
<dd>
<p>Returns the DCS Identifiable category name as defined within the DCS Identifiable Descriptor.</p>
<h3>Return value</h3>
<p><em>#string:</em>
The DCS Identifiable Category Name</p>
</dd>
</dl>
<dl class="function">
<dt>
<a id="#(IDENTIFIABLE).GetCoalition" >
<strong>IDENTIFIABLE:GetCoalition()</strong>
</a>
</dt>
<dd>
<p>Returns coalition of the Identifiable.</p>
<h3>Return values</h3>
<ol>
<li>
<p><em><a href="Dcs.DCSCoalitionWrapper.Object.html##(coalition.side)">Dcs.DCSCoalitionWrapper.Object#coalition.side</a>:</em>
The side of the coalition.</p>
</li>
<li>
<p><em>#nil:</em>
The DCS Identifiable is not existing or alive. </p>
</li>
</ol>
</dd>
</dl>
<dl class="function">
<dt>
<a id="#(IDENTIFIABLE).GetCoalitionName" >
<strong>IDENTIFIABLE:GetCoalitionName()</strong>
</a>
</dt>
<dd>
<p>Returns the name of the coalition of the Identifiable.</p>
<h3>Return values</h3>
<ol>
<li>
<p><em>#string:</em>
The name of the coalition.</p>
</li>
<li>
<p><em>#nil:</em>
The DCS Identifiable is not existing or alive. </p>
</li>
</ol>
</dd>
</dl>
<dl class="function">
<dt>
<a id="#(IDENTIFIABLE).GetCountry" >
<strong>IDENTIFIABLE:GetCountry()</strong>
</a>
</dt>
<dd>
<p>Returns country of the Identifiable.</p>
<h3>Return values</h3>
<ol>
<li>
<p><em><a href="Dcs.DCScountry.html##(country.id)">Dcs.DCScountry#country.id</a>:</em>
The country identifier.</p>
</li>
<li>
<p><em>#nil:</em>
The DCS Identifiable is not existing or alive. </p>
</li>
</ol>
</dd>
</dl>
<dl class="function">
<dt>
<a id="#(IDENTIFIABLE).GetDesc" >
<strong>IDENTIFIABLE:GetDesc()</strong>
</a>
</dt>
<dd>
<p>Returns Identifiable descriptor.</p>
<p>Descriptor type depends on Identifiable category.</p>
<h3>Return values</h3>
<ol>
<li>
<p><em><a href="Dcs.DCSWrapper.Identifiable.html##(Identifiable.Desc)">Dcs.DCSWrapper.Identifiable#Identifiable.Desc</a>:</em>
The Identifiable descriptor.</p>
</li>
<li>
<p><em>#nil:</em>
The DCS Identifiable is not existing or alive. </p>
</li>
</ol>
</dd>
</dl>
<dl class="function">
<dt>
<a id="#(IDENTIFIABLE).GetName" >
<strong>IDENTIFIABLE:GetName()</strong>
</a>
</dt>
<dd>
<p>Returns DCS Identifiable object name.</p>
<p>The function provides access to non-activated objects too.</p>
<h3>Return values</h3>
<ol>
<li>
<p><em>#string:</em>
The name of the DCS Identifiable.</p>
</li>
<li>
<p><em>#nil:</em>
The DCS Identifiable is not existing or alive. </p>
</li>
</ol>
</dd>
</dl>
<dl class="function">
<dt>
<a id="#(IDENTIFIABLE).GetThreatLevel" >
<strong>IDENTIFIABLE:GetThreatLevel()</strong>
</a>
</dt>
<dd>
</dd>
</dl>
<dl class="function">
<dt>
<a id="#(IDENTIFIABLE).GetTypeName" >
<strong>IDENTIFIABLE:GetTypeName()</strong>
</a>
</dt>
<dd>
<p>Returns the type name of the DCS Identifiable.</p>
<h3>Return values</h3>
<ol>
<li>
<p><em>#string:</em>
The type name of the DCS Identifiable.</p>
</li>
<li>
<p><em>#nil:</em>
The DCS Identifiable is not existing or alive. </p>
</li>
</ol>
</dd>
</dl>
<dl class="function">
<dt>
<em>#string</em>
<a id="#(IDENTIFIABLE).IdentifiableName" >
<strong>IDENTIFIABLE.IdentifiableName</strong>
</a>
</dt>
<dd>
<p>The name of the identifiable.</p>
</dd>
</dl>
<dl class="function">
<dt>
<a id="#(IDENTIFIABLE).IsAlive" >
<strong>IDENTIFIABLE:IsAlive()</strong>
</a>
</dt>
<dd>
<p>Returns if the Identifiable is alive.</p>
<p>If the Identifiable is not alive, nil is returned. <br/>
If the Identifiable is alive, true is returned. </p>
<h3>Return values</h3>
<ol>
<li>
<p><em>#boolean:</em>
true if Identifiable is alive.</p>
</li>
<li>
<p><em>#nil:</em>
if the Identifiable is not existing or is not alive. </p>
</li>
</ol>
</dd>
</dl>
<dl class="function">
<dt>
<a id="#(IDENTIFIABLE).New" >
<strong>IDENTIFIABLE:New(IdentifiableName)</strong>
</a>
</dt>
<dd>
<p>Create a new IDENTIFIABLE from a DCSIdentifiable</p>
<h3>Parameter</h3>
<ul>
<li>
<p><code><em><a href="Dcs.DCSWrapper.Identifiable.html##(Identifiable)">Dcs.DCSWrapper.Identifiable#Identifiable</a> IdentifiableName </em></code>:
The DCS Identifiable name</p>
</li>
</ul>
<h3>Return value</h3>
<p><em><a href="##(IDENTIFIABLE)">#IDENTIFIABLE</a>:</em>
self</p>
</dd>
</dl>
</div>
</div>
</body>
</html>