Updated documentation

This commit is contained in:
FlightControl 2016-07-23 10:32:41 +02:00
parent 231b382df1
commit ede7813a94
3 changed files with 361 additions and 5 deletions

View File

@ -167,6 +167,12 @@ In order to keep the credibility of the the author, I want to emphasize that the
<td class="name" nowrap="nowrap"><a href="##(POINT_VEC2).New">POINT_VEC2:New(x, y, LandHeightAdd)</a></td>
<td class="summary">
<p>Create a new POINT_VEC2 object.</p>
</td>
</tr>
<tr>
<td class="name" nowrap="nowrap"><a href="##(POINT_VEC2).NewFromVec2">POINT_VEC2:NewFromVec2(Vec2, LandHeightAdd)</a></td>
<td class="summary">
<p>Create a new POINT_VEC2 object from Vec2 coordinates.</p>
</td>
</tr>
<tr>
@ -261,6 +267,24 @@ In order to keep the credibility of the the author, I want to emphasize that the
<td class="name" nowrap="nowrap"><a href="##(POINT_VEC3).GetNorthCorrectionRadians">POINT_VEC3:GetNorthCorrectionRadians()</a></td>
<td class="summary">
<p>Get a correction in radians of the real magnetic north of the POINT_VEC3.</p>
</td>
</tr>
<tr>
<td class="name" nowrap="nowrap"><a href="##(POINT_VEC3).GetRandomVec2InRadius">POINT_VEC3:GetRandomVec2InRadius(OuterRadius, InnerRadius)</a></td>
<td class="summary">
<p>Return a random Vec3 point within an Outer Radius and optionally NOT within an Inner Radius of the POINT_VEC3.</p>
</td>
</tr>
<tr>
<td class="name" nowrap="nowrap"><a href="##(POINT_VEC3).GetRandomVec3InRadius">POINT_VEC3:GetRandomVec3InRadius(OuterRadius, InnerRadius)</a></td>
<td class="summary">
<p>Return a random Vec3 point within an Outer Radius and optionally NOT within an Inner Radius of the POINT_VEC3.</p>
</td>
</tr>
<tr>
<td class="name" nowrap="nowrap"><a href="##(POINT_VEC3).GetVec2">POINT_VEC3:GetVec2()</a></td>
<td class="summary">
<p>Return the coordinates of the POINT_VEC3 in Vec2 format.</p>
</td>
</tr>
<tr>
@ -654,6 +678,38 @@ The y coordinate of the Vec3 point, pointing to the Right.</p>
<p><em><a href="Point.html##(POINT_VEC2)">Point#POINT_VEC2</a>:</em></p>
</dd>
</dl>
<dl class="function">
<dt>
<a id="#(POINT_VEC2).NewFromVec2" >
<strong>POINT_VEC2:NewFromVec2(Vec2, LandHeightAdd)</strong>
</a>
</dt>
<dd>
<p>Create a new POINT_VEC2 object from Vec2 coordinates.</p>
<h3>Parameters</h3>
<ul>
<li>
<p><code><em><a href="DCSTypes.html##(Vec2)">DCSTypes#Vec2</a> Vec2 </em></code>:
The Vec2 point.</p>
</li>
<li>
<p><code><em> LandHeightAdd </em></code>: </p>
</li>
</ul>
<h3>Return value</h3>
<p><em><a href="Point.html##(POINT_VEC2)">Point#POINT_VEC2</a>:</em>
self</p>
</dd>
</dl>
<dl class="function">
@ -1018,6 +1074,86 @@ CorrectionRadians The correction in radians.</p>
<dl class="function">
<dt>
<a id="#(POINT_VEC3).GetRandomVec2InRadius" >
<strong>POINT_VEC3:GetRandomVec2InRadius(OuterRadius, InnerRadius)</strong>
</a>
</dt>
<dd>
<p>Return a random Vec3 point within an Outer Radius and optionally NOT within an Inner Radius of the POINT_VEC3.</p>
<h3>Parameters</h3>
<ul>
<li>
<p><code><em><a href="DCSTypes.html##(Distance)">DCSTypes#Distance</a> OuterRadius </em></code>: </p>
</li>
<li>
<p><code><em><a href="DCSTypes.html##(Distance)">DCSTypes#Distance</a> InnerRadius </em></code>: </p>
</li>
</ul>
<h3>Return value</h3>
<p><em><a href="DCSTypes.html##(Vec2)">DCSTypes#Vec2</a>:</em>
Vec2</p>
</dd>
</dl>
<dl class="function">
<dt>
<a id="#(POINT_VEC3).GetRandomVec3InRadius" >
<strong>POINT_VEC3:GetRandomVec3InRadius(OuterRadius, InnerRadius)</strong>
</a>
</dt>
<dd>
<p>Return a random Vec3 point within an Outer Radius and optionally NOT within an Inner Radius of the POINT_VEC3.</p>
<h3>Parameters</h3>
<ul>
<li>
<p><code><em><a href="DCSTypes.html##(Distance)">DCSTypes#Distance</a> OuterRadius </em></code>: </p>
</li>
<li>
<p><code><em><a href="DCSTypes.html##(Distance)">DCSTypes#Distance</a> InnerRadius </em></code>: </p>
</li>
</ul>
<h3>Return value</h3>
<p><em><a href="DCSTypes.html##(Vec3)">DCSTypes#Vec3</a>:</em>
Vec3</p>
</dd>
</dl>
<dl class="function">
<dt>
<a id="#(POINT_VEC3).GetVec2" >
<strong>POINT_VEC3:GetVec2()</strong>
</a>
</dt>
<dd>
<p>Return the coordinates of the POINT_VEC3 in Vec2 format.</p>
<h3>Return value</h3>
<p><em><a href="DCSTypes.html##(Vec2)">DCSTypes#Vec2</a>:</em>
The Vec2 coodinate.</p>
</dd>
</dl>
<dl class="function">
<dt>
<a id="#(POINT_VEC3).GetVec3" >
<strong>POINT_VEC3:GetVec3()</strong>
</a>

View File

@ -153,6 +153,9 @@ So in principle, the group list will contain all parameters and configurations a
<li><a href="##(SPAWN).Spawn">SPAWN.Spawn</a>: Spawn one new group based on the last spawned index.</li>
<li><a href="##(SPAWN).ReSpawn">SPAWN.ReSpawn</a>: Re-spawn a group based on a given index.</li>
<li><a href="##(SPAWN).SpawnScheduled">SPAWN.SpawnScheduled</a>: Spawn groups at scheduled but randomized intervals. You can use <a href="##(SPAWN).SpawnScheduleStart">SPAWN.SpawnScheduleStart</a> and <a href="##(SPAWN).SpawnScheduleStop">SPAWN.SpawnScheduleStop</a> to start and stop the schedule respectively.</li>
<li><a href="##(SPAWN).SpawnFromVec3">SPAWN.SpawnFromVec3</a>: Spawn a new group from a Vec3 coordinate. (The group will can be spawned at a point in the air).</li>
<li><a href="##(SPAWN).SpawnFromVec2">SPAWN.SpawnFromVec2</a>: Spawn a new group from a Vec2 coordinate. (The group will be spawned at land height ).</li>
<li><a href="##(SPAWN).SpawnFromStatic">SPAWN.SpawnFromStatic</a>: Spawn a new group from a structure, taking the position of a <a href="STATIC.html">STATIC</a>.</li>
<li><a href="##(SPAWN).SpawnFromUnit">SPAWN.SpawnFromUnit</a>: Spawn a new group taking the position of a <a href="UNIT.html">UNIT</a>.</li>
<li><a href="##(SPAWN).SpawnInZone">SPAWN.SpawnInZone</a>: Spawn a new group in a <a href="ZONE.html">ZONE</a>.</li>
</ul>
@ -350,12 +353,30 @@ Check the <a href="##(SPAWN).CleanUp">SPAWN.CleanUp</a> for further info.</p>
<td class="name" nowrap="nowrap"><a href="##(SPAWN).SpawnCleanUpTimeStamps">SPAWN.SpawnCleanUpTimeStamps</a></td>
<td class="summary">
</td>
</tr>
<tr>
<td class="name" nowrap="nowrap"><a href="##(SPAWN).SpawnFromStatic">SPAWN:SpawnFromStatic(HostStatic, OuterRadius, InnerRadius, SpawnIndex)</a></td>
<td class="summary">
<p>Will spawn a group from a hosting static.</p>
</td>
</tr>
<tr>
<td class="name" nowrap="nowrap"><a href="##(SPAWN).SpawnFromUnit">SPAWN:SpawnFromUnit(HostUnit, OuterRadius, InnerRadius, SpawnIndex)</a></td>
<td class="summary">
<p>Will spawn a group from a hosting unit.</p>
</td>
</tr>
<tr>
<td class="name" nowrap="nowrap"><a href="##(SPAWN).SpawnFromVec2">SPAWN:SpawnFromVec2(Vec2, OuterRadius, InnerRadius, SpawnIndex)</a></td>
<td class="summary">
<p>Will spawn a group from a Vec2 in 3D space.</p>
</td>
</tr>
<tr>
<td class="name" nowrap="nowrap"><a href="##(SPAWN).SpawnFromVec3">SPAWN:SpawnFromVec3(Vec3, OuterRadius, InnerRadius, SpawnIndex)</a></td>
<td class="summary">
<p>Will spawn a group from a Vec3 in 3D space.</p>
</td>
</tr>
<tr>
@ -1358,6 +1379,65 @@ The group that was spawned. You can use this group for further actions.</p>
</dd>
</dl>
<dl class="function">
<dt>
<a id="#(SPAWN).SpawnFromStatic" >
<strong>SPAWN:SpawnFromStatic(HostStatic, OuterRadius, InnerRadius, SpawnIndex)</strong>
</a>
</dt>
<dd>
<p>Will spawn a group from a hosting static.</p>
<p>This function is mostly advisable to be used if you want to simulate spawning from buldings and structures (static buildings).
You can use the returned group to further define the route to be followed.</p>
<h3>Parameters</h3>
<ul>
<li>
<p><code><em><a href="Static.html##(STATIC)">Static#STATIC</a> HostStatic </em></code>:
The static dropping or unloading the group.</p>
</li>
<li>
<p><code><em>#number OuterRadius </em></code>:
(Optional) The outer radius in meters where the new group will be spawned.</p>
</li>
<li>
<p><code><em>#number InnerRadius </em></code>:
(Optional) The inner radius in meters where the new group will NOT be spawned.</p>
</li>
<li>
<p><code><em>#number SpawnIndex </em></code>:
(Optional) The index which group to spawn within the given zone.</p>
</li>
</ul>
<h3>Return values</h3>
<ol>
<li>
<p><em><a href="Group.html##(GROUP)">Group#GROUP</a>:</em>
that was spawned.</p>
</li>
<li>
<p><em>#nil:</em>
Nothing was spawned.</p>
</li>
</ol>
</dd>
</dl>
<dl class="function">
@ -1387,13 +1467,133 @@ The air or ground unit dropping or unloading the group.</p>
<li>
<p><code><em>#number OuterRadius </em></code>:
The outer radius in meters where the new group will be spawned.</p>
(Optional) The outer radius in meters where the new group will be spawned.</p>
</li>
<li>
<p><code><em>#number InnerRadius </em></code>:
The inner radius in meters where the new group will NOT be spawned.</p>
(Optional) The inner radius in meters where the new group will NOT be spawned.</p>
</li>
<li>
<p><code><em>#number SpawnIndex </em></code>:
(Optional) The index which group to spawn within the given zone.</p>
</li>
</ul>
<h3>Return values</h3>
<ol>
<li>
<p><em><a href="Group.html##(GROUP)">Group#GROUP</a>:</em>
that was spawned.</p>
</li>
<li>
<p><em>#nil:</em>
Nothing was spawned.</p>
</li>
</ol>
</dd>
</dl>
<dl class="function">
<dt>
<a id="#(SPAWN).SpawnFromVec2" >
<strong>SPAWN:SpawnFromVec2(Vec2, OuterRadius, InnerRadius, SpawnIndex)</strong>
</a>
</dt>
<dd>
<p>Will spawn a group from a Vec2 in 3D space.</p>
<p>This function is mostly advisable to be used if you want to simulate spawning groups on the ground from air units, like vehicles.
Note that each point in the route assigned to the spawning group is reset to the point of the spawn.
You can use the returned group to further define the route to be followed.</p>
<h3>Parameters</h3>
<ul>
<li>
<p><code><em><a href="DCSTypes.html##(Vec2)">DCSTypes#Vec2</a> Vec2 </em></code>:
The Vec2 coordinates where to spawn the group.</p>
</li>
<li>
<p><code><em>#number OuterRadius </em></code>:
(Optional) The outer radius in meters where the new group will be spawned.</p>
</li>
<li>
<p><code><em>#number InnerRadius </em></code>:
(Optional) The inner radius in meters where the new group will NOT be spawned.</p>
</li>
<li>
<p><code><em>#number SpawnIndex </em></code>:
(Optional) The index which group to spawn within the given zone.</p>
</li>
</ul>
<h3>Return values</h3>
<ol>
<li>
<p><em><a href="Group.html##(GROUP)">Group#GROUP</a>:</em>
that was spawned.</p>
</li>
<li>
<p><em>#nil:</em>
Nothing was spawned.</p>
</li>
</ol>
</dd>
</dl>
<dl class="function">
<dt>
<a id="#(SPAWN).SpawnFromVec3" >
<strong>SPAWN:SpawnFromVec3(Vec3, OuterRadius, InnerRadius, SpawnIndex)</strong>
</a>
</dt>
<dd>
<p>Will spawn a group from a Vec3 in 3D space.</p>
<p>This function is mostly advisable to be used if you want to simulate spawning units in the air, like helicopters or airplanes.
Note that each point in the route assigned to the spawning group is reset to the point of the spawn.
You can use the returned group to further define the route to be followed.</p>
<h3>Parameters</h3>
<ul>
<li>
<p><code><em><a href="DCSTypes.html##(Vec3)">DCSTypes#Vec3</a> Vec3 </em></code>:
The Vec3 coordinates where to spawn the group.</p>
</li>
<li>
<p><code><em>#number OuterRadius </em></code>:
(Optional) The outer radius in meters where the new group will be spawned.</p>
</li>
<li>
<p><code><em>#number InnerRadius </em></code>:
(Optional) The inner radius in meters where the new group will NOT be spawned.</p>
</li>
<li>

View File

@ -151,7 +151,7 @@ If the DCS Static object does not exist or is nil, the STATIC methods will retur
</td>
</tr>
<tr>
<td class="name" nowrap="nowrap"><a href="##(STATIC).GetDCSUnit">STATIC:GetDCSUnit()</a></td>
<td class="name" nowrap="nowrap"><a href="##(STATIC).GetDCSObject">STATIC:GetDCSObject()</a></td>
<td class="summary">
</td>
@ -160,6 +160,12 @@ If the DCS Static object does not exist or is nil, the STATIC methods will retur
<td class="name" nowrap="nowrap"><a href="##(STATIC).Register">STATIC:Register(StaticName)</a></td>
<td class="summary">
</td>
</tr>
<tr>
<td class="name" nowrap="nowrap"><a href="##(STATIC).StaticName">STATIC.StaticName</a></td>
<td class="summary">
</td>
</tr>
</table>
@ -233,8 +239,8 @@ Name of the DCS <strong>Static</strong> as defined within the Mission Editor.</p
<dl class="function">
<dt>
<a id="#(STATIC).GetDCSUnit" >
<strong>STATIC:GetDCSUnit()</strong>
<a id="#(STATIC).GetDCSObject" >
<strong>STATIC:GetDCSObject()</strong>
</a>
</dt>
<dd>
@ -262,6 +268,20 @@ Name of the DCS <strong>Static</strong> as defined within the Mission Editor.</p
</li>
</ul>
</dd>
</dl>
<dl class="function">
<dt>
<em></em>
<a id="#(STATIC).StaticName" >
<strong>STATIC.StaticName</strong>
</a>
</dt>
<dd>
</dd>
</dl>