surfaceIsWater: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
(add. classification)
mNo edit summary
 
(67 intermediate revisions by 8 users not shown)
Line 1: Line 1:
{{Command|= Comments
{{RV|type=command
____________________________________________________________________________________________


| arma |= Game name
|game1= ofpe
|version1= 1.00


|1.00|= Game version
|game2= arma1
____________________________________________________________________________________________
|version2= 1.00


| Returns whether water is at given position. |= Description
|game3= arma2
____________________________________________________________________________________________
|version3= 1.00


|[[Boolean]] <nowiki>=</nowiki>  '''surfaceIsWater''' [x, y] |= Syntax
|game4= arma2oa
|version4= 1.50


|p1= [x, y]: [[Array]] - format [[Position2D]] |= Parameter 1
|game5= tkoh
|version5= 1.00


| [[Boolean]] |= Return value
|game6= arma3
____________________________________________________________________________________________
|version6= 0.50


| |= See also
|gr1= Positions


|descr= Returns whether there is water at given position. In Arma 3, it also detects pond objects, but only if they are loaded in memory (normally only true if the objects are within the [[setObjectViewDistance|object view distance]])
|s1= [[surfaceIsWater]] position
|p1= position: [[Array]] format [[Position#Introduction|Position2D]]  or [[Array]] format [[Position#Introduction|Position3D]] - when using [[Position#Introduction|Position3D]] Z will be ignored
|r1= [[Boolean]]
|x1= <sqf>private _result = surfaceIsWater [1000, 3000];</sqf>
|x2= <sqf>_isWater = surfaceIsWater position player;</sqf>
|seealso= [[surfaceType]] [[surfaceNormal]] [[nearRoads]] [[roadsConnectedTo]] [[roadAt]] [[isOnRoad]]
}}
}}


<h3 style="display:none">Notes</h3>
<dl class="command_description">
<dl class="command_description">
<!-- Note Section BEGIN -->


<!-- Note Section END -->
<dt></dt>
<dd class="notedate">Posted on 4 May, 2012</dd>
<dt class="note">[[User:Osmo|Osmo]]</dt>
<dd class="note">
Does not work with inland water. Works only with sea water.
 
<dt></dt>
<dd class="notedate">Posted on 2021-07-19 - 06:11 (UTC)</dd>
<dt class="note">[[User:Leopard20|Leopard20]]</dt>
<dd class="note">
The above note is not true in Arma 3. The command '''does detect pond objects''' and will return true if there is a pond object at that position. However, the object must have been loaded in memory (normally only true if the object is within the object view distance)
</dd>
</dl>
</dl>
<h3 style="display:none">Bottom Section</h3>
[[Category:Scripting Commands|SURFACEISWATER]]
[[Category:Scripting Commands OFP Elite |SURFACEISWATER]]
[[Category:Scripting Commands ArmA|SURFACEISWATER]]
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands VBS2|{{uc:{{PAGENAME}}}}]]

Latest revision as of 21:39, 28 September 2023

Hover & click on the images for description

Description

Description:
Returns whether there is water at given position. In Arma 3, it also detects pond objects, but only if they are loaded in memory (normally only true if the objects are within the object view distance)
Groups:
Positions

Syntax

Syntax:
surfaceIsWater position
Parameters:
position: Array format Position2D or Array format Position3D - when using Position3D Z will be ignored
Return Value:
Boolean

Examples

Example 1:
private _result = surfaceIsWater [1000, 3000];
Example 2:
_isWater = surfaceIsWater position player;

Additional Information

See also:
surfaceType surfaceNormal nearRoads roadsConnectedTo roadAt isOnRoad

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
Posted on 4 May, 2012
Osmo
Does not work with inland water. Works only with sea water.
Posted on 2021-07-19 - 06:11 (UTC)
Leopard20
The above note is not true in Arma 3. The command does detect pond objects and will return true if there is a pond object at that position. However, the object must have been loaded in memory (normally only true if the object is within the object view distance)