getTerrainHeight: Difference between revisions

Latest revision as of 14:32, 20 September 2025

Hover & click on the images for description

Description:: Returns terrain height at the specified location.
ⓘ
Unlike getTerrainHeightASL which returns the exact position's height, this command returns the height at the closest terrain grid pixel to the provided position:
private _cellWidth = getTerrainInfo # 2; getTerrainHeightASL (_pos apply { _cellWidth * round (_x / _cellWidth) });
Groups:: Positions

Syntax:: getTerrainHeight positionWorld
Parameters:: positionWorld: Array format Position2D or Position3D - world coordinates
Return Value:: Number - terrain height

: 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

@@ Line 4: / Line 4: @@
 |version1= 2.10
-|branch= dev
-|gr1= Diagnostic
+|gr1= Positions
 |descr= Returns terrain height at the specified location.
-{{Feature|informative|Unlike [[getTerrainHeightASL]] which  returns the exact position's height, this commands returns the apex of the terrain polygon.}}
+{{Feature|informative|
+Unlike [[getTerrainHeightASL]] which returns the exact position's height, this command returns the height at the closest terrain grid pixel to the provided position:
+<sqf>
+private _cellWidth = getTerrainInfo # 2;
+getTerrainHeightASL (_pos apply { _cellWidth * round (_x / _cellWidth) });
+</sqf>
+}}
 |s1= [[getTerrainHeight]] positionWorld
-|p1= positionWorld: [[Position#Introduction|Position2D]] or [[Position#Introduction|Position3D]] - Position in world coordinates either in [[Position#Introduction|Position2D]] or [[Position#Introduction|Position3D]]
+|p1= positionWorld: [[Array]] format [[Position#Introduction|Position2D]] or [[Position#Introduction|Position3D]] - world coordinates
 |r1= [[Number]] - terrain height
-|x1= <sqf>private _h = diag_getTerrainHeight position player;</sqf>
+|x1= <sqf>private _gridCellHeight = getTerrainHeight getPosWorld player;</sqf>
-|seealso= [[setTerrainHeight]] [[getTerrainInfo]]
+|seealso= [[setTerrainHeight]] [[getTerrainHeightASL]] [[getTerrainInfo]]
 }}