SPAWN: Added InitRandomizePosition API

-- SPAWN:InitRandomizePosition( RandomizePosition, OuterRadius,
InnerRadius ) added.
-- SPA-350 test missions
-- Documentation Update
-- testing.

Moose Test Missions/SPA - Spawning/SPA-350 - Spawn at Vec3 position RandomzePosition/SPA-350 - Spawn at Vec3 position RandomzePosition.lua

@@ -0,0 +1,73 @@
+---
+-- Name: SPA-350 - Spawn at Vec3 position RandomzePosition
+-- Author: FlightControl
+-- Date Created: 14 Mar 2017
+--
+-- # Situation:
+--
+-- Ground troops, Airplanes, Helicopters and Ships are spawning from Vec3 points.
+-- The API InitRandomizePosition is tested here, ensure that groups are replaced within a 900 to 1000 zone band at random positions.
+-- 
+-- # Test cases:
+-- 
+-- 1. Observe the random positioning of the groups. There should be no scattering of units.
+-- 
+
+local Iterations = 10
+local Iteration = 1
+
+GroundZones = { "GroundZone1", "GroundZone2", "GroundZone3" }
+GroundRandomizeZones = { "GroundRandomizeZone1", "GroundRandomizeZone2", "GroundRandomizeZone3" }
+AirplaneZones = { "AirplaneZone1", "AirplaneZone2", "AirplaneZone3" }
+HelicopterZones = { "HelicopterZone1", "HelicopterZone2", "HelicopterZone3" }
+ShipZones = { "ShipZone1", "ShipZone2", "ShipZone3" }
+
+HeightLimit = 500
+
+SpawnGrounds = SPAWN:New("Ground"):InitLimit( 20, 10 ):InitRandomizePosition( true , 1000, 900 )
+SpawnRandomizeGrounds = SPAWN:New("GroundRandomize"):InitLimit( 20, 10 ):InitRandomizePosition( true , 1000, 900 )
+SpawnAirplanes = SPAWN:New("Airplane"):InitLimit( 20, 10 ):InitRandomizePosition( true , 1000, 900 )
+SpawnHelicopters = SPAWN:New("Helicopter"):InitLimit( 20, 10 ):InitRandomizePosition( true , 1000, 900 )
+SpawnShips = SPAWN:New("Ship"):InitLimit( 20, 10 ):InitRandomizePosition( true , 1000, 900 )
+
+--- Spawns these groups slowly.
+SCHEDULER:New( nil,
+
+  function( Interation, Iterations )
+    do
+      -- Spawn Ground
+      local ZoneName = GroundZones[ math.random( 1, 3 ) ]
+      local SpawnVec3 = POINT_VEC3:NewFromVec3( ZONE:New( ZoneName ):GetVec3() )
+      SpawnGrounds:SpawnFromVec3( SpawnVec3:GetVec3() )  
+    end
+    
+    do
+      -- Spawn Ground Randomize
+      local ZoneName = GroundRandomizeZones[ math.random( 1, 3 ) ]
+      local SpawnVec3 = POINT_VEC3:NewFromVec3( ZONE:New( ZoneName ):GetVec3() )
+      SpawnRandomizeGrounds:SpawnFromVec3( SpawnVec3:GetVec3() )  
+    end
+    
+    do
+      -- Spawn Airplanes
+      local ZoneName = AirplaneZones[ math.random( 1, 3 ) ]
+      local SpawnVec3 = POINT_VEC3:NewFromVec3( ZONE:New( ZoneName ):GetVec3() )
+      SpawnAirplanes:SpawnFromVec3( SpawnVec3:GetVec3() )  
+    end
+    
+    do
+      -- Spawn Helicopters
+      local ZoneName = HelicopterZones[ math.random( 1, 3 ) ]
+      local SpawnVec3 = POINT_VEC3:NewFromVec3( ZONE:New( ZoneName ):GetVec3() )
+      SpawnHelicopters:SpawnFromVec3( SpawnVec3:GetVec3() )  
+    end
+    
+    do
+      -- Spawn Ships
+      local ZoneName = ShipZones[ math.random( 1, 3 ) ]
+      local SpawnVec3 = POINT_VEC3:NewFromVec3( ZONE:New( ZoneName ):GetVec3() )
+      SpawnShips:SpawnFromVec3( SpawnVec3:GetVec3() )  
+    end
+    
+  end, {}, 0, 15, 0.5 
+)