PoliticalOrel at 12:29, 8 March 2010

2010-03-08T12:29:44Z

← Older revision		Revision as of 12:29, 8 March 2010
Line 1:		Line 1:
	__NOTOC__		__NOTOC__
	{{RU/Client function}}		{{RU/Client function}}
	~~This function gets the~~ Z ~~level of the highest ground below a point~~.		Эта функция помогает вам узнать наивысшую точку на оси координат Z в данной точке.

	It is required that the point is near enough to the local player so that it's within the area where collision data is loaded. If this is not the case, an incorrect position will be returned.		It is required that the point is near enough to the local player so that it's within the area where collision data is loaded. If this is not the case, an incorrect position will be returned.

PoliticalOrel: Created page with 'NOTOC {{RU/Client function}} This function gets the Z level of the highest ground below a point. It is required that the point is near enough to the local player so that it…'

2010-03-08T12:24:17Z

Created page with '__NOTOC__ {{RU/Client function}} This function gets the Z level of the highest ground below a point. It is required that the point is near enough to the local player so that it…'

New page

__NOTOC__
{{RU/Client function}}
This function gets the Z level of the highest ground below a point.

It is required that the point is near enough to the local player so that it's within the area where collision data is loaded. If this is not the case, an incorrect position will be returned.

==Использование==
<syntaxhighlight lang="lua">
float getGroundPosition ( float x, float y, float z )
</syntaxhighlight>

===Необходимые параметры===
*'''x:''' A floating point number representing the X world coordinate of the point.
*'''y:''' A floating point number representing the Y world coordinate of the point.
*'''z:''' A floating point number representing the Z world coordinate of the point.

===Что возвращается===
Returns a float with the highest ground-level Z coord if parameters are valid, ''0'' if the point you tried to test is outside the loaded world map, ''false'' otherwise.

==Пример==
This clientside function determines if a player is under a ceiling or not.
<syntaxhighlight lang="lua">
function isPlayerUnderCover ( thePlayer )
--we get the player's position
local px, py, pz = getElementPosition ( thePlayer )
--we'll check for ground level at the player's position, and also 500 units over him.
--if these ground levels match, it must mean there were no obstacles (such as a ceiling) over the player,
if getGroundPosition ( px, py, pz ) == getGroundPosition ( px, py, pz + 500 ) then
-- so the player is not under cover
return false
--otherwise, there was an object over him,
else
-- so the player is under cover
return true
end
end
</syntaxhighlight>

==Смотри также==
{{RU/Client_world_functions}}

[[en:getGroundPosition]]

RU/getGroundPosition - Revision history

PoliticalOrel at 12:29, 8 March 2010

PoliticalOrel: Created page with '__NOTOC__ {{RU/Client function}} This function gets the Z level of the highest ground below a point. It is required that the point is near enough to the local player so that it…'

PoliticalOrel: Created page with 'NOTOC {{RU/Client function}} This function gets the Z level of the highest ground below a point. It is required that the point is near enough to the local player so that it…'