GetElementVelocity - Revision history

Pirulax: /* Example */

2018-05-25T17:49:19Z

Example

← Older revision		Revision as of 17:49, 25 May 2018
Line 19:		Line 19:
	This example retrieves, calculates, and displays the speed of a random player.		This example retrieves, calculates, and displays the speed of a random player.
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	-- ~~find~~ a player ~~named "someguy"~~ and get ~~his~~ velocity.		-- get a random player and get its velocity
	speedx, speedy, speedz = getElementVelocity ( getRandomPlayer() )		speedx, speedy, speedz = getElementVelocity ( getRandomPlayer() )

Dfigfjf: /* Example */

2016-02-21T13:59:35Z

Example

← Older revision		Revision as of 13:59, 21 February 2016
Line 24:		Line 24:
	-- use pythagorean theorem to get actual velocity		-- use pythagorean theorem to get actual velocity
	-- raising something to the exponent of 0.5 is the same thing as taking a square root.		-- raising something to the exponent of 0.5 is the same thing as taking a square root.
	actualspeed = (speedx^2 + speedy^2 + speedz^2)^(0.5)		actualspeed = (speedx^2 + speedy^2 + speedz^2)^(0.5) -- can be: math.sqrt(speedx^2 + speedy^2 + speedz^2)

	-- multiply by 50 to obtain the speed in metres per second		-- multiply by 50 to obtain the speed in metres per second

AlexTMjugador: Fixed OOP

2015-07-30T16:37:42Z

Fixed OOP

← Older revision		Revision as of 16:37, 30 July 2015
Line 5:		Line 5:
	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">float float float getElementVelocity ( element theElement )</syntaxhighlight>		<syntaxhighlight lang="lua">float float float getElementVelocity ( element theElement )</syntaxhighlight>
	{{OOP\|\|\|[[element]]:getVelocity\|velocity\|}}		{{OOP\|\|[[element]]:getVelocity\|velocity\|setElementVelocity\|}}

	===Required Arguments===		===Required Arguments===

Qaisjp at 03:34, 1 January 2015

2015-01-01T03:34:04Z

← Older revision		Revision as of 03:34, 1 January 2015
Line 5:		Line 5:
	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">float float float getElementVelocity ( element theElement )</syntaxhighlight>		<syntaxhighlight lang="lua">float float float getElementVelocity ( element theElement )</syntaxhighlight>
	{{OOP\|~~This function is also a static function underneath the Element class.~~\|[[element]]:getVelocity\|velocity\|}}		{{OOP\|\|\|[[element]]:getVelocity\|velocity\|}}

	===Required Arguments===		===Required Arguments===

Jaysds: /* Syntax */ OOP

2014-08-16T16:24:57Z

Syntax: OOP

← Older revision		Revision as of 16:24, 16 August 2014
Line 5:		Line 5:
	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">float float float getElementVelocity ( element theElement )</syntaxhighlight>		<syntaxhighlight lang="lua">float float float getElementVelocity ( element theElement )</syntaxhighlight>
			{{OOP\|This function is also a static function underneath the Element class.\|[[element]]:getVelocity\|velocity\|}}

	===Required Arguments===		===Required Arguments===

Jaysds1: /* Example */

2012-12-11T20:06:58Z

Example

← Older revision		Revision as of 20:06, 11 December 2012
Line 16:		Line 16:
	==Example==		==Example==
	<section name="Server" class="server" show="true">		<section name="Server" class="server" show="true">
	This example retrieves, calculates, and displays the speed of a player ~~named ''someguy''~~.		This example retrieves, calculates, and displays the speed of a random player.
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	-- find a player named "someguy" and get his velocity.		-- find a player named "someguy" and get his velocity.
	speedx, speedy, speedz = getElementVelocity ( ~~getPlayerFromName~~ ( ~~"someguy"~~ ) )		speedx, speedy, speedz = getElementVelocity ( getRandomPlayer() )

	-- use pythagorean theorem to get actual velocity		-- use pythagorean theorem to get actual velocity

Mickdermack: Replaced deprecated function getPlayerFromNick with getPlayerFromName

2011-06-18T16:00:26Z

Replaced deprecated function getPlayerFromNick with getPlayerFromName

← Older revision		Revision as of 16:00, 18 June 2011
Line 19:		Line 19:
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	-- find a player named "someguy" and get his velocity.		-- find a player named "someguy" and get his velocity.
	speedx, speedy, speedz = getElementVelocity ( ~~getPlayerFromNick~~ ( "someguy" ) )		speedx, speedy, speedz = getElementVelocity ( getPlayerFromName ( "someguy" ) )

	-- use pythagorean theorem to get actual velocity		-- use pythagorean theorem to get actual velocity

Lordeveider da Silva: Clarification of units used

2011-01-13T14:47:01Z

Clarification of units used

← Older revision		Revision as of 14:47, 13 January 2011
Line 11:		Line 11:
	===Returns===		===Returns===
	If succesful, returns three ''float''s that represent the element's current velocity along the ''x'', ''y'', and ''z'' axis respectively. This function can fail if the element is a player in a car. Use the vehicle element in this case. It will also fail if the element specified does not have a velocity, or does not exist. In case of failure, the first return value will be ''false''.		If succesful, returns three ''float''s that represent the element's current velocity along the ''x'', ''y'', and ''z'' axis respectively. This function can fail if the element is a player in a car. Use the vehicle element in this case. It will also fail if the element specified does not have a velocity, or does not exist. In case of failure, the first return value will be ''false''.

			The returned values are expressed in GTA units per 1/50th of a second[http://forum.mtasa.com/viewtopic.php?f=91&t=31225]. A GTA Unit is equal to one metre[http://gta.wikia.com/Unit#GTA3.2C_GTAVC_.26_GTASA].

	==Example==		==Example==
Line 18:		Line 20:
	-- find a player named "someguy" and get his velocity.		-- find a player named "someguy" and get his velocity.
	speedx, speedy, speedz = getElementVelocity ( getPlayerFromNick ( "someguy" ) )		speedx, speedy, speedz = getElementVelocity ( getPlayerFromNick ( "someguy" ) )

	-- use pythagorean theorem to get actual velocity		-- use pythagorean theorem to get actual velocity
	-- raising something to the exponent of 0.5 is the same thing as taking a square root.		-- raising something to the exponent of 0.5 is the same thing as taking a square root.
	actualspeed = (speedx^2 + speedy^2 + speedz^2)^(0.5)		actualspeed = (speedx^2 + speedy^2 + speedz^2)^(0.5)

			-- multiply by 50 to obtain the speed in metres per second
			mps = actualspeed * 50

			-- other useful conversions
			-- kilometres per hour
			kmh = actualspeed * 180
			-- miles per hour
			mph = actualspeed * 111.847

	-- report the results.		-- report the results.
	outputChatBox ( "Someguy's current velocity: " .. ~~actualspeed~~ .. " ~~arbitrary units~~." )		outputChatBox ( "Someguy's current velocity: " .. mps .. " metres per second." )
	</syntaxhighlight>		</syntaxhighlight>
	</section>		</section>

Sebassje at 21:50, 16 November 2009

2009-11-16T21:50:48Z

← Older revision		Revision as of 21:50, 16 November 2009
Line 1:		Line 1:
	{{Server client function}}		{{Server client function}}
	__NOTOC__		__NOTOC__
	~~==Description==~~
	This function returns three floats containing the velocity (movement speeds) along the X, Y, and Z axis respectively. This means that velocity values can be positive and negative for each axis.		This function returns three floats containing the velocity (movement speeds) along the X, Y, and Z axis respectively. This means that velocity values can be positive and negative for each axis.

Line 12:		Line 11:
	===Returns===		===Returns===
	If succesful, returns three ''float''s that represent the element's current velocity along the ''x'', ''y'', and ''z'' axis respectively. This function can fail if the element is a player in a car. Use the vehicle element in this case. It will also fail if the element specified does not have a velocity, or does not exist. In case of failure, the first return value will be ''false''.		If succesful, returns three ''float''s that represent the element's current velocity along the ''x'', ''y'', and ''z'' axis respectively. This function can fail if the element is a player in a car. Use the vehicle element in this case. It will also fail if the element specified does not have a velocity, or does not exist. In case of failure, the first return value will be ''false''.


	==Example==		==Example==

Ransom at 03:03, 1 June 2008

2008-06-01T03:03:27Z

← Older revision		Revision as of 03:03, 1 June 2008
Line 2:		Line 2:
	__NOTOC__		__NOTOC__
	==Description==		==Description==
	This function returns three floats containing the velocity (movement speeds) along the X, Y, and Z axis respectively.		This function returns three floats containing the velocity (movement speeds) along the X, Y, and Z axis respectively. This means that velocity values can be positive and negative for each axis.

	==Syntax==		==Syntax==