Multi Theft Auto: Wiki - User contributions [en]

User:Dawi

2015-08-29T09:03:59Z

Dawi:

yourdawi.de

Github: yourdawi
Twitter: yourdawi
Facebook: yourdawi

CreateLight

2015-08-29T09:00:07Z

Dawi:

__NOTOC__
{{Client function}}

{{New feature/item|3.0150|1.5.0|7048|This function creates a 3D [[Element/Light|light]] to the world.}}

{{Note|
* The direction of the light only has any effect if the light type is ''spot light''.
* One light will only apply illumination effects to [[Element/Ped|peds]], [[Element/Player|players]], wheels and number plates (like a emergency vehicle siren light does).
* Two or more lights will apply illumination effects to everything (excluding objects) that is in range of, at least, two of them.
}}
==Syntax==
<syntaxhighlight lang="lua">light createLight ( int lightType, float posX, float posY, float posZ, [ float radius = 3, int r = 255, int g = 0, int b = 0, float dirX = 0, float dirY = 0, float dirZ = 0, bool createsShadow = false ] )</syntaxhighlight>
{{OOP||[[Light]]}}

===Required Arguments===
*'''lightType:''' An integer representing the type of light to create.
{{Light_types}}
*'''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}}
*'''radius:''' A floating point number representing the radius of the light.
*'''r:''' An integer number representing the amount of red to use in the colouring of the light (0 - 255).
*'''g:''' An integer number representing the amount of green to use in the colouring of the light (0 - 255).
*'''b:''' An integer number representing the amount of blue to use in the colouring of the light (0 - 255).
*'''dirX:''' A floating point number representing the light direction's X coordinate on the map.
*'''dirY:''' A floating point number representing the light direction's Y coordinate on the map.
*'''dirZ:''' A floating point number representing the light direction's Z coordinate on the map.
*'''createsShadow:''' A boolean representing whether or not does the light cast shadows.

=== Returns ===
Returns the [[Element/Light|light]] element if creation was successful, ''false'' otherwise.

== Example ==
This example will make every player to look completely black without using shaders. It will also dark vehicles he uses too.
<syntaxhighlight lang="lua">
local lightRadius = 2 * getElementRadius(localPlayer) -- Every standard player model has the same radius, so save it for quicker access
local lights = { localPlayer = createLight(2, 0, 0, 0, lightRadius) } -- Intitialize our light table with the one that the local player will use for the effect

local function addPlayerDarkLight()
-- Create a new dark light for that player
lights[source] = createLight(2, 0, 0, 0, lightRadius)
end
addEventHandler("onClientPlayerJoin", root, addPlayerDarkLight)

local function removePlayerDarkLight()
-- Destroy the light of that player and remove references
destroyElement(lights[source])
lights[source] = nil
end
addEventHandler("onClientPlayerQuit", root, removePlayerDarkLight)

-- Make the dark light assigned to each player to move with his center, so we archieve the desired effect
local function updateLightPositions()
for player, light in pairs(lights) do
setElementPosition(light, getPedBonePosition(player, 2))
end
end
addEventHandler("onClientPreRender", root, updateLightPositions)</syntaxhighlight>

==Changelog==
{{ChangelogHeader}}
{{ChangelogItem|1.5.0-3.0152|Addendum to r7048 (Applied source patch #8737 (PointLight Creation) by Lex128.)}}

== See Also ==
{{Client_light_functions}}

InjectBrowserMouseUp

2015-08-03T20:05:26Z

Dawi:

__NOTOC__
{{Client_function}}
{{New feature/item|3.0150|1.5||
This function injects a mouse click (state: up).
}}

==Syntax==
<syntaxhighlight lang="lua">
bool injectBrowserMouseUp ( browser webBrowser, string mouseButton )
</syntaxhighlight>
{{OOP||[[Element/Browser|browser]]:injectMouseUp||injectBrowserMouseUp}}

===Required arguments===
*'''webBrowser:''' The web browser
*'''mouseButton:''' The mouse button (Possible values: ''left'', ''middle'', ''right'')

===Returns===
Returns ''true'' if the click was successfully injected, ''false'' otherwise.

==Example==
<syntaxhighlight lang="lua">addEventHandler("onClientClick", root,
function(button, state)
if state == "down" then
injectBrowserMouseDown(browser, button)
else
injectBrowserMouseUp(browser, button)
end
end
)</syntaxhighlight>

==See also==
{{CEF_functions}}

IsVehicleEmpty

2014-01-20T18:42:58Z

Dawi:

{{Useful Function}}
<lowercasetitle/>
__NOTOC__

This function checks whether a vehicle is empty.

==Syntax==
<syntaxhighlight lang="lua">bool isVehicleEmpty ( vehicle theVehicle )</syntaxhighlight>

* '''theVehicle''': The vehicle that you want to check.

==Code==
<section name="Serverside/Clientside Script" class="both" show="true">
<syntaxhighlight lang="lua">
function isVehicleEmpty( vehicle )
if not isElement( vehicle ) or getElementType( vehicle ) ~= "vehicle" then
return true
end

local passengers = getVehicleMaxPassengers( vehicle )
if type( passengers ) == 'number' then
for seat = 0, passengers do
if getVehicleOccupant( vehicle, seat ) then
return false
end
end
end
return true
end
</syntaxhighlight>
</section>

==See Also==
{{Useful_Functions}}

User:Dawi

2013-08-16T01:52:22Z

Dawi:

Dawi is a german Scripter.
http://facebook.com/yourdawi
http://yourdawi.de

Youtube
http://youtube.com/mtascriptingnet

User:Dawi

2013-08-16T01:51:37Z

Dawi:

Dawi is a german Scripter.

IsVehicleEmpty

2013-06-27T11:57:38Z

Dawi:

{{Useful Function}}
<lowercasetitle/>
__NOTOC__

This function checks whether a vehicle is empty.

==Syntax==
<syntaxhighlight lang="lua">bool isVehicleEmpty ( vehicle theVehicle )</syntaxhighlight>

* '''theVehicle''': The car that you want to check.

==Code==
<section name="Serverside/Clientside Script" class="both" show="true">
<syntaxhighlight lang="lua">
function isVehicleEmpty( vehicle )
if not isElement( vehicle ) or getElementType( vehicle ) ~= "vehicle" then
return true
end

local passengers = getVehicleMaxPassengers( vehicle )
if type( passengers ) == 'number' then
for seat = 0, passengers do
if getVehicleOccupant( vehicle, seat ) then
return false
end
end
end
return true
end
</syntaxhighlight>
</section>

==See Also==
{{Useful_Functions}}

Template:Useful Functions

2013-06-27T11:57:23Z

Dawi:

*[[callClientFunction]] » This function allows you to call any clientside function from the server's side.
*[[callServerFunction]] » This function allows you to call any server-side function from the client's side.
*[[centerWindow]] » This function center the window in any resolution.
*[[Check]] » This function checks if it's arguments are of the right types and calls the error-function if one isn't.
*[[convertNumber]] » This function converts large numbers and adds commas to it. (Example: 100000 -> 100,000)
*[[coroutine.resume]] » Fix for hidden coroutine error messages
*[[dxDrawColorText]] » This function draws a dx text with #RRGGBB color codes support.
*[[dxDrawGifImage]] » This function simulates the effect of a GIF image by using image sprites.
*[[dxDrawImage3D]] » This function draws a 3D image.
*[[dxDrawRectangle3D]] » This function draws a 3D rectangle.
*[[dxGetFontSizeFromHeight]] » This function calculate a font size from given height for dxDraw.
*[[dxGetRealFontHeight]] » Accurately measures the pixel height of a font.
*[[findRotation]] » Takes two points and returns the direction from point A to point B.
*[[FormatDate]] » Formats a date on the basis of a format string and returns it.
*[[GenerateString]] » With this function you can generate a random string with any characters.
*[[getAge]] » This function calculates the age of a birthday.
*[[getAlivePlayers (Client)|getAlivePlayers]] » This function returns all the alive players by a client side, so you can store them into a Gridlist or something like that, faster.
*[[getAlivePlayersInTeam]] » This function returns a table of the alive players in a team.
*[[getCursorMoveOn]] » This function checks in which way the cursor is currently moving.
*[[getDistanceBetweenPointAndSegment2D]] » Takes point coordinates and line (a segment) starting and ending coordinates. It returns the shortest distance between the point and the line.
*[[getElementSpeed]] » This function allows you to get element speed in kph or mph units.
*[[getJetpackWeaponsEnabled]] » This function returns a table of enabled weapons usable on a jetpack.
*[[getOffsetFromXYZ]] » This function allows you to take an entity and a position and calculate the relative offset between them accounting for rotations.
*[[getOnlineAdmins]] » This function will give the online admins.
*[[getOnlineStaff]] » Returns all online staff, names separated by two spaces.
*[[getPlayersByData]] » This function gets players who have data name you passed to it.
*[[getPlayerFromNamePart]] » This function allows you to get player From his Name part.
*[[getPlayersInPhotograph]] » This function gets all the players in a photograph.
*[[getPlayerFromSerial]] » This function gets an online player from their serial.
*[[getPointFromDistanceRotation]] » Finds a point based on a starting point, direction and distance.
*[[getResourceSettings]] » This function returns a table of the resource settings.
*[[getTeamFromColor]] » This function gets a team from it's color. (Related to: [[getTeamFromName]])
*[[getTimestamp]] » With this function you can get the UNIX timestamp.
*[[getXMLNodes]] » Returns all children of a node
*[[getVehicleRespawnPosition]] » This function allows you to get the spawn position of a vehicle.
*[[guiComboBoxAdjustHeight]] » Adjusts the combobox to have a correct height.
*[[IfElse]] » Returns one of two values based on a boolean expression.
*[[isElementInPhotograph]] » This function checks if an element was in the player's camera picture.
*[[isElementInRange]] » This function allows you to check is the element's range to the main point is smaller than (or as big as) the maximum range.
*[[isElementMoving]]» This function checks if an element is moving.
*[[isElementWithinAColShape]]» This function checks if the [[element]] is in a [[colshape]].
*[[isPedAiming]]» This function checks if a ped is aiming.
*[[isPlayerInTeam]] » This function check if the player in the team.
*[[isLeapYear]] » Checks if the given year is a leap year.
*[[isVehicleOnRoof]] » This function checks whether vehicle is on roof.
*[[isVehicleEmpty]] » This function checks whether a vehicle is empty.
*[[iterElements]] » Returns an iterator for your for loops saving time typing ipairs( getElementsByType( type ) ), instead you type: iterElements( type ).
*[[mathNumber]] » This function is a workaround for the clientside floating-point precision of 24-bits
*[[math.round]] » Rounds a number whereas the number of decimals to keep and the method may be set.
*[[multi_check]] » This function checks one element to many, handy and clean.
*[[onVehicleWeaponFire]] » This code implements an event that is triggered when a player in a vehicle fires a vehicles weapon.
*[[RGBToHex]] » This function returns a string representing the color in hexadecimal.
*[[setElementSpeed]] » This function allows you to set moving element speed in kph or mph units.
*[[setTableProtected]] » Protects a table and makes it read-only.
*[[setVehicleGravityPoint]] » This clientside function sets a vehicle's gravity in the direction of a 3 dimensional coordinate with the strength specified.
*[[smoothMoveCamera]] » This clientside function allows you to create a cinematic camera flight.
*[[string.count]] » This function counts a text from a text.
*[[string.explode]] » This function splits a string at a given separator pattern and returns a table with the pieces.
*[[switch]] » This function allow the value of a variable or expression to control the flow of program execution via a multiway branch.
*[[table.copy]] » This function copies a whole table and all the tables in that table.
*[[table.compare]] » This function check if both tables is equal. 
*[[table.empty]] » This function check is empty table or not.
*[[table.map]] » This function goes through a table and replaces every field with the return of the passed function, where the field's value is passed as first argument and optionally more arguments.
*[[table.random]] » This function retrieves a random variable from a table.
*[[table.size]] » Finds the absolute size of a table.
*[[toHex]] » This function converts a decimal number to a hexadecimal number, as a fix to be used clientside.
*[[var dump]] » This function outputs information about one or more variables using outputConsole()
*[[wavelengthToRGBA]] » This function converts a phisical wavelength of light to a RGBA color.
[[Category:Useful Functions]]

Template:Useful Functions

2013-06-27T11:56:57Z

Dawi:

*[[callClientFunction]] » This function allows you to call any clientside function from the server's side.
*[[callServerFunction]] » This function allows you to call any server-side function from the client's side.
*[[centerWindow]] » This function center the window in any resolution.
*[[Check]] » This function checks if it's arguments are of the right types and calls the error-function if one isn't.
*[[convertNumber]] » This function converts large numbers and adds commas to it. (Example: 100000 -> 100,000)
*[[coroutine.resume]] » Fix for hidden coroutine error messages
*[[dxDrawColorText]] » This function draws a dx text with #RRGGBB color codes support.
*[[dxDrawGifImage]] » This function simulates the effect of a GIF image by using image sprites.
*[[dxDrawImage3D]] » This function draws a 3D image.
*[[dxDrawRectangle3D]] » This function draws a 3D rectangle.
*[[dxGetFontSizeFromHeight]] » This function calculate a font size from given height for dxDraw.
*[[dxGetRealFontHeight]] » Accurately measures the pixel height of a font.
*[[findRotation]] » Takes two points and returns the direction from point A to point B.
*[[FormatDate]] » Formats a date on the basis of a format string and returns it.
*[[GenerateString]] » With this function you can generate a random string with any characters.
*[[getAge]] » This function calculates the age of a birthday.
*[[getAlivePlayers (Client)|getAlivePlayers]] » This function returns all the alive players by a client side, so you can store them into a Gridlist or something like that, faster.
*[[getAlivePlayersInTeam]] » This function returns a table of the alive players in a team.
*[[getCursorMoveOn]] » This function checks in which way the cursor is currently moving.
*[[getDistanceBetweenPointAndSegment2D]] » Takes point coordinates and line (a segment) starting and ending coordinates. It returns the shortest distance between the point and the line.
*[[getElementSpeed]] » This function allows you to get element speed in kph or mph units.
*[[getJetpackWeaponsEnabled]] » This function returns a table of enabled weapons usable on a jetpack.
*[[getOffsetFromXYZ]] » This function allows you to take an entity and a position and calculate the relative offset between them accounting for rotations.
*[[getOnlineAdmins]] » This function will give the online admins.
*[[getOnlineStaff]] » Returns all online staff, names separated by two spaces.
*[[getPlayersByData]] » This function gets players who have data name you passed to it.
*[[getPlayerFromNamePart]] » This function allows you to get player From his Name part.
*[[getPlayersInPhotograph]] » This function gets all the players in a photograph.
*[[getPlayerFromSerial]] » This function gets an online player from their serial.
*[[getPointFromDistanceRotation]] » Finds a point based on a starting point, direction and distance.
*[[getResourceSettings]] » This function returns a table of the resource settings.
*[[getTeamFromColor]] » This function gets a team from it's color. (Related to: [[getTeamFromName]])
*[[getTimestamp]] » With this function you can get the UNIX timestamp.
*[[getXMLNodes]] » Returns all children of a node
*[[getVehicleRespawnPosition]] » This function allows you to get the spawn position of a vehicle.
*[[guiComboBoxAdjustHeight]] » Adjusts the combobox to have a correct height.
*[[IfElse]] » Returns one of two values based on a boolean expression.
*[[isElementInPhotograph]] » This function checks if an element was in the player's camera picture.
*[[isElementInRange]] » This function allows you to check is the element's range to the main point is smaller than (or as big as) the maximum range.
*[[isElementMoving]]» This function checks if an element is moving.
*[[isElementWithinAColShape]]» This function checks if the [[element]] is in a [[colshape]].
*[[isPedAiming]]» This function checks if a ped is aiming.
*[[isPlayerInTeam]] » This function check if the player in the team.
*[[isLeapYear]] » Checks if the given year is a leap year.
*[[isVehicleOnRoof]] » This function checks whether vehicle is on roof.
*[[isVehicleEmpty]] » This function checks whether a car is empty.
*[[iterElements]] » Returns an iterator for your for loops saving time typing ipairs( getElementsByType( type ) ), instead you type: iterElements( type ).
*[[mathNumber]] » This function is a workaround for the clientside floating-point precision of 24-bits
*[[math.round]] » Rounds a number whereas the number of decimals to keep and the method may be set.
*[[multi_check]] » This function checks one element to many, handy and clean.
*[[onVehicleWeaponFire]] » This code implements an event that is triggered when a player in a vehicle fires a vehicles weapon.
*[[RGBToHex]] » This function returns a string representing the color in hexadecimal.
*[[setElementSpeed]] » This function allows you to set moving element speed in kph or mph units.
*[[setTableProtected]] » Protects a table and makes it read-only.
*[[setVehicleGravityPoint]] » This clientside function sets a vehicle's gravity in the direction of a 3 dimensional coordinate with the strength specified.
*[[smoothMoveCamera]] » This clientside function allows you to create a cinematic camera flight.
*[[string.count]] » This function counts a text from a text.
*[[string.explode]] » This function splits a string at a given separator pattern and returns a table with the pieces.
*[[switch]] » This function allow the value of a variable or expression to control the flow of program execution via a multiway branch.
*[[table.copy]] » This function copies a whole table and all the tables in that table.
*[[table.compare]] » This function check if both tables is equal. 
*[[table.empty]] » This function check is empty table or not.
*[[table.map]] » This function goes through a table and replaces every field with the return of the passed function, where the field's value is passed as first argument and optionally more arguments.
*[[table.random]] » This function retrieves a random variable from a table.
*[[table.size]] » Finds the absolute size of a table.
*[[toHex]] » This function converts a decimal number to a hexadecimal number, as a fix to be used clientside.
*[[var dump]] » This function outputs information about one or more variables using outputConsole()
*[[wavelengthToRGBA]] » This function converts a phisical wavelength of light to a RGBA color.
[[Category:Useful Functions]]

IsVehicleEmpty

2013-06-26T15:24:09Z

Dawi:

{{Useful Function}}
<lowercasetitle/>
__NOTOC__

This function checks whether a car is empty.

==Syntax==
<syntaxhighlight lang="lua">bool isVehicleEmpty ( vehicle theVehicle )</syntaxhighlight>

* '''theVehicle''': The car that you want to check.

==Code==
<section name="Serverside/Clientside Script" class="both" show="true">
<syntaxhighlight lang="lua">
function isVehicleEmpty( vehicle )
if not isElement( vehicle ) or getElementType( vehicle ) ~= "vehicle" then
return true
end

local passengers = getVehicleMaxPassengers( vehicle )
if type( passengers ) == 'number' then
for seat = 0, passengers do
if getVehicleOccupant( vehicle, seat ) then
return false
end
end
end
return true
end
</syntaxhighlight>
</section>

==See Also==
{{Useful_Functions}}

IsVehicleEmpty

2013-06-26T15:22:45Z

Dawi: Created page with "{{Useful Function}} <lowercasetitle/> __NOTOC__ This function checks whether a car is empty. ==Syntax== <syntaxhighlight lang="lua">isVehicleEmpty ( vehicle theVehicle )</syntaxhighlight> * '''theVehic..."

{{Useful Function}}
<lowercasetitle/>
__NOTOC__

This function checks whether a car is empty.

==Syntax==
<syntaxhighlight lang="lua">isVehicleEmpty ( vehicle theVehicle )</syntaxhighlight>

* '''theVehicle''': The car that you want to check.

==Code==
<section name="Serverside/Clientside Script" class="both" show="true">
<syntaxhighlight lang="lua">
function isVehicleEmpty( vehicle )
if not isElement( vehicle ) or getElementType( vehicle ) ~= "vehicle" then
return true
end

local passengers = getVehicleMaxPassengers( vehicle )
if type( passengers ) == 'number' then
for seat = 0, passengers do
if getVehicleOccupant( vehicle, seat ) then
return false
end
end
end
return true
end
</syntaxhighlight>
</section>

==See Also==
{{Useful_Functions}}

User:Dawi

2013-05-06T01:08:17Z

Dawi: Created page with "Dawi is a german Scripter/Racer/Recorder. Youtube: http://youtube.com/DanyISTintern Facebook http://facebook.com/yourdawi"

Dawi is a german Scripter/Racer/Recorder.

Youtube: http://youtube.com/DanyISTintern
Facebook http://facebook.com/yourdawi