GetMarkerTarget: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 3: Line 3:


==Syntax==  
==Syntax==  
<section name="Server" class="server">
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
float float float getMarkerTarget ( element marker )   
float float float getMarkerTarget ( element marker )   
Line 10: Line 11:
*'''marker:''' The marker you wish to retieve the target position of.
*'''marker:''' The marker you wish to retieve the target position of.


===Returns===
Returns three ''float'' if a target is set, ''false'' in the first variable and ''nil'' in the two others if the marker is invalid or no target is set.
</section>
<section name="Client" class="client">
<syntaxhighlight lang="lua">
float float float getMarkerTarget ( element marker ) 
</syntaxhighlight>
===Required Arguments===
*'''marker:''' The marker you wish to retieve the target position of.


===Returns===
===Returns===
Returns three ''float'' if a target is set, ''false'' in the first variable and ''nil'' in the two others if the marker is invalid or no target is set.
Returns three ''float'' if a target is set, ''false'' in the first variable and ''nil'' in the two others if the marker is invalid or no target is set.
</section>


==Example==  
==Example==  

Revision as of 12:25, 3 August 2007

This function returns the x,y,z-position of the specified markers target, the position it points to.

Syntax

Click to expand [+]
Server
Click to expand [+]
Client

Example

This example outputs the markers target (if available) when a player hits a marker.

function nextCheck(player)
	local x,y,z = getMarkerTarget(source) -- get the marker target
	if (x ~= false) then -- if a target is set for the marker, then..
		outputChatBox("Next checkpoint at: "..x.." "..y.." "..z,player) -- output a message with the coordinates
	end
end
addEventHandler("onMarkerHit",getRootElement(),nextCheck) -- add an event handler for the 'onMarkerHit' event

See Also