GetRadarAreaColor: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
(Added OOP syntax)
 
(4 intermediate revisions by 3 users not shown)
Line 1: Line 1:
__NOTOC__  
__NOTOC__  
This function can be used to retrieve the current color of a Radar Area.
{{Server client function}}
This function can be used to retrieve the current color of a [[radararea|radar area]].


==Syntax==  
==Syntax==  
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
int int int int getRadarAreaColor ( radararea theRadararea )               
int, int, int, int getRadarAreaColor ( radararea theRadararea )               
</syntaxhighlight>  
</syntaxhighlight>
{{OOP||[[radararea]]:getColor}}


===Required Arguments===  
===Required Arguments===  
*'''theRadararea:''' The radar area you wish to retrieve the colour of
*'''theRadararea:''' The [[radararea|radar area]] you wish to retrieve the colour of.


===Returns===
===Returns===
Returns four integers in RGBA format (''red'', ''green'', ''blue'', ''alpha''), with a maximum value of 255 for each.  Alpha decides transparancy where 255 is opaque and 0 is transparent.  Returns ''false'' if the radararea is invalid.
Returns four integers in RGBA format (''red'', ''green'', ''blue'', ''alpha''), with a maximum value of 255 for each.  Alpha decides transparency where 255 is opaque and 0 is transparent.  Returns ''false'' if the radararea is invalid.


==Example==  
==Example==  
This example checks the color of a radararea defined as 'area' and announces if it is ballas or grove street.
This example checks the color of a radararea defined as 'area' and announces if it is Ballas or Grove Street territory.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
local r,g,b,a = getRadarAreaColor ( area ) --get the color of 'area' and define it as 'r', 'g', 'b' and 'a'
local r,g,b,a = getRadarAreaColor ( area )           -- get the color of 'area' and store it in 'r', 'g', 'b' and 'a'
if g == 255 then --if the radar area is fully green
if r == 0 and g == 255 and b == 0 then               -- if the radar area is fully green
     outputChatBox ( "This is Grove Street turf!" ) --announce it as grove street area
     outputChatBox ( "This is Grove Street turf!" )   -- announce it as grove street area
elseif r == 255 then --if it is fully red however
elseif r == 255 and g == 0 and b == 255 then         -- if it is purple however
     outputChatBox ( "This is Ballas turf!" ) --announce it as ballas area
     outputChatBox ( "This is Ballas turf!" )         -- announce it as ballas area
end
end
</syntaxhighlight>
</syntaxhighlight>

Latest revision as of 17:35, 26 November 2014

This function can be used to retrieve the current color of a radar area.

Syntax

int, int, int, int getRadarAreaColor ( radararea theRadararea )              

OOP Syntax Help! I don't understand this!

Method: radararea:getColor(...)


Required Arguments

  • theRadararea: The radar area you wish to retrieve the colour of.

Returns

Returns four integers in RGBA format (red, green, blue, alpha), with a maximum value of 255 for each. Alpha decides transparency where 255 is opaque and 0 is transparent. Returns false if the radararea is invalid.

Example

This example checks the color of a radararea defined as 'area' and announces if it is Ballas or Grove Street territory.

local r,g,b,a = getRadarAreaColor ( area )           -- get the color of 'area' and store it in 'r', 'g', 'b' and 'a'
if r == 0 and g == 255 and b == 0 then               -- if the radar area is fully green
    outputChatBox ( "This is Grove Street turf!" )   -- announce it as grove street area
elseif r == 255 and g == 0 and b == 255 then         -- if it is purple however
    outputChatBox ( "This is Ballas turf!" )         -- announce it as ballas area
end

See Also