# Closest Unit To Point

Grammar — Closest unit to point in unitGroup|Unit Group
Flags — Native | Function

Picks the closest unit to the point specified in a unit group.

# Arguments

• unitgroup — Unit Group
• point — Point

Returns — unit

native unit UnitGroupClosestToPoint(unitgroup g, point p);

# Related

Category: Unit Group / Groups

• [F] — void — Add Unit To Unit Group — ( UnitGroupAdd )
• [F] — void — Add Unit Group To Unit Group Old — ( libNtve_gf_AddUnitGroupToUnitGroup )
• [F] — void — Add Unit Group To Unit Group — ( UnitGroupAddUnitGroup )
• [F] — void — Unit Object Group Call For Help — ( UnitObjectGroupCallForHelp )
• [F] — void — Remove Unit From Unit Group — ( UnitGroupRemove )
• [F] — void — Remove Unit Group From Unit Group Old — ( libNtve_gf_RemoveUnitGroupFromUnitGroup )
• [F] — void — Remove Unit Group From Unit Group — ( UnitGroupRemoveUnitGroup )
• [F] — void — Remove All Units From Unit Group — ( UnitGroupClear )
• [F] — void — Pause All Units In Unit Group — ( UnitGroupPauseAll )
• [F] — int — Create Unit Object Group From Unit Group — ( UnitObjectGroupFromUnitGroup )
• [F] — int — Number Of Units In Unit Group — ( UnitGroupCount )
• [F] — bool — Unit In Unit Group — ( UnitGroupHasUnit )
• [F] — unit — Unit From Unit Group — ( UnitGroupUnit )
• [F] — unit — Random Unit From Unit Group — ( UnitGroupRandomUnit )
• [F] — unitgroup — Copy Of Unit Group — ( UnitGroupCopy )
• [F] — unit — Closest Unit To Point Old — ( libNtve_gf_ClosestUnitToPoint )
• [F] — unit — Closest Unit To Point — ( UnitGroupClosestToPoint )
• [F] — point — Center Of Unit Group Old — ( libNtve_gf_CenterOfUnitGroup )
• [F] — point — Center Of Unit Group — ( UnitGroupCenterOfGroup )

# Examples

# campaigns/swarm.sc2campaign

— MapScript.galaxy

// L1864
UnitGroupClosestToPoint(UnitGroup("InvisibleTargetDummy", 0, RegionFromName(("Bonus Objective Activate " + IntToString(lv_bonusIndex))), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), UnitGetPosition(auto32A283DE_var))

// L2456
UnitGroupClosestToPoint(lv_availableZealots, UnitGroupCenterOfGroup(lv_playersUnits))

// L2521
UnitGroupClosestToPoint(lv_availableZealots, UnitGroupCenterOfGroup(lv_playersUnits))

// L2586
UnitGroupClosestToPoint(lv_availableZealots, UnitGroupCenterOfGroup(lv_playersUnits))

// L6466
UnitGroupClosestToPoint(gv_victoryRescuedProtoss, UnitGetPosition(gv_victoryZeratul))

// L408
UnitGroupClosestToPoint(UnitGroup(null, gv_pLAYER_01_USER, RegionCircle(UnitGetPosition(lp_observer), 11.0), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), UnitGetPosition(lp_observer))

// L669
UnitGroupClosestToPoint(UnitGroup(null, gv_pLAYER_01_USER, lv_attackRegion, UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), UnitGetPosition(lp_hybrid))

// L676
UnitGroupClosestToPoint(UnitGroup(null, gv_pLAYER_01_USER, lv_attackRegion, UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), UnitGetPosition(lp_hybrid))

// L1472
UnitGroupClosestToPoint(lv_validTargets, UnitGetPosition(auto16E4DC23_var))

// L4062
UnitGroupClosestToPoint(UnitGroup(null, gv_pLAYER_01_USER, RegionFromId(52), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), UnitGetPosition(UnitGroupUnit(lv_remainingAscendants, 1)))

// L6419
UnitGroupClosestToPoint(lv_validTargets, UnitGetPosition(autoB0D64614_var))

// L6480
UnitGroupClosestToPoint(lv_validTargets, UnitGetPosition(autoFA044A09_var))

// L2372
UnitGroupClosestToPoint(lv_playerBuildings, UnitGetPosition(gv_tHE_ONE_GORGON))

// L844
UnitGroupClosestToPoint(UnitGroup(null, gv_pLAYER_01_USER, gv_flashFreezeRetreatAreas[lv_currentArea], UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), RegionGetCenter(gv_flashFreezeRetreatAreas[lv_currentArea]))

// L3444
UnitGroupClosestToPoint(UnitGroup("HybridScienceFacility", c_playerAny, RegionPlayableMap(), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), UnitGetPosition(UnitGroupUnit(UnitGroup(null, gv_pLAYER_01_USER, RegionFromId(41), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32)) | (1 << (c_targetFilterSummoned - 32))), 1), 1)))

// L4133
UnitGroupClosestToPoint(lv_dominions_Left, PointFromId(1239))

// L4136
UnitGroupClosestToPoint(lv_dominions_Right, PointFromId(1239))

// L1201
UnitGroupClosestToPoint(UnitGroup(null, gv_pLAYER_02_DOMINION, RegionCircle(UnitGetPosition(gv_stukov), 12.0), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), UnitGetPosition(gv_stukov))

// L1403
UnitGroupClosestToPoint(lv_playerUnits, UnitGetPosition(auto74F695C2_var))

// L1465
UnitGroupClosestToPoint(lv_playerUnits, UnitGetPosition(auto3A48285B_var))

// L3977
UnitGroupClosestToPoint(lv_consumeDNATargets, UnitGetPosition(auto9D485733_var))

// L5651
UnitGroupClosestToPoint(UnitGroup(null, gv_pLAYER_02_DOMINION, RegionCircle(UnitGetPosition(gv_kerrigan), 20.0), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), UnitGetPosition(gv_kerrigan))

// L823
UnitGroupClosestToPoint(UnitGroup("Drone", gv_pLAYER_01_USER, RegionFromId(47), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), PointFromId(164))

// L822
UnitGroupClosestToPoint(UnitGroup("Drone", gv_pLAYER_01_USER, RegionFromId(28), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), PointFromId(57))

// L971
UnitGroupClosestToPoint(UnitGroup("Drone", gv_pLAYER_01_USER, RegionFromId(2), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), PointFromId(561))

// L8785
UnitGroupClosestToPoint(lv_tempUnitGroup, lv_points[lv_i])

// L8799
UnitGroupClosestToPoint(lv_tempUnitGroup, lv_points[lv_i])

// L4040
UnitGroupClosestToPoint(lv_repairBots10, UnitGetPosition(gv_hyperion))

// L1808
UnitGroupClosestToPoint(gv_aIHarvestGroups[lp_harvestIndex], UnitGetPosition(gv_corpse_PerCamp[lv_campIndex]))

// L740
UnitGroupClosestToPoint(lv_attackGroup, PointFromId(36))

// L2033
UnitGroupClosestToPoint(lv_yagdraInitialAttackGroup, RegionGetCenter(RegionFromId(29)))

// L2269
UnitGroupClosestToPoint(gv_airAttackGroup, PointFromId(36))

// L2270
UnitGroupClosestToPoint(gv_airAttackGroup, PointFromId(36))

// L3076
UnitGroupClosestToPoint(lv_leftEnemyGroup, UnitGetPosition(auto62188331_var))

// L3080
UnitGroupClosestToPoint(lv_fullEnemyGroup, UnitGetPosition(auto62188331_var))

// L3093
UnitGroupClosestToPoint(lv_middleEnemyGroup, UnitGetPosition(auto854D4A6A_var))

// L3097
UnitGroupClosestToPoint(lv_fullEnemyGroup, UnitGetPosition(auto854D4A6A_var))

// L3110
UnitGroupClosestToPoint(lv_rightEnemyGroup, UnitGetPosition(auto0607D50B_var))

// L3114
UnitGroupClosestToPoint(lv_fullEnemyGroup, UnitGetPosition(auto0607D50B_var))

// L1336
UnitGroupClosestToPoint(UnitGroup(null, gv_pLAYER_01_USER, gv_zurvanTentacleRegions[lp_tentacle], UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), RegionGetCenter(gv_zurvanTentacleRegions[lp_tentacle]))

// L2766
UnitGroupClosestToPoint(lv_playerUnits, UnitGetPosition(auto43C9DCDF_var))

// L2927
UnitGroupClosestToPoint(lv_primalGroup, UnitGetPosition(lv_currentCritter))

// L1355
UnitGroupClosestToPoint(gv_impalerPlayerUnits, PointFromId(1109))

// L1412
UnitGroupClosestToPoint(gv_impalerPlayerUnits, PointFromId(1109))

// L3519
UnitGroupClosestToPoint(UnitGroup("Overlord", gv_pLAYER_05_ZERG_ALLIES, RegionFromId(4), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), PointFromId(550))

// L1060
UnitGroupClosestToPoint(gv_mutaliskGroup, UnitGetPosition(UnitGroupLoopCurrent()))

// L1067
UnitGroupClosestToPoint(gv_mutaliskGroup, UnitGetPosition(UnitGroupLoopCurrent()))

// L1274
UnitGroupClosestToPoint(gv_broodLordsGroup, UnitGetPosition(lv_viking))

// L2379
UnitGroupClosestToPoint(gv_torrasques, PointFromId(719))

// L1355
UnitGroupClosestToPoint(gv_impalerPlayerUnits, PointFromId(1109))

// L1412
UnitGroupClosestToPoint(gv_impalerPlayerUnits, PointFromId(1109))

// L3519
UnitGroupClosestToPoint(UnitGroup("Overlord", gv_pLAYER_05_ZERG_ALLIES, RegionFromId(4), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), PointFromId(550))

// L1060
UnitGroupClosestToPoint(gv_mutaliskGroup, UnitGetPosition(UnitGroupLoopCurrent()))

// L1067
UnitGroupClosestToPoint(gv_mutaliskGroup, UnitGetPosition(UnitGroupLoopCurrent()))

// L1274
UnitGroupClosestToPoint(gv_broodLordsGroup, UnitGetPosition(lv_viking))

// L2379
UnitGroupClosestToPoint(gv_torrasques, PointFromId(719))

// L2372
UnitGroupClosestToPoint(lv_playerBuildings, UnitGetPosition(gv_tHE_ONE_GORGON))

// L844
UnitGroupClosestToPoint(UnitGroup(null, gv_pLAYER_01_USER, gv_flashFreezeRetreatAreas[lv_currentArea], UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), RegionGetCenter(gv_flashFreezeRetreatAreas[lv_currentArea]))

// L3444
UnitGroupClosestToPoint(UnitGroup("HybridScienceFacility", c_playerAny, RegionPlayableMap(), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), UnitGetPosition(UnitGroupUnit(UnitGroup(null, gv_pLAYER_01_USER, RegionFromId(41), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32)) | (1 << (c_targetFilterSummoned - 32))), 1), 1)))

// L4133
UnitGroupClosestToPoint(lv_dominions_Left, PointFromId(1239))

// L4136
UnitGroupClosestToPoint(lv_dominions_Right, PointFromId(1239))

// L1201
UnitGroupClosestToPoint(UnitGroup(null, gv_pLAYER_02_DOMINION, RegionCircle(UnitGetPosition(gv_stukov), 12.0), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), UnitGetPosition(gv_stukov))

// L1403
UnitGroupClosestToPoint(lv_playerUnits, UnitGetPosition(auto74F695C2_var))

// L1465
UnitGroupClosestToPoint(lv_playerUnits, UnitGetPosition(auto3A48285B_var))

// L3977
UnitGroupClosestToPoint(lv_consumeDNATargets, UnitGetPosition(auto9D485733_var))

// L5651
UnitGroupClosestToPoint(UnitGroup(null, gv_pLAYER_02_DOMINION, RegionCircle(UnitGetPosition(gv_kerrigan), 20.0), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), UnitGetPosition(gv_kerrigan))

// L823
UnitGroupClosestToPoint(UnitGroup("Drone", gv_pLAYER_01_USER, RegionFromId(47), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), PointFromId(164))

// L822
UnitGroupClosestToPoint(UnitGroup("Drone", gv_pLAYER_01_USER, RegionFromId(28), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), PointFromId(57))

// L971
UnitGroupClosestToPoint(UnitGroup("Drone", gv_pLAYER_01_USER, RegionFromId(2), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), PointFromId(561))

// L8785
UnitGroupClosestToPoint(lv_tempUnitGroup, lv_points[lv_i])

// L8799
UnitGroupClosestToPoint(lv_tempUnitGroup, lv_points[lv_i])

// L4040
UnitGroupClosestToPoint(lv_repairBots10, UnitGetPosition(gv_hyperion))

// L1808
UnitGroupClosestToPoint(gv_aIHarvestGroups[lp_harvestIndex], UnitGetPosition(gv_corpse_PerCamp[lv_campIndex]))

// L740
UnitGroupClosestToPoint(lv_attackGroup, PointFromId(36))

// L2033
UnitGroupClosestToPoint(lv_yagdraInitialAttackGroup, RegionGetCenter(RegionFromId(29)))

// L2269
UnitGroupClosestToPoint(gv_airAttackGroup, PointFromId(36))

// L2270
UnitGroupClosestToPoint(gv_airAttackGroup, PointFromId(36))

// L3076
UnitGroupClosestToPoint(lv_leftEnemyGroup, UnitGetPosition(auto62188331_var))

// L3080
UnitGroupClosestToPoint(lv_fullEnemyGroup, UnitGetPosition(auto62188331_var))

// L3093
UnitGroupClosestToPoint(lv_middleEnemyGroup, UnitGetPosition(auto854D4A6A_var))

// L3097
UnitGroupClosestToPoint(lv_fullEnemyGroup, UnitGetPosition(auto854D4A6A_var))

// L3110
UnitGroupClosestToPoint(lv_rightEnemyGroup, UnitGetPosition(auto0607D50B_var))

// L3114
UnitGroupClosestToPoint(lv_fullEnemyGroup, UnitGetPosition(auto0607D50B_var))

// L1336
UnitGroupClosestToPoint(UnitGroup(null, gv_pLAYER_01_USER, gv_zurvanTentacleRegions[lp_tentacle], UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), RegionGetCenter(gv_zurvanTentacleRegions[lp_tentacle]))

// L2766
UnitGroupClosestToPoint(lv_playerUnits, UnitGetPosition(auto43C9DCDF_var))

// L2927
UnitGroupClosestToPoint(lv_primalGroup, UnitGetPosition(lv_currentCritter))

// L6466
UnitGroupClosestToPoint(gv_victoryRescuedProtoss, UnitGetPosition(gv_victoryZeratul))

// L1864
UnitGroupClosestToPoint(UnitGroup("InvisibleTargetDummy", 0, RegionFromName(("Bonus Objective Activate " + IntToString(lv_bonusIndex))), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), UnitGetPosition(auto32A283DE_var))

// L2456
UnitGroupClosestToPoint(lv_availableZealots, UnitGroupCenterOfGroup(lv_playersUnits))

// L2521
UnitGroupClosestToPoint(lv_availableZealots, UnitGroupCenterOfGroup(lv_playersUnits))

// L2586
UnitGroupClosestToPoint(lv_availableZealots, UnitGroupCenterOfGroup(lv_playersUnits))

// L408
UnitGroupClosestToPoint(UnitGroup(null, gv_pLAYER_01_USER, RegionCircle(UnitGetPosition(lp_observer), 11.0), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), UnitGetPosition(lp_observer))

// L669
UnitGroupClosestToPoint(UnitGroup(null, gv_pLAYER_01_USER, lv_attackRegion, UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), UnitGetPosition(lp_hybrid))

// L676
UnitGroupClosestToPoint(UnitGroup(null, gv_pLAYER_01_USER, lv_attackRegion, UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), UnitGetPosition(lp_hybrid))

// L1472
UnitGroupClosestToPoint(lv_validTargets, UnitGetPosition(auto16E4DC23_var))

// L4062
UnitGroupClosestToPoint(UnitGroup(null, gv_pLAYER_01_USER, RegionFromId(52), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), UnitGetPosition(UnitGroupUnit(lv_remainingAscendants, 1)))

// L6419
UnitGroupClosestToPoint(lv_validTargets, UnitGetPosition(autoB0D64614_var))

// L6480
UnitGroupClosestToPoint(lv_validTargets, UnitGetPosition(autoFA044A09_var))

# campaigns/swarmstory.sc2campaign

— SwarmCampaignLib.galaxy

// L4599
UnitGroupClosestToPoint(lv_resourceGroup, UnitGetPosition(lv_indexWorker))

// L4623
UnitGroupClosestToPoint(lv_resourceGroup, UnitGetPosition(lv_indexWorker))