Multi Theft Auto: Wiki - User contributions [en]

Template:Useful Functions

2014-05-30T09:52:49Z

Enad:

*[[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.
*[[getFewPlayersOnTeams]] » This function gets a team from it's few Players.!
*[[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.
*[[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.
[[Category:Useful Functions]]

Template:Useful Functions

2014-04-09T15:35:21Z

Enad:

*[[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.
*[[getFewPlayersOnTeams]] » This function gets a team from it's few Players.!
*[[getPlayerAllGroups]] » This function gets a groups from Player.
*[[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.
*[[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.
*[[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.
[[Category:Useful Functions]]

SetAccountName

2014-01-31T10:37:59Z

Enad: /* Code */

{{Useful Function}}
__NOTOC__
This function is used to change existing [[account]]s name. 

==Syntax==
<syntaxhighlight lang="lua">bool setAccountName ( element player, string oldAccount, string newAccount )</syntaxhighlight>

===Required Arguments===
* '''player''': The player who called the function.
* '''oldAccount''': The account you want to change.
* '''newAccount''': The name you wanna to apply old account on it.

===Returns===
Returns ''true'' if account was successfully changed, ''false'' if the old account does not exist/ the new account exist.

==Code==
<section name="Function source" class="server" show="true">
<syntaxhighlight lang="lua">
setAccountName = function ( plr, old, new )
if old and new then
local oldAccount, newAccount, newPass = getAccount ( old ), getAccount ( new ), "mta"..math.random(10000,100000)
if oldAccount and not newAccount then
if addAccount ( new, newPass ) then
local newAccount = getAccount ( new )
local player = getAccountPlayer ( oldAccount )
for index, value in pairs ( getAllAccountData ( oldAccount ) ) do
setAccountData ( newAccount, index, value )
end
for index, value in ipairs ( aclGroupList ( ) ) do
if isObjectInACLGroup ( "user."..old, value ) then
aclGroupAddObject ( value, "user."..new )
aclGroupRemoveObject ( value, "user."..old )
end
end
if player then
logOut ( player )
logIn ( player, newAccount, newPass )
if plr == player then
outputChatBox ( "* Your new account and password: [ "..new.." ] [ "..newPass.." ].", player, 255, 255, 0, true )
else
outputChatBox ( "* Your new account and password: [ "..new.." ] [ "..newPass.." ].", player, 255, 255, 0, true )
outputChatBox ( "* New account and password: [ "..new.." ] [ "..newPass.." ].", plr, 255, 255, 0, true )
end
else
outputChatBox ( "* New account and password: [ "..new.." ] [ "..newPass.." ].", plr, 255, 255, 0, true )
end
setTimer ( removeAccount, 100, 1, oldAccount )
return true
end
end
end
return false
end
</syntaxhighlight>
</section>

==Example==
<section name="Server" class="server" show="true">
This example will change account name.
<syntaxhighlight lang="lua">addCommandHandler ( "chgAccName", function ( player, _, old, new )
setAccountName ( player, old, new )
end )</syntaxhighlight></section>

==Author==
Created By 3NAD.
 

==See Also==
{{Useful_Functions}}

SetAccountName

2014-01-31T10:36:33Z

Enad:

{{Useful Function}}
__NOTOC__
This function is used to change existing [[account]]s name. 

==Syntax==
<syntaxhighlight lang="lua">bool setAccountName ( element player, string oldAccount, string newAccount )</syntaxhighlight>

===Required Arguments===
* '''player''': The player who called the function.
* '''oldAccount''': The account you want to change.
* '''newAccount''': The name you wanna to apply old account on it.

===Returns===
Returns ''true'' if account was successfully changed, ''false'' if the old account does not exist/ the new account exist.

==Code==
<section name="Function source" class="server" show="true">
<syntaxhighlight lang="lua">
setAccountName = function ( plr, old, new )
if old and new then
local oldAccount, newAccount, newPass = getAccount ( old ), getAccount ( new ), "mta"..math.random(10000,100000)
if oldAccount and not newAccount then
if addAccount ( new, newPass ) then
local newAccount = getAccount ( new )
local player = getAccountPlayer ( oldAccount )
for index, value in pairs ( getAllAccountData ( oldAccount ) ) do
setAccountData ( newAccount, index, value )
end
for index, value in ipairs ( aclGroupList ( ) ) do
if isObjectInACLGroup ( "user."..old, value ) then
aclGroupAddObject ( value, "user."..new )
aclGroupRemoveObject ( value, "user."..old )
end
end
if player then
logOut ( player )
logIn ( player, newAccount, newPass )
if plr == player then
outputChatBox ( "* Your new account and password: [ "..new.." ] [ "..newPass.." ].", player, 255, 255, 0, true )
else
outputChatBox ( "* Your new account and password: [ "..new.." ] [ "..newPass.." ].", player, 255, 255, 0, true )
outputChatBox ( "* New account and password: [ "..new.." ] [ "..newPass.." ].", plr, 255, 255, 0, true )
end
else
outputChatBox ( "* New account and password: [ "..new.." ] [ "..newPass.." ].", plr, 255, 255, 0, true )
end
setTimer ( removeAccount, 100, 1, oldAccount )
end
end
end
end
</syntaxhighlight>
</section>

==Example==
<section name="Server" class="server" show="true">
This example will change account name.
<syntaxhighlight lang="lua">addCommandHandler ( "chgAccName", function ( player, _, old, new )
setAccountName ( player, old, new )
end )</syntaxhighlight></section>

==Author==
Created By 3NAD.
 

==See Also==
{{Useful_Functions}}

SetAccountName

2014-01-29T16:50:57Z

Enad:

{{Useful Function}}
__NOTOC__
This function is used to change existing [[account]]s name. 

==Syntax==
<syntaxhighlight lang="lua">bool setAccountName ( element player, string oldAccount, string newAccount )</syntaxhighlight>

===Required Arguments===
* '''player''': The player who called the function.
* '''oldAccount''': The account you want to change.
* '''newAccount''': The name you wanna to apply old account on it.

===Returns===
Returns ''true'' if account was successfully changed, ''false'' if the account does not exist/ error occurred.

==Code==
<section name="Function source" class="server" show="true">
<syntaxhighlight lang="lua">
setAccountName = function ( plr, old, new )
if old and new then
local oldAccount, newAccount, newPass = getAccount ( old ), getAccount ( new ), "mta"..math.random(10000,100000)
if oldAccount and not newAccount then
if addAccount ( new, newPass ) then
local newAccount = getAccount ( new )
local player = getAccountPlayer ( oldAccount )
for index, value in pairs ( getAllAccountData ( oldAccount ) ) do
setAccountData ( newAccount, index, value )
end
for index, value in ipairs ( aclGroupList ( ) ) do
if isObjectInACLGroup ( "user."..old, value ) then
aclGroupAddObject ( value, "user."..new )
aclGroupRemoveObject ( value, "user."..old )
end
end
if player then
logOut ( player )
logIn ( player, newAccount, newPass )
if plr == player then
outputChatBox ( "* Your new account and password: [ "..new.." ] [ "..newPass.." ].", player, 255, 255, 0, true )
else
outputChatBox ( "* Your new account and password: [ "..new.." ] [ "..newPass.." ].", player, 255, 255, 0, true )
outputChatBox ( "* New account and password: [ "..new.." ] [ "..newPass.." ].", plr, 255, 255, 0, true )
end
else
outputChatBox ( "* New account and password: [ "..new.." ] [ "..newPass.." ].", plr, 255, 255, 0, true )
end
setTimer ( removeAccount, 100, 1, oldAccount )
end
end
end
end
</syntaxhighlight>
</section>

==Example==
<section name="Server" class="server" show="true">
This example will change account name.
<syntaxhighlight lang="lua">addCommandHandler ( "chgAccName", function ( player, _, old, new )
setAccountName ( player, old, new )
end )</syntaxhighlight></section>

==Author==
Created By 3NAD.
 

==See Also==
{{Useful_Functions}}

SetAccountName

2014-01-29T16:50:15Z

Enad: Created page with "{{Useful Function}} __NOTOC__ This function is used to change existing accounts name. ==Syntax== <syntaxhighlight lang="lua">bool setAccountName ( element player, string oldAccount, string..."

{{Useful Function}}
__NOTOC__
This function is used to change existing accounts name. 

==Syntax==
<syntaxhighlight lang="lua">bool setAccountName ( element player, string oldAccount, string newAccount )</syntaxhighlight>

===Required Arguments===
* '''player''': The player who called the function.
* '''oldAccount''': The account you want to change.
* '''newAccount''': The name you wanna to apply old account on it.

===Returns===
Returns ''true'' if account was successfully changed, ''false'' if the account does not exist/ error occurred.

==Code==
<section name="Function source" class="server" show="true">
<syntaxhighlight lang="lua">
setAccountName = function ( plr, old, new )
if old and new then
local oldAccount, newAccount, newPass = getAccount ( old ), getAccount ( new ), "mta"..math.random(10000,100000)
if oldAccount and not newAccount then
if addAccount ( new, newPass ) then
local newAccount = getAccount ( new )
local player = getAccountPlayer ( oldAccount )
for index, value in pairs ( getAllAccountData ( oldAccount ) ) do
setAccountData ( newAccount, index, value )
end
for index, value in ipairs ( aclGroupList ( ) ) do
if isObjectInACLGroup ( "user."..old, value ) then
aclGroupAddObject ( value, "user."..new )
aclGroupRemoveObject ( value, "user."..old )
end
end
if player then
logOut ( player )
logIn ( player, newAccount, newPass )
if plr == player then
outputChatBox ( "* Your new account and password: [ "..new.." ] [ "..newPass.." ].", player, 255, 255, 0, true )
else
outputChatBox ( "* Your new account and password: [ "..new.." ] [ "..newPass.." ].", player, 255, 255, 0, true )
outputChatBox ( "* New account and password: [ "..new.." ] [ "..newPass.." ].", plr, 255, 255, 0, true )
end
else
outputChatBox ( "* New account and password: [ "..new.." ] [ "..newPass.." ].", plr, 255, 255, 0, true )
end
setTimer ( removeAccount, 100, 1, oldAccount )
end
end
end
end
</syntaxhighlight>
</section>

==Example==
<section name="Server" class="server" show="true">
This example will change account name.
<syntaxhighlight lang="lua">addCommandHandler ( "chgAccName", function ( player, _, old, new )
setAccountName ( player, old, new )
end )</syntaxhighlight></section>

==Author==
Created By 3NAD.
 

==See Also==
{{Useful_Functions}}

IsPedDrivingVehicle

2013-10-26T10:37:59Z

Enad:

{{Useful Function}}
__NOTOC__
This function will get vehicle via element ( ped or player ). 

==Syntax==
<syntaxhighlight lang="lua">vehicle getPlayerVehicle ( element player/ped )</syntaxhighlight>

===Required Arguments===
* '''element''': The element you want to get his vehicle.

===Returns===
Returns a vehicle / false if the element didn't have vehicle.

==Code==
<syntaxhighlight lang="lua">
getPlayerVehicle = function ( element )
if element then
local type = getElementType
if type ( element ) == "player" or type ( element ) == "ped" then
if isPedInVehicle ( element ) then
local vehicle = getPedOccupiedVehicle ( element )
if getVehicleController ( vehicle ) == element then
return vehicle
end
return false
end
return false
end
return false
end
end
</syntaxhighlight>

==Example==
<section name="Server" class="server" show="true">
This example will get vehicle via element.
<syntaxhighlight lang="lua">addCommandHandler ( "vehicle",
function ( player )
local vehicle = getPlayerVehicle ( player )
if vehicle then
outputChatBox ( "* You have "..getVehicleName(vehicle).." ["..getElementModel(vehicle).."].", player, 255, 255, 0, true )
else
outputChatBox ( "* You don't have vehicle.", player, 255, 0, 0, true )
end
end
)</syntaxhighlight></section>

==Author==
getElementVehicle
Created By 3NAD.
 

==See Also==
{{Useful_Functions}}

IsPedDrivingVehicle

2013-10-26T10:35:08Z

Enad:

{{Useful Function}}
__NOTOC__
This function will get vehicle via element ( ped or player ). 

==Syntax==
<syntaxhighlight lang="lua">bool getPlayerVehicle ( element player/ped )</syntaxhighlight>

===Required Arguments===
* '''element''': The element you want to get his vehicle.

===Returns===
Returns a vehicle / false if the element didn't have vehicle.

==Code==
<syntaxhighlight lang="lua">
getPlayerVehicle = function ( element )
if element then
local type = getElementType
if type ( element ) == "player" or type ( element ) == "ped" then
if isPedInVehicle ( element ) then
local vehicle = getPedOccupiedVehicle ( element )
if getVehicleController ( vehicle ) == element then
return vehicle
end
return false
end
return false
end
return false
end
end
</syntaxhighlight>

==Example==
<section name="Server" class="server" show="true">
This example will get vehicle via element.
<syntaxhighlight lang="lua">addCommandHandler ( "vehicle",
function ( player )
local vehicle = getPlayerVehicle ( player )
if vehicle then
outputChatBox ( "* You have "..getVehicleName(vehicle).." ["..getElementModel(vehicle).."].", player, 255, 255, 0, true )
else
outputChatBox ( "* You don't have vehicle.", player, 255, 0, 0, true )
end
end
)</syntaxhighlight></section>

==Author==
getElementVehicle
Created By 3NAD.
 

==See Also==
{{Useful_Functions}}

IsPedDrivingVehicle

2013-10-26T10:33:59Z

Enad: getElementVehicle

{{Useful Function}}
__NOTOC__
This function will get vehicle via element ( ped or player ). 

==Syntax==
<syntaxhighlight lang="lua">bool getPlayerVehicle ( element player/ped )</syntaxhighlight>

===Required Arguments===
* '''element''': The element you want to get his vehicle.

===Returns===
Returns a vehicle / false if the element didn't have vehicle.

==Code==
<syntaxhighlight lang="lua">
getPlayerVehicle = function ( element )
if element then
local type = getElementType
if type ( element ) == "player" or type ( element ) == "ped" then
if isPedInVehicle ( element ) then
local vehicle = getPedOccupiedVehicle ( element )
if getVehicleController ( vehicle ) == element then
return vehicle
end
return false
end
return false
end
return false
end
end
</syntaxhighlight>

==Example==
<section name="Server" class="server" show="true">
This example will get vehicle via element.
<syntaxhighlight lang="lua">addCommandHandler ( "vehicle",
function ( player )
local vehicle = getPlayerVehicle ( player )
if vehicle then
outputChatBox ( "* You have "..getVehicleName(vehicle).." ["..getElementModel(vehicle).."].", player, 255, 255, 0, true )
else
outputChatBox ( "* You don't have vehicle.", player, 255, 0, 0, true )
end
end
)</syntaxhighlight></section>

==Author==
Created By 3NAD.
 

==See Also==
{{Useful_Functions}}

GuiSetLocation

2013-06-15T11:10:51Z

Enad: Created page with "<pageclass class="#228B22" subcaption="Useful Function"></pageclass> <lowercasetitle/> __NOTOC__ {{Useful Function}} This function will change gui Location to Horizontal and Vert..."

<pageclass class="#228B22" subcaption="Useful Function"></pageclass>
<lowercasetitle/>
__NOTOC__
{{Useful Function}}
This function will change gui Location to Horizontal and Vertical location.
 

==Syntax==
<syntaxhighlight lang="lua">
string guiSetLocation ( element Gui, string Horizontal, string Vertical )
</syntaxhighlight>

===Required Arguments===
* '''Gui''': The guiElement to be changed.
* '''Horizontal''': "left", "center", "right".
* '''Vertical''': "up", "center", "down".

==Code==
<section name="Function source" class="client" show="true">
<syntaxhighlight lang="lua">
x3NAD = {
xLocation = {
["right"] = { 1 };
["left"] = { 10 };
["center"] = { 2 };
};
yLocation = {
["up"] = { 10 };
["down"] = { 1 };
["center"] = { 2 };
};
};

guiSetLocation = function ( gui, Horizontal, Vertical )
local screenW, screenH = guiGetScreenSize ( )
local windowW, windowH = guiGetSize ( gui, false )
if Horizontal and Vertical then
local x, y = tonumber ( x3NAD.xLocation[Horizontal][1] ) or 2, tonumber ( x3NAD.yLocation[Vertical][1] ) or 2
local x, y = ( screenW -windowW ) /x, ( screenH -windowH ) /y
guiSetPosition ( gui, x, y, false )
end
end;
</syntaxhighlight>
</section>

==Example==
<section name="Client-side example" class="client" show="true">
<syntaxhighlight lang="lua">
window = guiCreateWindow ( 100, 100, 400, 400, "Test", false );
guiSetLocation ( window, "left", "down" );
</syntaxhighlight>
</section>

* This Function Has Created By '''3NAD'''.

==See Also==
{{Useful_Functions}}

[[Category:Useful Functions]]

SetBindKeyWindowShow

2013-03-26T10:29:09Z

Enad:

<pageclass class="#228B22" subcaption="Useful Function"></pageclass>
<lowercasetitle/>
__NOTOC__
{{Useful Function}}
This function will hide window automatically and set BindKey to show it.
 

==Syntax==
<syntaxhighlight lang="lua">
bool setBindKeyWindowShow ( element Window, string key )
</syntaxhighlight>

===Required Arguments===
* '''Window''': Window you want to edit it.
* '''key''': Key you want to enable it.
 

==Code==
<section name="Function source" class="client" show="true">
<syntaxhighlight lang="lua">
setBindKeyWindowShow = function ( guiWindow, key )
if guiWindow and key then
if getElementType ( guiWindow ) == "gui-window" then
guiSetVisible ( guiWindow, false );
local setBindKey_ = function ( key )
guiSetVisible ( guiWindow, not guiGetVisible ( guiWindow ) );
showCursor ( guiGetVisible ( guiWindow ) );
end
return bindKey ( key, "down", setBindKey_ );
else
return false;
end
else
return false;
end
end
</syntaxhighlight>
</section>
 

==Example==
<section name="Client-side example" class="client" show="true">
This Example will hide window and showing it by BindKey.
<syntaxhighlight lang="lua">
Window = guiCreateWindow ( 40, 40, 200, 200, "Test", false ) -- Create window.
setBindKeyWindowShow ( Window, "f2" ) -- Enable function on it.
</syntaxhighlight>
</section>
 

* This Function Has Created By '''3NAD'''.

==See Also==
{{Useful_Functions}}

[[Category:Useful Functions]]

SetBindKeyWindowShow

2013-03-26T10:26:21Z

Enad: Created page with "<pageclass class="#228B22" subcaption="Useful Function"></pageclass> <lowercasetitle/> __NOTOC__ {{Useful Function}} This function will hide window automatically and set BindKey ..."

<pageclass class="#228B22" subcaption="Useful Function"></pageclass>
<lowercasetitle/>
__NOTOC__
{{Useful Function}}
This function will hide window automatically and set BindKey to show it.
 

==Syntax==
<syntaxhighlight lang="lua">
bool setBindWindowShowing ( element Window, string key )
</syntaxhighlight>

===Required Arguments===
* '''Window''': Window you want to edit it.
* '''key''': Key you want to enable it.
 

==Code==
<section name="Function source" class="client" show="true">
<syntaxhighlight lang="lua">
setBindWindowShowing = function ( guiWindow, key )
if guiWindow and key then
if getElementType ( guiWindow ) == "gui-window" then
guiSetVisible ( guiWindow, false );
local setBindKey_ = function ( key )
guiSetVisible ( guiWindow, not guiGetVisible ( guiWindow ) );
showCursor ( guiGetVisible ( guiWindow ) );
end
return bindKey ( key, "down", setBindKey_ );
else
return false;
end
else
return false;
end
end
</syntaxhighlight>
</section>
 

==Example==
<section name="Client-side example" class="client" show="true">
This Example will hide window and showing it by BindKey.
<syntaxhighlight lang="lua">
Window = guiCreateWindow ( 40, 40, 200, 200, "Test", false ) -- Create Window.
setBindWindowShowing ( Window, "f2" ) -- Apply Function on it.
</syntaxhighlight>
</section>
 

* This Function Has Created By '''3NAD'''.

==See Also==
{{Useful_Functions}}

[[Category:Useful Functions]]

ChangeGridListItemToPlayersName

2013-03-26T10:03:07Z

Enad:

<pageclass class="#228B22" subcaption="Useful Function"></pageclass>
<lowercasetitle/>
__NOTOC__
{{Useful Function}}
This function will change gridlist items and values to players name.
 

==Syntax==
<syntaxhighlight lang="lua">
bool changeGridListItemToPlayersName ( element GridList, element Column )
</syntaxhighlight>

===Required Arguments===
* '''GridList''': GridList you want to edit it.
* '''Column''': Column you want to change the items.

==Code==
<section name="Function source" class="client" show="true">
<syntaxhighlight lang="lua">
changeGridListItemToPlayersName = function ( GridList, Column )
if GridList and Column then -- Check Parematers
if getElementType ( GridList ) == "gui-gridlist" then -- Check The Type of ' GridList '
if guiGridListClear ( GridList ) then
for i, v in next, getElementsByType ( "player" ) do -- Get Everything by Type ' player '
guiGridListSetItemText ( GridList, guiGridListAddRow ( GridList ), Column, getPlayerName ( v ), false, false );
end;
end;
end;
end;
end;
</syntaxhighlight>
</section>

==Example==
<section name="Client-side example" class="client" show="true">
This Example will add players name to the gridlist.
<syntaxhighlight lang="lua">
wnd = guiCreateWindow ( 100, 100, 400, 400, "Test", false ); -- Create Window
grid = guiCreateGridList ( 25, 30, 350, 350, false, wnd ); -- Create Gridlist
col = guiGridListAddColumn ( grid, "Players", 0.9 ); -- Create Column
changeGridListItemToPlayersName ( grid, col ); -- Set Gridlist Values
</syntaxhighlight>
</section>

* This Function Has Created By '''3NAD'''.

==See Also==
{{Useful_Functions}}

[[Category:Useful Functions]]

ChangeGridListItemToPlayersName

2013-03-18T10:47:34Z

Enad:

{{Adding_Pages_to_Categories_and_Templates}}
__NOTOC__
{{Useful Function}}
This function will change gridlist items and values to players name.
==Syntax==
<syntaxhighlight lang="lua">
bool changeGridListItemToPlayersName ( element GridList, element Column )
</syntaxhighlight>

===Required Arguments===
* '''GridList''': GridList you want to edit it.
* '''Column''': Column you want to change the items.

==Code==
<section name="Function source" class="client" show="true">
<syntaxhighlight lang="lua">
changeGridListItemToPlayersName = function ( GridList, Column )
if GridList and Column then -- Check Parematers
if getElementType ( GridList ) == "gui-gridlist" then -- Check The Type of ' GridList '
if guiGridListClear ( GridList ) then
for i, v in next, getElementsByType ( "player" ) do -- Get Everything by Type ' player '
guiGridListSetItemText ( GridList, guiGridListAddRow ( GridList ), Column, getPlayerName ( v ), false, false );
end;
end;
end;
end;
end;
</syntaxhighlight>
</section>

==Example==
<section name="Client-side example" class="client" show="true">
This Example will add players name to the gridlist.
<syntaxhighlight lang="lua">
wnd = guiCreateWindow ( 100, 100, 400, 400, "Test", false ); -- Create Window
grid = guiCreateGridList ( 25, 30, 350, 350, false, wnd ); -- Create Gridlist
col = guiGridListAddColumn ( grid, "Players", 0.9 ); -- Create Column
changeGridListItemToPlayersName ( grid, col ); -- Set Gridlist Values
</syntaxhighlight>
</section>

* This Function Has Created By '''3NAD'''.

==See Also==
{{Useful_Functions}}

ChangeGridListItemToPlayersName

2013-03-18T05:15:23Z

Enad:

__NOTOC__
{{Useful Function}}
This function will change gridlist items and values to players name.
==Syntax==
<syntaxhighlight lang="lua">
bool changeGridListItemToPlayersName ( element GridList, element Column )
</syntaxhighlight>

===Required Arguments===
* '''GridList''': GridList you want to edit it.
* '''Column''': Column you want to change the items.

==Code==
<section name="Function source" class="client" show="true">
<syntaxhighlight lang="lua">
changeGridListItemToPlayersName = function ( GridList, Column )
if GridList and Column then -- Check Parematers
if getElementType ( GridList ) == "gui-gridlist" then -- Check The Type of ' GridList '
if guiGridListClear ( GridList ) then
for i, v in next, getElementsByType ( "player" ) do -- Get Everything by Type ' player '
guiGridListSetItemText ( GridList, guiGridListAddRow ( GridList ), Column, getPlayerName ( v ), false, false );
end;
end;
end;
end;
end;
</syntaxhighlight>
</section>

==Example==
<section name="Client-side example" class="client" show="true">
This Example will add players name to the gridlist.
<syntaxhighlight lang="lua">
wnd = guiCreateWindow ( 100, 100, 400, 400, "Test", false ); -- Create Window
grid = guiCreateGridList ( 25, 30, 350, 350, false, wnd ); -- Create Gridlist
col = guiGridListAddColumn ( grid, "Players", 0.9 ); -- Create Column
changeGridListItemToPlayersName ( grid, col ); -- Set Gridlist Values
</syntaxhighlight>
</section>

* This Function Has Created By '''3NAD'''.

==See Also==
{{Useful_Functions}}

ChangeGridListItemToPlayersName

2013-03-17T13:43:23Z

Enad: Test

This function will change '''gridlist''' items and values to players name.