MIST getUnitsInPolygon

From DCS World Wiki - Hoggitworld.com
Revision as of 23:08, 19 January 2023 by Grimes (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)


Added with: Mist 3.5
Returns a table of units from the table unitNameTable that are inside of the polygon zone.
table mist.getUnitsInPolygon(table unitNameTable ,table poly , number maxAlt )
Valid Input Values:
unitNameTable: mist.makeUnitTable({"[blue][helicopter]"})

poly: mist.getGroupPoints('polyPath1')

maxAlt: 200

Return value:
Return example:
Usage Examples:
The following will generate a message of the unit names of blue helicopters that are inside a polygon zone designated by the points of a route belonging to a group "weirdShapeLZ".

    local LZ = mist.getGroupPoints("weirdShapeLZ")
    local choppas = mist.makeUnitTable({"[blue][helicopter]"})
    local inZone = mist.getUnitsInPolygon(choppas , LZ)
    local msg = {"The following helicopters are in the landing zone: "}
    for i = 1, #inZone do
       msg[#msg+1] = inZone[i]:getName()
       msg[#msg+1] = "\n"
    trigger.action.outText(table.concat(msg), 20)
Units must be activated to be counted as inside the zone.
Related Functions
makeUnitTable, getRandPointInCircle, getRandomPointInZone, getRandomPointInPoly, isTerrainValid, terrainHeightDiff, getUnitsInZones, getUnitsInMovingZones, pointInPolygon, getUnitsInPolygon, getDeadMapObjsInZones, getDeadMapObjsInPolygonZone, getUnitsLOS, random, randomizeNumTable, getAvgPoint, getQFE, getWindBearingAndVel, getPathLength, getPathInSegments, getPointAtDistanceOnPath, projectPoint, getGroupsByAttribute, , getUnitsByAttribute, mapValue,

Scripting Engine

MIST Root Page