Multi Theft Auto: Wiki - User contributions [en]

RequestBrowserDomains

2019-07-31T08:47:56Z

Crytx: /* Optional Arguments */

__NOTOC__
{{Client function}}
{{New feature/item|3.0150|1.5||
This function opens a request window in order to accept the requested remote URLs.
{{Note|You must use this function prior to calling [[loadBrowserURL]] because every domain, with exceptions in the whitelist [https://github.com/multitheftauto/mtasa-blue/blob/e11685cab4beb7958ab202261f9c9d9b4ce71e58/Client/cefweb/CWebCore.cpp#L280-L283 here] and [https://github.com/multitheftauto/mtasa-blue/blob/e11685cab4beb7958ab202261f9c9d9b4ce71e58/Client/cefweb/CWebCore.cpp#L205-L206 there], is blocked by default.}}
}}

==Syntax==
<syntaxhighlight lang="lua">bool requestBrowserDomains ( table pages [, bool parseAsURL = false, function callback ] )</syntaxhighlight>
{{OOP||[[Element/Browser|Browser]].requestDomains}}

===Required Arguments===
*'''pages:''' A table containing all domains

===Optional Arguments===
*'''parseAsURL:''' ''true'' if the passed addresses should be converted from URLs, ''false'' otherwise.
*'''callback:''' A callback function that is called as soon as the result is available
Syntax:
<syntaxhighlight lang="lua">function(bool wasAccepted, table new_domains)</syntaxhighlight>

===Returns===
Returns '''true''', if the string was successfully read, '''false''' otherwise.

==Example==
<syntaxhighlight lang="lua">requestBrowserDomains({ "mtasa.com" }) -- request browser domain
showCursor(true) -- show cursor
addEventHandler("onClientBrowserWhitelistChange", root,
function(newDomains)
if newDomains[1] == "mtasa.com" then
local browser = createBrowser(1280, 720, false, false) -- create browser
loadBrowserURL(browser, "http://mtasa.com/") -- load browser url
end
end
)
</syntaxhighlight>

==See also==
{{CEF_functions}}

[[hu:requestBrowserDomains]]

OnPickupHit

2018-07-31T11:21:41Z

Crytx:

__NOTOC__
{{Server event}}
This event is triggered when a [[player]] hits a [[pickup]].

==Parameters==
<syntaxhighlight lang="lua">
player thePlayer
</syntaxhighlight>

*'''thePlayer''': a [[player]] element referring to the player who moved over the [[pickup]].

==Source==
The [[event system#Event source|source]] of this event is the [[pickup]] that was hit by the player.

==Cancel effect==
If this event is [[Event system#Canceling|canceled]], the pickup does not disappear and the player does not receive its bonus.

==Example==
This example creates a pickup and outputs a message to the chat box when a player walks over it.
<syntaxhighlight lang="lua">
local thePickup = createPickup( 10, 10, 10, 2, 31, 3000, 50 ) -- Create a M4 weapon pickup when the script starts

function pickedUpWeaponCheck( player )
outputChatBox( "You have picked up a M4.", player ) -- Output a message to the chatbox
end
addEventHandler( "onPickupHit", thePickup, pickedUpWeaponCheck )
</syntaxhighlight>

==See Also==
{{Pickup events}}

OnPickupHit

2018-07-31T11:20:44Z

Crytx:

__NOTOC__
{{Server event}}
This event is triggered when a [[pickup]] hits a [[player]].

==Parameters==
<syntaxhighlight lang="lua">
player thePlayer
</syntaxhighlight>

*'''thePlayer''': a [[player]] element referring to the player who moved over the [[pickup]].

==Source==
The [[event system#Event source|source]] of this event is the [[pickup]] that was hit by the player.

==Cancel effect==
If this event is [[Event system#Canceling|canceled]], the pickup does not disappear and the player does not receive its bonus.

==Example==
This example creates a pickup and outputs a message to the chat box when a player walks over it.
<syntaxhighlight lang="lua">
local thePickup = createPickup( 10, 10, 10, 2, 31, 3000, 50 ) -- Create a M4 weapon pickup when the script starts

function pickedUpWeaponCheck( player )
outputChatBox( "You have picked up a M4.", player ) -- Output a message to the chatbox
end
addEventHandler( "onPickupHit", thePickup, pickedUpWeaponCheck )
</syntaxhighlight>

==See Also==
{{Pickup events}}

GetElementBoundingBox

2018-07-03T05:48:26Z

Crytx:

{{Client function}}
__NOTOC__
This function returns the minimum and maximum coordinates of an element's bounding box.

It should be noted that the values returned are relative to the position of the element, and as such if you wish to get world coordinates for drawing,...etc, you should retrieve the position of the element and add the returned values onto that.

'''Note:''' The element must be streamed in for this function to work.

==Syntax==
<syntaxhighlight lang="lua">
float float float float float float getElementBoundingBox ( element theElement )
</syntaxhighlight>
{{OOP||[[element]]:getBoundingBox}}

===Required Arguments===
'''theElement:''' the element whose bounding box we want to get.

===Returns===
*Returns ''min x, min y, min z, max x, max y, max z'' if the passed element is valid and streamed in, ''false'' otherwise.

==Example==
This example outputs to chatbox the minimum and the maximum coordinates of an element.
<syntaxhighlight lang="lua">
function minMaxOutput ( theElement )
local x0, y0, z0, x1, y1, z1 = getElementBoundingBox ( theElement )
if ( x0 ) then
outputChatBox ( "The coords are: " .. x0 .. ", " .. y0 .. ", " .. z0 .. ", " .. x1 .. ", " .. y1 .. ", " .. z1 )
else
outputChatBox ( "Failed to retrieve bounding box" )
end
end
</syntaxhighlight>

==See Also==
{{Client element functions}}

SetPlayerMuted

2018-06-24T03:57:13Z

Crytx:

{{note| Don't forget to give admin rights to the resource, in which you are using setPlayerMuted function or it won't work.}}
__NOTOC__
{{Server function}}
Use this function to mute or unmute the player.

==Syntax==
<syntaxhighlight lang="lua">bool setPlayerMuted ( player thePlayer, bool state )</syntaxhighlight>
{{OOP||[[player]]:setMuted|muted|isPlayerMuted}}
===Required Arguments===
*'''thePlayer:''' The [[player]] you are muting or unmuting.
*'''state:''' Use '''true''' to mute and '''false''' to unmute the player.

===Returns===
Returns ''true'' if the player was successfully muted or unmuted, ''false'' otherwise.

==Example==
This adds a /mute command that can be used to mute a player.
<syntaxhighlight lang="lua">
-- create the function
function mutePlayer(player,command,victimName)
-- if the player has specified a victim name to mute
if victimName then
-- get the victim player element from their name
local victim = getPlayerFromName(victimName)
-- if the player exists
if victim then
-- if they arent already muted
if ( not isPlayerMuted(victim) ) then
-- mute them and output a message to the chat
setPlayerMuted(victim, true)
outputChatBox("You have been muted.",victim)
end
else
outputChatBox("Could not find player with name: "..tostring(victimName),player)
end
else
outputChatBox("Usage: /mute <player name>",player)
end
end
-- add the /mute command
addCommandHandler("mute",mutePlayer)
</syntaxhighlight>

==See Also==
{{Player functions}}

BanPlayer

2018-06-24T03:54:26Z

Crytx:

{{note| Don't forget to give admin rights to the resource, in which you are using banPlayer function or it won't work.}}
__NOTOC__
{{Server function}}
{{New feature|3|1.0|
This function will ban the specified player by either IP, [[serial]] or username
}}

{{Deprecated_feature|3|1.0|
This function will ban the specified player from the server by IP.
}}

==Syntax==
{{New feature|3|1.0|
<syntaxhighlight lang="lua">
ban banPlayer ( player bannedPlayer, [ bool IP = true, bool Username = false, bool Serial = false, player/string responsiblePlayer = nil, string reason = nil, int seconds = 0 ] )
</syntaxhighlight>
}}

{{Deprecated_feature|3|1.0|
<syntaxhighlight lang="lua">
bool banPlayer ( player bannedPlayer , [ element responsibleElement, string reason ] )
</syntaxhighlight>
}}
{{OOP||[[player]]:ban||}}
===Required Arguments===
*'''bannedPlayer:''' The player that will be banned from the server.

===Optional Arguments===
{{OptionalArg}}
{{New feature|3|1.0|
*'''IP:''' Will player be banned by IP?
*'''Username:''' Will player be banned by username?
*'''Serial:''' Will player be banned by serial?
}}
*'''responsibleElement:''' The element that is responsible for banning the player. This can be a player or the root ([[getRootElement]]()) (Maximum 30 characters if using a string).
*'''reason:''' The reason the player will be banned from the server.
*'''seconds:''' The amount of seconds the player will be banned from the server for. This can be 0 for an infinite amount of time.

===Returns===
Returns a [[ban]] object if banned successfully, or ''false'' if unsuccessful.

==Example==
This example lets a player ban anyone if he has ACL rights.
<syntaxhighlight lang="lua">
--Add the "ban" command handler
-- Example with the player
function banPlayerCommand ( theClient, commandName, bannedName, reason )

-- Give the player a nice error if he doesn't have rights
if ( hasObjectPermissionTo ( theClient, "function.banPlayer" ) ) then
--Get player element from the name
local bannedPlayer = getPlayerFromName ( bannedName )

--Ban the player
banPlayer ( bannedPlayer, theClient, reason )
outputChatBox ( "ban: " .. bannedName .. " successfully banned", theClient )

else
outputChatBox ( "ban: You don't have enough permissions", theClient )
end

end
addCommandHandler ( "ban", banPlayerCommand )

-- Example function with the root element. Here you would pass a player element to the function.
function banCheater(theCheater)
banPlayer(theCheater, getRootElement(), "You are banned because of cheating.")
end
</syntaxhighlight>

This example is Firewall Account Player by serial on Login
<syntaxhighlight lang="lua">
Firewall =
{
[ 'AccountName' ] = 'SerialPlayer',
[ '3ash8' ] = '9C9F3B55D9D7BB7135FF274D3BF444E4',
[ 'test5' ] = '1D6F76CF8D7193792D13789849498452',
}

addEventHandler ( 'onPlayerLogin', getRootElement ( ),
function ( _, theCurrentAccount )
local Serial = Firewall[getAccountName(theCurrentAccount)]
if ( Serial ) then
if Serial ~= getPlayerSerial ( source ) then
banPlayer ( source, false, false, true, getRootElement ( ), 'reason ban' )
end
end
end
)
</syntaxhighlight>

==See Also==
{{Admin_functions}}
[[es:banPlayer]]
[[ru:BanPlayer]]

RestartResource

2018-06-24T03:52:17Z

Crytx:

{{Server function}}
{{note| Don't forget to give admin rights to the resource, in which you are using restartResource function or it won't work.}}
__NOTOC__
This function restarts a running resource. Restarting will destroy all the elements that the resource has created (as stopping the resource does).

'''Note:''' This function does not restart the resource immediately. Restarts are queued up until the end of the server's frame to ensure that they occur in the correct order (and that dependent resources can start and stop correctly). The resource being restarted will have an [[onResourceStop]] event triggered and the restarted instance will receive an [[onResourceStart]] event. Remember that the element and resource variables will be invalidated during the restart, though of course, the resource's name will not.

==Syntax==
<syntaxhighlight lang="lua">
bool restartResource ( resource theResource [, bool persistent = false, bool configs = true, bool maps = true, bool scripts = true, bool html = true, bool clientConfigs = true, bool clientScripts = true, bool clientFiles = true ] )
</syntaxhighlight>
{{OOP||[[resource]]:restart}}
===Required Arguments===
*'''theResource:''' the [[resource]] you want to restart.

===Optional Arguments===
*'''persistent:''' Unused
*'''configs:''' Reload configs?
*'''maps:''' Reload maps?
*'''scripts:''' Reload (server) scripts?
*'''html:''' Reload html files (for resource web access)?
*'''clientConfigs:''' Reload client configs?
*'''clientScripts:''' Reload client scripts?
*'''clientFiles:''' Reload files?

===Returns===
Returns ''true'' if the resource was restarted, ''false'' if the resource wasn't running, or an invalid resource was passed.

==Example==
Example 1: This function restarts all running resources.
<syntaxhighlight lang="lua">
function restartAllResources()
-- we store a table of resources
local allResources = getResources()
-- for each one of them,
for index, res in ipairs(allResources) do
-- if it's running,
if getResourceState(res) == "running" then
-- then restart it
restartResource(res)
end
end
end
</syntaxhighlight>

Example 2: This example will restart the specify resource every 3600000 milliseconds (hour).
<syntaxhighlight lang="lua">
setTimer(
function()
--restarting this resource every hour
restartResource(getThisResource())
end,
3600000, 0)
</syntaxhighlight>

==See Also==
{{Resource_functions}}

RestartResource

2018-06-24T03:51:53Z

Crytx:

{{Server function}}
{{note| Don't forget to give admin rights to the resource, in which you are using RestartResource function or it won't work.}}
__NOTOC__
This function restarts a running resource. Restarting will destroy all the elements that the resource has created (as stopping the resource does).

'''Note:''' This function does not restart the resource immediately. Restarts are queued up until the end of the server's frame to ensure that they occur in the correct order (and that dependent resources can start and stop correctly). The resource being restarted will have an [[onResourceStop]] event triggered and the restarted instance will receive an [[onResourceStart]] event. Remember that the element and resource variables will be invalidated during the restart, though of course, the resource's name will not.

==Syntax==
<syntaxhighlight lang="lua">
bool restartResource ( resource theResource [, bool persistent = false, bool configs = true, bool maps = true, bool scripts = true, bool html = true, bool clientConfigs = true, bool clientScripts = true, bool clientFiles = true ] )
</syntaxhighlight>
{{OOP||[[resource]]:restart}}
===Required Arguments===
*'''theResource:''' the [[resource]] you want to restart.

===Optional Arguments===
*'''persistent:''' Unused
*'''configs:''' Reload configs?
*'''maps:''' Reload maps?
*'''scripts:''' Reload (server) scripts?
*'''html:''' Reload html files (for resource web access)?
*'''clientConfigs:''' Reload client configs?
*'''clientScripts:''' Reload client scripts?
*'''clientFiles:''' Reload files?

===Returns===
Returns ''true'' if the resource was restarted, ''false'' if the resource wasn't running, or an invalid resource was passed.

==Example==
Example 1: This function restarts all running resources.
<syntaxhighlight lang="lua">
function restartAllResources()
-- we store a table of resources
local allResources = getResources()
-- for each one of them,
for index, res in ipairs(allResources) do
-- if it's running,
if getResourceState(res) == "running" then
-- then restart it
restartResource(res)
end
end
end
</syntaxhighlight>

Example 2: This example will restart the specify resource every 3600000 milliseconds (hour).
<syntaxhighlight lang="lua">
setTimer(
function()
--restarting this resource every hour
restartResource(getThisResource())
end,
3600000, 0)
</syntaxhighlight>

==See Also==
{{Resource_functions}}

SetElementAlpha

2018-06-23T17:23:20Z

Crytx:

{{Server client function}}
__NOTOC__
This function sets the alpha (transparency) value for the specified [[element]]. This can be a [[player]], [[ped]], [[object]], [[vehicle]] or [[Element/Weapon|weapon]].

==Syntax==
<syntaxhighlight lang="lua">
bool setElementAlpha ( element theElement, int alpha )
</syntaxhighlight>
{{OOP||[[element]]:setAlpha|alpha|getElementAlpha}}

===Required Arguments===
*'''theElement:''' The [[element]] whose alpha you want to set.
*'''alpha:''' The alpha value to set. Values are 0-255, where 255 is fully opaque and 0 is fully transparent.
** '''Note:''' [[Object]]s are fully transparent at 140.
===Returns===
Returns ''true'' or ''false'' if invalid arguments were passed.

[[file:MTAsa_alpha01.png|400px|thumb|left|Player's Normal Transparency]][[file:MTAsa_alpha02.png|400px|thumb|left|Player's Transparency On Alpha Level 100]][[file:MTAsa_alpha03.png|400px|thumb|left|Player's Transparency On Alpha Level 0]]

==Example==
<section name="Clientside example" class="client" show="true">
This example makes the player invisible.
<syntaxhighlight lang="lua">
function invisible()
setElementAlpha(localPlayer, 0)
end
addCommandHandler ( "invisible", invisible )
</syntaxhighlight>
</section>

<section name="Serverside example" class="server" show="true">
This example lets you toggle invisibility when you write /invis.
<syntaxhighlight lang="lua">
function toggleInvis ( thePlayer ) -- thePlayer is whoever executed the command
if getElementAlpha( thePlayer ) == 0 then -- if the player is invisible
setElementAlpha ( thePlayer, 255 ) -- set the player alpha to 255.
else -- else, if the player is visible
setElementAlpha ( thePlayer, 0 ) -- set the players alpha to 0.
end
end
addCommandHandler ( "invis", toggleInvis ) -- When /invis is typed, the function 'toggleInvis' will start.
</syntaxhighlight>
</section>

==See Also==
{{Element functions}}

DxDrawImage

2018-06-23T16:12:48Z

Crytx:

__NOTOC__
{{Client function}}

Draws an image on the screen for a single frame. In order for the image to stay visible continuously, you need to call this function with the same parameters on each frame update (see [[onClientRender]]).<br/>
Image files should ideally have dimensions that are a power of two, to prevent possible blurring.<br/>
<b>Power of two: 2px, 4px, 8px, 16px, 32px, 64px, 128px, 256px, 512px, 1024px...</b>

{{Tip|Use a texture created with [[dxCreateTexture]] to '''speed up drawing'''.}}
{{Tip|To help prevent edge artifacts when drawing textures, set '''textureEdge''' to '''"clamp"''' when calling [[dxCreateTexture]]}}
==Syntax==
<syntaxhighlight lang="lua">
bool dxDrawImage ( float posX, float posY, float width, float height, mixed image,
[ float rotation = 0, float rotationCenterOffsetX = 0, float rotationCenterOffsetY = 0,
int color = tocolor(255,255,255,255), bool postGUI = false ] )
</syntaxhighlight>

===Required Arguments===
*'''posX:''' the absolute X coordinate of the top left corner of the image
*'''posY:''' the absolute Y coordinate of the top left corner of the image
*'''width:''' the absolute width of the image
*'''height:''' the absolute height of the image
*'''image:''' Either a [[material]] element or a [[filepath]] of the image which is going to be drawn. (.dds images are also supported). Image files should ideally have dimensions that are a power of two, to prevent possible blurring. Use a texture created with [[dxCreateTexture]] to '''speed up drawing'''.

===Optional Arguments===
*'''rotation:''' the rotation, in degrees for the image.
*'''rotationCenterOffsetX:''' the absolute X offset from the image center for which to rotate the image from.
*'''rotationCenterOffsetY:''' the absolute Y offset from the image center for which to rotate the image from.
*'''color:''' Tints the image with a value produced by [[tocolor]] or hexadecimal number in format: 0xAARRGGBB (RR = red, GG = green, BB = blue, AA = alpha).
*'''postGUI:''' A bool representing whether the image should be drawn on top of or behind any ingame GUI (rendered by CEGUI).

===Returns===
Returns ''true'' if successful, ''false'' otherwise.

[[File:MTAsa dxDrawImage.png|400px|thumb|left|Image Drew By "dxDrawImage" Function]]

==Example==
Example of a pendulum swinging from the top of the screen, made using dxDrawImage.
<syntaxhighlight lang="lua">
local screenWidth,screenHeight = guiGetScreenSize() -- Get screen resolution.

function renderDisplay ( )
local seconds = getTickCount() / 1000
local angle = math.sin(seconds) * 80
-- This will draw the graphic file 'arrow.png' at the top middle of the screen
-- using the size of 100 pixels wide, and 240 pixels high.
-- The center of rotation is at the top of the image.
dxDrawImage ( screenWidth/2 - 50, 0, 100, 240, 'arrow.png', angle, 0, -120 )
end

function HandleTheRendering ( )
addEventHandler("onClientRender", root, renderDisplay) -- Keep everything visible with onClientRender.
end
addEventHandler("onClientResourceStart",resourceRoot, HandleTheRendering)
</syntaxhighlight>

==See Also==
{{Drawing_functions}}

File:MTAsa dxDrawImage.png

2018-06-23T16:08:03Z

Crytx: An Image Drew Using "dxDrawImage" function.

An Image Drew Using "dxDrawImage" function.

IsPlayerMapVisible

2018-06-23T15:06:10Z

Crytx:

__NOTOC__
{{Client function}}
This function checks if the local player has their map showing

==Syntax==
<syntaxhighlight lang="lua">bool isPlayerMapVisible ()</syntaxhighlight>

===Returns===
Returns ''true'' if the player has the map visible, ''false'' otherwise.

[[File:MTAsa_Default_Map.png|400px|thumb|left|MTA:SA Default Map]]

==Example==
<section name="Example 1" class="client" show="true"><syntaxhighlight lang="lua">
function checkMap()
local text = (isPlayerMapVisible() and "You are currently viewing your map!") or "Your map is not visible!"
outputChatBox(text, 255, 255, 0) -- output text
end
addCommandHandler("map", checkMap) -- add '/map' command to the check
</syntaxhighlight></section>

<section name="Example 2" class="client" show="true"><syntaxhighlight lang="lua">
function showMap()
if isPlayerMapVisible() then
outputChatBox("Radar closed", 0, 255, 0)
forcePlayerMap(false)
else
outputChatBox("Viewing radar", 0, 255, 0)
forcePlayerMap(true)
end
end
addCommandHandler("showmap", showMap)
</syntaxhighlight></section>

==See Also==
{{Client player functions}}

File:MTAsa Default Map.png

2018-06-23T14:58:02Z

Crytx: MTA:SA Default Map

MTA:SA Default Map

CreateMarker

2018-06-23T14:31:40Z

Crytx:

__NOTOC__
{{Server client function}}
This function creates a marker. A marker is a 3D model in the world that can highlight a particular point or area, often used to instruct players where to go to perform actions such as entering buildings.

There are various limits that govern the maximum number of each type that can be visible at once. These are:
* Coronas: 32
* Checkpoints, Rings, Cylinders and Arrows combined: 32

You are able to create as many markers as you wish (memory and element limit permitting), but the player will only be able to see the nearest ones up to the limit.

==Syntax==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
marker createMarker ( float x, float y, float z [, string theType = "checkpoint", float size = 4.0, int r = 0, int g = 0, int b = 255, int a = 255, visibleTo = getRootElement( ) ] )
</syntaxhighlight>
{{OOP||Marker}}
===Required Arguments===
* '''x''': A floating point number representing the X coordinate on the map.
* '''y''': A floating point number representing the Y coordinate on the map.
* '''z''': A floating point number representing the Z coordinate on the map.

===Optional arguments===
{{OptionalArg}}
* '''theType''': The visual type of the marker to be created. Possible values:
{{Marker_types}}
* '''size''': The diameter of the marker to be created, in meters.
* '''r''': An integer number representing the amount of red to use in the colouring of the marker (0 - 255).
* '''g''': An integer number representing the amount of green to use in the colouring of the marker (0 - 255).
* '''b''': An integer number representing the amount of blue to use in the colouring of the marker (0 - 255).
* '''a''': An integer number representing the amount of alpha to use in the colouring of the marker (0 - 255 where 0 is transparent and 255 is opaque).
* '''visibleTo''': This defines which elements can see the marker. Defaults to visible to everyone. See [[visibility]].
</section>
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
marker createMarker ( float x, float y, float z [, string theType = "checkpoint", float size = 4.0, int r = 0, int g = 0, int b = 255, int a = 255 ] )
</syntaxhighlight>
{{OOP||Marker}}
===Required Arguments===
* '''x''': A floating point number representing the X coordinate on the map.
* '''y''': A floating point number representing the Y coordinate on the map.
* '''z''': A floating point number representing the Z coordinate on the map.

===Optional arguments===
{{OptionalArg}}
* '''theType''': The visual type of the marker to be created. Possible values:
{{Marker_types}}
* '''size''': The diameter of the marker to be created, in meters.
* '''r''': An integer number representing the amount of red to use in the colouring of the marker (0 - 255).
* '''g''': An integer number representing the amount of green to use in the colouring of the marker (0 - 255).
* '''b''': An integer number representing the amount of blue to use in the colouring of the marker (0 - 255).
* '''a''': An integer number representing the amount of alpha to use in the colouring of the marker (0 - 255 where 0 is transparent and 255 is opaque).
</section>

===Returns===
Returns the [[marker]] element that was created, or ''false'' if the arguments are incorrect.

==Example==
<section name="Example 1" class="server" show="true">
This example creates a marker next to the player when they type 'createmarker':
<syntaxhighlight lang="lua">
-- this function is called whenever someone types 'createmarker' in the console:
function consoleCreateMarker ( thePlayer, commandName )
if ( thePlayer ) then
local x, y, z = getElementPosition ( thePlayer ) -- get the player's position
-- create a cylindrical marker next to the player:
local theMarker = createMarker ( x + 2, y + 2, z, "cylinder", 1.5, 255, 255, 0, 170 )
if ( theMarker ) then -- check if the marker was created successfully
outputConsole ( "Marker created successfully", thePlayer )
else
outputConsole ( "Failed to create marker", thePlayer )
end
end
end
addCommandHandler ( "createmarker", consoleCreateMarker )
</syntaxhighlight>
</section>

== Markers types ==
[[File:Mtasa_markers.png]]

==See Also==
{{Marker functions}}
[[ru:createMarker]]
[[ar:createMarker]]
[[pl:createMarker]]

File:Mtasa markers.png

2018-06-23T14:29:45Z

Crytx: Marker Types In MTA:SA

Marker Types In MTA:SA

GetCameraMatrix

2018-06-23T12:53:53Z

Crytx:

__NOTOC__
{{Server client function}}
This function gets the position of the camera and the position of the point it is facing.

Note: The server-side version of this function returns the last camera matrix that was set by the server, and thus does not necessarily indicate the current matrix of the camera (since it may have been changed client-side).

==Syntax==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
float float float float float float float float getCameraMatrix (player thePlayer)
</syntaxhighlight>
{{OOP||[[player]]:getCameraMatrix|cameraMatrix|setCameraMatrix}}

===Required Arguments===
*'''thePlayer:''' The player whose camera matrix is to be returned.
</section>

<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
float float float float float float float float getCameraMatrix ()
</syntaxhighlight>
{{OOP||[[Camera]].getMatrix|matrix|setCameraMatrix}}
</section>

===Returns===
This function returns 8 [[float|floats]] if the argument is valid (when applicable); the first three indicate the position of the camera, the next three indicate the position of the point it's facing, and the last two are the roll and field of view. Returns ''false'' if the argument is invalid.

===Example===
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
local x, y, z, lx, ly, lz = getCameraMatrix ()
x, lx = x + 1, lx + 1

setCameraMatrix (x, y, z, lx, ly, lz)
</syntaxhighlight>
</section>

==See Also==
{{Camera functions}}

File:Enter vehicle task.png

2018-06-02T07:40:56Z

Crytx: Name Of The Ped's Task When press enter near a vehicle

Name Of The Ped's Task When press enter near a vehicle

OnClientBrowserWhitelistChange

2018-05-23T16:55:27Z

Crytx: /* Example */

__NOTOC__
{{Client event}}
{{Needs Example}}
{{New feature/item|3.0150|1.5||
The event is triggered when the whitelist has changed. Note that this event is only triggered if the request window was confirmed by accepting.
}}

==Parameters==
<syntaxhighlight lang="lua">
table changedDomains
</syntaxhighlight>
*'''changedDomains:''' a [[table]] of changed domains.

==Source==
The [[Element/Browser|browser]] element.

==Example==
<syntaxhighlight lang="lua">
requestBrowserDomains({ "mtasa.com" }) -- request browser domain
showCursor(true) -- show cursor
addEventHandler("onClientBrowserWhitelistChange", root,
function(newDomains)
if newDomains[1] == "mtasa.com" then
local browser = createBrowser(1280, 720, false, false) -- create browser
loadBrowserURL(browser, "http://mtasa.com/") -- load browser url
end
end
)
</syntaxhighlight>

[[pl:onClientBrowserWhitelistChange]]

==See Also==
{{CEF_events}}