Multi Theft Auto: Wiki - User contributions [en]

SetCameraInterior

2010-06-13T11:16:36Z

MaddDogg14: /* Example */

__NOTOC__
{{Server client function}}
Sets the interior of the local camera. Only the interior of the camera is changed, the local player stays in the interior he was in.

==Syntax==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
bool setCameraInterior ( player thePlayer, int interior )
</syntaxhighlight>

===Required Arguments===
*'''thePlayer:''' the player whose camera interior will be set.
*'''interior:''' the interior to place the camera in.
</section>

<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
bool setCameraInterior ( int interior )
</syntaxhighlight>

===Required Arguments===
*'''interior:''' the interior to place the camera in.
</section>

===Returns===
Returns ''true'' if the camera's interior was changed successfully, ''false'' otherwise.

==Example==
<section name="Server" class="server" show="true">

 This example make a command to change your cam interior to a selected one. 

<syntaxhighlight lang="lua">
function setCamInt( thePlayer, commandName, intID )
if( intID )then
local seted = setCameraInterior( thePlayer, intID )
if( seted )then
outputChatBox( "Your camera's interior has been set to "..intID, thePlayer )
else
outputChatBox( "Can't change your camera's interior...", thePlayer, 255, 0, 0 )
end
else
outputChatBox( "Syntax: /caminterior [interiorID] ", thePlayer, 255, 0, 0 )
end
end
addCommandHandler( "caminterior", setCamInt )
</syntaxhighlight>
</section>
<section name="Client" class="client" show="true">
 This example make a command to change your cam interior to a selected one. 
<syntaxhighlight lang="lua">
function setCam(thePlayer,command,int)
if (int) then
local setInt = setCameraInterior(thePlayer,int)
if (setInt) then
outputChatBox("Your camera's interior has been set to "..int,255,255,0)
else
outputChatBox("Can't change your camera's interior...",255,0,0)
end
else
outputChatBox("Syntax: /camera [interiorID] ",255,0,0)
end
end
addCommandHandler("camera",setCam)
</syntaxhighlight>
</section>

==See Also==
{{Client_camera_functions}}

OnClientGUIChanged

2010-05-16T17:10:34Z

MaddDogg14:

{{Client event}}
__NOTOC__
This event is fired when a memo or an editbox has changed (either by the user or by [[guiSetText]]).

==Parameters==
<syntaxhighlight lang="lua">
element theElement
</syntaxhighlight>
* '''theElement''': The element which was changed.

==Source==
The [[event system#Event source|source]] of this event is the element which was changed.

==Example==
This example creates an editbox and prints a message when it has changed
<syntaxhighlight lang="lua">
editBox = guiCreateEdit(0.3,0.1,0.4,0.1,"",true)
addEventHandler("onClientGUIChanged", editBox, function(element)
outputChatBox("The box now reads: " .. guiGetText(element))
end)
</syntaxhighlight>

==See Also==
===GUI events===
{{GUI_events}}
===Client event functions===
{{Client_event_functions}}

Requested Functions and Events

2010-04-04T02:38:28Z

MaddDogg14: /* Server-side */

==Server-side==

onVehicleCreated or an equivalent... shouldn't be too hard? -Robhol (14:15 Jul 6, 08)
:If we did it, it'd be onElementCreated - what do you want this for? [[User:EAi|eAi]] 08:58, 7 July 2008 (CDT)
::onElementCreated is a good idea - it could be used for lots of things. Also, how about onVehicleDrown or whatever? that is, when a vehicle hits deep water. Checking for collisions and stuff is very awkward, and client-side only, and has to be checked constantly.. -Robhol (17:31 Jul 9 08)
:::I second that. It would be useful if you use like me element data like the fuel amount or other stuff. And an event like this would help me to setup those element data, when a car spawns. Otherwise I would either have to edit every car spawn script I use or do a post-setup when someone is entering the car.. [[User:MaddDogg14]] (04:34 Apr 4, 10 (CEST))

----

I ask for a function that detects if a ped is on floor, eg. '''isPedOnFloor(ped thePed)''', thanks. --[[User:Shadd|Shadd]]([[User_talk:Shadd|In caso di emergenza rompere le scatole]]) 11:29, 15 June 2008 (CDT)
: [[isPedOnGround]]? [[User:Awwu|Awwu]] 12:58, 15 June 2008 (CDT)
::I need to know if the player has its back touching the ground, not if it's simply "on ground". --[[User:Shadd|Shadd]]([[User_talk:Shadd|In caso di emergenza rompere le scatole]]) 14:16, 16 June 2008 (CDT)
:::Check what task the player has, they should have TASK_COMPLEX_FALL_AND_GET_UP or TASK_COMPLEX_FALL_AND_STAY_DOWN... [[User:EAi|eAi]] 19:12, 16 June 2008 (CDT)
::::Thanks. What task does player have after being hitten by a melee attack that cause it to fall down? Would "TASK_SIMPLE_BE_KICKED_ON_GROUND" and "TASK_SIMPLE_GET_UP" work? --[[User:Shadd|Shadd]]([[User_talk:Shadd|In caso di emergenza rompere le scatole]]) 09:35, 17 June 2008 (CDT)
:::::Try it, I'm not entirely sure. You should be able to produce some code to show the player's current tasks very easily... [[User:EAi|eAi]] 19:20, 17 June 2008 (CDT)
::::::My goal is to edit the standard damage of the attacks, in this case i have to know when player is on ground to cause higher damage. However it doesn't seem to work, when i hit the player it simply gets up without animation with no damage. --[[User:Shadd|Shadd]]([[User_talk:Shadd|In caso di emergenza rompere le scatole]]) 19:10, 19 June 2008 (CDT)

----

It may looks strange and useless (waste of time?) but I think that it could be a awesome feature. Having a web browser.
Like: http://www.youtube.com/watch?v=wT1UR6qEgdg
http://princeofcode.com/awesomium.php

----

There could be something like createBrowser( float x, float y, float z, [float rx, float ry, float rz, float width, float high, string url, bool locked] )
locked parameter: false = navigation bar present, true = no navigation bar
toggleBrowserFullsceenMode(browser theBrowser, bool tog, [bool smooth])
smooth parameter: If set to true the browser will smoothly move from his ingame position to the fullscreen position
toggleBrowserBackground(browser theBrowser, bool tog)
Set the browser background transparent.

----

Security: Disable file downloads, disable popups (disable flash, javascript and any other protocols than http and https [no mailto and stuff...]?)

----

Should be a Client and server function. --[[User:Masterofquebec|Masterofquebec]] 00:10, 15 October 2009 (UTC)

----

Support of tooltips from CEGUI would be cool. I saw a property for that, but it didn't work for me. [[User:MaddDogg14]] (04:36 Apr 4, 10 (CEST))

==Client-Side==

----

Pickup events clientside please, onClientPickupHit onClientPickupUse.

----

Would it be possible to add a color arg to guiGridListSetItemText()? Im trying to get each item colored differently in one list. Thanks, ABEL

----

I need a function which could get current target of hydra or a HS rocket launcher, like when someone press space and targets a element, to get what element is it for calculating distance from it. '''getPlayerOccupiedVehicleTarget''' or '''getPlayerHSTarget'''.
Thanks in advance -Nidza a.k.a. CodeMaster 2:26 PM 19th June 2008.

----

It'd be useful to have something to disable elements of the default hud (weapon display, health display, armor, radar, etcetera) so that you can create your own HUDs. Something like '''setHudElement(element name, toggle)'''.

[[User:Lord Xalphox|Lord Xalphox]] 19:32, 22 March 2009 (CET)
:[[showPlayerHudComponent]]? [[User:Awwu|Awwu]] 19:43, 22 March 2009 (CET)

----

I'd like to have a function that sets the chatbox input line text. Then I could script my own chat history function (that inserts the last sent text into the input line again by pressing arrow up) (which samp has since 0.2 btw) since nobody builds it into the client. [[User:NeonBlack|NeonBlack]] 12:03, 4 July 2009 (CEST) PS.: samp also supports cut, copy and paste :P
----

A function setElementMatrix, doing the exact opposite of getElementMatrix would be much appreciated. --[[User:Kayl|Kayl]] 15:21, 13 November 2009 (UTC)

----

Functions like setTrainPosition(train,track,pos) and track,pos getTrainPosition(train) would be great in order to allow more script side control of trains.
The track argument would be an index of the track number (currently there are around 4 tracks handled, including 1 incompletely defined).
The position would be a float between 0 and 1 (or however you guys handle it) telling where on the track the train currently is.
It would be great if those functions could be available client and server side. --[[User:Kayl|Kayl]] 12:58, 23 November 2009 (UTC)

----

need this function client and server side '''movePlayerHudComponent(string component, float x, float y)''' --[[User:SuatEyrice|SuatEyrice]] 00:18, 26 February 2010 (UTC)

----

Requested Functions and Events

2010-04-04T02:38:04Z

MaddDogg14: /* Server-side */

==Server-side==

onVehicleCreated or an equivalent... shouldn't be too hard? -Robhol (14:15 Jul 6, 08)
:If we did it, it'd be onElementCreated - what do you want this for? [[User:EAi|eAi]] 08:58, 7 July 2008 (CDT)
::onElementCreated is a good idea - it could be used for lots of things. Also, how about onVehicleDrown or whatever? that is, when a vehicle hits deep water. Checking for collisions and stuff is very awkward, and client-side only, and has to be checked constantly.. -Robhol (17:31 Jul 9 08)
:::I second that. It would be useful if you use like me element data like the fuel amount or other stuff. And an event like this would help me to setup those element data, when a car spawns. Otherwise I would either have to edit every car spawn script I use or do a post-setup when someone is entering the car.. [[User:MaddDogg14]] (04:34 Apr 4, 10 (CEST))

----

I ask for a function that detects if a ped is on floor, eg. '''isPedOnFloor(ped thePed)''', thanks. --[[User:Shadd|Shadd]]([[User_talk:Shadd|In caso di emergenza rompere le scatole]]) 11:29, 15 June 2008 (CDT)
: [[isPedOnGround]]? [[User:Awwu|Awwu]] 12:58, 15 June 2008 (CDT)
::I need to know if the player has its back touching the ground, not if it's simply "on ground". --[[User:Shadd|Shadd]]([[User_talk:Shadd|In caso di emergenza rompere le scatole]]) 14:16, 16 June 2008 (CDT)
:::Check what task the player has, they should have TASK_COMPLEX_FALL_AND_GET_UP or TASK_COMPLEX_FALL_AND_STAY_DOWN... [[User:EAi|eAi]] 19:12, 16 June 2008 (CDT)
::::Thanks. What task does player have after being hitten by a melee attack that cause it to fall down? Would "TASK_SIMPLE_BE_KICKED_ON_GROUND" and "TASK_SIMPLE_GET_UP" work? --[[User:Shadd|Shadd]]([[User_talk:Shadd|In caso di emergenza rompere le scatole]]) 09:35, 17 June 2008 (CDT)
:::::Try it, I'm not entirely sure. You should be able to produce some code to show the player's current tasks very easily... [[User:EAi|eAi]] 19:20, 17 June 2008 (CDT)
::::::My goal is to edit the standard damage of the attacks, in this case i have to know when player is on ground to cause higher damage. However it doesn't seem to work, when i hit the player it simply gets up without animation with no damage. --[[User:Shadd|Shadd]]([[User_talk:Shadd|In caso di emergenza rompere le scatole]]) 19:10, 19 June 2008 (CDT)

----

Support of tooltips from CEGUI would be cool. I saw a property for that, but it didn't work for me. [[User:MaddDogg14]] (04:36 Apr 4, 10 (CEST))

----

It may looks strange and useless (waste of time?) but I think that it could be a awesome feature. Having a web browser.
Like: http://www.youtube.com/watch?v=wT1UR6qEgdg
http://princeofcode.com/awesomium.php

----

There could be something like createBrowser( float x, float y, float z, [float rx, float ry, float rz, float width, float high, string url, bool locked] )
locked parameter: false = navigation bar present, true = no navigation bar
toggleBrowserFullsceenMode(browser theBrowser, bool tog, [bool smooth])
smooth parameter: If set to true the browser will smoothly move from his ingame position to the fullscreen position
toggleBrowserBackground(browser theBrowser, bool tog)
Set the browser background transparent.

----

Security: Disable file downloads, disable popups (disable flash, javascript and any other protocols than http and https [no mailto and stuff...]?)

----

Should be a Client and server function. --[[User:Masterofquebec|Masterofquebec]] 00:10, 15 October 2009 (UTC)

==Client-Side==

----

Pickup events clientside please, onClientPickupHit onClientPickupUse.

----

Would it be possible to add a color arg to guiGridListSetItemText()? Im trying to get each item colored differently in one list. Thanks, ABEL

----

I need a function which could get current target of hydra or a HS rocket launcher, like when someone press space and targets a element, to get what element is it for calculating distance from it. '''getPlayerOccupiedVehicleTarget''' or '''getPlayerHSTarget'''.
Thanks in advance -Nidza a.k.a. CodeMaster 2:26 PM 19th June 2008.

----

It'd be useful to have something to disable elements of the default hud (weapon display, health display, armor, radar, etcetera) so that you can create your own HUDs. Something like '''setHudElement(element name, toggle)'''.

[[User:Lord Xalphox|Lord Xalphox]] 19:32, 22 March 2009 (CET)
:[[showPlayerHudComponent]]? [[User:Awwu|Awwu]] 19:43, 22 March 2009 (CET)

----

I'd like to have a function that sets the chatbox input line text. Then I could script my own chat history function (that inserts the last sent text into the input line again by pressing arrow up) (which samp has since 0.2 btw) since nobody builds it into the client. [[User:NeonBlack|NeonBlack]] 12:03, 4 July 2009 (CEST) PS.: samp also supports cut, copy and paste :P
----

A function setElementMatrix, doing the exact opposite of getElementMatrix would be much appreciated. --[[User:Kayl|Kayl]] 15:21, 13 November 2009 (UTC)

----

Functions like setTrainPosition(train,track,pos) and track,pos getTrainPosition(train) would be great in order to allow more script side control of trains.
The track argument would be an index of the track number (currently there are around 4 tracks handled, including 1 incompletely defined).
The position would be a float between 0 and 1 (or however you guys handle it) telling where on the track the train currently is.
It would be great if those functions could be available client and server side. --[[User:Kayl|Kayl]] 12:58, 23 November 2009 (UTC)

----

need this function client and server side '''movePlayerHudComponent(string component, float x, float y)''' --[[User:SuatEyrice|SuatEyrice]] 00:18, 26 February 2010 (UTC)

----

Requested Functions and Events

2010-04-04T02:37:46Z

MaddDogg14: /* Server-side */

==Server-side==

onVehicleCreated or an equivalent... shouldn't be too hard? -Robhol (14:15 Jul 6, 08)
:If we did it, it'd be onElementCreated - what do you want this for? [[User:EAi|eAi]] 08:58, 7 July 2008 (CDT)
::onElementCreated is a good idea - it could be used for lots of things. Also, how about onVehicleDrown or whatever? that is, when a vehicle hits deep water. Checking for collisions and stuff is very awkward, and client-side only, and has to be checked constantly.. -Robhol (17:31 Jul 9 08)
:::I second that. It would be useful if you use like me element data like the fuel amount or other stuff. And an event like this would help me to setup those element data, when a car spawns. Otherwise I would either have to edit every car spawn script I use or do a post-setup when someone is entering the car.. [[User:MaddDogg14]] (04:34 Apr 4, 10 (CEST))

---

I ask for a function that detects if a ped is on floor, eg. '''isPedOnFloor(ped thePed)''', thanks. --[[User:Shadd|Shadd]]([[User_talk:Shadd|In caso di emergenza rompere le scatole]]) 11:29, 15 June 2008 (CDT)
: [[isPedOnGround]]? [[User:Awwu|Awwu]] 12:58, 15 June 2008 (CDT)
::I need to know if the player has its back touching the ground, not if it's simply "on ground". --[[User:Shadd|Shadd]]([[User_talk:Shadd|In caso di emergenza rompere le scatole]]) 14:16, 16 June 2008 (CDT)
:::Check what task the player has, they should have TASK_COMPLEX_FALL_AND_GET_UP or TASK_COMPLEX_FALL_AND_STAY_DOWN... [[User:EAi|eAi]] 19:12, 16 June 2008 (CDT)
::::Thanks. What task does player have after being hitten by a melee attack that cause it to fall down? Would "TASK_SIMPLE_BE_KICKED_ON_GROUND" and "TASK_SIMPLE_GET_UP" work? --[[User:Shadd|Shadd]]([[User_talk:Shadd|In caso di emergenza rompere le scatole]]) 09:35, 17 June 2008 (CDT)
:::::Try it, I'm not entirely sure. You should be able to produce some code to show the player's current tasks very easily... [[User:EAi|eAi]] 19:20, 17 June 2008 (CDT)
::::::My goal is to edit the standard damage of the attacks, in this case i have to know when player is on ground to cause higher damage. However it doesn't seem to work, when i hit the player it simply gets up without animation with no damage. --[[User:Shadd|Shadd]]([[User_talk:Shadd|In caso di emergenza rompere le scatole]]) 19:10, 19 June 2008 (CDT)

---

Support of tooltips from CEGUI would be cool. I saw a property for that, but it didn't work for me. [[User:MaddDogg14]] (04:36 Apr 4, 10 (CEST))

---

It may looks strange and useless (waste of time?) but I think that it could be a awesome feature. Having a web browser.
Like: http://www.youtube.com/watch?v=wT1UR6qEgdg
http://princeofcode.com/awesomium.php

---

There could be something like createBrowser( float x, float y, float z, [float rx, float ry, float rz, float width, float high, string url, bool locked] )
locked parameter: false = navigation bar present, true = no navigation bar
toggleBrowserFullsceenMode(browser theBrowser, bool tog, [bool smooth])
smooth parameter: If set to true the browser will smoothly move from his ingame position to the fullscreen position
toggleBrowserBackground(browser theBrowser, bool tog)
Set the browser background transparent.

---

Security: Disable file downloads, disable popups (disable flash, javascript and any other protocols than http and https [no mailto and stuff...]?)

---

Should be a Client and server function. --[[User:Masterofquebec|Masterofquebec]] 00:10, 15 October 2009 (UTC)

==Client-Side==

----

Pickup events clientside please, onClientPickupHit onClientPickupUse.

----

Would it be possible to add a color arg to guiGridListSetItemText()? Im trying to get each item colored differently in one list. Thanks, ABEL

----

I need a function which could get current target of hydra or a HS rocket launcher, like when someone press space and targets a element, to get what element is it for calculating distance from it. '''getPlayerOccupiedVehicleTarget''' or '''getPlayerHSTarget'''.
Thanks in advance -Nidza a.k.a. CodeMaster 2:26 PM 19th June 2008.

----

It'd be useful to have something to disable elements of the default hud (weapon display, health display, armor, radar, etcetera) so that you can create your own HUDs. Something like '''setHudElement(element name, toggle)'''.

[[User:Lord Xalphox|Lord Xalphox]] 19:32, 22 March 2009 (CET)
:[[showPlayerHudComponent]]? [[User:Awwu|Awwu]] 19:43, 22 March 2009 (CET)

----

I'd like to have a function that sets the chatbox input line text. Then I could script my own chat history function (that inserts the last sent text into the input line again by pressing arrow up) (which samp has since 0.2 btw) since nobody builds it into the client. [[User:NeonBlack|NeonBlack]] 12:03, 4 July 2009 (CEST) PS.: samp also supports cut, copy and paste :P
----

A function setElementMatrix, doing the exact opposite of getElementMatrix would be much appreciated. --[[User:Kayl|Kayl]] 15:21, 13 November 2009 (UTC)

----

Functions like setTrainPosition(train,track,pos) and track,pos getTrainPosition(train) would be great in order to allow more script side control of trains.
The track argument would be an index of the track number (currently there are around 4 tracks handled, including 1 incompletely defined).
The position would be a float between 0 and 1 (or however you guys handle it) telling where on the track the train currently is.
It would be great if those functions could be available client and server side. --[[User:Kayl|Kayl]] 12:58, 23 November 2009 (UTC)

----

need this function client and server side '''movePlayerHudComponent(string component, float x, float y)''' --[[User:SuatEyrice|SuatEyrice]] 00:18, 26 February 2010 (UTC)

----

Requested Functions and Events

2010-04-04T02:36:57Z

MaddDogg14: /* Server-side */

==Server-side==

onVehicleCreated or an equivalent... shouldn't be too hard? -Robhol (14:15 Jul 6, 08)
:If we did it, it'd be onElementCreated - what do you want this for? [[User:EAi|eAi]] 08:58, 7 July 2008 (CDT)
::onElementCreated is a good idea - it could be used for lots of things. Also, how about onVehicleDrown or whatever? that is, when a vehicle hits deep water. Checking for collisions and stuff is very awkward, and client-side only, and has to be checked constantly.. -Robhol (17:31 Jul 9 08)
:::I second that. It would be useful if you use like me element data like the fuel amount or other stuff. And an event like this would help me to setup those element data, when a car spawns. Otherwise I would either have to edit every car spawn script I use or do a post-setup when someone is entering the car.. [[User:MaddDogg14]] (04:34 Apr 4, 10 (CEST))

I ask for a function that detects if a ped is on floor, eg. '''isPedOnFloor(ped thePed)''', thanks. --[[User:Shadd|Shadd]]([[User_talk:Shadd|In caso di emergenza rompere le scatole]]) 11:29, 15 June 2008 (CDT)
: [[isPedOnGround]]? [[User:Awwu|Awwu]] 12:58, 15 June 2008 (CDT)
::I need to know if the player has its back touching the ground, not if it's simply "on ground". --[[User:Shadd|Shadd]]([[User_talk:Shadd|In caso di emergenza rompere le scatole]]) 14:16, 16 June 2008 (CDT)
:::Check what task the player has, they should have TASK_COMPLEX_FALL_AND_GET_UP or TASK_COMPLEX_FALL_AND_STAY_DOWN... [[User:EAi|eAi]] 19:12, 16 June 2008 (CDT)
::::Thanks. What task does player have after being hitten by a melee attack that cause it to fall down? Would "TASK_SIMPLE_BE_KICKED_ON_GROUND" and "TASK_SIMPLE_GET_UP" work? --[[User:Shadd|Shadd]]([[User_talk:Shadd|In caso di emergenza rompere le scatole]]) 09:35, 17 June 2008 (CDT)
:::::Try it, I'm not entirely sure. You should be able to produce some code to show the player's current tasks very easily... [[User:EAi|eAi]] 19:20, 17 June 2008 (CDT)
::::::My goal is to edit the standard damage of the attacks, in this case i have to know when player is on ground to cause higher damage. However it doesn't seem to work, when i hit the player it simply gets up without animation with no damage. --[[User:Shadd|Shadd]]([[User_talk:Shadd|In caso di emergenza rompere le scatole]]) 19:10, 19 June 2008 (CDT)

Support of tooltips from CEGUI would be cool. I saw a property for that, but it didn't work for me. [[User:MaddDogg14]] (04:36 Apr 4, 10 (CEST))

It may looks strange and useless (waste of time?) but I think that it could be a awesome feature. Having a web browser.
Like: http://www.youtube.com/watch?v=wT1UR6qEgdg
http://princeofcode.com/awesomium.php

There could be something like createBrowser( float x, float y, float z, [float rx, float ry, float rz, float width, float high, string url, bool locked] )
locked parameter: false = navigation bar present, true = no navigation bar
toggleBrowserFullsceenMode(browser theBrowser, bool tog, [bool smooth])
smooth parameter: If set to true the browser will smoothly move from his ingame position to the fullscreen position
toggleBrowserBackground(browser theBrowser, bool tog)
Set the browser background transparent.

Security: Disable file downloads, disable popups (disable flash, javascript and any other protocols than http and https [no mailto and stuff...]?)

Should be a Client and server function. --[[User:Masterofquebec|Masterofquebec]] 00:10, 15 October 2009 (UTC)

==Client-Side==

----

Pickup events clientside please, onClientPickupHit onClientPickupUse.

----

Would it be possible to add a color arg to guiGridListSetItemText()? Im trying to get each item colored differently in one list. Thanks, ABEL

----

I need a function which could get current target of hydra or a HS rocket launcher, like when someone press space and targets a element, to get what element is it for calculating distance from it. '''getPlayerOccupiedVehicleTarget''' or '''getPlayerHSTarget'''.
Thanks in advance -Nidza a.k.a. CodeMaster 2:26 PM 19th June 2008.

----

It'd be useful to have something to disable elements of the default hud (weapon display, health display, armor, radar, etcetera) so that you can create your own HUDs. Something like '''setHudElement(element name, toggle)'''.

[[User:Lord Xalphox|Lord Xalphox]] 19:32, 22 March 2009 (CET)
:[[showPlayerHudComponent]]? [[User:Awwu|Awwu]] 19:43, 22 March 2009 (CET)

----

I'd like to have a function that sets the chatbox input line text. Then I could script my own chat history function (that inserts the last sent text into the input line again by pressing arrow up) (which samp has since 0.2 btw) since nobody builds it into the client. [[User:NeonBlack|NeonBlack]] 12:03, 4 July 2009 (CEST) PS.: samp also supports cut, copy and paste :P
----

A function setElementMatrix, doing the exact opposite of getElementMatrix would be much appreciated. --[[User:Kayl|Kayl]] 15:21, 13 November 2009 (UTC)

----

Functions like setTrainPosition(train,track,pos) and track,pos getTrainPosition(train) would be great in order to allow more script side control of trains.
The track argument would be an index of the track number (currently there are around 4 tracks handled, including 1 incompletely defined).
The position would be a float between 0 and 1 (or however you guys handle it) telling where on the track the train currently is.
It would be great if those functions could be available client and server side. --[[User:Kayl|Kayl]] 12:58, 23 November 2009 (UTC)

----

need this function client and server side '''movePlayerHudComponent(string component, float x, float y)''' --[[User:SuatEyrice|SuatEyrice]] 00:18, 26 February 2010 (UTC)

----

User:MaddDogg14

2010-04-04T02:33:07Z

MaddDogg14: Created page with 'Hi, what's up?'

Hi, what's up?

OnClientGUITabSwitched

2010-03-30T15:49:38Z

MaddDogg14:

{{Client event}}
__NOTOC__
This event is triggered each time the user switch from GUI tab.

==Parameters==
<syntaxhighlight lang="lua">
element theElement
</syntaxhighlight>
* '''theElement''': The element which was selected.

==Source==
The [[event system#Event source|source]] of this event is always the [[getRootElement|root]] element.

==Example==
This example creates a window with a tabpanel with two tabs. Every time a user changes tabpage a notification will be shown.

First we'll create the window. Then add a tabpanel and couple tabs with some labels in them. Qoute: [[GuiCreateWindow#Example]]
<syntaxhighlight lang="lua">
local myWindow = guiCreateWindow ( 0, 0, 0.5, 0.4, "Information", true ) -- create a window which has "Information" in the title bar.
local tabPanel = guiCreateTabPanel ( 0, 0.1, 1, 1, true, myWindow ) -- create a tab panel which fills the whole window
local tabMap = guiCreateTab( "Map Information", tabPanel ) -- create a tab named "Map Information" on 'tabPanel'
local tabHelp = guiCreateTab( "Help", tabPanel ) -- create another tab named "Help" on 'tabPanel'

-- adds a label (text) to each tab
guiCreateLabel( 0.02, 0.04, 0.94, 0.2, "This is information about the current map", true, tabMap )
guiCreateLabel( 0.02, 0.04, 0.94, 0.92, "This is help text.", true, tabHelp )
</syntaxhighlight>

Now let's add the event handler.
<syntaxhighlight lang="lua">

function OnChange( selectedTab )

-- If there is a selected tab.
if selectedTab ~= nil then

outputChatBox( "You've changed your active tab." )

end

end

addEventHandler("onClientGUITabSwitched", getRootElement( ), OnChange)
</syntaxhighlight>

==See Also==
===GUI events===
{{GUI_events}}
===Client event functions===
{{Client_event_functions}}

GuiGridListAddRow

2010-02-03T21:00:20Z

MaddDogg14: typo

{{Client function}}
__NOTOC__
Adds a row to a grid list.

ATTENTION: Without guiGridListSetItemText there is no row added to the grid.
Look at the example, first you give the row a name with '''[[row =]]''' guiGridListAddRow ( playerList ), and then you use guiGridListSetItemText.

==Syntax==
<syntaxhighlight lang="lua">
int guiGridListAddRow ( element gridList )
</syntaxhighlight>

===Required Arguments===
*'''gridList:''' The grid list you want to add a row to

===Returns===
Returns the row id if it has been created, ''false'' otherwise.

==Example==
This example creates a player list on the right side of the screen and fills it with the names of the connected players.
<syntaxhighlight lang="lua">
function clientsideResourceStart ()
local playerList = guiCreateGridList ( 0.80, 0.10, 0.15, 0.60, true ) -- Create the grid list
local column = guiGridListAddColumn( playerList, "Player", 0.85 ) -- Create a 'players' column in the list
if ( column ) then -- If the column was successfully created
for id, playeritem in ipairs(getElementsByType("player")) do
--Loop through all the players, adding them to the table
local row = guiGridListAddRow ( playerList )
guiGridListSetItemText ( playerList, row, column, getPlayerName ( playeritem ), false, false )
end
end
end
addEventHandler ( "onClientResourceStart", getRootElement(), clientsideResourceStart )
</syntaxhighlight>

==See Also==
{{GUI functions}}

CallClientFunction

2010-01-04T19:43:19Z

MaddDogg14: Little typo

{{Useful Function}}
<lowercasetitle/>
__NOTOC__
This function allows you to call any clientside function from the server's side. Of course only those which are available clientside. It doesn't matter if it's a MTA function, a Lua standard function or a custom function.
 
Numbers are automatically converted to a string and vice versa clientside to avoid data being lost. If you don't need this feature just delete it.
 
'''Important Note:''' Bear in mind that the funcname has to be a '''string'''! Avoid using callClientFunction in the serverside onResourceStart-event since the client did not add the event handler onServerCallsClientFunction yet.

==Syntax==
<syntaxhighlight lang="lua">void callClientFunction( element client, string funcname, [ var arg1, ... ] )</syntaxhighlight>

===Required Arguments===
* '''client''': The element of the player who should be affected.
* '''funcname''': The name of the function that should be called clientside. May also be a function in a table, e.g. "math.round".

===Optional Arguments===
{{OptionalArg}}
* '''arg1-argn''': The arguments that should be passed to the function.

==Code==
<section name="Serverside Script" class="server" show="true">
<syntaxhighlight lang="lua">
function callClientFunction(client, funcname, ...)
local arg = { ... }
if (arg[1]) then
for key, value in next, arg do
if (type(value) == "number") then arg[key] = tostring(value) end
end
end
triggerClientEvent(client, "onServerCallsClientFunction", root, funcname, unpack(arg or {}))
end
</syntaxhighlight>
</section>
<section name="Clientside Script" class="client" show="true">
<syntaxhighlight lang="lua">
function callClientFunction(funcname, ...)
local arg = { ... }
if (arg[1]) then
for key, value in next, arg do arg[key] = tonumber(value) or value end
end
loadstring("return "..funcname)()(unpack(arg))
end
addEvent("onServerCallsClientFunction", true)
addEventHandler("onServerCallsClientFunction", root, callClientFunction)
</syntaxhighlight>
</section>

==Example==
<section name="Server" class="server" show="true">
This example sets the player's minute duration.
<syntaxhighlight lang="lua">
-- define the onPlayerJoin handler function
function onPlayerJoin()
-- set the minute duration
callClientFunction(source, "setMinuteDuration", 10000)
end
-- add the event handler
addEventHandler("onPlayerJoin", root, onPlayerJoin)
</syntaxhighlight>
</section>

Author: NeonBlack

==See Also==
{{Useful_Functions}}

OnClientGUIClick

2009-12-26T07:12:27Z

MaddDogg14: "Needs checking" note was outdated

{{Client event}}
__NOTOC__
This event is fired when the user clicks a GUI element.

==Parameters==
<syntaxhighlight lang="lua">
string button, string state, int absoluteX, int absoluteY
</syntaxhighlight>
*'''button:''' the name of the mouse button that the GUI element was clicked with, can be ''left'', ''right'', or ''middle''.
*'''state:''' the state of the mouse button, will be ''down'' if the mouse button was pushed, or ''up'' if it was released. '''Please note currently only the ''up'' state is supported.'''
*'''absoluteX:''' the X position of the mouse cursor, in pixels, measured from the left side of the screen.
*'''absoluteY:''' the Y position of the mouse cursor, in pixels, measured from the top of the screen.

==Source==
The [[event system#Event source|source]] of this event is the GUI element that was clicked.

==Example==
This example creates an edit box alongside an "Output!" button. When the button is clicked with the left mouse button, it will output the message in the edit box into the chat box.
<syntaxhighlight lang="lua">
-- When client's resource starts, create the GUI
function initGUI( )
-- Create our button
btnOutput = guiCreateButton( 0.7, 0.1, 0.2, 0.1, "Output!", true )

-- And attach our button to the outputEditBox function
addEventHandler ( "onClientGUIClick", btnOutput, outputEditBox, false )

-- Create an edit box and define it as "editBox".
editBox = guiCreateEdit( 0.3, 0.1, 0.4, 0.1, "Type your message here!", true )
guiEditSetMaxLength ( editBox, 128 ) -- The max chatbox text length is 128, so force this
end
addEventHandler( "onClientResourceStart", getResourceRootElement( getThisResource( ) ), initGUI )

-- Setup our function to output the message to the chatbox
function outputEditBox ( button )
if button == "left" then
local text = guiGetText ( editBox )-- Get the text from the edit box
outputChatBox ( text ) -- Output that text
end
end
</syntaxhighlight>

==See Also==
===GUI events===
{{GUI_events}}
===Client event functions===
{{Client_event_functions}}