Multi Theft Auto: Wiki - User contributions [en]

GetResourceScripts

2014-12-01T21:12:20Z

Wassim Masmoudi: /* Credits */

{{Useful Function}}
<lowercasetitle></lowercasetitle>
__NOTOC__
This function show all scripts in resource.

==Syntax==
<syntaxhighlight lang="lua">table getResourceScripts ( resource theResource )</syntaxhighlight>

===Required Arguments===
* '''theResource''': The resource where you want to get the scripts from.

===Returns===
Returns ''table'' scripts on [[resource]].

==Code==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
function getResourceScripts(resource)
local scripts = {}
local resourceName = getResourceName(resource)
local theMeta = xmlLoadFile(":"..resourceName.."/meta.xml")
for i, node in ipairs (xmlNodeGetChildren(theMeta)) do
if (xmlNodeGetName(node) == "script") then
local script = xmlNodeGetAttribute(node, "src")
if (script) then
table.insert(scripts, script)
end
end
end
return scripts
end
</syntaxhighlight>
</section>

==Example==
This example will compile all script on resource
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
addCommandHandler("compile",
function (source, cmd, resourceName)
local resource = getResourceFromName(resourceName)
if (resource) then
for i, script in ipairs (getResourceScripts(resource)) do
local localFile = ":"..resourceName.."/"..script
local theScript = fileExists(localFile) and fileOpen(localFile, true)
if (theScript) then
local code = fileRead(theScript, fileGetSize(theScript)), fileClose(theScript)
if not (string.byte(code) == 28) then
if (fetchRemote("http://luac.mtasa.com/?compile=1&debug=0&obfuscate=1", myCallback, code, true, localFile, source)) then
outputChatBox(localFile..": Start copy compile script...", source, 0, 255, 0)
else
outputChatBox(localFile..": Problem fetch remort", source, 255, 0, 0)
end
else
outputChatBox(localFile..": Already compiled", source, 255, 0, 0)
end
else
outputChatBox(localFile..": Does not exist or script don't opened", source, 255, 0, 0)
end
end
else
outputChatBox(resourceName..": Does not exist", source, 255, 0, 0)
end
end)

function myCallback(responseData, errno, localFile, source)
if (errno == 0) and (responseData) then
local localFileC = localFile.."c"
if (string.find(responseData, "ERROR")) then
outputChatBox(localFile..": "..responseData, source, 255, 0, 0)
else
if (fileExists(localFileC)) then fileDelete(localFileC) end
local theScriptC = fileCreate(localFileC)
if (theScriptC) then
fileWrite(theScriptC, responseData)
fileClose(theScriptC)
outputChatBox(localFile..": Successfully compiled", source, 0, 255, 0)
else
outputChatBox(localFile..": Failed to compiled", source, 255, 0, 0)
end
end
else
outputChatBox(localFile..": Failed get compiled code", source, 255, 0, 0)
end
end
</syntaxhighlight>
</section>

==Credits==
*'''Author:''' WASSIm.

==See Also==
{{Useful_Functions}}

GetResourceScripts

2014-12-01T21:11:56Z

Wassim Masmoudi: /* Example */

Template:Useful Functions

2014-07-16T21:14:59Z

Wassim Masmoudi:

*[[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.
*[[loadScript]] » This function load script.
*[[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
*[[dxDrawAnimWindow]] » Create Animated Dx Window
*[[dxDrawCircle]] » This function draws a 2D line in a circle shape on the screen.
*[[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.
*[[dxDrawPartialCircle]] » This function draws a 2D line in a partial circle shape on the screen.
*[[dxDrawRectangle3D]] » This function draws a 3D rectangle.
*[[dxDrawEmptyRec]] » This funcions draws an empty 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.
*[[getTeamWithFewestPlayers]] » This function returns the team with less players of the teams passed to it.
*[[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.
*[[getBoundControls]] » This function returns a list of control names that are bound to the specified key.
*[[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.
*[[getElementsInDimension]] » This function gets the elements that are in the specified dimension.
*[[getElementsWithinMarker]] » This function gets the elements that are in a markers colshape.
*[[getJetpackWeaponsEnabled]] » This function reurens a table of enabled weapons usable on a jetpack.
*[[getKeyFromValueInTable]] » This function returns the key of the specified value in a table.
*[[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.
*[[getPlayerAcls]] » This function gets all ACL's group on player.
*[[getPlayerAllGroups]] » This function gets groups from Player.
*[[isVehicleOccupied]] » This function checks if a specified vehicle is occupied.
*[[isPedDrivingVehicle]] » This function checks if the specified ped is driving a vehicle.
*[[getPointFromDistanceRotation]] » Finds a point based on a starting point, direction and distance.
*[[getResourceSettings]] » This function returns a table of the resource settings.
*[[getResourceScripts]] » This function returns a table of the resource scripts.
*[[getRGColorFromPercentage]] »This function returns two integers representing Red and Green colors according to the percentage requested.
*[[getScreenRotationFromWorldPosition]] » This function returns a screen relative rotation to a world position. The returned rotation can be used in dxDrawImage
*[[getTeamFromColor]] » This function gets a team from it's color. (Related to: [[getTeamFromName]])
*[[getTimestamp]] » With this function you can get the UNIX timestamp.
*[[getValidVehicleModels]] » This function returns a table containing valid MTA Vehicle models.
*[[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.
*[[guiGridListGetSelectedText]] » This function get text selected on gridlist.
*[[GuiMoveRightToCenter]] » This function move it Gui right to center.!
*[[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.
*[[isElementTeam]]» This function checks if element is team.
*[[isElementWithinAColShape]]» This function checks if the [[element]] is in a [[colshape]].
*[[isPedAiming]]» This function checks if a ped is aiming.
*[[isPlayerInACL]] » This function will check to see if a player element is in an ACL group.
*[[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.
*[[isSoundFinished]] » This function checks sound finished or not.
*[[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.percent]] » Return the porcent from one number.
*[[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.
*[[secondsToTimeDesc]] » This function converts a plain seconds-integer into a user-friendly time description.
*[[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.
*[[setAccountName]] » This function is used to change existing accounts name.
*[[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.merge]] » Merges two or more tables in the first.
*[[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.
*[[getPedMaxHealth]] » This function to get ped's maximal health by conversion from his stat.
[[Category:Useful Functions]]

Template:Useful Functions

2014-07-14T23:01:33Z

Wassim Masmoudi:

*[[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
*[[dxDrawAnimWindow]] » Create Animated Dx Window
*[[dxDrawCircle]] » This function draws a 2D line in a circle shape on the screen.
*[[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.
*[[dxDrawPartialCircle]] » This function draws a 2D line in a partial circle shape on the screen.
*[[dxDrawRectangle3D]] » This function draws a 3D rectangle.
*[[dxDrawEmptyRec]] » This funcions draws an empty 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.
*[[getTeamWithFewestPlayers]] » This function returns the team with less players of the teams passed to it.
*[[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.
*[[getBoundControls]] » This function returns a list of control names that are bound to the specified key.
*[[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.
*[[getElementsInDimension]] » This function gets the elements that are in the specified dimension.
*[[getElementsWithinMarker]] » This function gets the elements that are in a markers colshape.
*[[getJetpackWeaponsEnabled]] » This function returns a table of enabled weapons usable on a jetpack.
*[[getKeyFromValueInTable]] » This function returns the key of the specified value in a table.
*[[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.
*[[getPlayerAcls]] » This function gets all ACL's group on player.
*[[getPlayerAllGroups]] » This function gets groups from Player.
*[[getPlayerVehicle]] » This function gets vehicle from Player.
*[[getPointFromDistanceRotation]] » Finds a point based on a starting point, direction and distance.
*[[getResourceSettings]] » This function returns a table of the resource settings.
*[[getResourceScripts]] » This function returns a table of the resource scripts.
*[[getRGColorFromPercentage]] »This function returns two integers representing Red and Green colors according to the percentage requested.
*[[getScreenRotationFromWorldPosition]] » This function returns a screen relative rotation to a world position. The returned rotation can be used in dxDrawImage
*[[getTeamFromColor]] » This function gets a team from it's color. (Related to: [[getTeamFromName]])
*[[getTimestamp]] » With this function you can get the UNIX timestamp.
*[[getValidVehicleModels]] » This function returns a table containing valid MTA Vehicle models.
*[[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.
*[[guiGridListGetSelectedText]] » This function get text selected on gridlist.
*[[GuiMoveRightToCenter]] » This function move it Gui right to center.!
*[[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.
*[[isElementTeam]]» This function checks if element is team.
*[[isElementWithinAColShape]]» This function checks if the [[element]] is in a [[colshape]].
*[[isPedAiming]]» This function checks if a ped is aiming.
*[[isPlayerInACL]] » This function will check to see if a player element is in an ACL group.
*[[isPlayerInTeam]] » This function check if the player in the team.
*[[isPlayersInVehicle]] » This function check if there any players in a Vehicle.
*[[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.
*[[isSoundFinished]] » This function checks sound finished or not.
*[[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.percent]] » Return the porcent from one number.
*[[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.
*[[secondsToTimeDesc]] » This function converts a plain seconds-integer into a user-friendly time description.
*[[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.
*[[setAccountName]] » This function is used to change existing accounts name.
*[[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.merge]] » Merges two or more tables in the first.
*[[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.
*[[getPedMaxHealth]] » This function to get ped's maximal health by conversion from his stat.
[[Category:Useful Functions]]

GuiGridListGetSelectedText

2014-07-14T22:59:41Z

Wassim Masmoudi: /* Example */

{{Useful Function}}
<lowercasetitle></lowercasetitle>
__NOTOC__
This function get text selected on gridlist

==Syntax==
<syntaxhighlight lang="lua">element guiGridListGetSelectedText( element gridList, int columnIndex )</syntaxhighlight>

===Required Arguments===
* '''gridList''': The grid list element
* '''columnIndex''': column id of the item

===Returns===
Returns ''string'' text of the selected item if the specified grid list is valid and has a selected item, false otherwise.

==Code==
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">

function guiGridListGetSelectedText(gridList, columnIndex)
local selectedItem = guiGridListGetSelectedItem(gridList)
if (selectedItem) then
local text = guiGridListGetItemText(gridList, selectedItem, columnIndex or 1)
if (text) and not (text == "") then
return text
end
end
return false
end
</syntaxhighlight>
</section>

==Example==
This example get player name from gridlist
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">

addEventHandler("onClientResourceStart", resourceRoot,
function ()
playerList = guiCreateGridList(0.80, 0.10, 0.15, 0.60, true)
local column = guiGridListAddColumn(playerList, "Player", 0.85)
if (column) then
for id, playeritem in ipairs(getElementsByType("player")) do
local row = guiGridListAddRow(playerList)
guiGridListSetItemText(playerList, row, column, getPlayerName(playeritem), false, false)
end
end
end)

addEventHandler("onClientGUIClick", playerList,
function ( )
local playerName = guiGridListGetSelectedText(playerList)
outputChatBox("You'r selected player: "..playerName)
end)
</syntaxhighlight>
</section>

==Credits==
*'''Author:''': WASSIm.

==See Also==
{{Useful_Functions}}

GuiGridListGetSelectedText

2014-07-14T22:58:45Z

Wassim Masmoudi: Created page with "{{Useful Function}} <lowercasetitle></lowercasetitle> __NOTOC__ This function get text selected on gridlist ==Syntax== <syntaxhighlight lang="lua">element guiGridListGetSelectedText( elemen..."

{{Useful Function}}
<lowercasetitle></lowercasetitle>
__NOTOC__
This function get text selected on gridlist

==Syntax==
<syntaxhighlight lang="lua">element guiGridListGetSelectedText( element gridList, int columnIndex )</syntaxhighlight>

===Required Arguments===
* '''gridList''': The grid list element
* '''columnIndex''': column id of the item

===Returns===
Returns ''string'' text of the selected item if the specified grid list is valid and has a selected item, false otherwise.

==Code==
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">

function guiGridListGetSelectedText(gridList, columnIndex)
local selectedItem = guiGridListGetSelectedItem(gridList)
if (selectedItem) then
local text = guiGridListGetItemText(gridList, selectedItem, columnIndex or 1)
if (text) and not (text == "") then
return text
end
end
return false
end
</syntaxhighlight>
</section>

==Example==
This example get player name from gridlist
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">

addEventHandler("onClientResourceStart", resourceRoot,
function ()
local playerList = guiCreateGridList(0.80, 0.10, 0.15, 0.60, true)
local column = guiGridListAddColumn(playerList, "Player", 0.85)
if (column) then
for id, playeritem in ipairs(getElementsByType("player")) do
local row = guiGridListAddRow(playerList)
guiGridListSetItemText(playerList, row, column, getPlayerName(playeritem), false, false)
end
end
end)

addEventHandler("onClientGUIClick", playerList,
function ( )
local playerName = guiGridListGetSelectedText(playerList)
outputChatBox("You'r selected player: "..playerName)
end)
</syntaxhighlight>
</section>

==Credits==
*'''Author:''': WASSIm.

==See Also==
{{Useful_Functions}}