SetRadarAreaFlashing: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 1: Line 1:
__NOTOC__  
__NOTOC__
{{Server function}}
This function makes an existing radar area flash in transparency.
This function makes an existing radar area flash in transparency.


Line 18: Line 19:
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
local isFlashing = isRadarAreaFlashing ( someArea )
local isFlashing = isRadarAreaFlashing ( someArea )
if isFlashing then -- if the area is already flashing...
if isFlashing then                                           -- if the area is already flashing...
  outputChatBox ( "The radar area is already flashing." )
    outputChatBox ( "The radar area is already flashing." )
else -- it it isn't...
else                                                         -- if it isn't...
  setRadarAreaFlashing ( someArea, true ) -- make the area flash
    setRadarAreaFlashing ( someArea, true )                 -- make the area flash
end
end
</syntaxhighlight>
</syntaxhighlight>


'''Example 2:'''This example creates a radar area for the ''King of the Hill'' script, and a colsquare. When the player enters the radar area flashes, it stops flashing when a player leaves.
'''Example 2:''' This example creates a radar area for the ''King of the Hill'' script, and a colsquare. When the player enters the radar area flashes, it stops flashing when a player leaves.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
-- create our hill area for our gamemode
-- create our hill area for our gamemode
Line 33: Line 34:
-- add hill_Enter as a handler for when a player enters the hill area
-- add hill_Enter as a handler for when a player enters the hill area
function hill_Enter ( thePlayer, matchingDimension )
function hill_Enter ( thePlayer, matchingDimension )
--announce to everyone that the player entered the hill
    -- announce to everyone that the player entered the hill
outputChatBox( getClientName(thePlayer).." entered the zone!", getRootElement(), 255, 255, 109, )
    outputChatBox( getClientName(thePlayer) .. " entered the zone!", getRootElement(), 255, 255, 109 )
setRadarAreaFlashing ( hillRadar, true )
    setRadarAreaFlashing ( hillRadar, true )
end
end
addEventHandler ( "onColShapeHit", hillArea, hill_Enter )
addEventHandler ( "onColShapeHit", hillArea, hill_Enter )
Line 41: Line 42:
-- add hill_Enter as a handler for when a player leaves the hill area
-- add hill_Enter as a handler for when a player leaves the hill area
function hill_Exit ( thePlayer, matchingDimension )
function hill_Exit ( thePlayer, matchingDimension )
--check if the player is not dead
    -- check if the player is not dead
if isPlayerDead ( thePlayer ) ~= true then
    if isPlayerDead ( thePlayer ) ~= true then
--if he was alive, announce to everyone that the player has left the hill
        -- if he was alive, announce to everyone that the player has left the hill
outputChatBox ( getClientName(thePlayer).." left the zone!", getRootElement(), 255, 255, 109 )
        outputChatBox ( getClientName(thePlayer) .. " left the zone!", getRootElement(), 255, 255, 109 )
setRadarAreaFlashing ( hillRadar, false )
        setRadarAreaFlashing ( hillRadar, false )
end
    end
end
end
addEventHandler ( "onColShapeLeave", hillArea, hill_Exit )
addEventHandler ( "onColShapeLeave", hillArea, hill_Exit )

Revision as of 20:53, 15 August 2007

This function makes an existing radar area flash in transparency.

Syntax

bool setRadarAreaFlashing ( radararea theRadarArea, bool flash )

Required Arguments

  • theRadarArea: the radararea element we want to change flashing state of.
  • flash: a bool indicating whether the radar area should flash (true to flash, false to not flash).

Returns

Returns true if the new flash state was successfully set, false if the radar area doesn't exist or invalid arguments were passed.

Example

Example 1: This example checks to see whether an existing radar area (someArea) is flashing, and forces it to flash if it isn't:

local isFlashing = isRadarAreaFlashing ( someArea )
if isFlashing then                                           -- if the area is already flashing...
    outputChatBox ( "The radar area is already flashing." )
else                                                         -- if it isn't...
    setRadarAreaFlashing ( someArea, true )                  -- make the area flash
end

Example 2: This example creates a radar area for the King of the Hill script, and a colsquare. When the player enters the radar area flashes, it stops flashing when a player leaves.

-- create our hill area for our gamemode
local hillArea = createColSquare ( -2171.0678710938, 678.17950439453, 0, 15, 15 )
local hillRadar = createRadarArea ( -2183.5678710938, 705.67950439453, 40, -40, 0, 255, 0, 175 )

-- add hill_Enter as a handler for when a player enters the hill area
function hill_Enter ( thePlayer, matchingDimension )
    -- announce to everyone that the player entered the hill
    outputChatBox( getClientName(thePlayer) .. " entered the zone!", getRootElement(), 255, 255, 109 )
    setRadarAreaFlashing ( hillRadar, true )
end
addEventHandler ( "onColShapeHit", hillArea, hill_Enter )

-- add hill_Enter as a handler for when a player leaves the hill area
function hill_Exit ( thePlayer, matchingDimension )
    -- check if the player is not dead
    if isPlayerDead ( thePlayer ) ~= true then
        -- if he was alive, announce to everyone that the player has left the hill
        outputChatBox ( getClientName(thePlayer) .. " left the zone!", getRootElement(), 255, 255, 109 )
        setRadarAreaFlashing ( hillRadar, false )
    end
end
addEventHandler ( "onColShapeLeave", hillArea, hill_Exit )

See Also