Auto commit by GitHub Actions Workflow

Documentation/Utilities.Utils.html

@@ -3077,6 +3077,12 @@ use negative idp for rounding ahead of decimal place, positive for rounding afte
             <td class="name w3-half w3-container" style="word-wrap: break-word"><p><a href="##(UTILS).ValidateAndRepositionGroundUnits">UTILS.ValidateAndRepositionGroundUnits(Positions, Anchor, MaxRadius, Spacing)</a></p></td>
             <td class="summary w3-half w3-container" style="word-wrap: break-word">
 <p>This function uses Disposition and other fallback logic to find better ground positions for ground units.</p>
+</td>
+          </tr>
+          <tr class="w3-border">
+            <td class="name w3-half w3-container" style="word-wrap: break-word"><p><a href="##(UTILS).ValidateAndRepositionStatic">UTILS.ValidateAndRepositionStatic(Positions, Position, MaxRadius, Country, Category, Type, ShapeName)</a></p></td>
+            <td class="summary w3-half w3-container" style="word-wrap: break-word">
+<p>This function uses Disposition and other fallback logic to find better ground positions for ground units.</p>
 </td>
           </tr>
           <tr class="w3-border">
@@ -12983,6 +12989,123 @@ static, shape_name is optional. Also, livery_id is optional, but is applied to t
         </div>
 </div>
 
+</div>
+</div>
+
+        <div class="w3-card-2 w3-padding-small w3-margin-top">
+
+<div class="w3-theme-l2">
+<h2><a id="#(UTILS).ValidateAndRepositionStatic" ><strong>UTILS.ValidateAndRepositionStatic(Positions, Position, MaxRadius, Country, Category, Type, ShapeName)</strong></a></h2>
+</div>
+    
+<p>This function uses Disposition and other fallback logic to find better ground positions for ground units.</p>
+
+    
+<ul>
+    <li>NOTE: This is not a spawn randomizer.</li>
+    <li>It will try to find clear ground locations avoiding trees, water, roads, runways, map scenery, statics and other units in the area and modifies the provided positions table.</li>
+    <li>Maintains the original layout and unit positions as close as possible by searching for the next closest valid position to each unit.</li>
+</ul>
+
+<div id= "#Functions##ValidateAndRepositionStatic" class="w3-show w3-white">
+  <div class="w3-container w3-white" id="functiontype">
+   <h2><strong>Defined in:</strong></h2>
+   <div class="w3-margin-left">
+<p>UTILS</p>
+</div>
+    <h2><strong>Parameters:</strong></h2>
+        <div class="w3-row w3-margin-left w3-border-bottom w3-border-l2">
+          <div class="w3-half">
+            <p>
+                #table
+            <strong><strong>Positions</strong></strong>
+            </p>
+          </div>
+          <div class="w3-half">
+              
+<p>A table of DCS#Vec2 or DCS#Vec3, can be a units table from the group template.</p>
+
+          </div>
+        </div>
+        <div class="w3-row w3-margin-left w3-border-bottom w3-border-l2">
+          <div class="w3-half">
+            <p>
+                <a href="DCS.html##(Vec2)">DCS#Vec2</a>
+            <strong><strong>Position</strong></strong>
+            </p>
+          </div>
+          <div class="w3-half">
+              
+<p>DCS#Vec2 or DCS#Vec3 initial spawn location.</p>
+
+          </div>
+        </div>
+        <div class="w3-row w3-margin-left w3-border-bottom w3-border-l2">
+          <div class="w3-half">
+            <p>
+                #number
+            <strong><strong>MaxRadius</strong></strong>
+            </p>
+          </div>
+          <div class="w3-half">
+              
+<p>(Optional) Max radius to search for valid ground locations in meters. Default is double the max radius of the static.</p>
+
+          </div>
+        </div>
+        <div class="w3-row w3-margin-left w3-border-bottom w3-border-l2">
+          <div class="w3-half">
+            <p>
+            <strong><strong>Country</strong></strong>
+            </p>
+          </div>
+          <div class="w3-half">
+              <p></p>
+          </div>
+        </div>
+        <div class="w3-row w3-margin-left w3-border-bottom w3-border-l2">
+          <div class="w3-half">
+            <p>
+            <strong><strong>Category</strong></strong>
+            </p>
+          </div>
+          <div class="w3-half">
+              <p></p>
+          </div>
+        </div>
+        <div class="w3-row w3-margin-left w3-border-bottom w3-border-l2">
+          <div class="w3-half">
+            <p>
+            <strong><strong>Type</strong></strong>
+            </p>
+          </div>
+          <div class="w3-half">
+              <p></p>
+          </div>
+        </div>
+        <div class="w3-row w3-margin-left w3-border-bottom w3-border-l2">
+          <div class="w3-half">
+            <p>
+            <strong><strong>ShapeName</strong></strong>
+            </p>
+          </div>
+          <div class="w3-half">
+              <p></p>
+          </div>
+        </div>
+    <h2><strong>Return value:</strong></h2>
+    <div class="w3-row w3-border-bottom w3-margin-left">
+      <div class="w3-half">
+        <p><a href="DCS.html##(Vec2)">DCS#Vec2</a>:</p>
+      </div>
+      <div class="w3-half">
+        
+<p>Initial Position if it's valid, else a valid spawn position. nil if no valid position found.</p>
+
+      </div>
+    </div>
+</div>
+
 </div>
 </div>