GetMarkerColor: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
 
mNo edit summary
 
(16 intermediate revisions by 10 users not shown)
Line 1: Line 1:
__NOTOC__
__NOTOC__
==Description==
{{Server client function}}
This function returns three ints corresponding to the amount of red, green and blue (respectively) in the marker's color. It can be useful for coloring objectives text to the same color as the marker.
This function returns the color and transparency for a marker element.


==Syntax==
==Syntax==
int int int [[getMarkerColor]] ( [[marker]] marker )
<syntaxhighlight lang="lua">
int, int, int, int getMarkerColor ( marker theMarker )
</syntaxhighlight>
{{OOP||[[Marker]]:getColor||setMarkerColor}}
===Required Arguments===
*'''theMarker''': The [[marker]] that you wish to retrieve the color of.


This function also has three variants that allow you to retrieve data from just one of the three axes.
===Returns===
Returns four [[int]]s corresponding to the amount of ''red'', ''green'', ''blue'' and ''alpha'' (respectively) of the marker, ''false'' if invalid arguments were passed.


int [[getMarkerColor|getMarkerColorRed]] ( [[marker]] marker )
==Example==
 
<section name="Serverside example" class="server" show="true">
int [[getMarkerColor|getMarkerColorGreen]] ( [[marker]] marker )
This example script fully heals players who hit a white marker, and kills players who hit a red one.
<syntaxhighlight lang="lua">
-- we define the function that will determine if the player is to be healed or killed
function healOrKill ( hitMarker, matchingDimension )
-- if the marker was in a different dimension, stop here to ignore the event
if not matchingDimension then
return
end
-- get the marker's color
local R, G, B, A = getMarkerColor( hitMarker )
-- if its RGB color is 255,255,255 (white),
if R == 255 and G == 255 and B == 255 then
-- heal the player
setElementHealth( source, 100 )
-- if it isn't white, but 255,0,0 (red),
elseif R == 255 and G == 0 and B == 0 then
-- kill the player
killPed( source )
end
end
-- add our function as a handler to "onPlayerMarkerHit"
addEventHandler( "onPlayerMarkerHit", root, healOrKill )
</syntaxhighlight>
</section>


int [[getMarkerColor|getMarkerColorBlue]] ( [[marker]] marker )
==See Also==
 
{{Marker functions}}
===Required Arguments===
*'''marker''': The [[marker]] that you wish to retrieve the color of.
 
==Example==
newmarker = [[createMarker]] ( 1, 1000, 1000, 1000, 1,0,0 )
r,g,b = [[getMarkerColor]] ( newmarker )
if (r) then
  [[serverChat]] ( "Current marker color: ",r,",",g,",",b,"." )
end

Latest revision as of 19:22, 15 July 2024

This function returns the color and transparency for a marker element.

Syntax

int, int, int, int getMarkerColor ( marker theMarker )

OOP Syntax Help! I don't understand this!

Method: Marker:getColor(...)
Counterpart: setMarkerColor


Required Arguments

  • theMarker: The marker that you wish to retrieve the color of.

Returns

Returns four ints corresponding to the amount of red, green, blue and alpha (respectively) of the marker, false if invalid arguments were passed.

Example

Click to collapse [-]
Serverside example

This example script fully heals players who hit a white marker, and kills players who hit a red one.

-- we define the function that will determine if the player is to be healed or killed
function healOrKill ( hitMarker, matchingDimension )
	-- if the marker was in a different dimension, stop here to ignore the event
	if not matchingDimension then
		return
	end
	-- get the marker's color
	local R, G, B, A = getMarkerColor( hitMarker )
	-- if its RGB color is 255,255,255 (white),
	if R == 255 and G == 255 and B == 255 then
		-- heal the player
		setElementHealth( source, 100 )
	-- if it isn't white, but 255,0,0 (red),
	elseif R == 255 and G == 0 and B == 0 then
		-- kill the player
		killPed( source )
	end
end
-- add our function as a handler to "onPlayerMarkerHit"
addEventHandler( "onPlayerMarkerHit", root, healOrKill )

See Also