surfaceIsWater: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (template:command argument fix)
mNo edit summary
 
(56 intermediate revisions by 3 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


|'''surfaceIsWater''' position |SYNTAX=
|game4= arma2oa
|version4= 1.50


|p1= position: [[Array]] - format [[Position2D]]  or [[Position3D]] in which case Z will be ignored |PARAMETER1=
|game5= tkoh
|version5= 1.00


| [[Boolean]] |RETURNVALUE=
|game6= arma3
|version6= 0.50


____________________________________________________________________________________________
|gr1= Positions


|x1= <code>_isWater= [[surfaceIsWater]] [1000, 3000];</code>|EXAMPLE1=
|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]])


|x2= <code>_isWater = [[surfaceIsWater]] [[position]] [[player]];</code>|EXAMPLE2=
|s1= [[surfaceIsWater]] position
____________________________________________________________________________________________


| [[surfaceType]], [[surfaceNormal]], [[nearRoads]], [[roadsConnectedTo]], [[roadAt]], [[isOnRoad]] |SEEALSO=
|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 -->
 
<dd class="notedate">Posted on 4 May, 2012
<dt></dt>
<dt class="note">'''[[User:Osmo|Osmo]]'''<dd class="note">
<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.
Does not work with inland water. Works only with sea water.


 
<dt></dt>
<!-- Note Section END -->
<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 Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting_Commands_Take_On_Helicopters|{{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)