nearestBuilding: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
No edit summary
m (Some wiki formatting)
 
(98 intermediate revisions by 19 users not shown)
Line 1: Line 1:
back to [[Scripting_Reference#N|COMREF]]
{{RV|type=command


<h2 style="color:#000066">'''nearestBuilding ''obj'''''</h2>
|game1= ofp
|version1= 1.00


|game2= ofpe
|version2= 1.00


'''Operand types:'''
|game3= arma1
|version3= 1.00


'''obj:''' [[Object]]
|game4= arma2
|version4= 1.00


'''Type of returned value:'''
|game5= arma2oa
|version5= 1.50


[[Object]]
|game6= tkoh
|version6= 1.00


'''Description:'''
|game7= arma3
|version7= 0.50


Nearest building to given '''object'''.
|gr1= Object Detection


|descr= Finds the nearest building to a given object or position. A "building" is defined as an object that is of class "House" and contains a path LOD.


'''Example:'''
|s1= [[nearestBuilding]] position


_nBuilding = '''nearestBuilding''' [[player]]
|p1= position: [[Object]] or [[Array]] in format [[Position#Introduction|Position2D]] or [[Position#PositionAGL|PositionAGL]]
 
|r1= [[Object]]
 
|x1= <sqf>_nBuilding = nearestBuilding player;</sqf>
 
|x2= <sqf>_nBuilding = nearestBuilding position player;</sqf>
 
|seealso= [[buildingPos]] [[nearestObject]] [[nearestObjects]] [[nearObjects]] [[nearestLocation]] [[nearEntities]] [[nearTargets]] [[nearSupplies]] [[nearestLocationWithDubbing]] [[nearObjectsReady]] [[nearRoads]] [[nearestMines]]
}}
 
{{Note
|user= Pierre MGI
|timestamp= 20160218201800
|text= This command doesn't return any house or building placed in editor (with [[createVehicle]]). Use [[nearestObjects]] instead:
<sqf>nearestObjects [player, ["House", "Building"], 50] select 0</sqf>
}}
 
{{Note
|user= Tankbuster
|timestamp= 20201230160400
|text= Some large buildings are not found by this command. "Land_Airport_Tower_F", "Land_Offices_01_V1_F" and "Land_Hotel_02_F" are examples.
}}

Latest revision as of 21:29, 21 August 2022

Logo A0.png1.00ofpe logo.png1.00Logo A1 black.png1.00Logo A2.png1.00A2 OA Logo.png1.50tkoh logo small.png1.00Arma 3 logo black.png0.50
Hover & click on the images for description

Description

Description:
Finds the nearest building to a given object or position. A "building" is defined as an object that is of class "House" and contains a path LOD.
Groups:
Object Detection

Syntax

Syntax:
nearestBuilding position
Parameters:
position: Object or Array in format Position2D or PositionAGL
Return Value:
Object

Examples

Example 1:
_nBuilding = nearestBuilding player;
Example 2:
_nBuilding = nearestBuilding position player;

Additional Information

See also:
buildingPos nearestObject nearestObjects nearObjects nearestLocation nearEntities nearTargets nearSupplies nearestLocationWithDubbing nearObjectsReady nearRoads nearestMines

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note
Pierre MGI - c
Posted on Feb 18, 2016 - 20:18 (UTC)
This command doesn't return any house or building placed in editor (with createVehicle). Use nearestObjects instead:
nearestObjects [player, ["House", "Building"], 50] select 0
Tankbuster - c
Posted on Dec 30, 2020 - 16:04 (UTC)
Some large buildings are not found by this command. "Land_Airport_Tower_F", "Land_Offices_01_V1_F" and "Land_Hotel_02_F" are examples.
Retrieved from "https://community.bistudio.com/wiki?title=nearestBuilding&oldid=330128"