surfaceNormal: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - " +" to " ")
m (Some wiki formatting)
 
(21 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{RV|type=command
{{RV|type=command


| arma2oa
|game1= arma2oa
|version1= 1.60


|1.60
|game2= tkoh
|version2= 1.00
 
|game3= arma3
|version3= 0.50


|gr1= Positions
|gr1= Positions


| Returns {{Wikipedia|Normal_(geometry)|surface normal}} on given position.
|descr= Returns terrain's {{Link|https://en.wikipedia.org/wiki/Normal_(geometry)|surface normal}} on given position.


| '''surfaceNormal''' position
|s1= [[surfaceNormal]] position


|p1= position: [[Array]] - format [[Position2D]] or [[Position3D]] in which case Z will be ignored
|p1= position: [[Array]] format [[Position#Introduction|Position2D]] or [[Position#Introduction|Position3D]] - when using [[Position#Introduction|Position3D]], Z is ignored


| [[Array]] - Example: [-0.102321,0.19977,0.974486]
|r1= [[Array]] format [[Vector3D]]


|x1= <code>_normal <nowiki>=</nowiki> [[surfaceNormal]] [300, 500];</code>
|x1= <sqf>_normal = surfaceNormal [300, 500];</sqf>


|x2= <code>_normal <nowiki>=</nowiki> [[surfaceNormal]] [[position]] [[player]];</code>
|x2= <sqf>_normal = surfaceNormal getPosASL player;</sqf>


|seealso= [[setVectorUp]], [[surfaceIsWater]], [[surfaceType]]
|seealso= [[setVectorUp]] [[surfaceIsWater]] [[surfaceType]]
}}
}}
{{GameCategory|arma2|Scripting Commands}}
{{GameCategory|arma3|Scripting Commands}}
[[Category:Arma 2: Operation Arrowhead: New Scripting Commands|{{uc:{{PAGENAME}}}}]]

Latest revision as of 15:24, 8 November 2023

Hover & click on the images for description

Description

Description:
Returns terrain's surface normal on given position.
Groups:
Positions

Syntax

Syntax:
surfaceNormal position
Parameters:
position: Array format Position2D or Position3D - when using Position3D, Z is ignored
Return Value:
Array format Vector3D

Examples

Example 1:
_normal = surfaceNormal [300, 500];
Example 2:
_normal = surfaceNormal getPosASL player;

Additional Information

See also:
setVectorUp surfaceIsWater surfaceType

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