isTouchingGround: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
(code insertion)
m (Text replacement - "AgentRevolution" to "AgentRev")
 
(52 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{Command|= Comments
{{RV|type=command
____________________________________________________________________________________________


| arma3 |= Game name
|game1= arma3
|0.50|= Game version
|version1= 0.50
|arg= global|= Arguments in MP
____________________________________________________________________________________________


| Returns true if object is touching the ground.  |= Description
|arg= global
____________________________________________________________________________________________


| '''isTouchingGround''' object |= Syntax
|gr1= Object Manipulation


|p1= object: [[Object]]  |= PARAMETER1
|descr= Returns true if object is touching the ground.


| [[Boolean]] |= RETURNVALUE
|s1= [[isTouchingGround]] object


|p1= object: [[Object]]


|x1= <code>if ([[isTouchingGround]] [[player]]) then {[[hint]] "Terraferma!";};
|r1= [[Boolean]]
</code>|= EXAMPLE1


____________________________________________________________________________________________
|x1= <sqf>if (isTouchingGround player) then { hint "Terraferma!" };</sqf>


| [[underwater]] |= SEEALSO
|x2= A full "is safely parked" method for air, ground and water vehicles:
<sqf>
// get if a vehicle is properly parked - covers e.g helicopter landed on a building, boat (beached or not) and underwater or not submarine
// return false on null, disabled or destroyed vehicle
private _isSafelyParked = {
params [
["_vehicle", objNull, [objNull]], // 0: OBJECT - vehicle - a null object returns false
["_altitudeTolerance", 0.1, [0]], // 1: NUMBER - altitude tolerance - in metre
["_velocityTolerance", 0.01, [0]] // 2: NUMBER - velocity tolerance - in km/h
];


|  |= MPBEHAVIOUR
if (not canMove _vehicle) exitWith { false }; // returns false for null as well
____________________________________________________________________________________________
}}


<h3 style='display:none'>Notes</h3>
if (_vehicle isKindOf "Ship") then
<dl class='command_description'>
{
<!-- Note Section BEGIN -->
// surfaceIsWater getPosASL _vehicle // a beached boat is fine
velocity _vehicle params ["_velX", "_velY"];
sqrt (_velX * _velX + _velY * _velY) < _velocityTolerance // only 2D speed matters (think waves)
&& {
getPosASLW _vehicle < _altitudeTolerance // underwater submarines are OK
|| { getPos _vehicle select 2 < _altitudeTolerance } // beached boat
};
}
else
{
// over -a- ground and not over ocean
(isTouchingGround _vehicle || {
getPosASLW _vehicle select 2 >= _altitudeTolerance // not in water
&& { getPos _vehicle select 2 < _altitudeTolerance }
})
&& { vectorMagnitude velocity _vehicle * 3.6 < _velocityTolerance }
}
};


<!-- Note Section END -->
objectParent player call _isSafelyParked;
</dl>
</sqf>


<h3 style='display:none'>Bottom Section</h3>
|seealso= [[underwater]]
[[Category:Arma_3:_New_Scripting_Commands_List|{{uc:{{PAGENAME}}}}]]
}}
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]


<!-- CONTINUE Notes -->
{{Note
<dl class="command_description">
|user= AgentRev
<dd class="notedate">Posted on June 1, 2014 - 01:23 (UTC)</dd>
|timestamp= 20140601012300
<dt class="note">'''[[User:AgentRevolution|AgentRevolution]]'''</dt>
|text= If you are using this command as a validation method, it should not be the sole thing you are checking for, as the result is often inaccurate.
<dd class="note">
For example, it returns false for some helicopters when landed on the roof of certain buildings, and it always returns false for boats, even if they are beached.
If you are using this command as a validation method, it should not be the sole thing you are checking for, as the result is often inaccurate. For example, it returns false for some helicopters when landed on the roof of certain buildings, and it always returns false for boats, even if they are beached.
}}
</dd>
</dl>
<!-- DISCONTINUE Notes -->


<!-- CONTINUE Notes -->
{{Note
<dl class="command_description">
|user= Demellion
<dd class="notedate">Posted on September 29, 2016 - 08:28 (UTC)</dd>
|timestamp= 20160929082800
<dt class="note">[[User:Demellion|Demellion]]</dt>
|text= In addition to previous statement: That behaviour is true, simply because [[isTouchingGround]] applied to a player unit (or any unit) is frozen to a last state when unit enters vehicle.
<dd class="note">
In addition to previous statement: That behaviour is true, simply beacuse '''isTouchingGround''' applied to a player unit (or any unit) is frozen to a last state when unit enters vehicle.
To get proper return from this command you should go for units [[vehicle]]:  
To get proper return from this command you should go for units [[vehicle]]:  
<code>_var = isTouchingGround player // Unreliable
<sqf>
_var = isTouchingGround (vehicle player) // Pretty reliable
_var = isTouchingGround player; // unreliable
</code>
_var = isTouchingGround (vehicle player); // pretty reliable
</dd>
</sqf>
</dl>
}}
<!-- DISCONTINUE Notes -->
 
{{Note
|user= Pierre MGI
|timestamp= 20161110205700
|text= This command returns always true if the falling object is attached to some other object with the [[attachTo]] command, like for vehicle air drop with parachute.
}}
 
{{Note
|user= Gippo
|timestamp= 20170426200200
|text= Be aware: it is not reliable on remote objects.
}}

Latest revision as of 23:07, 4 May 2024

Arma 3 logo black.png0.50
GAGlobal
Hover & click on the images for description

Description

Description:
Returns true if object is touching the ground.
Groups:
Object Manipulation

Syntax

Syntax:
isTouchingGround object
Parameters:
object: Object
Return Value:
Boolean

Examples

Example 1:
if (isTouchingGround player) then { hint "Terraferma!" };
Example 2:
A full "is safely parked" method for air, ground and water vehicles:
// get if a vehicle is properly parked - covers e.g helicopter landed on a building, boat (beached or not) and underwater or not submarine // return false on null, disabled or destroyed vehicle private _isSafelyParked = { params [ ["_vehicle", objNull, [objNull]], // 0: OBJECT - vehicle - a null object returns false ["_altitudeTolerance", 0.1, [0]], // 1: NUMBER - altitude tolerance - in metre ["_velocityTolerance", 0.01, [0]] // 2: NUMBER - velocity tolerance - in km/h ]; if (not canMove _vehicle) exitWith { false }; // returns false for null as well if (_vehicle isKindOf "Ship") then { // surfaceIsWater getPosASL _vehicle // a beached boat is fine velocity _vehicle params ["_velX", "_velY"]; sqrt (_velX * _velX + _velY * _velY) < _velocityTolerance // only 2D speed matters (think waves) && { getPosASLW _vehicle < _altitudeTolerance // underwater submarines are OK || { getPos _vehicle select 2 < _altitudeTolerance } // beached boat }; } else { // over -a- ground and not over ocean (isTouchingGround _vehicle || { getPosASLW _vehicle select 2 >= _altitudeTolerance // not in water && { getPos _vehicle select 2 < _altitudeTolerance } }) && { vectorMagnitude velocity _vehicle * 3.6 < _velocityTolerance } } }; objectParent player call _isSafelyParked;

Additional Information

See also:
underwater

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
AgentRev - c
Posted on Jun 01, 2014 - 01:23 (UTC)
If you are using this command as a validation method, it should not be the sole thing you are checking for, as the result is often inaccurate. For example, it returns false for some helicopters when landed on the roof of certain buildings, and it always returns false for boats, even if they are beached.
Demellion - c
Posted on Sep 29, 2016 - 08:28 (UTC)
In addition to previous statement: That behaviour is true, simply because isTouchingGround applied to a player unit (or any unit) is frozen to a last state when unit enters vehicle. To get proper return from this command you should go for units vehicle:
_var = isTouchingGround player; // unreliable _var = isTouchingGround (vehicle player); // pretty reliable
Pierre MGI - c
Posted on Nov 10, 2016 - 20:57 (UTC)
This command returns always true if the falling object is attached to some other object with the attachTo command, like for vehicle air drop with parachute.
Gippo - c
Posted on Apr 26, 2017 - 20:02 (UTC)
Be aware: it is not reliable on remote objects.
Retrieved from "https://community.bistudio.com/wiki?title=isTouchingGround&oldid=364128"