Multi Theft Auto: Wiki - User contributions [en]

GetSoundMaxDistance

2009-03-29T17:26:55Z

Silverfang: /* Returns */

__NOTOC__
{{Client function}}
Gets a custom [[sound]] max distance at which the sound stops.

==Syntax==
<syntaxhighlight lang="lua">int getSoundMaxDistance ( element sound )</syntaxhighlight>

===Required Arguments===
*'''sound:''' a [[sound]] element.

===Returns===
Returns an ''integer'' of the max distance, ''false'' if invalid arguments where passed.

==Example==
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
local sound = playSound3D("sounds/song.mp3", 373.14, -125.21, 1001, true)

function getmaxdistanceFunc()
outputChatBox("Max distance: "..getSoundMaxDistance(sound))
end
addCommandHandler("getmaxdistance", getmaxdistanceFunc)
</syntaxhighlight>
</section>

==See Also==
{{Client_audio_functions}}

CreateRadarArea

2008-07-29T17:55:13Z

Silverfang: /* Example */

__NOTOC__
{{Server client function}}
This function can be used to create custom radar areas on the radar.

==Syntax==
<syntaxhighlight lang="lua">
radararea createRadarArea ( float centerX, float centerY, float sizeX, float sizeY, [ int r = 255, int g = 0, int b = 0, int a = 255, element visibleTo = getRootElement() ] )
</syntaxhighlight>

===Required Arguments===
*'''centerX:''' A float representing the center 'x' position of the radar area.
*'''centerY:''' A float representing the center 'y' position of the radar area.
*'''sizeX:''' A float representing the width of the radar area.
*'''sizeY:''' A float representing the height of the radar area.

*'''r:''' An integer representing the amount of red in the color. Maximum value is 255
*'''g:''' An integer representing the amount of green in the color. Maximum value is 255
*'''b:''' An integer representing the amount of blue in the color. Maximum value is 255
*'''a:''' An integer representing the amount of alpha in the color. This allows setting the transparency of the radar area. 255 is opaque and 0 is transparent.

===Optional Arguments===
{{OptionalArg}}
*'''visibleTo:''' An [[element]] that you wish to restrict the [[visibility]] of the radar area to.

==Example==
<section name="Server" class="server" show="true">
This example creates a radar area for the King of the hill script, and a colsquare. When the player enters the radar area it flashes, and stops flashing when a player leaves it.
<syntaxhighlight lang="lua">
-- create our hill area for our gamemode
local hillArea = createColRectangle ( -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
if (getElementType(thePlayer) == "player") then
outputChatBox( getClientName(thePlayer) .. " entered the zone!", getRootElement(), 255, 255, 109 )
setRadarAreaFlashing ( hillRadar, true )
end
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 (getElementType(thePlayer) == "player") then
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
end
addEventHandler ( "onColShapeLeave", hillArea, hill_Exit )
</syntaxhighlight>
</section>

==See Also==
{{Radar area_functions}}

CreateRadarArea

2008-07-29T17:54:33Z

Silverfang: /* Example */