Multi Theft Auto: Wiki - User contributions [en]

EngineSetSurfaceProperties

2023-10-14T08:37:58Z

Hydra: /* Example */

{{Client function}}
__NOTOC__
{{New feature/item|3.0157|1.5.6|16365|This function changes a property of a surface.}}

==Syntax==
<syntaxhighlight lang="lua">
bool engineSetSurfaceProperties ( int surfaceID, string property, mixed value )
</syntaxhighlight>
===Required Arguments===
*'''surfaceID:''' [[Material IDs|Material ID]] from 0 to 178
*'''property:''' Property name
*'''value:''' New value from table below

===Returns===
Returns ''true'' if the function executed succesfully, ''false'' otherwise.

== Properties ==
{{Material_Properties}}

==Example==
This will disable the smoke for the wheels when going on the surfaces with the id below:
<syntaxhighlight lang="lua">
addCommandHandler("weffect", function()
for i = 9, 14 do
engineSetSurfaceProperties(i, "wheeleffect", "disabled")
end
end)
</syntaxhighlight>

==See Also==
{{Engine_functions}}

RO/getSoundProperties

2023-10-02T08:02:13Z

Hydra: Created page with "__NOTOC__ {{Client function}} {{New feature/item|3.0130|1.3.0|4097| Această funcție obține proprietățile unui anumit sound. }} ==Sintaxă== <syntaxhighlight lang="lua">float, float, float, bool getSoundProperties( element sound )</syntaxhighlight> {{OOP||sound:getProperties||setSoundProperties}} ===Argumente necesare=== *'''sound:'''' un sound element care este creat folosind playSound sau playSound3D. ===Returneaza=== Această funcție..."

__NOTOC__
{{Client function}}
{{New feature/item|3.0130|1.3.0|4097|
Această funcție obține proprietățile unui anumit [[sound]].
}}

==Sintaxă==
<syntaxhighlight lang="lua">float, float, float, bool getSoundProperties( element sound )</syntaxhighlight>
{{OOP||[[sound]]:getProperties||setSoundProperties}}
===Argumente necesare===
*'''sound:'''' un [[sound]] [[element]] care este creat folosind [[playSound]] sau [[playSound3D]].

===Returneaza===
Această funcție returnează 3 [[float|floats]] și o valoare [[boolean]]:

Primul float este cel a sunetului [http://en.wikipedia.org/wiki/Sampling_rate sample rate], al doilea este tempo-ul suntelui [http://en.wikipedia.org/wiki/Tempo tempo], iar cel de-al treilea este înălțimea [http://en.wikipedia.org/wiki/Pitch_%28music%29 pitch] sunetului. Boolean care reprezintă dacă sunetul este inversat sau nu.

==Exemplu==
'''Exemplu 1:''' Acest exemplu ar returna la fiecare 5 secunde trei valori float reprezentând rata de eșantionare, tempo-ul, înălțimea și o valoare booleană care reprezintă dacă sunetul este inversat sau nu.
<syntaxhighlight lang="lua">
local sound
local timer

addCommandHandler("playsound",
function ()
sound = playSound("wasted.mp3")
timer = setTimer(function() soundProperties(sound) end, 5000, 0)
end
)

function soundProperties(sound)
local sampleRate, tempo, pitch, isReversed = getSoundProperties(sound) --gets the sample rate, tempo, pitch and a boolean value representing whether the sound is reversed or not.
outputChatBox(sampleRate.." "..tempo.." "..pitch.." "..tostring(isReversed))
end
</syntaxhighlight>

==Vezi și==
{{Client_audio_functions}}

[[hu:getSoundProperties]]
[[ar:getSoundProperties]]
[[pt-br:getSoundProperties]]

RO/getSoundPan

2023-10-02T07:55:14Z

Hydra: Created page with "__NOTOC__ {{Client function}} Această funcție este utilizată pentru a obține nivelul de panoramare al elementului sound specificat. ==Sintaxă== <syntaxhighlight lang="lua">float getSoundPan ( element theSound )</syntaxhighlight> {{OOP||sound:getPan|pan|setSoundPan}} ===Argumente necesare=== *''''theSound:'''' elementul sound pe care doriți să îl obțineți. ===Returnează=== Returnează valoarea ''float'' cu intervalul de la ''-1,0 (stânga)'' l..."

__NOTOC__
{{Client function}}
Această funcție este utilizată pentru a obține nivelul de panoramare al elementului [[sound]] specificat.

==Sintaxă==
<syntaxhighlight lang="lua">float getSoundPan ( element theSound )</syntaxhighlight>
{{OOP||[[sound]]:getPan|pan|setSoundPan}}
===Argumente necesare===
*''''theSound:'''' elementul [[sound]] pe care doriți să îl obțineți.

===Returnează===
Returnează valoarea ''float'' cu intervalul de la ''-1,0 (stânga)'' la ''1,0 (dreapta)'', altfel ''false''.

==Exemplu==
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
function playMusic()
local song = playSound("song.mp3")
setSoundPan(song, -1)
outputChatBox("Current pan is " .. getSoundPan(song))
end
addCommandHandler("music", playMusic)
</syntaxhighlight>
</section>

==Vezi și==
{{Client_audio_functions}}

[[AR:getSoundPan]]
[[HU:getSoundPan]]
[[PT-BR:getSoundPan]]

RO/getSoundFFTData

2023-10-02T07:50:10Z

Hydra: /* Required Arguments */

__NOTOC__
{{Client function}}
Această funcție obține datele transformării rapide Fourier pentru un flux audio, care este un tabel de valori float reprezentând cadrul audio curent. Acest lucru permite vizualizări, de exemplu.
O transformare Fourier rapidă generează un tabel cu toate frecvențele din cadrul audio curent, care începe de la capătul de jos al spectrului, trecând de la frecvențe medii la cele înalte, în această ordine.
În cazul în care întâmpinați probleme, există o resursă de exemplu în depozitul de resurse:
[https://github.com/multitheftauto/mtasa-resources/tree/master/%5Bgameplay%5D/visualiser Visualiser]

Trebuie doar să tastați "startmusic mystreamurl" în consola dvs. și va fi difuzat pe panoul cinematografului de lângă A51. În cazul în care elementul este un jucător, această funcție va folosi vocea jucătorului.

==Sintaxă==
<syntaxhighlight lang="lua">table getSoundFFTData ( element sound, int iSamples [, int iBands = 0 ] )</syntaxhighlight>
{{OOP||[[sound]]:getFFTData}}
===Argumente necesare===
*'''sound:''' un element sonor creat cu ajutorul [[playSound]] sau [[playSound3D]]. De asemenea, sunt acceptate și fluxurile
*'''iSamples:''' Eșantioanele permise sunt 256, 512, 1024, 2048, 4096, 8192 și 16384.

===Argumente opționale===
*'''iBands:''' opțiunea de post-procesare vă permite să împărțiți eșantioanele în numărul dorit de benzi sau bare, astfel încât, dacă aveți nevoie doar de 5 bare, acest lucru economisește o mulțime de putere de procesare în comparație cu încercarea de a face acest lucru în Lua.

===Returnează===
Returnează un tabel de '''iSamples''/2 (sau '''iBands''' dacă se utilizează '''iBands''') ''floats''' reprezentând cadrul audio curent.
Returnează ''false'' dacă sunetul nu este încă redat sau nu a fost pus în buffer în cazul fluxurilor.

==Exemplu==
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
soundHandler = playSound ( "sound.wav" )

function onSoundPlayRender ( )
if ( soundHandler ) then
local soundFFT = getSoundFFTData ( soundHandler, 2048, 256 )
if ( soundFFT ) then
for i = 0, 255 do -- Data starts from index 0
dxDrawRectangle ( i, 0, 1, math.sqrt ( soundFFT[i] ) * 256 )
end
end
end
end
addEventHandler ( "onClientRender", getRootElement(), onSoundPlayRender )
</syntaxhighlight>
</section>

==Actualizări==
{{ChangelogHeader}}
{{ChangelogItem|1.3.2|Added player element to use a players voice}}

==Vezi și==
{{Client_audio_functions}}
[[ES:getSoundFFTData]]
[[AR:getSoundFFTData]]
[[PT-BR:getSoundFFTData]]
[[RO:getSoundFFTData]]

RO/getSoundFFTData

2023-10-02T07:49:54Z

Hydra:

__NOTOC__
{{Client function}}
Această funcție obține datele transformării rapide Fourier pentru un flux audio, care este un tabel de valori float reprezentând cadrul audio curent. Acest lucru permite vizualizări, de exemplu.
O transformare Fourier rapidă generează un tabel cu toate frecvențele din cadrul audio curent, care începe de la capătul de jos al spectrului, trecând de la frecvențe medii la cele înalte, în această ordine.
În cazul în care întâmpinați probleme, există o resursă de exemplu în depozitul de resurse:
[https://github.com/multitheftauto/mtasa-resources/tree/master/%5Bgameplay%5D/visualiser Visualiser]

Trebuie doar să tastați "startmusic mystreamurl" în consola dvs. și va fi difuzat pe panoul cinematografului de lângă A51. În cazul în care elementul este un jucător, această funcție va folosi vocea jucătorului.

==Sintaxă==
<syntaxhighlight lang="lua">table getSoundFFTData ( element sound, int iSamples [, int iBands = 0 ] )</syntaxhighlight>
{{OOP||[[sound]]:getFFTData}}
===Required Arguments===
*'''sound:''' un element sonor creat cu ajutorul [[playSound]] sau [[playSound3D]]. De asemenea, sunt acceptate și fluxurile
*'''iSamples:''' Eșantioanele permise sunt 256, 512, 1024, 2048, 4096, 8192 și 16384.

===Argumente opționale===
*'''iBands:''' opțiunea de post-procesare vă permite să împărțiți eșantioanele în numărul dorit de benzi sau bare, astfel încât, dacă aveți nevoie doar de 5 bare, acest lucru economisește o mulțime de putere de procesare în comparație cu încercarea de a face acest lucru în Lua.

===Returnează===
Returnează un tabel de '''iSamples''/2 (sau '''iBands''' dacă se utilizează '''iBands''') ''floats''' reprezentând cadrul audio curent.
Returnează ''false'' dacă sunetul nu este încă redat sau nu a fost pus în buffer în cazul fluxurilor.

==Exemplu==
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
soundHandler = playSound ( "sound.wav" )

function onSoundPlayRender ( )
if ( soundHandler ) then
local soundFFT = getSoundFFTData ( soundHandler, 2048, 256 )
if ( soundFFT ) then
for i = 0, 255 do -- Data starts from index 0
dxDrawRectangle ( i, 0, 1, math.sqrt ( soundFFT[i] ) * 256 )
end
end
end
end
addEventHandler ( "onClientRender", getRootElement(), onSoundPlayRender )
</syntaxhighlight>
</section>

==Actualizări==
{{ChangelogHeader}}
{{ChangelogItem|1.3.2|Added player element to use a players voice}}

==Vezi și==
{{Client_audio_functions}}
[[ES:getSoundFFTData]]
[[AR:getSoundFFTData]]
[[PT-BR:getSoundFFTData]]
[[RO:getSoundFFTData]]

RO/getSoundFFTData

2023-10-02T07:47:54Z

Hydra: Created page with "__NOTOC__ {{Client function}} Această funcție obține datele transformării rapide Fourier pentru un flux audio, care este un tabel de valori float reprezentând cadrul audio curent. Acest lucru permite vizualizări, de exemplu. O transformare Fourier rapidă generează un tabel cu toate frecvențele din cadrul audio curent, care începe de la capătul de jos al spectrului, trecând de la frecvențe medii la cele înalte, în această ordine. În cazul în care întâ..."

__NOTOC__
{{Client function}}
Această funcție obține datele transformării rapide Fourier pentru un flux audio, care este un tabel de valori float reprezentând cadrul audio curent. Acest lucru permite vizualizări, de exemplu.
O transformare Fourier rapidă generează un tabel cu toate frecvențele din cadrul audio curent, care începe de la capătul de jos al spectrului, trecând de la frecvențe medii la cele înalte, în această ordine.
În cazul în care întâmpinați probleme, există o resursă de exemplu în depozitul de resurse:
[https://github.com/multitheftauto/mtasa-resources/tree/master/%5Bgameplay%5D/visualiser Visualiser]

Trebuie doar să tastați "startmusic mystreamurl" în consola dvs. și va fi difuzat pe panoul cinematografului de lângă A51. În cazul în care elementul este un jucător, această funcție va folosi vocea jucătorului.

==Syntax==
<syntaxhighlight lang="lua">table getSoundFFTData ( element sound, int iSamples [, int iBands = 0 ] )</syntaxhighlight>
{{OOP||[[sound]]:getFFTData}}
===Required Arguments===
*'''sound:''' un element sonor creat cu ajutorul [[playSound]] sau [[playSound3D]]. De asemenea, sunt acceptate și fluxurile
*'''iSamples:''' Eșantioanele permise sunt 256, 512, 1024, 2048, 4096, 8192 și 16384.

===Optional Arguments===
*'''iBands:''' opțiunea de post-procesare vă permite să împărțiți eșantioanele în numărul dorit de benzi sau bare, astfel încât, dacă aveți nevoie doar de 5 bare, acest lucru economisește o mulțime de putere de procesare în comparație cu încercarea de a face acest lucru în Lua.

===Returns===
Returnează un tabel de '''iSamples''/2 (sau '''iBands''' dacă se utilizează '''iBands''') ''floats''' reprezentând cadrul audio curent.
Returnează ''false'' dacă sunetul nu este încă redat sau nu a fost pus în buffer în cazul fluxurilor.

==Example==
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
soundHandler = playSound ( "sound.wav" )

function onSoundPlayRender ( )
if ( soundHandler ) then
local soundFFT = getSoundFFTData ( soundHandler, 2048, 256 )
if ( soundFFT ) then
for i = 0, 255 do -- Data starts from index 0
dxDrawRectangle ( i, 0, 1, math.sqrt ( soundFFT[i] ) * 256 )
end
end
end
end
addEventHandler ( "onClientRender", getRootElement(), onSoundPlayRender )
</syntaxhighlight>
</section>

==Changelog==
{{ChangelogHeader}}
{{ChangelogItem|1.3.2|Added player element to use a players voice}}

==See Also==
{{Client_audio_functions}}
[[ES:getSoundFFTData]]
[[AR:getSoundFFTData]]
[[PT-BR:getSoundFFTData]]
[[RO:getSoundFFTData]]

Template:Useful Functions

2023-09-21T08:11:37Z

Hydra: /* Cursor functions */

__NOTOC__
=== Table functions ===
*[[addTableChangeHandler]] » This function monitors the changes of a table.
*[[getTableFromSql]] » This functionality is used to obtain saved tables using the function ([https://wiki.multitheftauto.com/wiki/SetTableToSql SetTableToSql ]).
*[[isValueInTable]] » This function returns true if the value exists in the table, false if the value does not exist in the table.
*[[pairsByKeys]] » This function sort pairs table.
*[[rangeToTable]] » This function converts a string range to a table containing number values.
*[[setTableProtected]] » This function protects a table and makes it read-only.
*[[setTableToSql]] » This function is used to save the table in the database (sql).
*[[Sort_Functions]] » These functions are able to sort your tables by a key.
*[[table.compare]] » This function checks whether two given tables are equal.
*[[table.copy]] » This function copies a whole table and all the tables in that table.
*[[table.deepmerge]] » This function deep merges two tables. Every nested table will be correspondingly merged.
*[[table.element]] » This function returns a new table with only userdata content.
*[[table.empty]] » This function checks whether a table is empty.
*[[table.fromString]] » This function converts string to a table.
*[[table.getRandomRows]] » This function returns random rows from table.
*[[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]] » This function merges two or more tables together.
*[[table.random]] » This function retrieves a random value from a table.
*[[table.removeValue]] » This function removes a specified value from a table.
*[[table.size]] » This function returns the absolute size of a table.
*[[table.toString]] » This function converts table to a string.

=== ACL functions ===
*[[aclGroupClone]] » This function clone a group to another group with/without ACLs and/or objects.
*[[getAccountsRanks]] » This function is used to detect the account name groups and put them in the chat.
*[[getPlayerAcls]] » This function returns a table of all ACL groups on a player.
*[[getPlayersInACLGroup]] » This function returns all players in an ACL group.
*[[isPlayerInACL]] » This function checks if a player element is in an ACL group.
*[[renameAclGroup]] » This function gives an existing ACL group a new name.
*[[isPlayerACLAdmin]] » This function checks if a player element belong to Admin group in ACL

=== Account functions ===
*[[getPlayerFromAccountName]] » This function is used to obtain a player by the name of his account.

=== Camera functions ===
*[[smoothMoveCamera]] » This function allows you to create a cinematic camera flight.

=== Colshape functions ===
*[[createGarageColShape]] » This function creates a collision shape from the specified garage.

=== Cursor functions ===
*[[getCursorMovedOn]] » This function checks in which way the cursor is currently moving.
*[[setCursorCenteredOnRectangle]] » This functions will center the cursor inside a rectangle.

=== Drawing functions ===
*[[dxDrawAnimWindow]] » This function draws an animated 2D window on the screen.
*[[dxDrawBorderedRectangle]] » This is a function that will create a bordered rectangle.
*[[dxDrawBorderedText]] » This is a function that will create a bordered text.
*[[dxDrawDashedLine]] » This function draws a line with dashes.
*[[dxDrawGifImage]] » This function simulates the effect of a GIF image by using image sprites in 2D.
*[[dxDrawImage3D]] » This function draws a 3D image in GTA world.
*[[dxDrawImageOnElement]] » This function draws an image on any element.
*[[dxDrawLinedRectangle]] » This is a function that will create a rectangle outline with dx lines.
*[[dxDrawLoading]] » This function draws a loading bar on the screen.
*[[dxDrawOctagon3D]] » This function creates a 3D Octagon
*[[dxDrawPolygon]] » This function draws a custom polygon on the screen.
*[[dxDrawProgressBar]] » This function simulates a progress bar drawed using DirectDraw.
*[[dxDrawRectangle3D]] » This function draws a 3D rectangle in GTA world.
*[[dxDrawRectangleOnPlayer]] » This function draws a 3D rectangle above the player.
*[[dxDrawRing]] » This function draws a ring with dx lines.
*[[dxDrawRombo]] » This function creates a Rhombus.
*[[dxDrawSprite]] » This function draw a sprite in the 3D world.
*[[dxDrawTextOnElement]] » This function draws a text on any element.
*[[dxDrawTextOnRectangle]] » Esta funcion crea un rectangle con un texto dentro.
*[[dxDrawTriangle]] » This is a function that will create a triangle with dx lines.
*[[dxGetFontSizeFromHeight]] » This function calculates the font size from given height.
*[[dxGetRealFontHeight]] » This function calculates the height of a font.
*[[getScreenStartPositionFromBox]] » This function helps with getting the correct position for your dx-effects.
*[[wordWrap]] » This function breaks a long string into a table of separate lines limited to a specific length in pixels, for drawing separately.
*[[CreateRectangle3D]] » This is a function that will create a 3d rectangle on the player screen.
*[[DxDrawBordered3DLine]] »This function creates a bordered area with 3D dx lines.

=== Effects functions ===
*[[attachEffect]] » This function allows you attach an effect to an element.
*[[setScreenFlash]] » This function will make the screen flash(like a screenshot).

=== Element functions ===
*[[autoAttach]] » This function attaches one element into another at the same position and rotation they are.
*[[isElementPlayer]] » This function checks whether the element is a player or not.
*[[attachElementToBone]] » This function allows you to attach an element to ped bone accurately using new bone functions.
*[[getElementsInDimension]] » This function returns a table of elements that are in the specified dimension.
*[[getElementSpeed]] » This function returns the specified element's speed in m/s, km/h or mph.
*[[getElementsWithinMarker]] » This function returns a table of elements that are within a marker's collision shape.
*[[getElementUsingData]] » This function returns table elements that contains the elements data with the given key and value.
*[[getNearestElement]] » This function returns the nearest element (of a specific type) to a player.
*[[isElementInPhotograph]] » This function checks if an element is in the player's camera picture area.
*[[isElementInRange]] » This function allows you to check if an element's range to a main point is within the maximum range.
*[[isElementMoving]]» This function checks if an element is moving.
*[[isElementWithinAColShape]]» This function checks if an element is within a collision shape element.
*[[isElementInAir]]» This function checks if an element is in air or not.
*[[multi_check]] » This function checks one element to many, handy and clean.
*[[setElementSpeed]] » This function allows you to set the speed of an element in kph or mph units.
*[[getElementDirectionCardialPoint]] » This function returns the direction of the element according to the ''wind rose''.

=== Events ===
*[[onVehicleWeaponFire]] » This code implements an event that is triggered when a player in a vehicle fires a vehicle's weapon.

=== Input functions ===
*[[bindControlKeys]] » This function allows you to bind each key bound to a control individually. Doing this bypasses a little MTA restriction.
*[[getBoundControls]] » This function returns a table of control names that are bound to the specified key.
*[[unbindControlKeys]] » This function allows you to unbind each key bound to a control individually. Use this function with [[bindControlKeys]].
*[[isCommandHandlerAdded]] » This function allows you to check if a command is added or not in the respective resource.

=== Data functions ===
*[[byte2human]] » This function converts an integer (number of bytes) into a human-readable unit.
*[[capitalize]] » This function capitalizes a given string.
*[[convertDate]] » This function converts date to another look.
*[[convertServerTickToTimeStamp]] » This function converts server ticks to a unix timestamp.
*[[convertTextToSpeech]] » This function converts the provided text to a speech in the provided language which players can hear.
*[[findRotation3D]] » This function takes two sets of XYZ coordinates. It returns the 3D direction from point A to point B.
*[[findRotation]] » This function takes two points and returns the direction from point A to point B.
*[[formatDate]] » This function formats a date on the basis of a format string and returns it.
*[[formatNumber]] » This function formats large numbers by adding commas.
*[[generateRandomASCIIString]] » This function returns a random string which uses ASCII characters. 
*[[generateString]] » This function generates a random string with any characters.
*[[getAge]] » This function calculates the age of a given birthday.
*[[getDistanceBetweenElements]] » Returns the distance between two elements.
*[[getDistanceBetweenPointAndSegment2D]] » This function takes point coordinates and line (a segment) starting and ending coordinates. It returns the shortest distance between the point and the line.
*[[getEasterDate]] » This function returns easter date monthday and month for a given year.
*[[getElementRelatedAngle]] » This function returns the related angle between one element to another. This is useful to check which side an element is to another.
*[[getFreeDimension]] » This function get free dimension.
*[[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.
*[[getPointFromDistanceRotation]] » This function finds a point based on a starting point, direction and distance.
*[[getRealMonth]] » This function returns the current month name
*[[getRGColorFromPercentage]] »This function returns two integers representing red and green colors according to the specified percentage.
*[[getScreenRotationFromWorldPosition]] » This function returns a screen relative rotation to a world position.
*[[getTimestamp]] » This function returns the UNIX timestamp of a specified date and time.
*[[gradientString]] » This function transforms a string in a new coloured gradient string.
*[[hex2rgb]] » This function convert hex to rgb.
*[[hexColorToRGB]] » This function convert hex string/number to RGBA values.
*[[isLeapYear]] » This function returns a boolean representing if a given year is a leap year.
*[[isValidMail]] » This function checks whether a provided e-mail string is valid.
*[[removeHex]] » This function is used to remove hexadecimal numbers (colors, for example) from strings.
*[[RGBToHex]] » This function returns a string representing the color in hexadecimal.
*[[RGBToHSV]] » This function convert RGB to HSV color space.
*[[RGBToDecimal]] » This function convert RGB to Decimal color.
*[[secondsToTimeDesc]] » This function converts a plain seconds-integer into a user-friendly time description.
*[[string.count]] » This function counts the amount of occurences of a string in a string.
*[[string.explode]] » This function splits a string at a given separator pattern and returns a table with the pieces.
*[[string.insert]] » This function inserts a string within another string at a given position.
*[[switch]] » This function allows the value of a variable or expression to control the flow of program execution via a multiway branch.
*[[tocolor2rgba]] » This function convert tocolor to rgba.
*[[toHex]] » This function converts a decimal number to a hexadecimal number, as a fix to be used client-side.
*[[var dump]] » This function outputs information about one or more variables using outputConsole.
*[[wavelengthToRGBA]] » This function converts a physical wavelength of light to a RGBA color.

=== GUI functions ===
*[[centerWindow]] » This function centers a CEGUI window element responsively in any resolution.
*[[guiMoveElement]] » This function moves guiElement by/like using moveObject.
*[[guiSetStaticImageMovable]] » This function allows you to move a static image like a gui window.
*[[isMouseOnGUICloseButton]] » This function allows you to check whether the mouse cursor/pointer is within a gui-window's native close button.
*[[isMouseOnGuiElement]] » This function allows you to check whether or not your mouse is over a specific gui element, this is especially useful if the gui element has a parent. 
=====Comboboxes=====
*[[guiComboBoxAdjustHeight]] » This function adjusts a CEGUI combobox element to have the correct height.

=====Gridlists=====
*[[convertGridListToText]] » This function converts grid list contents to text.
*[[getGridListRowIndexFromText]] » This function returns the GridList row index from the specified text.
*[[guiGridListAddPlayers]] » This function add all online players to a grid list.
*[[guiGridListGetColumnIDFromTitle]] » This function gets a gridlist's column ID from the column title.
*[[guiGridListGetSelectedText]] » This function returns a string containing the inner text of a selected gridlist item.
*[[guiGridListSetColumnNonSortable]] » This function makes a gridlist column become non-sortable.
*[[isTextInGridList]] » This function checks if some text exist or not in the GridList.

=====Labels=====
*[[guiLabelAddEffect]] » This function add an effects to the gui-label like (shadow, outline).

=== Marker functions ===
*[[createMarkerAttachedTo]] » This function creates a marker that is attached to an element.

=== Math functions ===
*[[math.clamp]] » This function returns the number between range of numbers or it's minimum or maximum.
*[[math.getBezierPoint]] » Get N-th order bezier point.
*[[math.hypot]] » This function returns the Hypotenuse of the triangle given by sides x and y.
*[[math.isPointInPolygon]] » Check if point is inside polygon or not.
*[[math.lerp]] » Get val between two integer.
*[[math.percent]] » This function returns a percentage from two number values.
*[[math.polygonArea]] » Compute area of any polygon.
*[[math.randomDiff]] » Generates a pseudo-random integer that's always different from the last random number generated.
*[[math.rotVecToEulerAngle]] » Rotation Vector To Euler Angle
*[[math.round]] » Rounds a number whereas the number of decimals to keep and the method may be set.
*[[mathNumber]] » This function is a workaround for the client-side floating-point precision of 24-bits.
*[[reMap]] » Re-maps a number from one range to another.
*[[Math.percentProgress|math.percentProgress]] » Returns a percentage progress from two specific values.
*[[math.average]] » This function returns the simple arithmetic mean of multiple numbers.

=== Map functions ===
*[[assignLod]] » This function lets you conveniently generate and apply a LOD model to a mapping object.
*[[getWorldPositionFromMapPosition]] » This function converts an F11 map position to world position.

=== Ped functions ===
*[[getAlivePlayers (Client)|getAlivePlayers]] » This function returns a table of the alive players client-side.
*[[getAlivePlayersInTeam]] » This function returns a table of the alive players in a team.
*[[getGuestPlayers]] » This function gets a players not login or players Guest .
*[[getOnlineAdmins]] » This function returns a table of all logged-in administrators.
*[[getPedEyesPosition]] » This function allows you to get peds eyes position.
*[[getPedGender]] » This function allows you to get peds their gender.
*[[getPedMaxHealth]] » This function returns a pedestrians's maximum health by converting it from their maximum health stat.
*[[getPedMaxOxygenLevel]] » This function returns a ped's maximum oxygen level by converting it from their maximum underwater stamina stat.
*[[getPedWeaponSkill]] » This function returns a ped's corresponding weapon skill level name.
*[[getPedHitBone]] » This function gets the approximate number of the bone where the ped is hit.
*[[getPlayerFromNamePart]] » This function returns a player from partial name.
*[[getPlayerFromSerial]] » This function returns a player from their serial.
*[[getPlayersByData]] » This function returns a table of players that have the specified data name.
*[[getPlayersInPhotograph]] » This function returns a table of all players in photograph.
*[[getPlayersInVehicles]] » This function returns a table of the players insides vehicles from a specified dimension.
*[[isPedAiming]]» This function checks if a pedestrian is aiming their weapon.
*[[isPedAimingNearPed]] » This is similar to isPedAiming but uses a colshape to be more precise.
*[[isPedDiving]] » This feature checks that pedestrian is diving in the water.
*[[isPedDrivingVehicle]] » This function checks if a specified pedestrian is driving a vehicle.
*[[isPlayerInTeam]] » This function checks if a player is in a specified team.
*[[setPedAttack]] » This function will make a ped attack a specified target.
*[[setPedFollow]] » This function will make a ped follow a specified target.
*[[getPlayerNameFromID]] » This function will get the player name from the ID element data.

=== Player functions ===
*[[countPlayersInRange]] » This function returns the number of players that are within a certain range of the specified coordinates.
*[[getPlayerPreviousAndNextWeapon]] » This function returns the player previous and next weapon.
*[[getPlayersInRange]]» This function make a table of players within certain range.
*[[isPlayerActuallyInVehicle]]» This function checks if a player is actually in a vehicle instead of just in the process of entering.
*[[isPlayerHitByVehicle]]» This function cancels event when a element is hit by a vehicle.
*[[warpToPlayer]]» This function make player warp to another player.

=== Resource functions ===
*[[getFilesInResourceFolder]] » This function gets a list of files that are inside a folder of a resource.
*[[getResourceScripts]] » This function returns a table of the resource scripts.
*[[getResourceSettings]] » This function returns a table of the resource settings.
*[[getResourceSize]] » This function returns the size of a specified resource in kB(kilobyte)
*[[refreshResource]] » This function refreshes your resource if you changed any of the files
*[[setResourcePriority]] » This function set resource download priority group.

=== Sound functions ===
*[[isSoundFinished]] » This function checks if a sound element has finished.
*[[isSoundPlaying]] » This function checks if a sound element is playing or not.
*[[stopSoundSlowly]] » This function stop your sound element slowly.

=== Browser functions ===
*[[playVideo]] » This function plays a video on the screen.

=== Team functions ===
*[[getTeamFromColor]] » This function returns a team element by the specified color.
*[[getTeamWithFewestPlayers]] » This function returns a team element with least players of all the specified teams.

=== Vehicle functions ===
*[[findEmptyCarSeat]] » This function finds you the first empty seat in a vehicle.
*[[getNearestVehicle]] » This function gets the nearest vehicle to the specified player in a specified distance.
*[[getRandomVehicle]] » This function gets a random vehicle.
*[[getValidVehicleModels]] » This function returns a table of all valid vehicle models.
*[[getVehiclesCountByType]] » This function returns the amount of vehicles by the given type as an integer value.
*[[getVehicleTurnVelocityCenterOfMass]]» This function gets a vehicle's turn velocity relative to the vehicle's center or mass.
*[[isVehicleDoubleExhaust]] » This function checks is exhaust vehicle double.
*[[isVehicleEmpty]] » This function checks whether a vehicle is empty.
*[[isVehicleOccupied]] » This function checks if a specified vehicle is occupied.
*[[isVehicleOnRoof]] » This function checks whether vehicle is on roof.
*[[isVehicleOnFire]] » This function checks if the vehicle is on fire or not.
*[[isVehicleReversing]] » This function checks if a specified vehicle is moving backwards.
*[[isVehicleUpgraded]] » This function checks is vehicle upgraded by upgrade ID.
*[[setVehicleGravityPoint]] » This function sets a vehicle's gravity in the direction of a 3 dimensional coordinate with the strength specified.
*[[setVehicleTurnVelocityCenterOfMass]] » This function sets a vehicle's turn velocity relative to the vehicle's center or mass.
*[[setVehicleHandlingFromText]] » This function sets a vehicle's handling from text.
*[[setVehicleWheelModel]] » This function changes the wheel model of the informed vehicle.

=== Weapon functions ===
*[[getJetpackWeaponsEnabled]] » This function returns a table of enabled weapons usable on a jetpack.

=== Object functions ===
*[[getDynamicDoorObjectOpenRatio]] » This function tells you how open a dynamic door is in a range from 0 to 1.
*[[isElementObject]] » This function tells you if an element is an object or no.

=== XML functions ===
*[[getXMLNodes]] » This function returns all children of a XML node.

=== Engine functions ===
*[[engineGetCOLsFromLibrary]] » This function gets the collision data from the col library.
*[[engineLoadIMGContainer]] » This function loads the IMG container.

=== Utility ===
*[[animate]] » This function allows you to use interpolateBetween without render event and easily used.
*[[callClientFunction]] » This function allows you to call any client-side function from the server's side.
*[[callServerFunction]] » This function allows you to call any server-side function from the client's side.
*[[check]] » This function checks if its arguments are of the right type and calls the error-function if one is not.
*[[checkPassiveTimer]] » This function allows you to use passive timers in your conditions. For example you want to prevent players repeatedly using a command.
*[[coroutine.resume]] » This function applies a fix for hidden coroutine error messages.
*[[compact]] » This function create table containing variables and their values.
*[[getBanFromName]] » This functions returns the ban of the given playername.
*[[getCurrentFPS]] » This function returns the frames per second at which GTA: SA is running.
*[[getSkinNameFromID]] » This function returns the name of the skin from the given id.
*[[IfElse]] » This function returns one of two values based on a boolean expression.
*[[isCharInString]] » This shared function allows you to check if a char specified is in a string value.
*[[isMouseInCircle]] » This function checks if a cursor position is in circular area or not.
*[[isMouseInPosition]] » This function allows you to check whether the mouse cursor/pointer is within a rectangular position.
*[[iterElements]] » This function returns ''a time-saving'' iterator for your for-loops.
*[[PlotTrajectoryAtTime]] » Calculate projectile/water trajectory.
*[[preprocessor]] » This function allow you to use gcc macros.
*[[vector3:compare]] » This method checks whether two vectors match, with optional precision.
*[[svgCreateRoundedRectangle]] » This function creates a rectangle with rounded edges.

<noinclude>[[Category:Useful Functions]]</noinclude>

SetCursorCenteredOnRectangle

2023-09-21T08:11:21Z

Hydra: Created page with "{{Useful Function}} __NOTOC__ This function will center the cursor inside of an rectangle. ==Syntax== <syntaxhighlight lang="lua">bool setCursorCenteredOnRectangle ( float x, float y, float width, float height)</syntaxhighlight> ===Required Arguments=== * '''x:''' The x position of the rectangle. * '''y:''' The y position of the rectangle. * '''width:''' The width of the rectangle. * '''height:''' The width of the rectangle. ===Returns=== Returns a ''true'' if the op..."

{{Useful Function}}
__NOTOC__
This function will center the cursor inside of an rectangle.

==Syntax==
<syntaxhighlight lang="lua">bool setCursorCenteredOnRectangle ( float x, float y, float width, float height)</syntaxhighlight>

===Required Arguments===
* '''x:''' The x position of the rectangle.
* '''y:''' The y position of the rectangle.
* '''width:''' The width of the rectangle.
* '''height:''' The width of the rectangle.

===Returns===
Returns a ''true'' if the operation was successful, ''false'' otherwise.

==Code==
<section name="Clientside script" class="client" show="true">
<syntaxhighlight lang="lua">
function setCursorCenteredOnRectangle(x, y, width, height)
if x and y and width and height then
setCursorPosition(x + width/2, y + height/2)
end
end
</syntaxhighlight>
</section>

==Example==

<syntaxhighlight lang="lua">
local resx, resy = guiGetScreenSize()
local sx, sy = resx/1920, resy/1080

setCursorCenteredOnRectangle(sx * 200, sy * 500, sx * 200, sy * 33)

addEventHandler("onClientRender", root, function()
dxDrawRectangle(sx * 200, sy * 500, sx * 200, sy * 33, tocolor(255, 0, 0, 255), false)
end)
</syntaxhighlight>

Author: Hydra

==See Also==
{{Useful_Functions}}

Template:Useful Functions

2023-09-21T08:04:51Z

Hydra: /* Cursor functions */

__NOTOC__
=== Table functions ===
*[[addTableChangeHandler]] » This function monitors the changes of a table.
*[[getTableFromSql]] » This functionality is used to obtain saved tables using the function ([https://wiki.multitheftauto.com/wiki/SetTableToSql SetTableToSql ]).
*[[isValueInTable]] » This function returns true if the value exists in the table, false if the value does not exist in the table.
*[[pairsByKeys]] » This function sort pairs table.
*[[rangeToTable]] » This function converts a string range to a table containing number values.
*[[setTableProtected]] » This function protects a table and makes it read-only.
*[[setTableToSql]] » This function is used to save the table in the database (sql).
*[[Sort_Functions]] » These functions are able to sort your tables by a key.
*[[table.compare]] » This function checks whether two given tables are equal.
*[[table.copy]] » This function copies a whole table and all the tables in that table.
*[[table.deepmerge]] » This function deep merges two tables. Every nested table will be correspondingly merged.
*[[table.element]] » This function returns a new table with only userdata content.
*[[table.empty]] » This function checks whether a table is empty.
*[[table.fromString]] » This function converts string to a table.
*[[table.getRandomRows]] » This function returns random rows from table.
*[[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]] » This function merges two or more tables together.
*[[table.random]] » This function retrieves a random value from a table.
*[[table.removeValue]] » This function removes a specified value from a table.
*[[table.size]] » This function returns the absolute size of a table.
*[[table.toString]] » This function converts table to a string.

=== ACL functions ===
*[[aclGroupClone]] » This function clone a group to another group with/without ACLs and/or objects.
*[[getAccountsRanks]] » This function is used to detect the account name groups and put them in the chat.
*[[getPlayerAcls]] » This function returns a table of all ACL groups on a player.
*[[getPlayersInACLGroup]] » This function returns all players in an ACL group.
*[[isPlayerInACL]] » This function checks if a player element is in an ACL group.
*[[renameAclGroup]] » This function gives an existing ACL group a new name.
*[[isPlayerACLAdmin]] » This function checks if a player element belong to Admin group in ACL

=== Account functions ===
*[[getPlayerFromAccountName]] » This function is used to obtain a player by the name of his account.

=== Camera functions ===
*[[smoothMoveCamera]] » This function allows you to create a cinematic camera flight.

=== Colshape functions ===
*[[createGarageColShape]] » This function creates a collision shape from the specified garage.

=== Cursor functions ===
*[[getCursorMovedOn]] » This function checks in which way the cursor is currently moving.
*[[SetCursorCenteredOnRectangle]] » This functions will center the cursor inside a rectangle.

=== Drawing functions ===
*[[dxDrawAnimWindow]] » This function draws an animated 2D window on the screen.
*[[dxDrawBorderedRectangle]] » This is a function that will create a bordered rectangle.
*[[dxDrawBorderedText]] » This is a function that will create a bordered text.
*[[dxDrawDashedLine]] » This function draws a line with dashes.
*[[dxDrawGifImage]] » This function simulates the effect of a GIF image by using image sprites in 2D.
*[[dxDrawImage3D]] » This function draws a 3D image in GTA world.
*[[dxDrawImageOnElement]] » This function draws an image on any element.
*[[dxDrawLinedRectangle]] » This is a function that will create a rectangle outline with dx lines.
*[[dxDrawLoading]] » This function draws a loading bar on the screen.
*[[dxDrawOctagon3D]] » This function creates a 3D Octagon
*[[dxDrawPolygon]] » This function draws a custom polygon on the screen.
*[[dxDrawProgressBar]] » This function simulates a progress bar drawed using DirectDraw.
*[[dxDrawRectangle3D]] » This function draws a 3D rectangle in GTA world.
*[[dxDrawRectangleOnPlayer]] » This function draws a 3D rectangle above the player.
*[[dxDrawRing]] » This function draws a ring with dx lines.
*[[dxDrawRombo]] » This function creates a Rhombus.
*[[dxDrawSprite]] » This function draw a sprite in the 3D world.
*[[dxDrawTextOnElement]] » This function draws a text on any element.
*[[dxDrawTextOnRectangle]] » Esta funcion crea un rectangle con un texto dentro.
*[[dxDrawTriangle]] » This is a function that will create a triangle with dx lines.
*[[dxGetFontSizeFromHeight]] » This function calculates the font size from given height.
*[[dxGetRealFontHeight]] » This function calculates the height of a font.
*[[getScreenStartPositionFromBox]] » This function helps with getting the correct position for your dx-effects.
*[[wordWrap]] » This function breaks a long string into a table of separate lines limited to a specific length in pixels, for drawing separately.
*[[CreateRectangle3D]] » This is a function that will create a 3d rectangle on the player screen.
*[[DxDrawBordered3DLine]] »This function creates a bordered area with 3D dx lines.

=== Effects functions ===
*[[attachEffect]] » This function allows you attach an effect to an element.
*[[setScreenFlash]] » This function will make the screen flash(like a screenshot).

=== Element functions ===
*[[autoAttach]] » This function attaches one element into another at the same position and rotation they are.
*[[isElementPlayer]] » This function checks whether the element is a player or not.
*[[attachElementToBone]] » This function allows you to attach an element to ped bone accurately using new bone functions.
*[[getElementsInDimension]] » This function returns a table of elements that are in the specified dimension.
*[[getElementSpeed]] » This function returns the specified element's speed in m/s, km/h or mph.
*[[getElementsWithinMarker]] » This function returns a table of elements that are within a marker's collision shape.
*[[getElementUsingData]] » This function returns table elements that contains the elements data with the given key and value.
*[[getNearestElement]] » This function returns the nearest element (of a specific type) to a player.
*[[isElementInPhotograph]] » This function checks if an element is in the player's camera picture area.
*[[isElementInRange]] » This function allows you to check if an element's range to a main point is within the maximum range.
*[[isElementMoving]]» This function checks if an element is moving.
*[[isElementWithinAColShape]]» This function checks if an element is within a collision shape element.
*[[isElementInAir]]» This function checks if an element is in air or not.
*[[multi_check]] » This function checks one element to many, handy and clean.
*[[setElementSpeed]] » This function allows you to set the speed of an element in kph or mph units.
*[[getElementDirectionCardialPoint]] » This function returns the direction of the element according to the ''wind rose''.

=== Events ===
*[[onVehicleWeaponFire]] » This code implements an event that is triggered when a player in a vehicle fires a vehicle's weapon.

=== Input functions ===
*[[bindControlKeys]] » This function allows you to bind each key bound to a control individually. Doing this bypasses a little MTA restriction.
*[[getBoundControls]] » This function returns a table of control names that are bound to the specified key.
*[[unbindControlKeys]] » This function allows you to unbind each key bound to a control individually. Use this function with [[bindControlKeys]].
*[[isCommandHandlerAdded]] » This function allows you to check if a command is added or not in the respective resource.

=== Data functions ===
*[[byte2human]] » This function converts an integer (number of bytes) into a human-readable unit.
*[[capitalize]] » This function capitalizes a given string.
*[[convertDate]] » This function converts date to another look.
*[[convertServerTickToTimeStamp]] » This function converts server ticks to a unix timestamp.
*[[convertTextToSpeech]] » This function converts the provided text to a speech in the provided language which players can hear.
*[[findRotation3D]] » This function takes two sets of XYZ coordinates. It returns the 3D direction from point A to point B.
*[[findRotation]] » This function takes two points and returns the direction from point A to point B.
*[[formatDate]] » This function formats a date on the basis of a format string and returns it.
*[[formatNumber]] » This function formats large numbers by adding commas.
*[[generateRandomASCIIString]] » This function returns a random string which uses ASCII characters. 
*[[generateString]] » This function generates a random string with any characters.
*[[getAge]] » This function calculates the age of a given birthday.
*[[getDistanceBetweenElements]] » Returns the distance between two elements.
*[[getDistanceBetweenPointAndSegment2D]] » This function takes point coordinates and line (a segment) starting and ending coordinates. It returns the shortest distance between the point and the line.
*[[getEasterDate]] » This function returns easter date monthday and month for a given year.
*[[getElementRelatedAngle]] » This function returns the related angle between one element to another. This is useful to check which side an element is to another.
*[[getFreeDimension]] » This function get free dimension.
*[[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.
*[[getPointFromDistanceRotation]] » This function finds a point based on a starting point, direction and distance.
*[[getRealMonth]] » This function returns the current month name
*[[getRGColorFromPercentage]] »This function returns two integers representing red and green colors according to the specified percentage.
*[[getScreenRotationFromWorldPosition]] » This function returns a screen relative rotation to a world position.
*[[getTimestamp]] » This function returns the UNIX timestamp of a specified date and time.
*[[gradientString]] » This function transforms a string in a new coloured gradient string.
*[[hex2rgb]] » This function convert hex to rgb.
*[[hexColorToRGB]] » This function convert hex string/number to RGBA values.
*[[isLeapYear]] » This function returns a boolean representing if a given year is a leap year.
*[[isValidMail]] » This function checks whether a provided e-mail string is valid.
*[[removeHex]] » This function is used to remove hexadecimal numbers (colors, for example) from strings.
*[[RGBToHex]] » This function returns a string representing the color in hexadecimal.
*[[RGBToHSV]] » This function convert RGB to HSV color space.
*[[RGBToDecimal]] » This function convert RGB to Decimal color.
*[[secondsToTimeDesc]] » This function converts a plain seconds-integer into a user-friendly time description.
*[[string.count]] » This function counts the amount of occurences of a string in a string.
*[[string.explode]] » This function splits a string at a given separator pattern and returns a table with the pieces.
*[[string.insert]] » This function inserts a string within another string at a given position.
*[[switch]] » This function allows the value of a variable or expression to control the flow of program execution via a multiway branch.
*[[tocolor2rgba]] » This function convert tocolor to rgba.
*[[toHex]] » This function converts a decimal number to a hexadecimal number, as a fix to be used client-side.
*[[var dump]] » This function outputs information about one or more variables using outputConsole.
*[[wavelengthToRGBA]] » This function converts a physical wavelength of light to a RGBA color.

=== GUI functions ===
*[[centerWindow]] » This function centers a CEGUI window element responsively in any resolution.
*[[guiMoveElement]] » This function moves guiElement by/like using moveObject.
*[[guiSetStaticImageMovable]] » This function allows you to move a static image like a gui window.
*[[isMouseOnGUICloseButton]] » This function allows you to check whether the mouse cursor/pointer is within a gui-window's native close button.
*[[isMouseOnGuiElement]] » This function allows you to check whether or not your mouse is over a specific gui element, this is especially useful if the gui element has a parent. 
=====Comboboxes=====
*[[guiComboBoxAdjustHeight]] » This function adjusts a CEGUI combobox element to have the correct height.

=====Gridlists=====
*[[convertGridListToText]] » This function converts grid list contents to text.
*[[getGridListRowIndexFromText]] » This function returns the GridList row index from the specified text.
*[[guiGridListAddPlayers]] » This function add all online players to a grid list.
*[[guiGridListGetColumnIDFromTitle]] » This function gets a gridlist's column ID from the column title.
*[[guiGridListGetSelectedText]] » This function returns a string containing the inner text of a selected gridlist item.
*[[guiGridListSetColumnNonSortable]] » This function makes a gridlist column become non-sortable.
*[[isTextInGridList]] » This function checks if some text exist or not in the GridList.

=====Labels=====
*[[guiLabelAddEffect]] » This function add an effects to the gui-label like (shadow, outline).

=== Marker functions ===
*[[createMarkerAttachedTo]] » This function creates a marker that is attached to an element.

=== Math functions ===
*[[math.clamp]] » This function returns the number between range of numbers or it's minimum or maximum.
*[[math.getBezierPoint]] » Get N-th order bezier point.
*[[math.hypot]] » This function returns the Hypotenuse of the triangle given by sides x and y.
*[[math.isPointInPolygon]] » Check if point is inside polygon or not.
*[[math.lerp]] » Get val between two integer.
*[[math.percent]] » This function returns a percentage from two number values.
*[[math.polygonArea]] » Compute area of any polygon.
*[[math.randomDiff]] » Generates a pseudo-random integer that's always different from the last random number generated.
*[[math.rotVecToEulerAngle]] » Rotation Vector To Euler Angle
*[[math.round]] » Rounds a number whereas the number of decimals to keep and the method may be set.
*[[mathNumber]] » This function is a workaround for the client-side floating-point precision of 24-bits.
*[[reMap]] » Re-maps a number from one range to another.
*[[Math.percentProgress|math.percentProgress]] » Returns a percentage progress from two specific values.
*[[math.average]] » This function returns the simple arithmetic mean of multiple numbers.

=== Map functions ===
*[[assignLod]] » This function lets you conveniently generate and apply a LOD model to a mapping object.
*[[getWorldPositionFromMapPosition]] » This function converts an F11 map position to world position.

=== Ped functions ===
*[[getAlivePlayers (Client)|getAlivePlayers]] » This function returns a table of the alive players client-side.
*[[getAlivePlayersInTeam]] » This function returns a table of the alive players in a team.
*[[getGuestPlayers]] » This function gets a players not login or players Guest .
*[[getOnlineAdmins]] » This function returns a table of all logged-in administrators.
*[[getPedEyesPosition]] » This function allows you to get peds eyes position.
*[[getPedGender]] » This function allows you to get peds their gender.
*[[getPedMaxHealth]] » This function returns a pedestrians's maximum health by converting it from their maximum health stat.
*[[getPedMaxOxygenLevel]] » This function returns a ped's maximum oxygen level by converting it from their maximum underwater stamina stat.
*[[getPedWeaponSkill]] » This function returns a ped's corresponding weapon skill level name.
*[[getPedHitBone]] » This function gets the approximate number of the bone where the ped is hit.
*[[getPlayerFromNamePart]] » This function returns a player from partial name.
*[[getPlayerFromSerial]] » This function returns a player from their serial.
*[[getPlayersByData]] » This function returns a table of players that have the specified data name.
*[[getPlayersInPhotograph]] » This function returns a table of all players in photograph.
*[[getPlayersInVehicles]] » This function returns a table of the players insides vehicles from a specified dimension.
*[[isPedAiming]]» This function checks if a pedestrian is aiming their weapon.
*[[isPedAimingNearPed]] » This is similar to isPedAiming but uses a colshape to be more precise.
*[[isPedDiving]] » This feature checks that pedestrian is diving in the water.
*[[isPedDrivingVehicle]] » This function checks if a specified pedestrian is driving a vehicle.
*[[isPlayerInTeam]] » This function checks if a player is in a specified team.
*[[setPedAttack]] » This function will make a ped attack a specified target.
*[[setPedFollow]] » This function will make a ped follow a specified target.
*[[getPlayerNameFromID]] » This function will get the player name from the ID element data.

=== Player functions ===
*[[countPlayersInRange]] » This function returns the number of players that are within a certain range of the specified coordinates.
*[[getPlayerPreviousAndNextWeapon]] » This function returns the player previous and next weapon.
*[[getPlayersInRange]]» This function make a table of players within certain range.
*[[isPlayerActuallyInVehicle]]» This function checks if a player is actually in a vehicle instead of just in the process of entering.
*[[isPlayerHitByVehicle]]» This function cancels event when a element is hit by a vehicle.
*[[warpToPlayer]]» This function make player warp to another player.

=== Resource functions ===
*[[getFilesInResourceFolder]] » This function gets a list of files that are inside a folder of a resource.
*[[getResourceScripts]] » This function returns a table of the resource scripts.
*[[getResourceSettings]] » This function returns a table of the resource settings.
*[[getResourceSize]] » This function returns the size of a specified resource in kB(kilobyte)
*[[refreshResource]] » This function refreshes your resource if you changed any of the files
*[[setResourcePriority]] » This function set resource download priority group.

=== Sound functions ===
*[[isSoundFinished]] » This function checks if a sound element has finished.
*[[isSoundPlaying]] » This function checks if a sound element is playing or not.
*[[stopSoundSlowly]] » This function stop your sound element slowly.

=== Browser functions ===
*[[playVideo]] » This function plays a video on the screen.

=== Team functions ===
*[[getTeamFromColor]] » This function returns a team element by the specified color.
*[[getTeamWithFewestPlayers]] » This function returns a team element with least players of all the specified teams.

=== Vehicle functions ===
*[[findEmptyCarSeat]] » This function finds you the first empty seat in a vehicle.
*[[getNearestVehicle]] » This function gets the nearest vehicle to the specified player in a specified distance.
*[[getRandomVehicle]] » This function gets a random vehicle.
*[[getValidVehicleModels]] » This function returns a table of all valid vehicle models.
*[[getVehiclesCountByType]] » This function returns the amount of vehicles by the given type as an integer value.
*[[getVehicleTurnVelocityCenterOfMass]]» This function gets a vehicle's turn velocity relative to the vehicle's center or mass.
*[[isVehicleDoubleExhaust]] » This function checks is exhaust vehicle double.
*[[isVehicleEmpty]] » This function checks whether a vehicle is empty.
*[[isVehicleOccupied]] » This function checks if a specified vehicle is occupied.
*[[isVehicleOnRoof]] » This function checks whether vehicle is on roof.
*[[isVehicleOnFire]] » This function checks if the vehicle is on fire or not.
*[[isVehicleReversing]] » This function checks if a specified vehicle is moving backwards.
*[[isVehicleUpgraded]] » This function checks is vehicle upgraded by upgrade ID.
*[[setVehicleGravityPoint]] » This function sets a vehicle's gravity in the direction of a 3 dimensional coordinate with the strength specified.
*[[setVehicleTurnVelocityCenterOfMass]] » This function sets a vehicle's turn velocity relative to the vehicle's center or mass.
*[[setVehicleHandlingFromText]] » This function sets a vehicle's handling from text.
*[[setVehicleWheelModel]] » This function changes the wheel model of the informed vehicle.

=== Weapon functions ===
*[[getJetpackWeaponsEnabled]] » This function returns a table of enabled weapons usable on a jetpack.

=== Object functions ===
*[[getDynamicDoorObjectOpenRatio]] » This function tells you how open a dynamic door is in a range from 0 to 1.
*[[isElementObject]] » This function tells you if an element is an object or no.

=== XML functions ===
*[[getXMLNodes]] » This function returns all children of a XML node.

=== Engine functions ===
*[[engineGetCOLsFromLibrary]] » This function gets the collision data from the col library.
*[[engineLoadIMGContainer]] » This function loads the IMG container.

=== Utility ===
*[[animate]] » This function allows you to use interpolateBetween without render event and easily used.
*[[callClientFunction]] » This function allows you to call any client-side function from the server's side.
*[[callServerFunction]] » This function allows you to call any server-side function from the client's side.
*[[check]] » This function checks if its arguments are of the right type and calls the error-function if one is not.
*[[checkPassiveTimer]] » This function allows you to use passive timers in your conditions. For example you want to prevent players repeatedly using a command.
*[[coroutine.resume]] » This function applies a fix for hidden coroutine error messages.
*[[compact]] » This function create table containing variables and their values.
*[[getBanFromName]] » This functions returns the ban of the given playername.
*[[getCurrentFPS]] » This function returns the frames per second at which GTA: SA is running.
*[[getSkinNameFromID]] » This function returns the name of the skin from the given id.
*[[IfElse]] » This function returns one of two values based on a boolean expression.
*[[isCharInString]] » This shared function allows you to check if a char specified is in a string value.
*[[isMouseInCircle]] » This function checks if a cursor position is in circular area or not.
*[[isMouseInPosition]] » This function allows you to check whether the mouse cursor/pointer is within a rectangular position.
*[[iterElements]] » This function returns ''a time-saving'' iterator for your for-loops.
*[[PlotTrajectoryAtTime]] » Calculate projectile/water trajectory.
*[[preprocessor]] » This function allow you to use gcc macros.
*[[vector3:compare]] » This method checks whether two vectors match, with optional precision.
*[[svgCreateRoundedRectangle]] » This function creates a rectangle with rounded edges.

<noinclude>[[Category:Useful Functions]]</noinclude>

SetScreenFlash

2023-04-17T09:04:25Z

Hydra: Created page with "{{Useful Function}} <lowercasetitle/> __NOTOC__ This function allows you to attach an effect to an element. ==Syntax== <syntaxhighlight lang="lua">bool setScreenFlash()</syntaxhighlight> ==Code== <syntaxhighlight lang="lua"> function setScreenFlash() fadeCamera(false, 0.2, 255, 255, 255) setTimer(function() fadeCamera(true) end, 100, 1) end) </syntaxhighlight> ==Example== <section name="Client" class="client" show="true"> Quick Example, your scree..."

{{Useful Function}}
<lowercasetitle/>
__NOTOC__
This function allows you to attach an effect to an element.
==Syntax==
<syntaxhighlight lang="lua">bool setScreenFlash()</syntaxhighlight>

==Code==
<syntaxhighlight lang="lua">
function setScreenFlash()
fadeCamera(false, 0.2, 255, 255, 255)
setTimer(function()
fadeCamera(true)
end, 100, 1)
end)

</syntaxhighlight>

==Example==
<section name="Client" class="client" show="true">
Quick Example, your screen will flash when you will hit a marker.
<syntaxhighlight lang="lua">
addEventHandler("onClientMarkerHit", root, function()
setScreenFlash()
end)
</syntaxhighlight>
</section>

==See Also==
{{Useful_Functions}}

Template:Useful Functions

2023-04-17T09:01:08Z

Hydra: /* Effects functions */

__NOTOC__
=== Table functions ===
*[[addTableChangeHandler]] » This function monitors the changes of a table.
*[[getTableFromSql]] » This functionality is used to obtain saved tables using the function ([https://wiki.multitheftauto.com/wiki/SetTableToSql SetTableToSql ]).
*[[isValueInTable]] » This function returns true if the value exists in the table, false if the value does not exist in the table.
*[[pairsByKeys]] » This function sort pairs table.
*[[rangeToTable]] » This function converts a string range to a table containing number values.
*[[setTableProtected]] » This function protects a table and makes it read-only.
*[[setTableToSql]] » This function is used to save the table in the database (sql).
*[[Sort_Functions]] » These functions are able to sort your tables by a key.
*[[table.compare]] » This function checks whether two given tables are equal.
*[[table.copy]] » This function copies a whole table and all the tables in that table.
*[[table.deepmerge]] » This function deep merges two tables. Every nested table will be correspondingly merged.
*[[table.element]] » This function returns a new table with only userdata content.
*[[table.empty]] » This function checks whether a table is empty.
*[[table.fromString]] » This function converts string to a table.
*[[table.getRandomRows]] » This function returns random rows from table.
*[[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]] » This function merges two or more tables together.
*[[table.random]] » This function retrieves a random value from a table.
*[[table.removeValue]] » This function removes a specified value from a table.
*[[table.size]] » This function returns the absolute size of a table.
*[[table.toString]] » This function converts table to a string.

=== ACL functions ===
*[[aclGroupClone]] » This function clone a group to another group with/without ACLs and/or objects.
*[[getAccountsRanks]] » This function is used to detect the account name groups and put them in the chat.
*[[getPlayerAcls]] » This function returns a table of all ACL groups on a player.
*[[getPlayersInACLGroup]] » This function returns all players in an ACL group.
*[[isPlayerInACL]] » This function checks if a player element is in an ACL group.
*[[renameAclGroup]] » This function gives an existing ACL group a new name.

=== Account functions ===
*[[getPlayerFromAccountName]] » This function is used to obtain a player by the name of his account.

=== Camera functions ===
*[[smoothMoveCamera]] » This function allows you to create a cinematic camera flight.

=== Colshape functions ===
*[[createGarageColShape]] » This function creates a collision shape from the specified garage.

=== Cursor functions ===
*[[getCursorMovedOn]] » This function checks in which way the cursor is currently moving.

=== Drawing functions ===
*[[dxDrawAnimWindow]] » This function draws an animated 2D window on the screen.
*[[dxDrawBorderedRectangle]] » This is a function that will create a bordered rectangle.
*[[dxDrawBorderedText]] » This is a function that will create a bordered text.
*[[dxDrawDashedLine]] » This function draws a line with dashes.
*[[dxDrawGifImage]] » This function simulates the effect of a GIF image by using image sprites in 2D.
*[[dxDrawImage3D]] » This function draws a 3D image in GTA world.
*[[dxDrawImageOnElement]] » This function draws an image on any element.
*[[dxDrawLinedRectangle]] » This is a function that will create a rectangle outline with dx lines.
*[[dxDrawLoading]] » This function draws a loading bar on the screen.
*[[dxDrawOctagon3D]] » This function creates a 3D Octagon
*[[dxDrawPolygon]] » This function draws a custom polygon on the screen.
*[[dxDrawProgressBar]] » This function simulates a progress bar drawed using DirectDraw.
*[[dxDrawRectangle3D]] » This function draws a 3D rectangle in GTA world.
*[[dxDrawRectangleOnPlayer]] » This function draws a 3D rectangle above the player.
*[[dxDrawRing]] » This function draws a ring with dx lines.
*[[dxDrawRombo]] » This function creates a Rhombus.
*[[dxDrawSprite]] » This function draw a sprite in the 3D world.
*[[dxDrawTextOnElement]] » This function draws a text on any element.
*[[dxDrawTextOnRectangle]] » Esta funcion crea un rectangle con un texto dentro.
*[[dxDrawTriangle]] » This is a function that will create a triangle with dx lines.
*[[dxGetFontSizeFromHeight]] » This function calculates the font size from given height.
*[[dxGetRealFontHeight]] » This function calculates the height of a font.
*[[getScreenStartPositionFromBox]] » This function helps with getting the correct position for your dx-effects.
*[[wordWrap]] » This function breaks a long string into a table of separate lines limited to a specific length in pixels, for drawing separately.
*[[CreateRectangle3D]] » This is a function that will create a 3d rectangle on the player screen.
*[[DxDrawBordered3DLine]] »This function creates a bordered area with 3D dx lines.

=== Effects functions ===
*[[attachEffect]] » This function allows you attach an effect to an element.
*[[setScreenFlash]] » This function will make the screen flash(like a screenshot).

=== Element functions ===
*[[autoAttach]] » This function attaches one element into another at the same position and rotation they are.
*[[isElementPlayer]] » This function checks whether the element is a player or not.
*[[attachElementToBone]] » This function allows you to attach an element to ped bone accurately using new bone functions.
*[[getElementsInDimension]] » This function returns a table of elements that are in the specified dimension.
*[[getElementSpeed]] » This function returns the specified element's speed in m/s, km/h or mph.
*[[getElementsWithinMarker]] » This function returns a table of elements that are within a marker's collision shape.
*[[getElementUsingData]] » This function returns table elements that contains the elements data with the given key and value.
*[[getNearestElement]] » This function returns the nearest element (of a specific type) to a player.
*[[isElementInPhotograph]] » This function checks if an element is in the player's camera picture area.
*[[isElementInRange]] » This function allows you to check if an element's range to a main point is within the maximum range.
*[[isElementMoving]]» This function checks if an element is moving.
*[[isElementWithinAColShape]]» This function checks if an element is within a collision shape element.
*[[isElementInAir]]» This function checks if an element is in air or not.
*[[multi_check]] » This function checks one element to many, handy and clean.
*[[setElementSpeed]] » This function allows you to set the speed of an element in kph or mph units.
*[[getElementDirectionCardialPoint]] » This function returns the direction of the element according to the ''wind rose''.

=== Events ===
*[[onVehicleWeaponFire]] » This code implements an event that is triggered when a player in a vehicle fires a vehicle's weapon.

=== Input functions ===
*[[bindControlKeys]] » This function allows you to bind each key bound to a control individually. Doing this bypasses a little MTA restriction.
*[[getBoundControls]] » This function returns a table of control names that are bound to the specified key.
*[[unbindControlKeys]] » This function allows you to unbind each key bound to a control individually. Use this function with [[bindControlKeys]].
*[[isCommandHandlerAdded]] » This function allows you to check if a command is added or not in the respective resource.

=== Data functions ===
*[[byte2human]] » This function converts an integer (number of bytes) into a human-readable unit.
*[[capitalize]] » This function capitalizes a given string.
*[[convertDate]] » This function converts date to another look.
*[[convertServerTickToTimeStamp]] » This function converts server ticks to a unix timestamp.
*[[convertTextToSpeech]] » This function converts the provided text to a speech in the provided language which players can hear.
*[[findRotation3D]] » This function takes two sets of XYZ coordinates. It returns the 3D direction from point A to point B.
*[[findRotation]] » This function takes two points and returns the direction from point A to point B.
*[[formatDate]] » This function formats a date on the basis of a format string and returns it.
*[[formatNumber]] » This function formats large numbers by adding commas.
*[[generateRandomASCIIString]] » This function returns a random string which uses ASCII characters. 
*[[generateString]] » This function generates a random string with any characters.
*[[getAge]] » This function calculates the age of a given birthday.
*[[getDistanceBetweenElements]] » Returns the distance between two elements.
*[[getDistanceBetweenPointAndSegment2D]] » This function takes point coordinates and line (a segment) starting and ending coordinates. It returns the shortest distance between the point and the line.
*[[getEasterDate]] » This function returns easter date monthday and month for a given year.
*[[getElementRelatedAngle]] » This function returns the related angle between one element to another. This is useful to check which side an element is to another.
*[[getFreeDimension]] » This function get free dimension.
*[[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.
*[[getPointFromDistanceRotation]] » This function finds a point based on a starting point, direction and distance.
*[[getRealMonth]] » This function returns the current month name
*[[getRGColorFromPercentage]] »This function returns two integers representing red and green colors according to the specified percentage.
*[[getScreenRotationFromWorldPosition]] » This function returns a screen relative rotation to a world position.
*[[getTimestamp]] » This function returns the UNIX timestamp of a specified date and time.
*[[gradientString]] » This function transforms a string in a new coloured gradient string.
*[[hex2rgb]] » This function convert hex to rgb.
*[[hexColorToRGB]] » This function convert hex string/number to RGBA values.
*[[isLeapYear]] » This function returns a boolean representing if a given year is a leap year.
*[[isValidMail]] » This function checks whether a provided e-mail string is valid.
*[[removeHex]] » This function is used to remove hexadecimal numbers (colors, for example) from strings.
*[[RGBToHex]] » This function returns a string representing the color in hexadecimal.
*[[RGBToHSV]] » This function convert RGB to HSV color space.
*[[RGBToDecimal]] » This function convert RGB to Decimal color.
*[[secondsToTimeDesc]] » This function converts a plain seconds-integer into a user-friendly time description.
*[[string.count]] » This function counts the amount of occurences of a string in a string.
*[[string.explode]] » This function splits a string at a given separator pattern and returns a table with the pieces.
*[[string.insert]] » This function inserts a string within another string at a given position.
*[[switch]] » This function allows the value of a variable or expression to control the flow of program execution via a multiway branch.
*[[tocolor2rgba]] » This function convert tocolor to rgba.
*[[toHex]] » This function converts a decimal number to a hexadecimal number, as a fix to be used client-side.
*[[var dump]] » This function outputs information about one or more variables using outputConsole.
*[[wavelengthToRGBA]] » This function converts a physical wavelength of light to a RGBA color.

=== GUI functions ===
*[[centerWindow]] » This function centers a CEGUI window element responsively in any resolution.
*[[guiMoveElement]] » This function moves guiElement by/like using moveObject.
*[[guiSetStaticImageMovable]] » This function allows you to move a static image like a gui window.
*[[isMouseOnGUICloseButton]] » This function allows you to check whether the mouse cursor/pointer is within a gui-window's native close button.
*[[isMouseOnGuiElement]] » This function allows you to check whether or not your mouse is over a specific gui element, this is especially useful if the gui element has a parent. 
=====Comboboxes=====
*[[guiComboBoxAdjustHeight]] » This function adjusts a CEGUI combobox element to have the correct height.

=====Gridlists=====
*[[convertGridListToText]] » This function converts grid list contents to text.
*[[getGridListRowIndexFromText]] » This function returns the GridList row index from the specified text.
*[[guiGridListAddPlayers]] » This function add all online players to a grid list.
*[[guiGridListGetColumnIDFromTitle]] » This function gets a gridlist's column ID from the column title.
*[[guiGridListGetSelectedText]] » This function returns a string containing the inner text of a selected gridlist item.
*[[guiGridListSetColumnNonSortable]] » This function makes a gridlist column become non-sortable.
*[[isTextInGridList]] » This function checks if some text exist or not in the GridList.

=====Labels=====
*[[guiLabelAddEffect]] » This function add an effects to the gui-label like (shadow, outline).

=== Marker functions ===
*[[createMarkerAttachedTo]] » This function creates a marker that is attached to an element.

=== Math functions ===
*[[math.clamp]] » This function returns the number between range of numbers or it's minimum or maximum.
*[[math.getBezierPoint]] » Get N-th order bezier point.
*[[math.hypot]] » This function returns the Hypotenuse of the triangle given by sides x and y.
*[[math.isPointInPolygon]] » Check if point is inside polygon or not.
*[[math.lerp]] » Get val between two integer.
*[[math.percent]] » This function returns a percentage from two number values.
*[[math.polygonArea]] » Compute area of any polygon.
*[[math.randomDiff]] » Generates a pseudo-random integer that's always different from the last random number generated.
*[[math.rotVecToEulerAngle]] » Rotation Vector To Euler Angle
*[[math.round]] » Rounds a number whereas the number of decimals to keep and the method may be set.
*[[mathNumber]] » This function is a workaround for the client-side floating-point precision of 24-bits.
*[[reMap]] » Re-maps a number from one range to another.
*[[Math.percentProgress|math.percentProgress]] » Returns a percentage progress from two specific values.
*[[math.average]] » This function returns the simple arithmetic mean of multiple numbers.

=== Map functions ===
*[[assignLod]] » This function lets you conveniently generate and apply a LOD model to a mapping object.
*[[getWorldPositionFromMapPosition]] » This function converts an F11 map position to world position.

=== Ped functions ===
*[[getAlivePlayers (Client)|getAlivePlayers]] » This function returns a table of the alive players client-side.
*[[getAlivePlayersInTeam]] » This function returns a table of the alive players in a team.
*[[getGuestPlayers]] » This function gets a players not login or players Guest .
*[[getOnlineAdmins]] » This function returns a table of all logged-in administrators.
*[[getPedEyesPosition]] » This function allows you to get peds eyes position.
*[[getPedGender]] » This function allows you to get peds their gender.
*[[getPedMaxHealth]] » This function returns a pedestrians's maximum health by converting it from their maximum health stat.
*[[getPedMaxOxygenLevel]] » This function returns a ped's maximum oxygen level by converting it from their maximum underwater stamina stat.
*[[getPedWeaponSkill]] » This function returns a ped's corresponding weapon skill level name.
*[[getPedHitBone]] » This function gets the approximate number of the bone where the ped is hit.
*[[getPlayerFromNamePart]] » This function returns a player from partial name.
*[[getPlayerFromSerial]] » This function returns a player from their serial.
*[[getPlayersByData]] » This function returns a table of players that have the specified data name.
*[[getPlayersInPhotograph]] » This function returns a table of all players in photograph.
*[[getPlayersInVehicles]] » This function returns a table of the players insides vehicles from a specified dimension.
*[[isPedAiming]]» This function checks if a pedestrian is aiming their weapon.
*[[isPedAimingNearPed]] » This is similar to isPedAiming but uses a colshape to be more precise.
*[[isPedDiving]] » This feature checks that pedestrian is diving in the water.
*[[isPedDrivingVehicle]] » This function checks if a specified pedestrian is driving a vehicle.
*[[isPlayerInTeam]] » This function checks if a player is in a specified team.
*[[setPedAttack]] » This function will make a ped attack a specified target.
*[[setPedFollow]] » This function will make a ped follow a specified target.
*[[getPlayerNameFromID]] » This function will get the player name from the ID element data.

=== Player functions ===
*[[countPlayersInRange]] » This function returns the number of players that are within a certain range of the specified coordinates.
*[[getPlayerPreviousAndNextWeapon]] » This function returns the player previous and next weapon.
*[[getPlayersInRange]]» This function make a table of players within certain range.
*[[isPlayerActuallyInVehicle]]» This function checks if a player is actually in a vehicle instead of just in the process of entering.
*[[isPlayerHitByVehicle]]» This function cancels event when a element is hit by a vehicle.
*[[warpToPlayer]]» This function make player warp to another player.

=== Resource functions ===
*[[getFilesInResourceFolder]] » This function gets a list of files that are inside a folder of a resource.
*[[getResourceScripts]] » This function returns a table of the resource scripts.
*[[getResourceSettings]] » This function returns a table of the resource settings.
*[[getResourceSize]] » This function returns the size of a specified resource in kB(kilobyte)
*[[refreshResource]] » This function refreshes your resource if you changed any of the files
*[[setResourcePriority]] » This function set resource download priority group.

=== Sound functions ===
*[[isSoundFinished]] » This function checks if a sound element has finished.
*[[isSoundPlaying]] » This function checks if a sound element is playing or not.
*[[stopSoundSlowly]] » This function stop your sound element slowly.

=== Browser functions ===
*[[playVideo]] » This function plays a video on the screen.

=== Team functions ===
*[[getTeamFromColor]] » This function returns a team element by the specified color.
*[[getTeamWithFewestPlayers]] » This function returns a team element with least players of all the specified teams.

=== Vehicle functions ===
*[[findEmptyCarSeat]] » This function finds you the first empty seat in a vehicle.
*[[getNearestVehicle]] » This function gets the nearest vehicle to the specified player in a specified distance.
*[[getRandomVehicle]] » This function gets a random vehicle.
*[[getValidVehicleModels]] » This function returns a table of all valid vehicle models.
*[[getVehiclesCountByType]] » This function returns the amount of vehicles by the given type as an integer value.
*[[getVehicleTurnVelocityCenterOfMass]]» This function gets a vehicle's turn velocity relative to the vehicle's center or mass.
*[[isVehicleDoubleExhaust]] » This function checks is exhaust vehicle double.
*[[isVehicleEmpty]] » This function checks whether a vehicle is empty.
*[[isVehicleOccupied]] » This function checks if a specified vehicle is occupied.
*[[isVehicleOnRoof]] » This function checks whether vehicle is on roof.
*[[isVehicleOnFire]] » This function checks if the vehicle is on fire or not.
*[[isVehicleReversing]] » This function checks if a specified vehicle is moving backwards.
*[[isVehicleUpgraded]] » This function checks is vehicle upgraded by upgrade ID.
*[[setVehicleGravityPoint]] » This function sets a vehicle's gravity in the direction of a 3 dimensional coordinate with the strength specified.
*[[setVehicleTurnVelocityCenterOfMass]]» This function sets a vehicle's turn velocity relative to the vehicle's center or mass.
*[[setVehicleHandlingFromText]]» This function sets a vehicle's handling from text.

=== Weapon functions ===
*[[getJetpackWeaponsEnabled]] » This function returns a table of enabled weapons usable on a jetpack.

=== Object functions ===
*[[getDynamicDoorObjectOpenRatio]] » This function tells you how open a dynamic door is in a range from 0 to 1.
*[[isElementObject]] » This function tells you if an element is an object or no.

=== XML functions ===
*[[getXMLNodes]] » This function returns all children of a XML node.

=== Engine functions ===
*[[engineGetCOLsFromLibrary]] » This function gets the collision data from the col library.
*[[engineLoadIMGContainer]] » This function loads the IMG container.

=== Utility ===
*[[animate]] » This function allows you to use interpolateBetween without render event and easily used.
*[[callClientFunction]] » This function allows you to call any client-side function from the server's side.
*[[callServerFunction]] » This function allows you to call any server-side function from the client's side.
*[[check]] » This function checks if its arguments are of the right type and calls the error-function if one is not.
*[[checkPassiveTimer]] » This function allows you to use passive timers in your conditions. For example you want to prevent players repeatedly using a command.
*[[coroutine.resume]] » This function applies a fix for hidden coroutine error messages.
*[[compact]] » This function create table containing variables and their values.
*[[getBanFromName]] » This functions returns the ban of the given playername.
*[[getCurrentFPS]] » This function returns the frames per second at which GTA: SA is running.
*[[getSkinNameFromID]] » This function returns the name of the skin from the given id.
*[[IfElse]] » This function returns one of two values based on a boolean expression.
*[[isCharInString]] » This shared function allows you to check if a char specified is in a string value.
*[[isMouseInCircle]] » This function checks if a cursor position is in circular area or not.
*[[isMouseInPosition]] » This function allows you to check whether the mouse cursor/pointer is within a rectangular position.
*[[iterElements]] » This function returns ''a time-saving'' iterator for your for-loops.
*[[PlotTrajectoryAtTime]] » Calculate projectile/water trajectory.
*[[preprocessor]] » This function allow you to use gcc macros.
*[[vector3:compare]] » This method checks whether two vectors match, with optional precision.
*[[svgCreateRoundedRectangle]] » This function creates a rectangle with rounded edges.

<noinclude>[[Category:Useful Functions]]</noinclude>

RO/getPedClothes

2023-03-17T08:38:27Z

Hydra:

{{Server client function}}
__NOTOC__
Această funcție este folosită pentru a vedea texturile hainelor si modelul de pe un ped [[ped]].

==Sintaxă==
<syntaxhighlight lang="lua">
string, string getPedClothes ( ped thePed, int clothesType )
</syntaxhighlight>
{{OOP||[[ped]]:getClothes||addPedClothes}}

===Argumente Necesare===
*'''thePed:''' [[ped]] ale cărui haine vreți să le obțineți.
*'''clothesType:''' Tipul/slot de îmbrăcăminte pe care doriți să-l obțineți.
{{Clothes Textures}}

===Returnează===
This function returns 2 [[string|strings]], the clothes texture and model. The first return value will be ''false'' if this player's clothes type is empty or an invalid player was specified.
Această funcție returnează 2 string-uri, textura hainelor si modelul. Prima valoare va returna ''false'' dacă hainele jucătorului(ped) nu există sau jucătorul(ped) este invalid.

==Exemplu==
<section name="Server" class="server" show="true">
Acest exemplu printează modelul și textura curentă a hainelor jucătorului care scrie comanda "clothes". De exemplu: "clothes 3" pentru papuic.
<syntaxhighlight lang="lua">
function getClothes ( source, key, clothesType )
local texture, model = getPedClothes ( source, clothesType )
if ( texture and model ) then
outputChatBox ( getPlayerName(source) .. " is wearing " .. texture .. " " .. model ..
" on his " .. getClothesTypeName(clothesType), source )
else
outputChatBox ( "Invalid input.", source )
end
end
addCommandHandler ( "clothes", getClothes )
</syntaxhighlight>
</section>

==Vezi și==
{{Ped functions}}

[[hu:getPedClothes]]
[[pl:GetPedClothes]]
[[ro:getPedClothes]]

RO/getPedClothes

2023-03-17T08:37:25Z

Hydra: Created page with "{{Server client function}} __NOTOC__ Această funcție este folosită pentru a vedea hainele, texturile si modelul unui ped ped. ==Sintaxă== <syntaxhighlight lang="lua"> string, string getPedClothes ( ped thePed, int clothesType ) </syntaxhighlight> {{OOP||ped:getClothes||addPedClothes}} ===Argumente Necesare=== *'''thePed:''' ped ale cărui haine vreți să le obțineți. *'''clothesType:''' Tipul/slot de îmbrăcăminte pe care doriți să-l obțineți...."

{{Server client function}}
__NOTOC__
Această funcție este folosită pentru a vedea hainele, texturile si modelul unui ped [[ped]].

==Sintaxă==
<syntaxhighlight lang="lua">
string, string getPedClothes ( ped thePed, int clothesType )
</syntaxhighlight>
{{OOP||[[ped]]:getClothes||addPedClothes}}

===Argumente Necesare===
*'''thePed:''' [[ped]] ale cărui haine vreți să le obțineți.
*'''clothesType:''' Tipul/slot de îmbrăcăminte pe care doriți să-l obțineți.
{{Clothes Textures}}

===Returnează===
This function returns 2 [[string|strings]], the clothes texture and model. The first return value will be ''false'' if this player's clothes type is empty or an invalid player was specified.
Această funcție returnează 2 string-uri, textura hainelor si modelul. Prima valoare va returna ''false'' dacă hainele jucătorului(ped) nu există sau jucătorul(ped) este invalid.

==Exemplu==
<section name="Server" class="server" show="true">
Acest exemplu printează modelul și textura curentă a hainelor jucătorului care scrie comanda "clothes". De exemplu: "clothes 3" pentru papuic.
<syntaxhighlight lang="lua">
function getClothes ( source, key, clothesType )
local texture, model = getPedClothes ( source, clothesType )
if ( texture and model ) then
outputChatBox ( getPlayerName(source) .. " is wearing " .. texture .. " " .. model ..
" on his " .. getClothesTypeName(clothesType), source )
else
outputChatBox ( "Invalid input.", source )
end
end
addCommandHandler ( "clothes", getClothes )
</syntaxhighlight>
</section>

==Vezi și==
{{Ped functions}}

[[hu:getPedClothes]]
[[pl:GetPedClothes]]
[[ro:getPedClothes]]

RO/createPed

2023-03-15T21:29:51Z

Hydra:

__NOTOC__
{{Server client function}}
Creează un ped în lumea GTA.

==Sintaxă==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">ped createPed ( int id model, float x, float y, float z [, float rotație = 0.0, bool sincronizat = true ] )</syntaxhighlight>

===Argumente Necesare===
*'''id model:''' Un număr care specifică modelul pielii [[Character_Skins|GTASA skin ID]].
*'''x:''' Un numar real ce poate sa aiba sau nu zecimale poate sa fie sau nu negativ care reprezintă coordonatele X de pe hartă.
*'''y:''' Un numar real ce poate sa aiba sau nu zecimale poate sa fie sau nu negativ care reprezintă coordonatele Y de pe hartă.
*'''z:''' Un numar real ce poate sa aiba sau nu zecimale poate sa fie sau nu negativ care reprezintă coordonatele Z de pe hartă.

==Argumente Opționale==
{{OptionalArg}}
*'''rotație:''' Un număr care reprezintă rotația în grade.
*'''sincronizat:''' O valoare booleană care reprezintă dacă ped-ul va fi sau nu sincronizat. Dezactivarea sincronizării ar putea fi utilă pentru ped-urile înghețate sau statice pentru a crește performanța serverului.
</section>
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">ped createPed ( int id model, float x, float y, float z [, float rotație = 0.0 ] )</syntaxhighlight>

===Argumente Necesare===
*'''id model:''' Un număr care specifică modelul pielii [[Character_Skins|GTASA skin ID]].
*'''x:''' Un numar real ce poate sa aiba sau nu zecimale poate sa fie sau nu negativ care reprezintă coordonatele X de pe hartă.
*'''y:''' Un numar real ce poate sa aiba sau nu zecimale poate sa fie sau nu negativ care reprezintă coordonatele Y de pe hartă.
*'''z:''' Un numar real ce poate sa aiba sau nu zecimale poate sa fie sau nu negativ care reprezintă coordonatele Z de pe hartă.

==Argumente Opționale==
{{OptionalArg}}
*'''rotație:''' Un număr care reprezintă rotația în grade.
</section>

===Returnează===
Returnează un element ped dacă a fost creat cu succes.

==Exemplu==

<section name="Server" class="server" show="true">
Acest exemplu creează un ped când resursa va porni:
<syntaxhighlight lang="lua">
function pedLoad ( name )
createPed ( 120, 5540.6654, 1020.55122, 1240.545 )
end
addEventHandler ( "onResourceStart", getResourceRootElement(), pedLoad )
</syntaxhighlight>
</section>

<section name="Client" class="client" show="true">
Acest exemplu creează un ped si il face invincibil:
<syntaxhighlight lang="lua">
thePed = createPed(120, 5540.6654, 1020.55122, 1240.545) -- Creează un ped
function cancelPedDamage()
cancelEvent() -- Cancelează eventul onClientPedDamage
end
addEventHandler("onClientPedDamage", thePed, cancelPedDamage) -- Când thePed va fi lovit, onClientPedDamage va fi cancelat
</syntaxhighlight>
</section>

==Tradus==
'''de către Hydra45 (Gabriel45#6859 - Discord)'''

==Probleme==
{{Issues|
{{Issue|375|Sync distance of unoccupied vehicles and peds should match stream distance}}
{{Issue|605|Ped fireing Projectiles doesn't work}}
{{Issue|492|Peds shooting incorrectly}}
}}

==Vezi si==
{{Ped functions}}

[[hu:createPed]]
[[pl:createPed]]
[[ru:createPed]]
[[en:createPed]]

RO/createPed

2023-03-15T21:29:35Z

Hydra:

__NOTOC__
{{Server client function}}
Creează un ped în lumea GTA.

==Sintaxă==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">ped createPed ( int id model, float x, float y, float z [, float rotație = 0.0, bool sincronizat = true ] )</syntaxhighlight>

===Argumente Necesare===
*'''id model:''' Un număr care specifică modelul pielii [[Character_Skins|GTASA skin ID]].
*'''x:''' Un numar real ce poate sa aiba sau nu zecimale poate sa fie sau nu negativ care reprezintă coordonatele X de pe hartă.
*'''y:''' Un numar real ce poate sa aiba sau nu zecimale poate sa fie sau nu negativ care reprezintă coordonatele Y de pe hartă.
*'''z:''' Un numar real ce poate sa aiba sau nu zecimale poate sa fie sau nu negativ care reprezintă coordonatele Z de pe hartă.

==Argumente Opționale==
{{OptionalArg}}
*'''rotație:''' Un număr care reprezintă rotația în grade.
*'''sincronizat:''' O valoare booleană care reprezintă dacă ped-ul va fi sau nu sincronizat. Dezactivarea sincronizării ar putea fi utilă pentru ped-urile înghețate sau statice pentru a crește performanța serverului.
</section>
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">ped createPed ( int id model, float x, float y, float z [, float rotație = 0.0 ] )</syntaxhighlight>

===Argumente Necesare===
*'''id model:''' Un număr care specifică modelul pielii [[Character_Skins|GTASA skin ID]].
*'''x:''' Un număr care reprezintă coordonatele X de pe hartă.
*'''y:''' Un număr care reprezintă coordonatele Y de pe hartă.
*'''z:''' Un număr care reprezintă coordonatele Z de pe hartă.

==Argumente Opționale==
{{OptionalArg}}
*'''rotație:''' Un număr care reprezintă rotația în grade.
</section>

===Returnează===
Returnează un element ped dacă a fost creat cu succes.

==Exemplu==

<section name="Server" class="server" show="true">
Acest exemplu creează un ped când resursa va porni:
<syntaxhighlight lang="lua">
function pedLoad ( name )
createPed ( 120, 5540.6654, 1020.55122, 1240.545 )
end
addEventHandler ( "onResourceStart", getResourceRootElement(), pedLoad )
</syntaxhighlight>
</section>

<section name="Client" class="client" show="true">
Acest exemplu creează un ped si il face invincibil:
<syntaxhighlight lang="lua">
thePed = createPed(120, 5540.6654, 1020.55122, 1240.545) -- Creează un ped
function cancelPedDamage()
cancelEvent() -- Cancelează eventul onClientPedDamage
end
addEventHandler("onClientPedDamage", thePed, cancelPedDamage) -- Când thePed va fi lovit, onClientPedDamage va fi cancelat
</syntaxhighlight>
</section>

==Tradus==
'''de către Hydra45 (Gabriel45#6859 - Discord)'''

==Probleme==
{{Issues|
{{Issue|375|Sync distance of unoccupied vehicles and peds should match stream distance}}
{{Issue|605|Ped fireing Projectiles doesn't work}}
{{Issue|492|Peds shooting incorrectly}}
}}

==Vezi si==
{{Ped functions}}

[[hu:createPed]]
[[pl:createPed]]
[[ru:createPed]]
[[en:createPed]]

RO/Main Page

2023-03-15T18:30:15Z

Hydra:

<div style="display: flex; align-items: center; padding-left: 15px; padding-right: 15px;">
[[File:Mtalogo.png||100px|link=https://wiki.multitheftauto.com/]]
<div style="margin-left: .5em">
'''Bine ai venit pe wiki-ul [[Multi Theft Auto]]''' Pe acest wiki veți găsi o mulțime de informații despre utilizarea Multi Theft Auto.

Există multe [[How you can help|things you can do to help us]] îmbunătățiți MTA - creați o hartă, un mod de joc, ajutați la documentarea funcțiilor de scripting, scrieți cod exemplu, scrieți tutoriale sau doar jucați MTA și raportați erorile pe care le găsiți.

Dacă aveți întrebări sau probleme legate de scripting, nu ezitați să ne contactați [[Places To Chat#Scripting Help|Discord]].

[ Oprește-te să te mai joci singur ]
</div>
</div>

<div style="display: flex; flex-direction: row; flex-wrap: wrap;">

<div style="flex-grow: 1"> 
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px; background: #FFFCF2;">
<div style="float:right; width: 32px;">[[File:Input-gaming.png‎|link=]]</div>
<h3>Play</h3>
<div style="background: #FFEEAA; border: 1px solid #FFCD19;">
[[File:Go-down.png|link=https://multitheftauto.com/]] ''' [https://multitheftauto.com/ Descarcă Multi Theft Auto: San Andreas {{Current Version|full}}]'''</div>
* [[Where to buy GTASA]] - De unde poți cumpăra GTA:SA.
* [[Client Manual]] - Manual Client

* [[Changes_in_{{padleft:|5|{{Current Version|full}}}}|Changes in {{padleft:|5|{{Current Version|full}}}}]]
* [[Known_Issues_-_FAQ|Known Issues]] - Probleme Cunoscute
* [[Server Manual]] - Manual Server
* [[Map manager|Map Manager]] - Manager Hărți

<h3>Editarea Mapei</h3>
*[[Resource:Editor|Manual]]
*[[Resource:Editor/EDF|Editor Definition Format]]
*[[Resource:Editor/Plugins|Plugins]]
*[[Resource:Editor#FAQ|Frequently Asked Questions]]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Package-x-generic.png‎|link=]]</div>
<h3>Baza de date</h3>
Această secțiune prezintă toate capabilitățile Lua pe care MTA sau resursele le oferă.
* [[:Category:Resource|Resource Catalogue]] - Trebuie să le înveți pentru a crea scripturi adecvate
* [[Client side scripts]] - Script-uri de tip client-side
* [[Modules]] - Module pentru Multi Theft Auto
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Applications-development.png‎‎‎|link=]]</div>
<h3>Dezvoltarea Multi Theft Auto</h3>
[[File:Go-down.png|link=https://nightly.mtasa.com/]] [https://nightly.mtasa.com/ Nightly builds]
* [[Compiling_MTASA|Compiling MTASA on Windows]] - Creează-ți propiul launcher

* [[Building_MTASA_Server_on_GNU_Linux|Compiling MTASA on GNU/Linux]]
* [[Coding guidelines]]
* [https://github.com/multitheftauto/mtasa-blue Main GitHub repository]
* [[Roadmap]]
* [https://github.com/multitheftauto/mtasa-blue/issues Bugtracker]
* [[Branches]]
*[[Forks|Forks and anti cheat]] - Despre proiecte propii si despre sistemul împotriva trișării
</div>
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Applications-office.png|link=]]</div>
<h3>Wiki - Cum poți ajuta</h3>
* Finalizați documentația pentru categoriile incomplete -> [[:Category:Incomplete|Incomplete functions]].
* Adăuga-ti exemple la funcții si event-uri [[:Category:Needs_Example |Add examples to functions and events]].
* Examinați și verificați [[:Category:Needs Checking|pages that need checking]].
* Scrie tutoriale pentru a ajuta oamenii noi.
* Traduceți pagini wiki.
* Vezi de asemenea: [https://wiki.multitheftauto.com/wiki/RO/Cum_Poti_Ajuta Cum Poti Ajuta?]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Internet-group-chat.png‎|link=]]</div>
<h3>Comunitate</h3>
* [https://forum.multitheftauto.com/ Forum] - Forum-ul official.
* Serverul de discord al comunității: [https://discord.com/invite/mtasa Official MTA Discord server] ([https://forum.multitheftauto.com/topic/95008-multi-theft-autos-official-discord-server/ Forum post])
* Serverul de discord pentru dezvoltarea proiectului: [https://discord.com/invite/GNN6PRtTnu Server invite link]
* [https://community.multitheftauto.com/ MTA Community] - Distribuie și descarcă resurse de pe comunitate.
* [https://www.youtube.com/user/MTAQA YouTube] - [https://www.facebook.com/multitheftauto Facebook] - [https://www.moddb.com/mods/multi-theft-auto-san-andreas ModDB]
</div>
</div> 

<div style="flex-grow: 1"> 
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Accessories-text-editor.png|link=]]</div>
<h3>Scripting</h3>
* [[Scripting Introduction|Introduction to Scripting]] - Primii pasi pentru a incepe sa scriptezi
* [[Introduction to Scripting the GUI]] - Incepe sa creezi interfațe pe serverul tău
* [[Debugging|Debugging Tutorial]] - Cum să găsiți erori în scripturile dvs
* [[Resources|Introduction to Resources]] - Totul despre resurse
** [[Resource Web Access]] - Cum poți scrie site-uri web cu resurse
** [[CEF_Tutorial|CEF Tutorial]] - Cum puteți utiliza browserul web din joc în resursele dvs
** [[:Category:Resource|Resource Catalogue]]
** [[Meta.xml]] - În spatele fiecărei resurse se află un fișier meta care o definește
** [[ACL]] - Lista de control al accesului, aceasta este vitală pentru ca scripturile complexe să funcționeze
* [[Writing_Gamemodes|Writing Gamemodes]] - Cum să îți faci un mod de joc
Link-uri Forum
* [https://forum.multitheftauto.com/forum/71-scripting/ Scripting Sub-Forum], [https://forum.multitheftauto.com/forum/123-tutorials/ Scripting Tutorials Sub-Forum]
* [https://forum.multitheftauto.com/topic/24702-mtasa-wiki-offline-copies-online-mirrors/ Offline Wiki Copies]
<div style="float:right; width: 32px;">[[File:start-here.png|link=]]</div>
<h3>General Lua Help</h3>
Pagini concepute pentru a vă ajuta să înțelegeți Lua
*[http://www.lua.org/pil/index.html "Programming in Lua" Manual]
**[http://www.lua.org/manual/5.1/#index Internal Lua functions reference]
*[http://lua-users.org/wiki/TutorialDirectory Lua Wiki]
*[http://nixstaller.sourceforge.net/manual/0.5.1/nixstaller_10.html A general guide to Lua from Nixstaller]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px; background:#F2F2FF;">
<div style="float:right; width: 32px;">[[File:Preferences-system.png|link=]]</div>
<h3>Reference</h3>
* [[Client Scripting Functions|Client-side Functions]]
* [[Client Scripting Events|Client-side Events]]
* [[Server Scripting Functions|Server-side Functions]]
* [[Server Scripting Events|Server-side Events]]
* [[Useful Functions]]

* [[MTA Classes]] - Descrieri detaliate ale tuturor claselor personalizate pe MTA
** [[Element|MTA Elements]] / [[Element tree]]
</div>
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:System-file-manager.png|link=]]</div>
<h3>[[Id|ID Lists]]</h3>
*[[Animations|Animations]] - Toate animațiile din GTA
*[[Character Skins]] - Toate personajele din GTA
*[[CJ_Clothes|Clothing styles]] - Toate hainele de pe CJ
*[[Garage|Garage IDs]] - Lista Garajelor din joc
*[[Interior IDs]] - Lista Interioarelor din joc
*[[Material IDs]] - Lista Materialelor din joc
*[[Ped voices|Ped Voices]]
*[[Projectiles]] - Proiectile
*[[Radar Blips]] - Iconițe Radar
*[[Sounds]] - Sunete
*[[Vehicle IDs]] - Lista mașiniilor din joc
*[[Vehicle Colors]] - Toate culoriile de pe mașini
*[[Vehicle Upgrades]] - Toate modificarile de pe mașini
*[[Vehicle variants|Vehicle Variants]] - Toate variantele de pe mașini
*[[Vehicle component manipulation]] - Despre componentele mașiniilor
*[[Weapons|Weapons]] - Despre Arme
*[[Weather]] - Vremea din joc
</div>
</div> 
</div> 


<div style="display: flex; flex-wrap: wrap; align-items: center; padding-left: 15px; padding-right: 15px;" class="plainlinks">
[[File:MTALogo_8ball.png||85px|link=Archive]]

<div style="display: flex; flex-wrap: wrap;>
<div style="margin-right: 5em;">
'''Despre [[Multi Theft Auto]]''' 
[[Archive]] 
[[Press Coverage]] 
[https://github.com/multitheftauto/mtasa-blue/graphs/contributors Developers]
</div>

<div style="margin-right: 5em;">
'''Multi Theft Auto 0.5''' 
[[Archive#Multi_Theft_Auto_0.5|Download]] 
[[MTA 0.5r2 Known Issues|Known Issues]]
</div>

<div style="margin-right: 5em;">
'''Statistici Wiki''' 
{{NUMBEROFARTICLES}} Articole 
{{NUMBEROFPAGES}} Pagini 
{{NUMBEROFUSERS}} Utilizatori Înregistrați 
</div>

<div>
[[File:Osi symbol.png|75px|link=https://opensource.org/|left]]
'''Multi Theft Auto''' este '''Open Source'''.
 Aceasta înseamnă că oricine poate contribui la îmbunătățirea Multi Theft Auto!
</div>
</div>

</div>

==Tradus==
''de către Hydra (Gabriel45#6859 - Discord)''

__NOTOC__
__NOEDITSECTION__
{{Languages list|en}}

RO/Main Page

2023-03-15T18:28:49Z

Hydra:

<div style="display: flex; align-items: center; padding-left: 15px; padding-right: 15px;">
[[File:Mtalogo.png||100px|link=https://wiki.multitheftauto.com/]]
<div style="margin-left: .5em">
'''Bine ai venit pe wiki-ul [[Multi Theft Auto]]''' Pe acest wiki veți găsi o mulțime de informații despre utilizarea Multi Theft Auto.

Există multe [[How you can help|things you can do to help us]] îmbunătățiți MTA - creați o hartă, un mod de joc, ajutați la documentarea funcțiilor de scripting, scrieți cod exemplu, scrieți tutoriale sau doar jucați MTA și raportați erorile pe care le găsiți.

Dacă aveți întrebări sau probleme legate de scripting, nu ezitați să ne contactați [[Places To Chat#Scripting Help|Discord]].

[ Oprește-te să te mai joci singur ]
</div>
</div>

<div style="display: flex; flex-direction: row; flex-wrap: wrap;">

<div style="flex-grow: 1"> 
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px; background: #FFFCF2;">
<div style="float:right; width: 32px;">[[File:Input-gaming.png‎|link=]]</div>
<h3>Play</h3>
<div style="background: #FFEEAA; border: 1px solid #FFCD19;">
[[File:Go-down.png|link=https://multitheftauto.com/]] ''' [https://multitheftauto.com/ Descarcă Multi Theft Auto: San Andreas {{Current Version|full}}]'''</div>
* [[Where to buy GTASA]] - De unde poți cumpăra GTA:SA.
* [[Client Manual]] - Manual Client

* [[Changes_in_{{padleft:|5|{{Current Version|full}}}}|Changes in {{padleft:|5|{{Current Version|full}}}}]]
* [[Known_Issues_-_FAQ|Known Issues]] - Probleme Cunoscute
* [[Server Manual]] - Manual Server
* [[Map manager|Map Manager]] - Manager Hărți

<h3>Editarea Mapei</h3>
*[[Resource:Editor|Manual]]
*[[Resource:Editor/EDF|Editor Definition Format]]
*[[Resource:Editor/Plugins|Plugins]]
*[[Resource:Editor#FAQ|Frequently Asked Questions]]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Package-x-generic.png‎|link=]]</div>
<h3>Baza de date</h3>
Această secțiune prezintă toate capabilitățile Lua pe care MTA sau resursele le oferă.
* [[:Category:Resource|Resource Catalogue]] - Trebuie să le înveți pentru a crea scripturi adecvate
* [[Client side scripts]] - Script-uri de tip client-side
* [[Modules]] - Module pentru Multi Theft Auto
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Applications-development.png‎‎‎|link=]]</div>
<h3>Dezvoltarea Multi Theft Auto</h3>
[[File:Go-down.png|link=https://nightly.mtasa.com/]] [https://nightly.mtasa.com/ Nightly builds]
* [[Compiling_MTASA|Compiling MTASA on Windows]] - Creează-ți propiul launcher

* [[Building_MTASA_Server_on_GNU_Linux|Compiling MTASA on GNU/Linux]]
* [[Coding guidelines]]
* [https://github.com/multitheftauto/mtasa-blue Main GitHub repository]
* [[Roadmap]]
* [https://github.com/multitheftauto/mtasa-blue/issues Bugtracker]
* [[Branches]]
*[[Forks|Forks and anti cheat]] - Despre proiecte propii si despre sistemul împotriva trișării
</div>
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Applications-office.png|link=]]</div>
<h3>Wiki - Cum poți ajuta</h3>
* Finalizați documentația pentru categoriile incomplete -> [[:Category:Incomplete|Incomplete functions]].
* Adăuga-ti exemple la funcții si event-uri [[:Category:Needs_Example |Add examples to functions and events]].
* Examinați și verificați [[:Category:Needs Checking|pages that need checking]].
* Scrie tutoriale pentru a ajuta oamenii noi.
* Traduceți pagini wiki.
* Vezi de asemenea: [[ro:Cum Poti Ajuta]]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Internet-group-chat.png‎|link=]]</div>
<h3>Comunitate</h3>
* [https://forum.multitheftauto.com/ Forum] - Forum-ul official.
* Serverul de discord al comunității: [https://discord.com/invite/mtasa Official MTA Discord server] ([https://forum.multitheftauto.com/topic/95008-multi-theft-autos-official-discord-server/ Forum post])
* Serverul de discord pentru dezvoltarea proiectului: [https://discord.com/invite/GNN6PRtTnu Server invite link]
* [https://community.multitheftauto.com/ MTA Community] - Distribuie și descarcă resurse de pe comunitate.
* [https://www.youtube.com/user/MTAQA YouTube] - [https://www.facebook.com/multitheftauto Facebook] - [https://www.moddb.com/mods/multi-theft-auto-san-andreas ModDB]
</div>
</div> 

<div style="flex-grow: 1"> 
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Accessories-text-editor.png|link=]]</div>
<h3>Scripting</h3>
* [[Scripting Introduction|Introduction to Scripting]] - Primii pasi pentru a incepe sa scriptezi
* [[Introduction to Scripting the GUI]] - Incepe sa creezi interfațe pe serverul tău
* [[Debugging|Debugging Tutorial]] - Cum să găsiți erori în scripturile dvs
* [[Resources|Introduction to Resources]] - Totul despre resurse
** [[Resource Web Access]] - Cum poți scrie site-uri web cu resurse
** [[CEF_Tutorial|CEF Tutorial]] - Cum puteți utiliza browserul web din joc în resursele dvs
** [[:Category:Resource|Resource Catalogue]]
** [[Meta.xml]] - În spatele fiecărei resurse se află un fișier meta care o definește
** [[ACL]] - Lista de control al accesului, aceasta este vitală pentru ca scripturile complexe să funcționeze
* [[Writing_Gamemodes|Writing Gamemodes]] - Cum să îți faci un mod de joc
Link-uri Forum
* [https://forum.multitheftauto.com/forum/71-scripting/ Scripting Sub-Forum], [https://forum.multitheftauto.com/forum/123-tutorials/ Scripting Tutorials Sub-Forum]
* [https://forum.multitheftauto.com/topic/24702-mtasa-wiki-offline-copies-online-mirrors/ Offline Wiki Copies]
<div style="float:right; width: 32px;">[[File:start-here.png|link=]]</div>
<h3>General Lua Help</h3>
Pagini concepute pentru a vă ajuta să înțelegeți Lua
*[http://www.lua.org/pil/index.html "Programming in Lua" Manual]
**[http://www.lua.org/manual/5.1/#index Internal Lua functions reference]
*[http://lua-users.org/wiki/TutorialDirectory Lua Wiki]
*[http://nixstaller.sourceforge.net/manual/0.5.1/nixstaller_10.html A general guide to Lua from Nixstaller]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px; background:#F2F2FF;">
<div style="float:right; width: 32px;">[[File:Preferences-system.png|link=]]</div>
<h3>Reference</h3>
* [[Client Scripting Functions|Client-side Functions]]
* [[Client Scripting Events|Client-side Events]]
* [[Server Scripting Functions|Server-side Functions]]
* [[Server Scripting Events|Server-side Events]]
* [[Useful Functions]]

* [[MTA Classes]] - Descrieri detaliate ale tuturor claselor personalizate pe MTA
** [[Element|MTA Elements]] / [[Element tree]]
</div>
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:System-file-manager.png|link=]]</div>
<h3>[[Id|ID Lists]]</h3>
*[[Animations|Animations]] - Toate animațiile din GTA
*[[Character Skins]] - Toate personajele din GTA
*[[CJ_Clothes|Clothing styles]] - Toate hainele de pe CJ
*[[Garage|Garage IDs]] - Lista Garajelor din joc
*[[Interior IDs]] - Lista Interioarelor din joc
*[[Material IDs]] - Lista Materialelor din joc
*[[Ped voices|Ped Voices]]
*[[Projectiles]] - Proiectile
*[[Radar Blips]] - Iconițe Radar
*[[Sounds]] - Sunete
*[[Vehicle IDs]] - Lista mașiniilor din joc
*[[Vehicle Colors]] - Toate culoriile de pe mașini
*[[Vehicle Upgrades]] - Toate modificarile de pe mașini
*[[Vehicle variants|Vehicle Variants]] - Toate variantele de pe mașini
*[[Vehicle component manipulation]] - Despre componentele mașiniilor
*[[Weapons|Weapons]] - Despre Arme
*[[Weather]] - Vremea din joc
</div>
</div> 
</div> 


<div style="display: flex; flex-wrap: wrap; align-items: center; padding-left: 15px; padding-right: 15px;" class="plainlinks">
[[File:MTALogo_8ball.png||85px|link=Archive]]

<div style="display: flex; flex-wrap: wrap;>
<div style="margin-right: 5em;">
'''Despre [[Multi Theft Auto]]''' 
[[Archive]] 
[[Press Coverage]] 
[https://github.com/multitheftauto/mtasa-blue/graphs/contributors Developers]
</div>

<div style="margin-right: 5em;">
'''Multi Theft Auto 0.5''' 
[[Archive#Multi_Theft_Auto_0.5|Download]] 
[[MTA 0.5r2 Known Issues|Known Issues]]
</div>

<div style="margin-right: 5em;">
'''Statistici Wiki''' 
{{NUMBEROFARTICLES}} Articole 
{{NUMBEROFPAGES}} Pagini 
{{NUMBEROFUSERS}} Utilizatori Înregistrați 
</div>

<div>
[[File:Osi symbol.png|75px|link=https://opensource.org/|left]]
'''Multi Theft Auto''' este '''Open Source'''.
 Aceasta înseamnă că oricine poate contribui la îmbunătățirea Multi Theft Auto!
</div>
</div>

</div>

==Tradus==
''de către Hydra (Gabriel45#6859 - Discord)''

__NOTOC__
__NOEDITSECTION__
{{Languages list|en}}

RO/Cum Poti Ajuta

2023-03-15T17:13:51Z

Hydra: Created page with "__NOTOC__ Multi Theft Auto are o mulțime de domenii în care ne puteți ajuta. La rândul nostru, vom fi mai mult decât bucuroși să vă ajutăm să începeți cu orice idei pe care le aveți, să le ajutăm să le testăm și, dacă sunt suficient de bune, să le lansăm întregii comunități. Această pagină prezintă domeniile cheie în care ați putea face ceva, desigur, există multe lucruri la care nu ne-am gândit, așa că gândiți-vă în afara cutiei! ==..."

__NOTOC__
Multi Theft Auto are o mulțime de domenii în care ne puteți ajuta. La rândul nostru, vom fi mai mult decât bucuroși să vă ajutăm să începeți cu orice idei pe care le aveți, să le ajutăm să le testăm și, dacă sunt suficient de bune, să le lansăm întregii comunități. Această pagină prezintă domeniile cheie în care ați putea face ceva, desigur, există multe lucruri la care nu ne-am gândit, așa că gândiți-vă în afara cutiei!

==Dezvoltare MTA:SA==
* Deveniți un colaborator prin trimitere [https://github.com/multitheftauto/mtasa-blue/pulls pull requests] la MTA, care conțin funcții solicitate sau remedieri de erori. ([https://github.com/multitheftauto/mtasa-blue/blob/master/CONTRIBUTING.md#contributors-guide Coding guidelines])
* Traduceți MTA:SA în limba maternă pe Crowdin la https://multitheftauto.crowdin.com/

==Dezvoltare(Scriptare)==
* Deveniți un contributor la resursele oficiale ale MTA prin trimitere [https://github.com/multitheftauto/mtasa-resources/pulls pull requests] la depozitul nostru de resurse.
* Creați și [https://community.multitheftauto.com/ publish] un mod de joc sau un script util
**[[Scripting Introduction]]
**[https://www.lua.org/pil/index.html "Programming in Lua" Manual]
* Creați o resursă de uz general care oferă funcții utile altor resurse.

==Hărți==
* Creați și [https://community.multitheftauto.com/ publish] publicați o hartă pentru un mod de joc existent, cu editorul de hărți.
**[[Resource:Editor|Map Editor Manual]]

==Dezvoltare Web==
* Creați-vă propriul sistem pentru statistici - folosind [[PHP SDK]] ca bază. Alatura-te [https://discord.com/invite/mtasa MTA Discord] (sau [https://discord.gg/GNN6PRtTnu development Discord]) pentru ajutor.

==Documentare==
Înainte de a face modificări, verificați: [[Help:Editing Guidelines|Editing Guidelines]] și [[Help:MTA Wiki Specific Templates|Specific Templates]]
* Finalizați documentația pentru [[:Category:Incomplete|Incomplete functions]] - întrebați în #mta.scripting dacă nu sunteți sigur de ceva.
* Adăugați exemple la [[:Category:Needs Example|functions & events missing examples]] - vă rugăm să le ''testați'' și, din nou, întrebați dacă aveți nevoie de ajutor.
* Examinați și verificați [[:Category:Needs Checking|pages that need checking]] - asigurați-vă că problemele evidențiate sunt rezolvate înainte de a elimina paginile din categorie.
* Extindeți paginile care explică [[:Category:Scripting_Concepts|MTA core concepts]].
* Scrie [https://forum.multitheftauto.com/forum/123-tutorials/ tutorials] pentru a ajuta oameni noi.
* Traduceți paginile wiki, astfel încât oamenii din alte țări să poată începe și în MTA.
* Creați documentație pentru funcții și event-uri nedocumentate [[Undocumented Items]]
* Păstrați 'schimbările în' [current work-in-progress: https://wiki.multitheftauto.com/wiki/Changes_in_1.6] pentru versiunile viitoare actualizate.

==Asigurarea Calității==
* [https://github.com/multitheftauto/mtasa-blue/issues Report issues] - Asigurați-vă că faceți mai întâi o căutare pe problemele deja raportate.
* Testați și confirmați problemele raportate existente.
* Utilizați cea mai nouă versiune a MTA pentru a detecta și raporta erori noi, accesând „Setări”, „Avansat”, „Actualizare tip de versiune” și alegând „Nightly” sau obțineți-o în mod regulat [https://nightly.multitheftauto.com/ from here].
* Orice erori care sunt legate de o funcție/eveniment de scripting și prezente în versiunea principală (mai degrabă decât cele de noapte), documentează această eroare adăugând un [https://wiki.multitheftauto.com/wiki/Help:MTA_Wiki_Specific_Templates warning] la pagina wiki pentru a economisi mult timp altor scripteri.

==Sarcini Specifice==
* Creați un fuzzer pentru a verifica dacă există blocări în funcțiile noastre de scripting.

==Acordă==
Puteți dona către MTA:SA [https://multitheftauto.com/donate/manage.php here]

[[ar:كيف_يمكنك_المساعدة]]
[[en:How you can help]]
[[ru:How you can help]]
[[pl:Jak możesz pomóc]]
[[uk:How you can help]]
[[es:Cómo puedes ayudar]]
[[hu:How you can help]]
[[tr:Nasıl yardımcı olabilirsiniz]]
[[pt-br:Como você pode ajudar]]
[[ro:Cum Poti Ajuta]]

RO/Main Page

2023-03-15T16:57:24Z

Hydra:

<div style="display: flex; align-items: center; padding-left: 15px; padding-right: 15px;">
[[File:Mtalogo.png||100px|link=https://wiki.multitheftauto.com/]]
<div style="margin-left: .5em">
'''Bine ai venit pe wiki-ul [[Multi Theft Auto]]''' Pe acest wiki veți găsi o mulțime de informații despre utilizarea Multi Theft Auto.

Există multe [[How you can help|things you can do to help us]] îmbunătățiți MTA - creați o hartă, un mod de joc, ajutați la documentarea funcțiilor de scripting, scrieți cod exemplu, scrieți tutoriale sau doar jucați MTA și raportați erorile pe care le găsiți.

Dacă aveți întrebări sau probleme legate de scripting, nu ezitați să ne contactați [[Places To Chat#Scripting Help|Discord]].

[ Oprește-te să te mai joci singur ]
</div>
</div>

<div style="display: flex; flex-direction: row; flex-wrap: wrap;">

<div style="flex-grow: 1"> 
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px; background: #FFFCF2;">
<div style="float:right; width: 32px;">[[File:Input-gaming.png‎|link=]]</div>
<h3>Play</h3>
<div style="background: #FFEEAA; border: 1px solid #FFCD19;">
[[File:Go-down.png|link=https://multitheftauto.com/]] ''' [https://multitheftauto.com/ Descarcă Multi Theft Auto: San Andreas {{Current Version|full}}]'''</div>
* [[Where to buy GTASA]] - De unde poți cumpăra GTA:SA.
* [[Client Manual]] - Manual Client

* [[Changes_in_{{padleft:|5|{{Current Version|full}}}}|Changes in {{padleft:|5|{{Current Version|full}}}}]]
* [[Known_Issues_-_FAQ|Known Issues]] - Probleme Cunoscute
* [[Server Manual]] - Manual Server
* [[Map manager|Map Manager]] - Manager Hărți

<h3>Editarea Mapei</h3>
*[[Resource:Editor|Manual]]
*[[Resource:Editor/EDF|Editor Definition Format]]
*[[Resource:Editor/Plugins|Plugins]]
*[[Resource:Editor#FAQ|Frequently Asked Questions]]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Package-x-generic.png‎|link=]]</div>
<h3>Baza de date</h3>
Această secțiune prezintă toate capabilitățile Lua pe care MTA sau resursele le oferă.
* [[:Category:Resource|Resource Catalogue]] - Trebuie să le înveți pentru a crea scripturi adecvate
* [[Client side scripts]] - Script-uri de tip client-side
* [[Modules]] - Module pentru Multi Theft Auto
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Applications-development.png‎‎‎|link=]]</div>
<h3>Dezvoltarea Multi Theft Auto</h3>
[[File:Go-down.png|link=https://nightly.mtasa.com/]] [https://nightly.mtasa.com/ Nightly builds]
* [[Compiling_MTASA|Compiling MTASA on Windows]] - Creează-ți propiul launcher

* [[Building_MTASA_Server_on_GNU_Linux|Compiling MTASA on GNU/Linux]]
* [[Coding guidelines]]
* [https://github.com/multitheftauto/mtasa-blue Main GitHub repository]
* [[Roadmap]]
* [https://github.com/multitheftauto/mtasa-blue/issues Bugtracker]
* [[Branches]]
*[[Forks|Forks and anti cheat]] - Despre proiecte propii si despre sistemul împotriva trișării
</div>
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Applications-office.png|link=]]</div>
<h3>Wiki - Cum poți ajuta</h3>
* Finalizați documentația pentru categoriile incomplete -> [[:Category:Incomplete|Incomplete functions]].
* Adăuga-ti exemple la funcții si event-uri [[:Category:Needs_Example |Add examples to functions and events]].
* Examinați și verificați [[:Category:Needs Checking|pages that need checking]].
* Scrie tutoriale pentru a ajuta oamenii noi.
* Traduceți pagini wiki.
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Internet-group-chat.png‎|link=]]</div>
<h3>Comunitate</h3>
* [https://forum.multitheftauto.com/ Forum] - Forum-ul official.
* Serverul de discord al comunității: [https://discord.com/invite/mtasa Official MTA Discord server] ([https://forum.multitheftauto.com/topic/95008-multi-theft-autos-official-discord-server/ Forum post])
* Serverul de discord pentru dezvoltarea proiectului: [https://discord.com/invite/GNN6PRtTnu Server invite link]
* [https://community.multitheftauto.com/ MTA Community] - Distribuie și descarcă resurse de pe comunitate.
* [https://www.youtube.com/user/MTAQA YouTube] - [https://www.facebook.com/multitheftauto Facebook] - [https://www.moddb.com/mods/multi-theft-auto-san-andreas ModDB]
</div>
</div> 

<div style="flex-grow: 1"> 
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Accessories-text-editor.png|link=]]</div>
<h3>Scripting</h3>
* [[Scripting Introduction|Introduction to Scripting]] - Primii pasi pentru a incepe sa scriptezi
* [[Introduction to Scripting the GUI]] - Incepe sa creezi interfațe pe serverul tău
* [[Debugging|Debugging Tutorial]] - Cum să găsiți erori în scripturile dvs
* [[Resources|Introduction to Resources]] - Totul despre resurse
** [[Resource Web Access]] - Cum poți scrie site-uri web cu resurse
** [[CEF_Tutorial|CEF Tutorial]] - Cum puteți utiliza browserul web din joc în resursele dvs
** [[:Category:Resource|Resource Catalogue]]
** [[Meta.xml]] - În spatele fiecărei resurse se află un fișier meta care o definește
** [[ACL]] - Lista de control al accesului, aceasta este vitală pentru ca scripturile complexe să funcționeze
* [[Writing_Gamemodes|Writing Gamemodes]] - Cum să îți faci un mod de joc
Link-uri Forum
* [https://forum.multitheftauto.com/forum/71-scripting/ Scripting Sub-Forum], [https://forum.multitheftauto.com/forum/123-tutorials/ Scripting Tutorials Sub-Forum]
* [https://forum.multitheftauto.com/topic/24702-mtasa-wiki-offline-copies-online-mirrors/ Offline Wiki Copies]
<div style="float:right; width: 32px;">[[File:start-here.png|link=]]</div>
<h3>General Lua Help</h3>
Pagini concepute pentru a vă ajuta să înțelegeți Lua
*[http://www.lua.org/pil/index.html "Programming in Lua" Manual]
**[http://www.lua.org/manual/5.1/#index Internal Lua functions reference]
*[http://lua-users.org/wiki/TutorialDirectory Lua Wiki]
*[http://nixstaller.sourceforge.net/manual/0.5.1/nixstaller_10.html A general guide to Lua from Nixstaller]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px; background:#F2F2FF;">
<div style="float:right; width: 32px;">[[File:Preferences-system.png|link=]]</div>
<h3>Reference</h3>
* [[Client Scripting Functions|Client-side Functions]]
* [[Client Scripting Events|Client-side Events]]
* [[Server Scripting Functions|Server-side Functions]]
* [[Server Scripting Events|Server-side Events]]
* [[Useful Functions]]

* [[MTA Classes]] - Descrieri detaliate ale tuturor claselor personalizate pe MTA
** [[Element|MTA Elements]] / [[Element tree]]
</div>
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:System-file-manager.png|link=]]</div>
<h3>[[Id|ID Lists]]</h3>
*[[Animations|Animations]] - Toate animațiile din GTA
*[[Character Skins]] - Toate personajele din GTA
*[[CJ_Clothes|Clothing styles]] - Toate hainele de pe CJ
*[[Garage|Garage IDs]] - Lista Garajelor din joc
*[[Interior IDs]] - Lista Interioarelor din joc
*[[Material IDs]] - Lista Materialelor din joc
*[[Ped voices|Ped Voices]]
*[[Projectiles]] - Proiectile
*[[Radar Blips]] - Iconițe Radar
*[[Sounds]] - Sunete
*[[Vehicle IDs]] - Lista mașiniilor din joc
*[[Vehicle Colors]] - Toate culoriile de pe mașini
*[[Vehicle Upgrades]] - Toate modificarile de pe mașini
*[[Vehicle variants|Vehicle Variants]] - Toate variantele de pe mașini
*[[Vehicle component manipulation]] - Despre componentele mașiniilor
*[[Weapons|Weapons]] - Despre Arme
*[[Weather]] - Vremea din joc
</div>
</div> 
</div> 


<div style="display: flex; flex-wrap: wrap; align-items: center; padding-left: 15px; padding-right: 15px;" class="plainlinks">
[[File:MTALogo_8ball.png||85px|link=Archive]]

<div style="display: flex; flex-wrap: wrap;>
<div style="margin-right: 5em;">
'''Despre [[Multi Theft Auto]]''' 
[[Archive]] 
[[Press Coverage]] 
[https://github.com/multitheftauto/mtasa-blue/graphs/contributors Developers]
</div>

<div style="margin-right: 5em;">
'''Multi Theft Auto 0.5''' 
[[Archive#Multi_Theft_Auto_0.5|Download]] 
[[MTA 0.5r2 Known Issues|Known Issues]]
</div>

<div style="margin-right: 5em;">
'''Statistici Wiki''' 
{{NUMBEROFARTICLES}} Articole 
{{NUMBEROFPAGES}} Pagini 
{{NUMBEROFUSERS}} Utilizatori Înregistrați 
</div>

<div>
[[File:Osi symbol.png|75px|link=https://opensource.org/|left]]
'''Multi Theft Auto''' este '''Open Source'''.
 Aceasta înseamnă că oricine poate contribui la îmbunătățirea Multi Theft Auto!
</div>
</div>

</div>

==Tradus==
''de către Hydra (Gabriel45#6859 - Discord)''

__NOTOC__
__NOEDITSECTION__
{{Languages list|en}}

RO/Main Page

2023-03-15T16:55:03Z

Hydra:

<div style="display: flex; align-items: center; padding-left: 15px; padding-right: 15px;">
[[File:Mtalogo.png||100px|link=https://wiki.multitheftauto.com/]]
<div style="margin-left: .5em">
'''Bine ai venit pe wiki-ul [[Multi Theft Auto]]''' Pe acest wiki veți găsi o mulțime de informații despre utilizarea Multi Theft Auto.

Există multe [[How you can help|things you can do to help us]] îmbunătățiți MTA - creați o hartă, un mod de joc, ajutați la documentarea funcțiilor de scripting, scrieți cod exemplu, scrieți tutoriale sau doar jucați MTA și raportați erorile pe care le găsiți.

Dacă aveți întrebări sau probleme legate de scripting, nu ezitați să ne contactați [[Places To Chat#Scripting Help|Discord]].

[ Oprește-te să te mai joci singur ]
</div>
</div>

<div style="display: flex; flex-direction: row; flex-wrap: wrap;">

<div style="flex-grow: 1"> 
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px; background: #FFFCF2;">
<div style="float:right; width: 32px;">[[File:Input-gaming.png‎|link=]]</div>
<h3>Play</h3>
<div style="background: #FFEEAA; border: 1px solid #FFCD19;">
[[File:Go-down.png|link=https://multitheftauto.com/]] ''' [https://multitheftauto.com/ Descarcă Multi Theft Auto: San Andreas {{Current Version|full}}]'''</div>
* [[Where to buy GTASA]] - De unde poți cumpăra GTA:SA.
* [[Client Manual]] - Manual Client

* [[Changes_in_{{padleft:|5|{{Current Version|full}}}}|Changes in {{padleft:|5|{{Current Version|full}}}}]]
* [[Known_Issues_-_FAQ|Known Issues]] - Probleme Cunoscute
* [[Server Manual]] - Manual Server
* [[Map manager|Map Manager]] - Manager Hărți

<h3>Editarea Mapei</h3>
*[[Resource:Editor|Manual]]
*[[Resource:Editor/EDF|Editor Definition Format]]
*[[Resource:Editor/Plugins|Plugins]]
*[[Resource:Editor#FAQ|Frequently Asked Questions]]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Package-x-generic.png‎|link=]]</div>
<h3>Baza de date</h3>
Această secțiune prezintă toate capabilitățile Lua pe care MTA sau resursele le oferă.
* [[:Category:Resource|Resource Catalogue]] - Trebuie să le înveți pentru a crea scripturi adecvate
* [[Client side scripts]] - Script-uri de tip client-side
* [[Modules]] - Module pentru Multi Theft Auto
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Applications-development.png‎‎‎|link=]]</div>
<h3>Dezvoltarea Multi Theft Auto</h3>
[[File:Go-down.png|link=https://nightly.mtasa.com/]] [https://nightly.mtasa.com/ Nightly builds]
* [[Compiling_MTASA|Compiling MTASA on Windows]] - Creează-ți propiul launcher

* [[Building_MTASA_Server_on_GNU_Linux|Compiling MTASA on GNU/Linux]]
* [[Coding guidelines]]
* [https://github.com/multitheftauto/mtasa-blue Main GitHub repository]
* [[Roadmap]]
* [https://github.com/multitheftauto/mtasa-blue/issues Bugtracker]
* [[Branches]]
*[[Forks|Forks and anti cheat]] - Despre proiecte propii si despre sistemul împotriva trișării
</div>
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Applications-office.png|link=]]</div>
<h3>Wiki - Cum poți ajuta</h3>
* Finalizați documentația pentru categoriile incomplete -> [[:Category:Incomplete|Incomplete functions]].
* Adăuga-ti exemple la funcții si event-uri [[:Category:Needs_Example |Add examples to functions and events]].
* Examinați și verificați [[:Category:Needs Checking|pages that need checking]].
* Scrie tutoriale pentru a ajuta oamenii noi.
* Traduceți pagini wiki.
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Internet-group-chat.png‎|link=]]</div>
<h3>Comunitate</h3>
* [https://forum.multitheftauto.com/ Forum] - Forum-ul official.
* Serverul de discord al comunității: [https://discord.com/invite/mtasa Official MTA Discord server] ([https://forum.multitheftauto.com/topic/95008-multi-theft-autos-official-discord-server/ Forum post])
* Serverul de discord pentru dezvoltarea proiectului: [https://discord.com/invite/GNN6PRtTnu Server invite link]
* [https://community.multitheftauto.com/ MTA Community] - Distribuie și descarcă resurse de pe comunitate.
* [https://www.youtube.com/user/MTAQA YouTube] - [https://www.facebook.com/multitheftauto Facebook] - [https://www.moddb.com/mods/multi-theft-auto-san-andreas ModDB]
</div>
</div> 

<div style="flex-grow: 1"> 
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Accessories-text-editor.png|link=]]</div>
<h3>Scripting</h3>
* [[Scripting Introduction|Introduction to Scripting]] - Primii pasi pentru a incepe sa scriptezi
* [[Introduction to Scripting the GUI]] - Incepe sa creezi interfațe pe serverul tău
* [[Debugging|Debugging Tutorial]] - Cum să găsiți erori în scripturile dvs
* [[Resources|Introduction to Resources]] - Totul despre resurse
** [[Resource Web Access]] - Cum poți scrie site-uri web cu resurse
** [[CEF_Tutorial|CEF Tutorial]] - Cum puteți utiliza browserul web din joc în resursele dvs
** [[:Category:Resource|Resource Catalogue]]
** [[Meta.xml]] - În spatele fiecărei resurse se află un fișier meta care o definește
** [[ACL]] - Lista de control al accesului, aceasta este vitală pentru ca scripturile complexe să funcționeze
* [[Writing_Gamemodes|Writing Gamemodes]] - Cum să îți faci un mod de joc
Link-uri Forum
* [https://forum.multitheftauto.com/forum/71-scripting/ Scripting Sub-Forum], [https://forum.multitheftauto.com/forum/123-tutorials/ Scripting Tutorials Sub-Forum]
* [https://forum.multitheftauto.com/topic/24702-mtasa-wiki-offline-copies-online-mirrors/ Offline Wiki Copies]
<div style="float:right; width: 32px;">[[File:start-here.png|link=]]</div>
<h3>General Lua Help</h3>
Pagini concepute pentru a vă ajuta să înțelegeți Lua
*[http://www.lua.org/pil/index.html "Programming in Lua" Manual]
**[http://www.lua.org/manual/5.1/#index Internal Lua functions reference]
*[http://lua-users.org/wiki/TutorialDirectory Lua Wiki]
*[http://nixstaller.sourceforge.net/manual/0.5.1/nixstaller_10.html A general guide to Lua from Nixstaller]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px; background:#F2F2FF;">
<div style="float:right; width: 32px;">[[File:Preferences-system.png|link=]]</div>
<h3>Reference</h3>
* [[Client Scripting Functions|Client-side Functions]]
* [[Client Scripting Events|Client-side Events]]
* [[Server Scripting Functions|Server-side Functions]]
* [[Server Scripting Events|Server-side Events]]
* [[Useful Functions]]

* [[MTA Classes]] - Descrieri detaliate ale tuturor claselor personalizate pe MTA
** [[Element|MTA Elements]] / [[Element tree]]
</div>
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:System-file-manager.png|link=]]</div>
<h3>[[Id|ID Lists]]</h3>
*[[Animations|Animations]] - Toate animațiile din GTA
*[[Character Skins]] - Toate personajele din GTA
*[[CJ_Clothes|Clothing styles]] - Toate hainele de pe CJ
*[[Garage|Garage IDs]] - Lista Garajelor din joc
*[[Interior IDs]] - Lista Interioarelor din joc
*[[Material IDs]] - Lista Materialelor din joc
*[[Ped voices|Ped Voices]]
*[[Projectiles]] - Proiectile
*[[Radar Blips]] - Iconițe Radar
*[[Sounds]] - Sunete
*[[Vehicle IDs]] - Lista mașiniilor din joc
*[[Vehicle Colors]] - Toate culoriile de pe mașini
*[[Vehicle Upgrades]] - Toate modificarile de pe mașini
*[[Vehicle variants|Vehicle Variants]] - Toate variantele de pe mașini
*[[Vehicle component manipulation]] - Despre componentele mașiniilor
*[[Weapons|Weapons]] - Despre Arme
*[[Weather]] - Vremea din joc
</div>
</div> 
</div> 


<div style="display: flex; flex-wrap: wrap; align-items: center; padding-left: 15px; padding-right: 15px;" class="plainlinks">
[[File:MTALogo_8ball.png||85px|link=Archive]]

<div style="display: flex; flex-wrap: wrap;>
<div style="margin-right: 5em;">
'''Despre [[Multi Theft Auto]]''' 
[[Archive]] 
[[Press Coverage]] 
[https://github.com/multitheftauto/mtasa-blue/graphs/contributors Developers]
</div>

<div style="margin-right: 5em;">
'''Multi Theft Auto 0.5''' 
[[Archive#Multi_Theft_Auto_0.5|Download]] 
[[MTA 0.5r2 Known Issues|Known Issues]]
</div>

<div style="margin-right: 5em;">
'''Statistici Wiki''' 
{{NUMBEROFARTICLES}} Articole 
{{NUMBEROFPAGES}} Pagini 
{{NUMBEROFUSERS}} Utilizatori Înregistrați 
</div>

<div>
[[File:Osi symbol.png|75px|link=https://opensource.org/|left]]
'''Multi Theft Auto''' este '''Open Source'''.
 Aceasta înseamnă că oricine poate contribui la îmbunătățirea Multi Theft Auto!
</div>
</div>

</div>

__NOTOC__
__NOEDITSECTION__
{{Languages list|en}}

RO/Main Page

2023-03-15T16:53:27Z

Hydra:

<div style="display: flex; align-items: center; padding-left: 15px; padding-right: 15px;">
[[File:Mtalogo.png||100px|link=https://wiki.multitheftauto.com/]]
<div style="margin-left: .5em">
'''Bine ai venit pe wiki-ul [[Multi Theft Auto]]''' Pe acest wiki veți găsi o mulțime de informații despre utilizarea Multi Theft Auto.

Există multe [[How you can help|things you can do to help us]] îmbunătățiți MTA - creați o hartă, un mod de joc, ajutați la documentarea funcțiilor de scripting, scrieți cod exemplu, scrieți tutoriale sau doar jucați MTA și raportați erorile pe care le găsiți.

Dacă aveți întrebări sau probleme legate de scripting, nu ezitați să ne contactați [[Places To Chat#Scripting Help|Discord]].

[ Oprește-te să te mai joci singur ]
</div>
</div>

<div style="display: flex; flex-direction: row; flex-wrap: wrap;">

<div style="flex-grow: 1"> 
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px; background: #FFFCF2;">
<div style="float:right; width: 32px;">[[File:Input-gaming.png‎|link=]]</div>
<h3>Play</h3>
<div style="background: #FFEEAA; border: 1px solid #FFCD19;">
[[File:Go-down.png|link=https://multitheftauto.com/]] ''' [https://multitheftauto.com/ Descarcă Multi Theft Auto: San Andreas {{Current Version|full}}]'''</div>
* [[Where to buy GTASA]] - De unde poți cumpăra GTA:SA.
* [[Client Manual]] - Manual Client

* [[Changes_in_{{padleft:|5|{{Current Version|full}}}}|Changes in {{padleft:|5|{{Current Version|full}}}}]]
* [[Known_Issues_-_FAQ|Known Issues]] - Probleme Cunoscute
* [[Server Manual]] - Manual Server
* [[Map manager|Map Manager]] - Manager Hărți

<h3>Editarea Mapei</h3>
*[[Resource:Editor|Manual]]
*[[Resource:Editor/EDF|Editor Definition Format]]
*[[Resource:Editor/Plugins|Plugins]]
*[[Resource:Editor#FAQ|Frequently Asked Questions]]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Package-x-generic.png‎|link=]]</div>
<h3>Baza de date</h3>
Această secțiune prezintă toate capabilitățile Lua pe care MTA sau resursele le oferă.
* [[:Category:Resource|Resource Catalogue]] - Trebuie să le înveți pentru a crea scripturi adecvate
* [[Client side scripts]] - Script-uri de tip client-side
* [[Modules]] - Module pentru Multi Theft Auto
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Applications-development.png‎‎‎|link=]]</div>
<h3>Dezvoltarea Multi Theft Auto</h3>
[[File:Go-down.png|link=https://nightly.mtasa.com/]] [https://nightly.mtasa.com/ Nightly builds]
* [[Compiling_MTASA|Compiling MTASA on Windows]] - Creează-ți propiul launcher

* [[Building_MTASA_Server_on_GNU_Linux|Compiling MTASA on GNU/Linux]]
* [[Coding guidelines]]
* [https://github.com/multitheftauto/mtasa-blue Main GitHub repository]
* [[Roadmap]]
* [https://github.com/multitheftauto/mtasa-blue/issues Bugtracker]
* [[Branches]]
*[[Forks|Forks and anti cheat]] - Despre proiecte propii si despre sistemul împotriva trișării
</div>
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Applications-office.png|link=]]</div>
<h3>Wiki - Cum poți ajuta</h3>
* Finalizați documentația pentru categoriile incomplete -> [[:Category:Incomplete|Incomplete functions]].
* Adăuga-ti exemple la funcții si event-uri [[:Category:Needs_Example |Add examples to functions and events]].
* Examinați și verificați [[:Category:Needs Checking|pages that need checking]].
* Scrie tutoriale pentru a ajuta oamenii noi.
* Traduceți pagini wiki.
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Internet-group-chat.png‎|link=]]</div>
<h3>Comunitate</h3>
* [https://forum.multitheftauto.com/ Forum] - Forum-ul official.
* Serverul de discord al comunității: [https://discord.com/invite/mtasa Official MTA Discord server] ([https://forum.multitheftauto.com/topic/95008-multi-theft-autos-official-discord-server/ Forum post])
* Serverul de discord pentru dezvoltarea proiectului: [https://discord.com/invite/GNN6PRtTnu Server invite link]
* [https://community.multitheftauto.com/ MTA Community] - Share and download resources.
* [https://www.youtube.com/user/MTAQA YouTube] - [https://www.facebook.com/multitheftauto Facebook] - [https://www.moddb.com/mods/multi-theft-auto-san-andreas ModDB]
</div>
</div> 

<div style="flex-grow: 1"> 
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Accessories-text-editor.png|link=]]</div>
<h3>Scripting</h3>
* [[Scripting Introduction|Introduction to Scripting]] - Primii pasi pentru a incepe sa scriptezi
* [[Introduction to Scripting the GUI]] - Incepe sa creezi interfațe pe serverul tău
* [[Debugging|Debugging Tutorial]] - Cum să găsiți erori în scripturile dvs
* [[Resources|Introduction to Resources]] - Totul despre resurse
** [[Resource Web Access]] - Cum poți scrie site-uri web cu resurse
** [[CEF_Tutorial|CEF Tutorial]] - Cum puteți utiliza browserul web din joc în resursele dvs
** [[:Category:Resource|Resource Catalogue]]
** [[Meta.xml]] - În spatele fiecărei resurse se află un fișier meta care o definește
** [[ACL]] - Lista de control al accesului, aceasta este vitală pentru ca scripturile complexe să funcționeze
* [[Writing_Gamemodes|Writing Gamemodes]] - Cum să îți faci un mod de joc
Link-uri Forum
* [https://forum.multitheftauto.com/forum/71-scripting/ Scripting Sub-Forum], [https://forum.multitheftauto.com/forum/123-tutorials/ Scripting Tutorials Sub-Forum]
* [https://forum.multitheftauto.com/topic/24702-mtasa-wiki-offline-copies-online-mirrors/ Offline Wiki Copies]
<div style="float:right; width: 32px;">[[File:start-here.png|link=]]</div>
<h3>General Lua Help</h3>
Pagini concepute pentru a vă ajuta să înțelegeți Lua
*[http://www.lua.org/pil/index.html "Programming in Lua" Manual]
**[http://www.lua.org/manual/5.1/#index Internal Lua functions reference]
*[http://lua-users.org/wiki/TutorialDirectory Lua Wiki]
*[http://nixstaller.sourceforge.net/manual/0.5.1/nixstaller_10.html A general guide to Lua from Nixstaller]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px; background:#F2F2FF;">
<div style="float:right; width: 32px;">[[File:Preferences-system.png|link=]]</div>
<h3>Reference</h3>
* [[Client Scripting Functions|Client-side Functions]]
* [[Client Scripting Events|Client-side Events]]
* [[Server Scripting Functions|Server-side Functions]]
* [[Server Scripting Events|Server-side Events]]
* [[Useful Functions]]

* [[MTA Classes]] - Descrieri detaliate ale tuturor claselor personalizate pe MTA
** [[Element|MTA Elements]] / [[Element tree]]
</div>
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:System-file-manager.png|link=]]</div>
<h3>[[Id|ID Lists]]</h3>
*[[Animations|Animations]] - Toate animațiile din GTA
*[[Character Skins]] - Toate personajele din GTA
*[[CJ_Clothes|Clothing styles]] - Toate hainele de pe CJ
*[[Garage|Garage IDs]] - Lista Garajelor din joc
*[[Interior IDs]] - Lista Interioarelor din joc
*[[Material IDs]] - Lista Materialelor din joc
*[[Ped voices|Ped Voices]]
*[[Projectiles]] - Proiectile
*[[Radar Blips]] - Iconițe Radar
*[[Sounds]] - Sunete
*[[Vehicle IDs]] - Lista mașiniilor din joc
*[[Vehicle Colors]] - Toate culoriile de pe mașini
*[[Vehicle Upgrades]] - Toate modificarile de pe mașini
*[[Vehicle variants|Vehicle Variants]] - Toate variantele de pe mașini
*[[Vehicle component manipulation]] - Despre componentele mașiniilor
*[[Weapons|Weapons]] - Despre Arme
*[[Weather]] - Vremea din joc
</div>
</div> 
</div> 


<div style="display: flex; flex-wrap: wrap; align-items: center; padding-left: 15px; padding-right: 15px;" class="plainlinks">
[[File:MTALogo_8ball.png||85px|link=Archive]]

<div style="display: flex; flex-wrap: wrap;>
<div style="margin-right: 5em;">
'''Despre [[Multi Theft Auto]]''' 
[[Archive]] 
[[Press Coverage]] 
[https://github.com/multitheftauto/mtasa-blue/graphs/contributors Developers]
</div>

<div style="margin-right: 5em;">
'''Multi Theft Auto 0.5''' 
[[Archive#Multi_Theft_Auto_0.5|Download]] 
[[MTA 0.5r2 Known Issues|Known Issues]]
</div>

<div style="margin-right: 5em;">
'''Statistici Wiki''' 
{{NUMBEROFARTICLES}} Articole 
{{NUMBEROFPAGES}} Pagini 
{{NUMBEROFUSERS}} Utilizatori Înregistrați 
</div>

<div>
[[File:Osi symbol.png|75px|link=https://opensource.org/|left]]
'''Multi Theft Auto''' este '''Open Source'''.
 Aceasta înseamnă că oricine poate contribui la îmbunătățirea Multi Theft Auto!
</div>
</div>

</div>

__NOTOC__
__NOEDITSECTION__
{{Languages list|en}}

RO/Main Page

2023-03-15T16:48:48Z

Hydra:

<div style="display: flex; align-items: center; padding-left: 15px; padding-right: 15px;">
[[File:Mtalogo.png||100px|link=https://wiki.multitheftauto.com/]]
<div style="margin-left: .5em">
'''Bine ai venit pe wiki-ul [[Multi Theft Auto]]''' Pe acest wiki veți găsi o mulțime de informații despre utilizarea Multi Theft Auto.

Există multe [[How you can help|things you can do to help us]] îmbunătățiți MTA - creați o hartă, un mod de joc, ajutați la documentarea funcțiilor de scripting, scrieți cod exemplu, scrieți tutoriale sau doar jucați MTA și raportați erorile pe care le găsiți.

Dacă aveți întrebări sau probleme legate de scripting, nu ezitați să ne contactați [[Places To Chat#Scripting Help|Discord]].

[ Oprește-te să te mai joci singur ]
</div>
</div>

<div style="display: flex; flex-direction: row; flex-wrap: wrap;">

<div style="flex-grow: 1"> 
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px; background: #FFFCF2;">
<div style="float:right; width: 32px;">[[File:Input-gaming.png‎|link=]]</div>
<h3>Play</h3>
<div style="background: #FFEEAA; border: 1px solid #FFCD19;">
[[File:Go-down.png|link=https://multitheftauto.com/]] ''' [https://multitheftauto.com/ Descarcă Multi Theft Auto: San Andreas {{Current Version|full}}]'''</div>
* [[Where to buy GTASA]] - De unde poți cumpăra GTA:SA.
* [[Client Manual]] - Manual Client

* [[Changes_in_{{padleft:|5|{{Current Version|full}}}}|Changes in {{padleft:|5|{{Current Version|full}}}}]]
* [[Known_Issues_-_FAQ|Known Issues]] - Probleme Cunoscute
* [[Server Manual]] - Manual Server
* [[Map manager|Map Manager]] - Manager Hărți

<h3>Editarea Mapei</h3>
*[[Resource:Editor|Manual]]
*[[Resource:Editor/EDF|Editor Definition Format]]
*[[Resource:Editor/Plugins|Plugins]]
*[[Resource:Editor#FAQ|Frequently Asked Questions]]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Package-x-generic.png‎|link=]]</div>
<h3>Baza de date</h3>
Această secțiune prezintă toate capabilitățile Lua pe care MTA sau resursele le oferă.
* [[:Category:Resource|Resource Catalogue]] - Trebuie să le înveți pentru a crea scripturi adecvate
* [[Client side scripts]] - Script-uri de tip client-side
* [[Modules]] - Module pentru Multi Theft Auto
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Applications-development.png‎‎‎|link=]]</div>
<h3>Dezvoltarea Multi Theft Auto</h3>
[[File:Go-down.png|link=https://nightly.mtasa.com/]] [https://nightly.mtasa.com/ Nightly builds]
* [[Compiling_MTASA|Compiling MTASA on Windows]] - Creează-ți propiul launcher

* [[Building_MTASA_Server_on_GNU_Linux|Compiling MTASA on GNU/Linux]]
* [[Coding guidelines]]
* [https://github.com/multitheftauto/mtasa-blue Main GitHub repository]
* [[Roadmap]]
* [https://github.com/multitheftauto/mtasa-blue/issues Bugtracker]
* [[Branches]]
*[[Forks|Forks and anti cheat]] - Despre proiecte propii si despre sistemul împotriva trișării
</div>
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Applications-office.png|link=]]</div>
<h3>Wiki - Cum poți ajuta</h3>
* Finalizați documentația pentru categoriile incomplete -> [[:Category:Incomplete|Incomplete functions]].
* Adăuga-ti exemple la funcții si event-uri [[:Category:Needs_Example |Add examples to functions and events]].
* Examinați și verificați [[:Category:Needs Checking|pages that need checking]].
* Scrie tutoriale pentru a ajuta oamenii noi.
* Traduceți pagini wiki.
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Internet-group-chat.png‎|link=]]</div>
<h3>Comunitate</h3>
* [https://forum.multitheftauto.com/ Forum] - Forum-ul official.
* Serverul de discord al comunității: [https://discord.com/invite/mtasa Official MTA Discord server] ([https://forum.multitheftauto.com/topic/95008-multi-theft-autos-official-discord-server/ Forum post])
* Serverul de discord pentru dezvoltarea proiectului: [https://discord.com/invite/GNN6PRtTnu Server invite link]
* [https://community.multitheftauto.com/ MTA Community] - Share and download resources.
* [https://www.youtube.com/user/MTAQA YouTube] - [https://www.facebook.com/multitheftauto Facebook] - [https://www.moddb.com/mods/multi-theft-auto-san-andreas ModDB]
</div>
</div> 

<div style="flex-grow: 1"> 
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Accessories-text-editor.png|link=]]</div>
<h3>Scripting</h3>
* [[Scripting Introduction|Introduction to Scripting]] - Primii pasi pentru a incepe sa scriptezi
* [[Introduction to Scripting the GUI]] - Incepe sa creezi interfațe pe serverul tău
* [[Debugging|Debugging Tutorial]] - Cum să găsiți erori în scripturile dvs
* [[Resources|Introduction to Resources]] - Totul despre resurse
** [[Resource Web Access]] - Cum poți scrie site-uri web cu resurse
** [[CEF_Tutorial|CEF Tutorial]] - Cum puteți utiliza browserul web din joc în resursele dvs
** [[:Category:Resource|Resource Catalogue]]
** [[Meta.xml]] - În spatele fiecărei resurse se află un fișier meta care o definește
** [[ACL]] - Lista de control al accesului, aceasta este vitală pentru ca scripturile complexe să funcționeze
* [[Writing_Gamemodes|Writing Gamemodes]] - Cum să îți faci un mod de joc
Link-uri Forum
* [https://forum.multitheftauto.com/forum/71-scripting/ Scripting Sub-Forum], [https://forum.multitheftauto.com/forum/123-tutorials/ Scripting Tutorials Sub-Forum]
* [https://forum.multitheftauto.com/topic/24702-mtasa-wiki-offline-copies-online-mirrors/ Offline Wiki Copies]
<div style="float:right; width: 32px;">[[File:start-here.png|link=]]</div>
<h3>General Lua Help</h3>
Pagini concepute pentru a vă ajuta să înțelegeți Lua
*[http://www.lua.org/pil/index.html "Programming in Lua" Manual]
**[http://www.lua.org/manual/5.1/#index Internal Lua functions reference]
*[http://lua-users.org/wiki/TutorialDirectory Lua Wiki]
*[http://nixstaller.sourceforge.net/manual/0.5.1/nixstaller_10.html A general guide to Lua from Nixstaller]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px; background:#F2F2FF;">
<div style="float:right; width: 32px;">[[File:Preferences-system.png|link=]]</div>
<h3>Reference</h3>
* [[Client Scripting Functions|Client-side Functions]]
* [[Client Scripting Events|Client-side Events]]
* [[Server Scripting Functions|Server-side Functions]]
* [[Server Scripting Events|Server-side Events]]
* [[Useful Functions]]

* [[MTA Classes]] - Descrieri detaliate ale tuturor tipurilor personalizate MTA
** [[Element|MTA Elements]] / [[Element tree]]
</div>
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:System-file-manager.png|link=]]</div>
<h3>[[Id|ID Lists]]</h3>
*[[Animations|Animations]]
*[[Character Skins]]
*[[CJ_Clothes|Clothing styles]]
*[[Garage|Garage IDs]]
*[[Interior IDs]]
*[[Material IDs]]
*[[Ped voices|Ped Voices]]
*[[Projectiles]]
*[[Radar Blips]]
*[[Sounds]]
*[[Vehicle IDs]]
*[[Vehicle Colors]]
*[[Vehicle Upgrades]]
*[[Vehicle variants|Vehicle Variants]]
*[[Vehicle component manipulation]]
*[[Weapons|Weapons]]
*[[Weather]]
</div>
</div> 
</div> 


<div style="display: flex; flex-wrap: wrap; align-items: center; padding-left: 15px; padding-right: 15px;" class="plainlinks">
[[File:MTALogo_8ball.png||85px|link=Archive]]

<div style="display: flex; flex-wrap: wrap;>
<div style="margin-right: 5em;">
'''Despre [[Multi Theft Auto]]''' 
[[Archive]] 
[[Press Coverage]] 
[https://github.com/multitheftauto/mtasa-blue/graphs/contributors Developers]
</div>

<div style="margin-right: 5em;">
'''Multi Theft Auto 0.5''' 
[[Archive#Multi_Theft_Auto_0.5|Download]] 
[[MTA 0.5r2 Known Issues|Known Issues]]
</div>

<div style="margin-right: 5em;">
'''Statistici Wiki''' 
{{NUMBEROFARTICLES}} Articole 
{{NUMBEROFPAGES}} Pagini 
{{NUMBEROFUSERS}} Utilizatori Înregistrați 
</div>

<div>
[[File:Osi symbol.png|75px|link=https://opensource.org/|left]]
'''Multi Theft Auto''' este '''Open Source'''.
 Aceasta înseamnă că oricine poate contribui la îmbunătățirea Multi Theft Auto!
</div>
</div>

</div>

__NOTOC__
__NOEDITSECTION__
{{Languages list|en}}

RO/Main Page

2023-03-15T16:44:22Z

Hydra:

<div style="display: flex; align-items: center; padding-left: 15px; padding-right: 15px;">
[[File:Mtalogo.png||100px|link=https://wiki.multitheftauto.com/]]
<div style="margin-left: .5em">
'''Bine ai venit pe wiki-ul [[Multi Theft Auto]]''' Pe acest wiki veți găsi o mulțime de informații despre utilizarea Multi Theft Auto.

Există multe [[How you can help|things you can do to help us]] îmbunătățiți MTA - creați o hartă, un mod de joc, ajutați la documentarea funcțiilor de scripting, scrieți cod exemplu, scrieți tutoriale sau doar jucați MTA și raportați erorile pe care le găsiți.

Dacă aveți întrebări sau probleme legate de scripting, nu ezitați să ne contactați [[Places To Chat#Scripting Help|Discord]].

[ Oprește-te să te mai joci singur ]
</div>
</div>

<div style="display: flex; flex-direction: row; flex-wrap: wrap;">

<div style="flex-grow: 1"> 
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px; background: #FFFCF2;">
<div style="float:right; width: 32px;">[[File:Input-gaming.png‎|link=]]</div>
<h3>Play</h3>
<div style="background: #FFEEAA; border: 1px solid #FFCD19;">
[[File:Go-down.png|link=https://multitheftauto.com/]] ''' [https://multitheftauto.com/ Descarcă Multi Theft Auto: San Andreas {{Current Version|full}}]'''</div>
* [[Where to buy GTASA]] - De unde poți cumpăra GTA:SA.
* [[Client Manual]] - Manual Client

* [[Changes_in_{{padleft:|5|{{Current Version|full}}}}|Changes in {{padleft:|5|{{Current Version|full}}}}]]
* [[Known_Issues_-_FAQ|Known Issues]] - Probleme Cunoscute
* [[Server Manual]] - Manual Server
* [[Map manager|Map Manager]] - Manager-ul Mapei

<h3>Editarea Mapei</h3>
*[[Resource:Editor|Manual]]
*[[Resource:Editor/EDF|Editor Definition Format]]
*[[Resource:Editor/Plugins|Plugins]]
*[[Resource:Editor#FAQ|Frequently Asked Questions]]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Package-x-generic.png‎|link=]]</div>
<h3>Baza de date</h3>
Această secțiune prezintă toate capabilitățile Lua pe care MTA sau resursele le oferă.
* [[:Category:Resource|Resource Catalogue]] - Trebuie să le înveți pentru a crea scripturi adecvate
* [[Client side scripts]] - Script-uri de tip client-side
* [[Modules]] - Module pentru Multi Theft Auto
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Applications-development.png‎‎‎|link=]]</div>
<h3>Dezvoltarea Multi Theft Auto</h3>
[[File:Go-down.png|link=https://nightly.mtasa.com/]] [https://nightly.mtasa.com/ Nightly builds]
* [[Compiling_MTASA|Compiling MTASA on Windows]] - Creează-ți propiul launcher

* [[Building_MTASA_Server_on_GNU_Linux|Compiling MTASA on GNU/Linux]]
* [[Coding guidelines]]
* [https://github.com/multitheftauto/mtasa-blue Main GitHub repository]
* [[Roadmap]]
* [https://github.com/multitheftauto/mtasa-blue/issues Bugtracker]
* [[Branches]]
*[[Forks|Forks and anti cheat]]
</div>
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Applications-office.png|link=]]</div>
<h3>Wiki - Cum poți ajuta</h3>
* Finalizați documentația pentru [[:Category:Incomplete|Incomplete functions]].
* [[:Category:Needs_Example |Add examples to functions and events]].
* Examinați și verificați [[:Category:Needs Checking|pages that need checking]].
* Scrie tutoriale pentru a ajuta oamenii noi.
* Traduceți pagini wiki.
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Internet-group-chat.png‎|link=]]</div>
<h3>Comunitate</h3>
* [https://forum.multitheftauto.com/ Forum]
* Serverul de discord al comunității: [https://discord.com/invite/mtasa Official MTA Discord server] ([https://forum.multitheftauto.com/topic/95008-multi-theft-autos-official-discord-server/ Forum post])
* Serverul de discord pentru dezvoltarea proiectului: [https://discord.com/invite/GNN6PRtTnu Server invite link]
* [https://community.multitheftauto.com/ MTA Community] - Share and download resources.
* [https://www.youtube.com/user/MTAQA YouTube] - [https://www.facebook.com/multitheftauto Facebook] - [https://www.moddb.com/mods/multi-theft-auto-san-andreas ModDB]
</div>
</div> 

<div style="flex-grow: 1"> 
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Accessories-text-editor.png|link=]]</div>
<h3>Scripting</h3>
* [[Scripting Introduction|Introduction to Scripting]]
* [[Introduction to Scripting the GUI]]
* [[Debugging|Debugging Tutorial]] - Cum să găsiți erori în scripturile dvs
* [[Resources|Introduction to Resources]]
** [[Resource Web Access]] - Cum poți scrie site-uri web cu resurse
** [[CEF_Tutorial|CEF Tutorial]] - Cum puteți utiliza browserul web din joc în resursele dvs
** [[:Category:Resource|Resource Catalogue]]
** [[Meta.xml]] - În spatele fiecărei resurse se află un fișier meta care o definește
** [[ACL]] - Lista de control al accesului, aceasta este vitală pentru ca scripturile complexe să funcționeze
* [[Writing_Gamemodes|Writing Gamemodes]]
Link-uri Forum
* [https://forum.multitheftauto.com/forum/71-scripting/ Scripting Sub-Forum], [https://forum.multitheftauto.com/forum/123-tutorials/ Scripting Tutorials Sub-Forum]
* [https://forum.multitheftauto.com/topic/24702-mtasa-wiki-offline-copies-online-mirrors/ Offline Wiki Copies]
<div style="float:right; width: 32px;">[[File:start-here.png|link=]]</div>
<h3>General Lua Help</h3>
Pagini concepute pentru a vă ajuta să înțelegeți Lua
*[http://www.lua.org/pil/index.html "Programming in Lua" Manual]
**[http://www.lua.org/manual/5.1/#index Internal Lua functions reference]
*[http://lua-users.org/wiki/TutorialDirectory Lua Wiki]
*[http://nixstaller.sourceforge.net/manual/0.5.1/nixstaller_10.html A general guide to Lua from Nixstaller]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px; background:#F2F2FF;">
<div style="float:right; width: 32px;">[[File:Preferences-system.png|link=]]</div>
<h3>Reference</h3>
* [[Client Scripting Functions|Client-side Functions]]
* [[Client Scripting Events|Client-side Events]]
* [[Server Scripting Functions|Server-side Functions]]
* [[Server Scripting Events|Server-side Events]]
* [[Useful Functions]]

* [[MTA Classes]] - Descrieri detaliate ale tuturor tipurilor personalizate MTA
** [[Element|MTA Elements]] / [[Element tree]]
</div>
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:System-file-manager.png|link=]]</div>
<h3>[[Id|ID Lists]]</h3>
*[[Animations|Animations]]
*[[Character Skins]]
*[[CJ_Clothes|Clothing styles]]
*[[Garage|Garage IDs]]
*[[Interior IDs]]
*[[Material IDs]]
*[[Ped voices|Ped Voices]]
*[[Projectiles]]
*[[Radar Blips]]
*[[Sounds]]
*[[Vehicle IDs]]
*[[Vehicle Colors]]
*[[Vehicle Upgrades]]
*[[Vehicle variants|Vehicle Variants]]
*[[Vehicle component manipulation]]
*[[Weapons|Weapons]]
*[[Weather]]
</div>
</div> 
</div> 


<div style="display: flex; flex-wrap: wrap; align-items: center; padding-left: 15px; padding-right: 15px;" class="plainlinks">
[[File:MTALogo_8ball.png||85px|link=Archive]]

<div style="display: flex; flex-wrap: wrap;>
<div style="margin-right: 5em;">
'''Despre [[Multi Theft Auto]]''' 
[[Archive]] 
[[Press Coverage]] 
[https://github.com/multitheftauto/mtasa-blue/graphs/contributors Developers]
</div>

<div style="margin-right: 5em;">
'''Multi Theft Auto 0.5''' 
[[Archive#Multi_Theft_Auto_0.5|Download]] 
[[MTA 0.5r2 Known Issues|Known Issues]]
</div>

<div style="margin-right: 5em;">
'''Statistici Wiki''' 
{{NUMBEROFARTICLES}} Articole 
{{NUMBEROFPAGES}} Pagini 
{{NUMBEROFUSERS}} Utilizatori Înregistrați 
</div>

<div>
[[File:Osi symbol.png|75px|link=https://opensource.org/|left]]
'''Multi Theft Auto''' este '''Open Source'''.
 Aceasta înseamnă că oricine poate contribui la îmbunătățirea Multi Theft Auto!
</div>
</div>

</div>

__NOTOC__
__NOEDITSECTION__
{{Languages list|en}}

RO/Main Page

2023-03-15T16:41:48Z

Hydra:

<div style="display: flex; align-items: center; padding-left: 15px; padding-right: 15px;">
[[File:Mtalogo.png||100px|link=https://wiki.multitheftauto.com/]]
<div style="margin-left: .5em">
'''Bine ai venit pe wiki-ul [[Multi Theft Auto]]''' Pe acest wiki veți găsi o mulțime de informații despre utilizarea Multi Theft Auto.

Există multe [[How you can help|things you can do to help us]] îmbunătățiți MTA - creați o hartă, un mod de joc, ajutați la documentarea funcțiilor de scripting, scrieți cod exemplu, scrieți tutoriale sau doar jucați MTA și raportați erorile pe care le găsiți.

Dacă aveți întrebări sau probleme legate de scripting, nu ezitați să ne contactați [[Places To Chat#Scripting Help|Discord]].

[ Oprește-te să te mai joci singur ]
</div>
</div>

<div style="display: flex; flex-direction: row; flex-wrap: wrap;">

<div style="flex-grow: 1"> 
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px; background: #FFFCF2;">
<div style="float:right; width: 32px;">[[File:Input-gaming.png‎|link=]]</div>
<h3>Play</h3>
<div style="background: #FFEEAA; border: 1px solid #FFCD19;">
[[File:Go-down.png|link=https://multitheftauto.com/]] ''' [https://multitheftauto.com/ Descarcă Multi Theft Auto: San Andreas {{Current Version|full}}]'''</div>
* [[Where to buy GTASA]]
* [[Client Manual]]

* [[Changes_in_{{padleft:|5|{{Current Version|full}}}}|Changes in {{padleft:|5|{{Current Version|full}}}}]]
* [[Known_Issues_-_FAQ|Known Issues]]
* [[Server Manual]]
* [[Map manager|Map Manager]]

<h3>Editarea Mapei</h3>
*[[Resource:Editor|Manual]]
*[[Resource:Editor/EDF|Editor Definition Format]]
*[[Resource:Editor/Plugins|Plugins]]
*[[Resource:Editor#FAQ|Frequently Asked Questions]]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Package-x-generic.png‎|link=]]</div>
<h3>Baza de date</h3>
Această secțiune prezintă toate capabilitățile Lua pe care MTA sau resursele le oferă.
* [[:Category:Resource|Resource Catalogue]] - Trebuie să le înveți pentru a crea scripturi adecvate
* [[Client side scripts]]
* [[Modules]]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Applications-development.png‎‎‎|link=]]</div>
<h3>Dezvoltarea Multi Theft Auto</h3>
[[File:Go-down.png|link=https://nightly.mtasa.com/]] [https://nightly.mtasa.com/ Nightly builds]
* [[Compiling_MTASA|Compiling MTASA on Windows]]

* [[Building_MTASA_Server_on_GNU_Linux|Compiling MTASA on GNU/Linux]]
* [[Coding guidelines]]
* [https://github.com/multitheftauto/mtasa-blue Main GitHub repository]
* [[Roadmap]]
* [https://github.com/multitheftauto/mtasa-blue/issues Bugtracker]
* [[Branches]]
*[[Forks|Forks and anti cheat]]
</div>
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Applications-office.png|link=]]</div>
<h3>Wiki - Cum poți ajuta</h3>
* Finalizați documentația pentru [[:Category:Incomplete|Incomplete functions]].
* [[:Category:Needs_Example |Add examples to functions and events]].
* Examinați și verificați [[:Category:Needs Checking|pages that need checking]].
* Scrie tutoriale pentru a ajuta oamenii noi.
* Traduceți pagini wiki.
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Internet-group-chat.png‎|link=]]</div>
<h3>Comunitate</h3>
* [https://forum.multitheftauto.com/ Forum]
* Serverul de discord al comunității: [https://discord.com/invite/mtasa Official MTA Discord server] ([https://forum.multitheftauto.com/topic/95008-multi-theft-autos-official-discord-server/ Forum post])
* Serverul de discord pentru dezvoltarea proiectului: [https://discord.com/invite/GNN6PRtTnu Server invite link]
* [https://community.multitheftauto.com/ MTA Community] - Share and download resources.
* [https://www.youtube.com/user/MTAQA YouTube] - [https://www.facebook.com/multitheftauto Facebook] - [https://www.moddb.com/mods/multi-theft-auto-san-andreas ModDB]
</div>
</div> 

<div style="flex-grow: 1"> 
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Accessories-text-editor.png|link=]]</div>
<h3>Scripting</h3>
* [[Scripting Introduction|Introduction to Scripting]]
* [[Introduction to Scripting the GUI]]
* [[Debugging|Debugging Tutorial]] - Cum să găsiți erori în scripturile dvs
* [[Resources|Introduction to Resources]]
** [[Resource Web Access]] - Cum poți scrie site-uri web cu resurse
** [[CEF_Tutorial|CEF Tutorial]] - Cum puteți utiliza browserul web din joc în resursele dvs
** [[:Category:Resource|Resource Catalogue]]
** [[Meta.xml]] - În spatele fiecărei resurse se află un fișier meta care o definește
** [[ACL]] - Lista de control al accesului, aceasta este vitală pentru ca scripturile complexe să funcționeze
* [[Writing_Gamemodes|Writing Gamemodes]]
Link-uri Forum
* [https://forum.multitheftauto.com/forum/71-scripting/ Scripting Sub-Forum], [https://forum.multitheftauto.com/forum/123-tutorials/ Scripting Tutorials Sub-Forum]
* [https://forum.multitheftauto.com/topic/24702-mtasa-wiki-offline-copies-online-mirrors/ Offline Wiki Copies]
<div style="float:right; width: 32px;">[[File:start-here.png|link=]]</div>
<h3>General Lua Help</h3>
Pagini concepute pentru a vă ajuta să înțelegeți Lua
*[http://www.lua.org/pil/index.html "Programming in Lua" Manual]
**[http://www.lua.org/manual/5.1/#index Internal Lua functions reference]
*[http://lua-users.org/wiki/TutorialDirectory Lua Wiki]
*[http://nixstaller.sourceforge.net/manual/0.5.1/nixstaller_10.html A general guide to Lua from Nixstaller]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px; background:#F2F2FF;">
<div style="float:right; width: 32px;">[[File:Preferences-system.png|link=]]</div>
<h3>Reference</h3>
* [[Client Scripting Functions|Client-side Functions]]
* [[Client Scripting Events|Client-side Events]]
* [[Server Scripting Functions|Server-side Functions]]
* [[Server Scripting Events|Server-side Events]]
* [[Useful Functions]]

* [[MTA Classes]] - Descrieri detaliate ale tuturor tipurilor personalizate MTA
** [[Element|MTA Elements]] / [[Element tree]]
</div>
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:System-file-manager.png|link=]]</div>
<h3>[[Id|ID Lists]]</h3>
*[[Animations|Animations]]
*[[Character Skins]]
*[[CJ_Clothes|Clothing styles]]
*[[Garage|Garage IDs]]
*[[Interior IDs]]
*[[Material IDs]]
*[[Ped voices|Ped Voices]]
*[[Projectiles]]
*[[Radar Blips]]
*[[Sounds]]
*[[Vehicle IDs]]
*[[Vehicle Colors]]
*[[Vehicle Upgrades]]
*[[Vehicle variants|Vehicle Variants]]
*[[Vehicle component manipulation]]
*[[Weapons|Weapons]]
*[[Weather]]
</div>
</div> 
</div> 


<div style="display: flex; flex-wrap: wrap; align-items: center; padding-left: 15px; padding-right: 15px;" class="plainlinks">
[[File:MTALogo_8ball.png||85px|link=Archive]]

<div style="display: flex; flex-wrap: wrap;>
<div style="margin-right: 5em;">
'''Despre [[Multi Theft Auto]]''' 
[[Archive]] 
[[Press Coverage]] 
[https://github.com/multitheftauto/mtasa-blue/graphs/contributors Developers]
</div>

<div style="margin-right: 5em;">
'''Multi Theft Auto 0.5''' 
[[Archive#Multi_Theft_Auto_0.5|Download]] 
[[MTA 0.5r2 Known Issues|Known Issues]]
</div>

<div style="margin-right: 5em;">
'''Statistici Wiki''' 
{{NUMBEROFARTICLES}} Articole 
{{NUMBEROFPAGES}} Pagini 
{{NUMBEROFUSERS}} Utilizatori Înregistrați 
</div>

<div>
[[File:Osi symbol.png|75px|link=https://opensource.org/|left]]
'''Multi Theft Auto''' este '''Open Source'''.
 Aceasta înseamnă că oricine poate contribui la îmbunătățirea Multi Theft Auto!
</div>
</div>

</div>

__NOTOC__
__NOEDITSECTION__
{{Languages list|en}}

RO/Main Page

2023-03-15T16:40:17Z

Hydra: Created page with "<div style="display: flex; align-items: center; padding-left: 15px; padding-right: 15px;"> link=https://wiki.multitheftauto.com/ <div style="margin-left: .5em"> '''Bine ai venit pe wiki-ul Multi Theft Auto''' Pe acest wiki veți găsi o mulțime de informații despre utilizarea Multi Theft Auto. Există multe things you can do to help us îmbunătățiți MTA - creați o hartă, un mod de joc, ajutați la documentare..."

<div style="display: flex; align-items: center; padding-left: 15px; padding-right: 15px;">
[[File:Mtalogo.png||100px|link=https://wiki.multitheftauto.com/]]
<div style="margin-left: .5em">
'''Bine ai venit pe wiki-ul [[Multi Theft Auto]]''' Pe acest wiki veți găsi o mulțime de informații despre utilizarea Multi Theft Auto.

Există multe [[How you can help|things you can do to help us]] îmbunătățiți MTA - creați o hartă, un mod de joc, ajutați la documentarea funcțiilor de scripting, scrieți cod exemplu, scrieți tutoriale sau doar jucați MTA și raportați erorile pe care le găsiți.

Dacă aveți întrebări sau probleme legate de scripting, nu ezitați să ne contactați [[Places To Chat#Scripting Help|Discord]].

[ Oprește-te să te mai joci singur ]
</div>
</div>

<div style="display: flex; flex-direction: row; flex-wrap: wrap;">

<div style="flex-grow: 1"> 
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px; background: #FFFCF2;">
<div style="float:right; width: 32px;">[[File:Input-gaming.png‎|link=]]</div>
<h3>Play</h3>
<div style="background: #FFEEAA; border: 1px solid #FFCD19;">
[[File:Go-down.png|link=https://multitheftauto.com/]] ''' [https://multitheftauto.com/ Download Multi Theft Auto: San Andreas {{Current Version|full}}]'''</div>
* [[Where to buy GTASA]]
* [[Client Manual]]

* [[Changes_in_{{padleft:|5|{{Current Version|full}}}}|Changes in {{padleft:|5|{{Current Version|full}}}}]]
* [[Known_Issues_-_FAQ|Known Issues]]
* [[Server Manual]]
* [[Map manager|Map Manager]]

<h3>Editarea Mapei</h3>
*[[Resource:Editor|Manual]]
*[[Resource:Editor/EDF|Editor Definition Format]]
*[[Resource:Editor/Plugins|Plugins]]
*[[Resource:Editor#FAQ|Frequently Asked Questions]]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Package-x-generic.png‎|link=]]</div>
<h3>Baza de date</h3>
Această secțiune prezintă toate capabilitățile Lua pe care MTA sau resursele le oferă.
* [[:Category:Resource|Resource Catalogue]] - Trebuie să le înveți pentru a crea scripturi adecvate
* [[Client side scripts]]
* [[Modules]]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Applications-development.png‎‎‎|link=]]</div>
<h3>Dezvoltarea Multi Theft Auto</h3>
[[File:Go-down.png|link=https://nightly.mtasa.com/]] [https://nightly.mtasa.com/ Nightly builds]
* [[Compiling_MTASA|Compiling MTASA on Windows]]

* [[Building_MTASA_Server_on_GNU_Linux|Compiling MTASA on GNU/Linux]]
* [[Coding guidelines]]
* [https://github.com/multitheftauto/mtasa-blue Main GitHub repository]
* [[Roadmap]]
* [https://github.com/multitheftauto/mtasa-blue/issues Bugtracker]
* [[Branches]]
*[[Forks|Forks and anti cheat]]
</div>
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Applications-office.png|link=]]</div>
<h3>Wiki - Cum poți ajuta</h3>
* Finalizați documentația pentru [[:Category:Incomplete|Incomplete functions]].
* [[:Category:Needs_Example |Add examples to functions and events]].
* Examinați și verificați [[:Category:Needs Checking|pages that need checking]].
* Scrie tutoriale pentru a ajuta oamenii noi.
* Traduceți pagini wiki.
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Internet-group-chat.png‎|link=]]</div>
<h3>Comunitate</h3>
* [https://forum.multitheftauto.com/ Forum]
* Serverul de discord al comunității: [https://discord.com/invite/mtasa Official MTA Discord server] ([https://forum.multitheftauto.com/topic/95008-multi-theft-autos-official-discord-server/ Forum post])
* Serverul de discord pentru dezvoltarea proiectului: [https://discord.com/invite/GNN6PRtTnu Server invite link]
* [https://community.multitheftauto.com/ MTA Community] - Share and download resources.
* [https://www.youtube.com/user/MTAQA YouTube] - [https://www.facebook.com/multitheftauto Facebook] - [https://www.moddb.com/mods/multi-theft-auto-san-andreas ModDB]
</div>
</div> 

<div style="flex-grow: 1"> 
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Accessories-text-editor.png|link=]]</div>
<h3>Scripting</h3>
* [[Scripting Introduction|Introduction to Scripting]]
* [[Introduction to Scripting the GUI]]
* [[Debugging|Debugging Tutorial]] - Cum să găsiți erori în scripturile dvs
* [[Resources|Introduction to Resources]]
** [[Resource Web Access]] - Cum poți scrie site-uri web cu resurse
** [[CEF_Tutorial|CEF Tutorial]] - Cum puteți utiliza browserul web din joc în resursele dvs
** [[:Category:Resource|Resource Catalogue]]
** [[Meta.xml]] - În spatele fiecărei resurse se află un fișier meta care o definește
** [[ACL]] - Lista de control al accesului, aceasta este vitală pentru ca scripturile complexe să funcționeze
* [[Writing_Gamemodes|Writing Gamemodes]]
Link-uri Forum
* [https://forum.multitheftauto.com/forum/71-scripting/ Scripting Sub-Forum], [https://forum.multitheftauto.com/forum/123-tutorials/ Scripting Tutorials Sub-Forum]
* [https://forum.multitheftauto.com/topic/24702-mtasa-wiki-offline-copies-online-mirrors/ Offline Wiki Copies]
<div style="float:right; width: 32px;">[[File:start-here.png|link=]]</div>
<h3>General Lua Help</h3>
Pagini concepute pentru a vă ajuta să înțelegeți Lua
*[http://www.lua.org/pil/index.html "Programming in Lua" Manual]
**[http://www.lua.org/manual/5.1/#index Internal Lua functions reference]
*[http://lua-users.org/wiki/TutorialDirectory Lua Wiki]
*[http://nixstaller.sourceforge.net/manual/0.5.1/nixstaller_10.html A general guide to Lua from Nixstaller]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px; background:#F2F2FF;">
<div style="float:right; width: 32px;">[[File:Preferences-system.png|link=]]</div>
<h3>Reference</h3>
* [[Client Scripting Functions|Client-side Functions]]
* [[Client Scripting Events|Client-side Events]]
* [[Server Scripting Functions|Server-side Functions]]
* [[Server Scripting Events|Server-side Events]]
* [[Useful Functions]]

* [[MTA Classes]] - Descrieri detaliate ale tuturor tipurilor personalizate MTA
** [[Element|MTA Elements]] / [[Element tree]]
</div>
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:System-file-manager.png|link=]]</div>
<h3>[[Id|ID Lists]]</h3>
*[[Animations|Animations]]
*[[Character Skins]]
*[[CJ_Clothes|Clothing styles]]
*[[Garage|Garage IDs]]
*[[Interior IDs]]
*[[Material IDs]]
*[[Ped voices|Ped Voices]]
*[[Projectiles]]
*[[Radar Blips]]
*[[Sounds]]
*[[Vehicle IDs]]
*[[Vehicle Colors]]
*[[Vehicle Upgrades]]
*[[Vehicle variants|Vehicle Variants]]
*[[Vehicle component manipulation]]
*[[Weapons|Weapons]]
*[[Weather]]
</div>
</div> 
</div> 


<div style="display: flex; flex-wrap: wrap; align-items: center; padding-left: 15px; padding-right: 15px;" class="plainlinks">
[[File:MTALogo_8ball.png||85px|link=Archive]]

<div style="display: flex; flex-wrap: wrap;>
<div style="margin-right: 5em;">
'''Despre [[Multi Theft Auto]]''' 
[[Archive]] 
[[Press Coverage]] 
[https://github.com/multitheftauto/mtasa-blue/graphs/contributors Developers]
</div>

<div style="margin-right: 5em;">
'''Multi Theft Auto 0.5''' 
[[Archive#Multi_Theft_Auto_0.5|Download]] 
[[MTA 0.5r2 Known Issues|Known Issues]]
</div>

<div style="margin-right: 5em;">
'''Statistici Wiki''' 
{{NUMBEROFARTICLES}} Articole 
{{NUMBEROFPAGES}} Pagini 
{{NUMBEROFUSERS}} Utilizatori Înregistrați 
</div>

<div>
[[File:Osi symbol.png|75px|link=https://opensource.org/|left]]
'''Multi Theft Auto''' este '''Open Source'''.
 Aceasta înseamnă că oricine poate contribui la îmbunătățirea Multi Theft Auto!
</div>
</div>

</div>

__NOTOC__
__NOEDITSECTION__
{{Languages list|en}}

RO/getPedArmor

2023-03-15T16:27:12Z

Hydra: Created page with "__NOTOC__ {{Server client function}} Această funcție returnează armura curentă unui ped specificat. ped ==Syntax== <syntaxhighlight lang="lua">float getPedArmor ( ped thePed )</syntaxhighlight> {{OOP||ped:getArmor|armor|setPedArmor}} ===Argumente Necesare=== *'''thePed:''' ped armura cui vrei sa ii verifici ===Returnează=== Un ''float'' cu armură, ''fals'' dacă a fost dat un ped invalid. ==Exemplu== <section name="Client" class="client" show="true"..."

__NOTOC__
{{Server client function}}
Această funcție returnează armura curentă unui ped specificat. [[ped]]

==Syntax==
<syntaxhighlight lang="lua">float getPedArmor ( ped thePed )</syntaxhighlight>
{{OOP||[[ped]]:getArmor|armor|setPedArmor}}

===Argumente Necesare===
*'''thePed:''' [[ped]] armura cui vrei sa ii verifici

===Returnează===
Un ''float'' cu armură, ''fals'' dacă a fost dat un ped invalid.

==Exemplu==
<section name="Client" class="client" show="true">
Acest exemplu definește o comandă cu numele „showarmor” care arată jucătorului care o execută cât de multă armură are.
<syntaxhighlight lang="lua">
function showArmor ( )
local armor = getPedArmor ( localPlayer )
outputChatBox( "Your armor: " .. armor )
end
addCommandHandler ( "showarmor", showArmor )
</syntaxhighlight>
</section>

==Vezi și==
{{Ped functions}}

[[en:getPedArmor]]

RO/createPed

2023-03-15T16:22:33Z

Hydra:

__NOTOC__
{{Server client function}}
Creează un ped în lumea GTA.

==Sintaxă==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">ped createPed ( int id model, float x, float y, float z [, float rotație = 0.0, bool sincronizat = true ] )</syntaxhighlight>

===Argumente Necesare===
*'''id model:''' Un număr care specifică modelul pielii [[Character_Skins|GTASA skin ID]].
*'''x:''' Un număr care reprezintă coordonatele X de pe hartă.
*'''y:''' Un număr care reprezintă coordonatele Y de pe hartă.
*'''z:''' Un număr care reprezintă coordonatele Z de pe hartă.

==Argumente Opționale==
{{OptionalArg}}
*'''rotație:''' Un număr care reprezintă rotația în grade.
*'''sincronizat:''' O valoare booleană care reprezintă dacă ped-ul va fi sau nu sincronizat. Dezactivarea sincronizării ar putea fi utilă pentru ped-urile înghețate sau statice pentru a crește performanța serverului.
</section>
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">ped createPed ( int id model, float x, float y, float z [, float rotație = 0.0 ] )</syntaxhighlight>

===Argumente Necesare===
*'''id model:''' Un număr care specifică modelul pielii [[Character_Skins|GTASA skin ID]].
*'''x:''' Un număr care reprezintă coordonatele X de pe hartă.
*'''y:''' Un număr care reprezintă coordonatele Y de pe hartă.
*'''z:''' Un număr care reprezintă coordonatele Z de pe hartă.

==Argumente Opționale==
{{OptionalArg}}
*'''rotație:''' Un număr care reprezintă rotația în grade.
</section>

===Returnează===
Returnează un element ped dacă a fost creat cu succes.

==Exemplu==

<section name="Server" class="server" show="true">
Acest exemplu creează un ped când resursa va porni:
<syntaxhighlight lang="lua">
function pedLoad ( name )
createPed ( 120, 5540.6654, 1020.55122, 1240.545 )
end
addEventHandler ( "onResourceStart", getResourceRootElement(), pedLoad )
</syntaxhighlight>
</section>

<section name="Client" class="client" show="true">
Acest exemplu creează un ped si il face invincibil:
<syntaxhighlight lang="lua">
thePed = createPed(120, 5540.6654, 1020.55122, 1240.545) -- Creează un ped
function cancelPedDamage()
cancelEvent() -- Cancelează eventul onClientPedDamage
end
addEventHandler("onClientPedDamage", thePed, cancelPedDamage) -- Când thePed va fi lovit, onClientPedDamage va fi cancelat
</syntaxhighlight>
</section>

==Tradus==
'''de către Hydra45 (Gabriel45#6859 - Discord)'''

==Probleme==
{{Issues|
{{Issue|375|Sync distance of unoccupied vehicles and peds should match stream distance}}
{{Issue|605|Ped fireing Projectiles doesn't work}}
{{Issue|492|Peds shooting incorrectly}}
}}

==Vezi si==
{{Ped functions}}

[[hu:createPed]]
[[pl:createPed]]
[[ru:createPed]]
[[en:createPed]]

RO/getPedAmmoInClip

2023-03-15T16:21:42Z

Hydra:

__NOTOC__
{{Server client function}}
Această funcție returnează un număr care conține muniția dintr-o armă specificată a lui [[ped]]. Vedeți [[weapon|Informații despre arme]]

==Syntax==
<syntaxhighlight lang="lua">
int getPedAmmoInClip ( ped thePed [, int weaponSlot = current ] )
</syntaxhighlight>

{{OOP||[[ped]]:getAmmoInClip|ammoInClip}}

===Argumente Necesare===
*'''thePed:''' [[ped]] a cărui muniție doriți să verificați.

===Argumente Opționale===
*'''weaponSlot:''' Un număr reprezentând slotul pentru armă (setat la slotul selectat curent al ped-ului dacă nu este specificat).

===Returnează===
Returnează un [[int]] care conține cantitatea de muniție din clipul selectat sau specificat al dispozitivului specificat sau 0 dacă dispozitivul specificat este nevalid.

==Exemplu==
Acest exemplu arată cantitatea de muniție pe care jucătorul specificat o are în slotul său actual. De exemplu: „muniție cineva”.
<syntaxhighlight lang="lua">
function showAmmo(thePlayer, command, who )
local targetPlayer = getPlayerFromName ( who )
if ( thePlayer ) then
local ammo = getPedAmmoInClip ( targetPlayer )
outputChatBox ( who .. " has " .. ammo .. " ammo in his active clip" )
else
outputChatBox ( "Player '" .. who .. "' not found." )
end
end
addCommandHandler( "ammo", showAmmo )
</syntaxhighlight>

== Probleme ==
{{Issues|
{{Issue|734|Sometimes wrong count of player ammo, if get it in onPlayerWeaponFire}}
}}

==Tradus==
'''de către Hydra (Gabriel45#6859 - Discord)'''

==Vezi și==
{{Client_ped_functions}}

[[en:getPedAmmoInClip]]

RO/getPedAmmoInClip

2023-03-15T16:20:55Z

Hydra: Created page with "__NOTOC__ {{Server client function}} Această funcție returnează un număr care conține muniția dintr-o armă specificată a lui ped. Vedeți Informații despre arme ==Syntax== <syntaxhighlight lang="lua"> int getPedAmmoInClip ( ped thePed [, int weaponSlot = current ] ) </syntaxhighlight> {{OOP||ped:getAmmoInClip|ammoInClip}} ===Argumente Necesare=== *'''thePed:''' ped a cărui muniție doriți să verificați. ===Argumente Opționale=== *..."

__NOTOC__
{{Server client function}}
Această funcție returnează un număr care conține muniția dintr-o armă specificată a lui [[ped]]. Vedeți [[weapon|Informații despre arme]]

==Syntax==
<syntaxhighlight lang="lua">
int getPedAmmoInClip ( ped thePed [, int weaponSlot = current ] )
</syntaxhighlight>

{{OOP||[[ped]]:getAmmoInClip|ammoInClip}}

===Argumente Necesare===
*'''thePed:''' [[ped]] a cărui muniție doriți să verificați.

===Argumente Opționale===
*'''weaponSlot:''' Un număr reprezentând slotul pentru armă (setat la slotul selectat curent al ped-ului dacă nu este specificat).

===Returnează===
Returnează un [[int]] care conține cantitatea de muniție din clipul selectat sau specificat al dispozitivului specificat sau 0 dacă dispozitivul specificat este nevalid.

==Exemplu==
Acest exemplu arată cantitatea de muniție pe care jucătorul specificat o are în slotul său actual. De exemplu: „muniție cineva”.
<syntaxhighlight lang="lua">
function showAmmo(thePlayer, command, who )
local targetPlayer = getPlayerFromName ( who )
if ( thePlayer ) then
local ammo = getPedAmmoInClip ( targetPlayer )
outputChatBox ( who .. " has " .. ammo .. " ammo in his active clip" )
else
outputChatBox ( "Player '" .. who .. "' not found." )
end
end
addCommandHandler( "ammo", showAmmo )
</syntaxhighlight>

== Probleme ==
{{Issues|
{{Issue|734|Sometimes wrong count of player ammo, if get it in onPlayerWeaponFire}}
}}

==Vezi și==
{{Client_ped_functions}}

[[en:getPedAmmoInClip]]

RO/createPed

2023-03-15T16:14:56Z

Hydra: Created page with "__NOTOC__ {{Server client function}} Creează un ped în lumea GTA. ==Sintaxă== <section name="Server" class="server" show="true"> <syntaxhighlight lang="lua">ped createPed ( int id model, float x, float y, float z [, float rotație = 0.0, bool sincronizat = true ] )</syntaxhighlight> ===Argumente Necesare=== *'''id model:''' Un număr care specifică modelul pielii GTASA skin ID. *'''x:''' Un număr care reprezintă coordonatele X de pe hartă..."

__NOTOC__
{{Server client function}}
Creează un ped în lumea GTA.

==Sintaxă==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">ped createPed ( int id model, float x, float y, float z [, float rotație = 0.0, bool sincronizat = true ] )</syntaxhighlight>

===Argumente Necesare===
*'''id model:''' Un număr care specifică modelul pielii [[Character_Skins|GTASA skin ID]].
*'''x:''' Un număr care reprezintă coordonatele X de pe hartă.
*'''y:''' Un număr care reprezintă coordonatele Y de pe hartă.
*'''z:''' Un număr care reprezintă coordonatele Z de pe hartă.

==Argumente Opționale==
{{OptionalArg}}
*'''rotație:''' Un număr care reprezintă rotația în grade.
*'''sincronizat:''' O valoare booleană care reprezintă dacă ped-ul va fi sau nu sincronizat. Dezactivarea sincronizării ar putea fi utilă pentru ped-urile înghețate sau statice pentru a crește performanța serverului.
</section>
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">ped createPed ( int id model, float x, float y, float z [, float rotație = 0.0 ] )</syntaxhighlight>

===Argumente Necesare===
*'''id model:''' Un număr care specifică modelul pielii [[Character_Skins|GTASA skin ID]].
*'''x:''' Un număr care reprezintă coordonatele X de pe hartă.
*'''y:''' Un număr care reprezintă coordonatele Y de pe hartă.
*'''z:''' Un număr care reprezintă coordonatele Z de pe hartă.

==Argumente Opționale==
{{OptionalArg}}
*'''rotație:''' Un număr care reprezintă rotația în grade.
</section>

===Returnează===
Returnează un element ped dacă a fost creat cu succes.

==Exemplu==

<section name="Server" class="server" show="true">
Acest exemplu creează un ped când resursa va porni:
<syntaxhighlight lang="lua">
function pedLoad ( name )
createPed ( 120, 5540.6654, 1020.55122, 1240.545 )
end
addEventHandler ( "onResourceStart", getResourceRootElement(), pedLoad )
</syntaxhighlight>
</section>

<section name="Client" class="client" show="true">
Acest exemplu creează un ped si il face invincibil:
<syntaxhighlight lang="lua">
thePed = createPed(120, 5540.6654, 1020.55122, 1240.545) -- Creează un ped
function cancelPedDamage()
cancelEvent() -- Cancelează eventul onClientPedDamage
end
addEventHandler("onClientPedDamage", thePed, cancelPedDamage) -- Când thePed va fi lovit, onClientPedDamage va fi cancelat
</syntaxhighlight>
</section>

==Tradus==
'''de Hydra45 (Gabriel45#6859 - Discord)'''

==Probleme==
{{Issues|
{{Issue|375|Sync distance of unoccupied vehicles and peds should match stream distance}}
{{Issue|605|Ped fireing Projectiles doesn't work}}
{{Issue|492|Peds shooting incorrectly}}
}}

==Vezi si==
{{Ped functions}}

[[hu:createPed]]
[[pl:createPed]]
[[ru:createPed]]
[[en:createPed]]

IsCommandHandlerAdded

2023-02-16T09:33:11Z

Hydra: Created page with "{{Useful Function}} <lowercasetitle></lowercasetitle> __NOTOC__ Checks if a command is added in the respective resource. ==Syntax== <syntaxhighlight lang="lua"> isCommandHandlerAdded(string command) </syntaxhighlight> ===Required Arguments=== *'''command:''' The name of the command you want to check. ===Returns=== Return true if the command exists and false if not. ==Code== <section name="Serverside script" class="server" show="true"> <syntaxhighlight lang="lua"> fu..."

{{Useful Function}}
<lowercasetitle></lowercasetitle>
__NOTOC__
Checks if a command is added in the respective resource.

==Syntax==
<syntaxhighlight lang="lua">
isCommandHandlerAdded(string command)
</syntaxhighlight>

===Required Arguments===
*'''command:''' The name of the command you want to check.

===Returns===
Return true if the command exists and false if not.

==Code==
<section name="Serverside script" class="server" show="true">
<syntaxhighlight lang="lua">
function isCommandHandlerAdded(theCmd)
local commands = getCommandHandlers()
for _, v in ipairs(commands) do
if v[1] == theCmd then
return true
end
end
return false
end
</syntaxhighlight>
Author: Hydra45
</section>

==Example 1==
<section name="Example" class="server" show="true">
<syntaxhighlight lang="lua">

local tps = {"sf", "lv"}

addEventHandler("onPlayerCommand", root, function(cmd)
for _, tele in ipairs(tps) do
if cmd == tele then
if not isCommandHandlerAdded(tele) then
print("Indeed, it's not added")
else
print("Seems like it's added")
end
end
end
end)

addCommandHandler("sf", function(thePlayer, _)
end)
</syntaxhighlight>
</section>

==See Also==
{{Useful_Functions}}

Template:Useful Functions

2023-02-16T08:43:01Z

Hydra: /* Input functions */

__NOTOC__
=== Table functions ===
*[[addTableChangeHandler]] » This function monitors the changes of a table.
*[[getTableFromSql]] » This functionality is used to obtain saved tables using the function ([https://wiki.multitheftauto.com/wiki/SetTableToSql SetTableToSql ]).
*[[isValueInTable]] » This function returns true if the value exists in the table, false if the value does not exist in the table.
*[[pairsByKeys]] » This function sort pairs table.
*[[rangeToTable]] » This function converts a string range to a table containing number values.
*[[setTableProtected]] » This function protects a table and makes it read-only.
*[[setTableToSql]] » This function is used to save the table in the database (sql).
*[[Sort_Functions]] » These functions are able to sort your tables by a key.
*[[table.compare]] » This function checks whether two given tables are equal.
*[[table.copy]] » This function copies a whole table and all the tables in that table.
*[[table.deepmerge]] » This function deep merges two tables. Every nested table will be correspondingly merged.
*[[table.element]] » This function returns a new table with only userdata content.
*[[table.empty]] » This function checks whether a table is empty.
*[[table.fromString]] » This function converts string to a table.
*[[table.getRandomRows]] » This function returns random rows from table.
*[[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]] » This function merges two or more tables together.
*[[table.random]] » This function retrieves a random value from a table.
*[[table.removeValue]] » This function removes a specified value from a table.
*[[table.size]] » This function returns the absolute size of a table.
*[[table.toString]] » This function converts table to a string.

=== ACL functions ===
*[[aclGroupClone]] » This function clone a group to another group with/without ACLs and/or objects.
*[[getAccountsRanks]] » This function is used to detect the account name groups and put them in the chat.
*[[getPlayerAcls]] » This function returns a table of all ACL groups on a player.
*[[getPlayersInACLGroup]] » This function returns all players in an ACL group.
*[[isPlayerInACL]] » This function checks if a player element is in an ACL group.
*[[renameAclGroup]] » This function gives an existing ACL group a new name.

=== Account functions ===
*[[getPlayerFromAccountName]] » This function is used to obtain a player by the name of his account.

=== Camera functions ===
*[[smoothMoveCamera]] » This function allows you to create a cinematic camera flight.

=== Cursor functions ===
*[[getCursorMovedOn]] » This function checks in which way the cursor is currently moving.

=== Drawing functions ===
*[[dxDrawAnimWindow]] » This function draws an animated 2D window on the screen.
*[[dxDrawBorderedRectangle]] » This is a function that will create a bordered rectangle.
*[[dxDrawBorderedText]] » This is a function that will create a bordered text.
*[[dxDrawDashedLine]] » This function draws a line with dashes.
*[[dxDrawGifImage]] » This function simulates the effect of a GIF image by using image sprites in 2D.
*[[dxDrawImage3D]] » This function draws a 3D image in GTA world.
*[[dxDrawImageOnElement]] » This function draws an image on any element.
*[[dxDrawLinedRectangle]] » This is a function that will create a rectangle outline with dx lines.
*[[dxDrawLoading]] » This function draws a loading bar on the screen.
*[[dxDrawOctagon3D]] » This function creates a 3D Octagon
*[[dxDrawPolygon]] » This function draws a custom polygon on the screen.
*[[dxDrawProgressBar]] » This function simulates a progress bar drawed using DirectDraw.
*[[dxDrawRectangle3D]] » This function draws a 3D rectangle in GTA world.
*[[dxDrawRectangleOnPlayer]] » This function draws a 3D rectangle above the player.
*[[dxDrawRing]] » This function draws a ring with dx lines.
*[[dxDrawRombo]] » This function creates a Rhombus.
*[[dxDrawSprite]] » This function draw a sprite in the 3D world.
*[[dxDrawTextOnElement]] » This function draws a text on any element.
*[[dxDrawTextOnRectangle]] » Esta funcion crea un rectangle con un texto dentro.
*[[dxDrawTriangle]] » This is a function that will create a triangle with dx lines.
*[[dxGetFontSizeFromHeight]] » This function calculates the font size from given height.
*[[dxGetRealFontHeight]] » This function calculates the height of a font.
*[[getScreenStartPositionFromBox]] » This function helps with getting the correct position for your dx-effects.
*[[wordWrap]] » This function breaks a long string into a table of separate lines limited to a specific length in pixels, for drawing separately.
*[[CreateRectangle3D]] » This is a function that will create a 3d rectangle on the player screen.
*[[DxDrawBordered3DLine]] »This function creates a bordered area with 3D dx lines.

=== Effects functions ===
*[[attachEffect]] » This function allows you attach an effect to an element.

=== Element functions ===
*[[autoAttach]] » This function attaches one element into another at the same position and rotation they are.
*[[isElementPlayer]] » This function checks whether the element is a player or not.
*[[attachElementToBone]] » This function allows you to attach an element to ped bone accurately using new bone functions.
*[[getElementsInDimension]] » This function returns a table of elements that are in the specified dimension.
*[[getElementSpeed]] » This function returns the specified element's speed in m/s, km/h or mph.
*[[getElementsWithinMarker]] » This function returns a table of elements that are within a marker's collision shape.
*[[getElementUsingData]] » This function returns table elements that contains the elements data with the given key and value.
*[[getNearestElement]] » This function returns the nearest element (of a specific type) to a player.
*[[isElementInPhotograph]] » This function checks if an element is in the player's camera picture area.
*[[isElementInRange]] » This function allows you to check if an element's range to a main point is within the maximum range.
*[[isElementMoving]]» This function checks if an element is moving.
*[[isElementWithinAColShape]]» This function checks if an element is within a collision shape element.
*[[isElementInAir]]» This function checks if an element is in air or not.
*[[multi_check]] » This function checks one element to many, handy and clean.
*[[setElementSpeed]] » This function allows you to set the speed of an element in kph or mph units.
*[[getElementDirectionCardialPoint]] » This function returns the direction of the element according to the ''wind rose''.

=== Events ===
*[[onVehicleWeaponFire]] » This code implements an event that is triggered when a player in a vehicle fires a vehicle's weapon.

=== Input functions ===
*[[bindControlKeys]] » This function allows you to bind each key bound to a control individually. Doing this bypasses a little MTA restriction.
*[[getBoundControls]] » This function returns a table of control names that are bound to the specified key.
*[[unbindControlKeys]] » This function allows you to unbind each key bound to a control individually. Use this function with [[bindControlKeys]].
*[[isCommandHandlerAdded]] » This function allows you to check if a command is added or not in the respective resource.

=== Data functions ===
*[[byte2human]] » This function converts an integer (number of bytes) into a human-readable unit.
*[[capitalize]] » This function capitalizes a given string.
*[[convertDate]] » This function converts date to another look.
*[[convertServerTickToTimeStamp]] » This function converts server ticks to a unix timestamp.
*[[convertTextToSpeech]] » This function converts the provided text to a speech in the provided language which players can hear.
*[[findRotation3D]] » This function takes two sets of XYZ coordinates. It returns the 3D direction from point A to point B.
*[[findRotation]] » This function takes two points and returns the direction from point A to point B.
*[[formatDate]] » This function formats a date on the basis of a format string and returns it.
*[[formatNumber]] » This function formats large numbers by adding commas.
*[[generateRandomASCIIString]] » This function returns a random string which uses ASCII characters. 
*[[generateString]] » This function generates a random string with any characters.
*[[getAge]] » This function calculates the age of a given birthday.
*[[getDistanceBetweenElements]] » Returns the distance between two elements.
*[[getDistanceBetweenPointAndSegment2D]] » This function takes point coordinates and line (a segment) starting and ending coordinates. It returns the shortest distance between the point and the line.
*[[getEasterDate]] » This function returns easter date monthday and month for a given year.
*[[getFreeDimension]] » This function get free dimension.
*[[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.
*[[getPointFromDistanceRotation]] » This function finds a point based on a starting point, direction and distance.
*[[getRealMonth]] » This function returns the current month name
*[[getRGColorFromPercentage]] »This function returns two integers representing red and green colors according to the specified percentage.
*[[getScreenRotationFromWorldPosition]] » This function returns a screen relative rotation to a world position.
*[[getTimestamp]] » This function returns the UNIX timestamp of a specified date and time.
*[[gradientString]] » This function transforms a string in a new coloured gradient string.
*[[hex2rgb]] » This function convert hex to rgb.
*[[hexColorToRGB]] » This function convert hex string/number to RGBA values.
*[[isLeapYear]] » This function returns a boolean representing if a given year is a leap year.
*[[isValidMail]] » This function checks whether a provided e-mail string is valid.
*[[removeHex]] » This function is used to remove hexadecimal numbers (colors, for example) from strings.
*[[RGBToHex]] » This function returns a string representing the color in hexadecimal.
*[[RGBToHSV]] » This function convert RGB to HSV color space.
*[[RGBToDecimal]] » This function convert RGB to Decimal color.
*[[secondsToTimeDesc]] » This function converts a plain seconds-integer into a user-friendly time description.
*[[string.count]] » This function counts the amount of occurences of a string in a string.
*[[string.explode]] » This function splits a string at a given separator pattern and returns a table with the pieces.
*[[string.insert]] » This function inserts a string within another string at a given position.
*[[switch]] » This function allows the value of a variable or expression to control the flow of program execution via a multiway branch.
*[[tocolor2rgba]] » This function convert tocolor to rgba.
*[[toHex]] » This function converts a decimal number to a hexadecimal number, as a fix to be used client-side.
*[[var dump]] » This function outputs information about one or more variables using outputConsole.
*[[wavelengthToRGBA]] » This function converts a physical wavelength of light to a RGBA color.

=== GUI functions ===
*[[centerWindow]] » This function centers a CEGUI window element responsively in any resolution.
*[[guiMoveElement]] » This function moves guiElement by/like using moveObject.
*[[guiSetStaticImageMovable]] » This function allows you to move a static image like a gui window.
*[[isMouseOnGUICloseButton]] » This function allows you to check whether the mouse cursor/pointer is within a gui-window's native close button.
*[[isMouseOnGuiElement]] » This function allows you to check whether or not your mouse is over a specific gui element, this is especially useful if the gui element has a parent. 
=====Comboboxes=====
*[[guiComboBoxAdjustHeight]] » This function adjusts a CEGUI combobox element to have the correct height.

=====Gridlists=====
*[[convertGridListToText]] » This function converts grid list contents to text.
*[[getGridListRowIndexFromText]] » This function returns the GridList row index from the specified text.
*[[guiGridListAddPlayers]] » This function add all online players to a grid list.
*[[guiGridListGetColumnIDFromTitle]] » This function gets a gridlist's column ID from the column title.
*[[guiGridListGetSelectedText]] » This function returns a string containing the inner text of a selected gridlist item.
*[[guiGridListSetColumnNonSortable]] » This function makes a gridlist column become non-sortable.
*[[isTextInGridList]] » This function checks if some text exist or not in the GridList.

=====Labels=====
*[[guiLabelAddEffect]] » This function add an effects to the gui-label like (shadow, outline).

=== Marker functions ===
*[[createMarkerAttachedTo]] » This function creates a marker that is attached to an element.

=== Math functions ===
*[[math.clamp]] » This function returns the number between range of numbers or it's minimum or maximum.
*[[math.getBezierPoint]] » Get N-th order bezier point.
*[[math.hypot]] » This function returns the Hypotenuse of the triangle given by sides x and y.
*[[math.isPointInPolygon]] » Check if point is inside polygon or not.
*[[math.lerp]] » Get val between two integer.
*[[math.percent]] » This function returns a percentage from two number values.
*[[math.polygonArea]] » Compute area of any polygon.
*[[math.randomDiff]] » Generates a pseudo-random integer that's always different from the last random number generated.
*[[math.rotVecToEulerAngle]] » Rotation Vector To Euler Angle
*[[math.round]] » Rounds a number whereas the number of decimals to keep and the method may be set.
*[[mathNumber]] » This function is a workaround for the client-side floating-point precision of 24-bits.
*[[reMap]] » Re-maps a number from one range to another.
*[[Math.percentProgress|math.percentProgress]] » Returns a percentage progress from two specific values.
*[[math.average]] » This function returns the simple arithmetic mean of multiple numbers.

=== Map functions ===
*[[assignLod]] » This function lets you conveniently generate and apply a LOD model to a mapping object.
*[[getWorldPositionFromMapPosition]] » This function converts an F11 map position to world position.

=== Ped functions ===
*[[getAlivePlayers (Client)|getAlivePlayers]] » This function returns a table of the alive players client-side.
*[[getAlivePlayersInTeam]] » This function returns a table of the alive players in a team.
*[[getGuestPlayers]] » This function gets a players not login or players Guest .
*[[getOnlineAdmins]] » This function returns a table of all logged-in administrators.
*[[getPedEyesPosition]] » This function allows you to get peds eyes position.
*[[getPedGender]] » This function allows you to get peds their gender.
*[[getPedMaxHealth]] » This function returns a pedestrians's maximum health by converting it from their maximum health stat.
*[[getPedMaxOxygenLevel]] » This function returns a ped's maximum oxygen level by converting it from their maximum underwater stamina stat.
*[[getPedWeaponSkill]] » This function returns a ped's corresponding weapon skill level name.
*[[getPedHitBone]] » This function gets the approximate number of the bone where the ped is hit.
*[[getPlayerFromNamePart]] » This function returns a player from partial name.
*[[getPlayerFromSerial]] » This function returns a player from their serial.
*[[getPlayersByData]] » This function returns a table of players that have the specified data name.
*[[getPlayersInPhotograph]] » This function returns a table of all players in photograph.
*[[getPlayersInVehicles]] » This function returns a table of the players insides vehicles from a specified dimension.
*[[isPedAiming]]» This function checks if a pedestrian is aiming their weapon.
*[[isPedAimingNearPed]] » This is similar to isPedAiming but uses a colshape to be more precise.
*[[isPedDiving]] » This feature checks that pedestrian is diving in the water.
*[[isPedDrivingVehicle]] » This function checks if a specified pedestrian is driving a vehicle.
*[[isPlayerInTeam]] » This function checks if a player is in a specified team.
*[[setPedAttack]] » This function will make a ped attack a specified target.
*[[setPedFollow]] » This function will make a ped follow a specified target.
*[[getPlayerNameFromID]] » This function will get the player name from the ID element data.

=== Player functions ===
*[[countPlayersInRange]] » This function returns the number of players that are within a certain range of the specified coordinates.
*[[getPlayerPreviousAndNextWeapon]] » This function returns the player previous and next weapon.
*[[getPlayersInRange]]» This function make a table of players within certain range.
*[[isPlayerActuallyInVehicle]]» This function checks if a player is actually in a vehicle instead of just in the process of entering.
*[[isPlayerHitByVehicle]]» This function cancels event when a element is hit by a vehicle.
*[[warpToPlayer]]» This function make player warp to another player.

=== Resource functions ===
*[[getFilesInResourceFolder]] » This function gets a list of files that are inside a folder of a resource.
*[[getResourceScripts]] » This function returns a table of the resource scripts.
*[[getResourceSettings]] » This function returns a table of the resource settings.
*[[getResourceSize]] » This function returns the size of a specified resource in kB(kilobyte)
*[[refreshResource]] » This function refreshes your resource if you changed any of the files
*[[setResourcePriority]] » This function set resource download priority group.

=== Sound functions ===
*[[isSoundFinished]] » This function checks if a sound element has finished.
*[[isSoundPlaying]] » This function checks if a sound element is playing or not.
*[[stopSoundSlowly]] » This function stop your sound element slowly.

=== Browser functions ===
*[[playVideo]] » This function plays a video on the screen.

=== Team functions ===
*[[getTeamFromColor]] » This function returns a team element by the specified color.
*[[getTeamWithFewestPlayers]] » This function returns a team element with least players of all the specified teams.

=== Vehicle functions ===
*[[findEmptyCarSeat]] » This function finds you the first empty seat in a vehicle.
*[[getNearestVehicle]] » This function gets the nearest vehicle to the specified player in a specified distance.
*[[getRandomVehicle]] » This function gets a random vehicle.
*[[getValidVehicleModels]] » This function returns a table of all valid vehicle models.
*[[getVehiclesCountByType]] » This function returns the amount of vehicles by the given type as an integer value.
*[[getVehicleTurnVelocityCenterOfMass]]» This function gets a vehicle's turn velocity relative to the vehicle's center or mass.
*[[isVehicleDoubleExhaust]] » This function checks is exhaust vehicle double.
*[[isVehicleEmpty]] » This function checks whether a vehicle is empty.
*[[isVehicleOccupied]] » This function checks if a specified vehicle is occupied.
*[[isVehicleOnRoof]] » This function checks whether vehicle is on roof.
*[[isVehicleOnFire]] » This function checks if the vehicle is on fire or not.
*[[isVehicleReversing]] » This function checks if a specified vehicle is moving backwards.
*[[isVehicleUpgraded]] » This function checks is vehicle upgraded by upgrade ID.
*[[setVehicleGravityPoint]] » This function sets a vehicle's gravity in the direction of a 3 dimensional coordinate with the strength specified.
*[[setVehicleTurnVelocityCenterOfMass]]» This function sets a vehicle's turn velocity relative to the vehicle's center or mass.
*[[setVehicleHandlingFromText]]» This function sets a vehicle's handling from text.

=== Weapon functions ===
*[[getJetpackWeaponsEnabled]] » This function returns a table of enabled weapons usable on a jetpack.

=== Object functions ===
*[[getDynamicDoorObjectOpenRatio]] » This function tells you how open a dynamic door is in a range from 0 to 1.
*[[isElementObject]] » This function tells you if an element is an object or no.

=== XML functions ===
*[[getXMLNodes]] » This function returns all children of a XML node.

=== Engine functions ===
*[[engineGetCOLsFromLibrary]] » This function gets the collision data from the col library.
*[[engineLoadIMGContainer]] » This function loads the IMG container.

=== Utility ===
*[[animate]] » This function allows you to use interpolateBetween without render event and easily used.
*[[callClientFunction]] » This function allows you to call any client-side function from the server's side.
*[[callServerFunction]] » This function allows you to call any server-side function from the client's side.
*[[check]] » This function checks if its arguments are of the right type and calls the error-function if one is not.
*[[checkPassiveTimer]] » This function allows you to use passive timers in your conditions. For example you want to prevent players repeatedly using a command.
*[[coroutine.resume]] » This function applies a fix for hidden coroutine error messages.
*[[compact]] » This function create table containing variables and their values.
*[[getBanFromName]] » This functions returns the ban of the given playername.
*[[getCurrentFPS]] » This function returns the frames per second at which GTA: SA is running.
*[[getSkinNameFromID]] » This function returns the name of the skin from the given id.
*[[IfElse]] » This function returns one of two values based on a boolean expression.
*[[isCharInString]] » This shared function allows you to check if a char specified is in a string value.
*[[isMouseInCircle]] » This function checks if a cursor position is in circular area or not.
*[[isMouseInPosition]] » This function allows you to check whether the mouse cursor/pointer is within a rectangular position.
*[[iterElements]] » This function returns ''a time-saving'' iterator for your for-loops.
*[[PlotTrajectoryAtTime]] » Calculate projectile/water trajectory.
*[[preprocessor]] » This function allow you to use gcc macros.
*[[vector3:compare]] » This method checks whether two vectors match, with optional precision.
*[[svgCreateRoundedRectangle]] » This function creates a rectangle with rounded edges.

<noinclude>[[Category:Useful Functions]]</noinclude>

IsVehicleOnFire

2022-09-22T07:27:32Z

Hydra: Created page with "{{Useful Function}} <lowercasetitle></lowercasetitle> __NOTOC__ This function checks if the vehicle is on fire. ==Syntax== <syntaxhighlight lang="lua">bool isVehicleOnFire(vehicle theVehicle)</syntaxhighlight> ===Required Arguments=== * '''vehicle''': vehicle element. ==Code== <section name="Function source" class="both" show="true"> <syntaxhighlight lang="lua"> function isVehicleOnFire(elementVehicle) if getElementType(elementVehicle) == "vehicle" then local..."

{{Useful Function}}
<lowercasetitle></lowercasetitle>
__NOTOC__
This function checks if the vehicle is on fire.

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

===Required Arguments===
* '''vehicle''': vehicle element.

==Code==
<section name="Function source" class="both" show="true">
<syntaxhighlight lang="lua">
function isVehicleOnFire(elementVehicle)
if getElementType(elementVehicle) == "vehicle" then
local vHealth = getElementHealth(elementVehicle)
if vHealth < 300 then
return true
else
return false
end
end
end
</syntaxhighlight>
</section>

==Author==
'''Hydra45 - (Discord: Gabriel45#6859)'''

==See Also==
{{Useful_Functions}}

Template:Useful Functions

2022-09-22T07:24:47Z

Hydra: /* Vehicle functions */

__NOTOC__
=== Table functions ===
*[[addTableChangeHandler]] » This function monitors the changes of a table.
*[[getTableFromSql]] » This functionality is used to obtain saved tables using the function ([https://wiki.multitheftauto.com/wiki/SetTableToSql SetTableToSql ]).
*[[isValueInTable]] » This function returns true if the value exists in the table, false if the value does not exist in the table.
*[[pairsByKeys]] » This function sort pairs table.
*[[rangeToTable]] » This function converts a string range to a table containing number values.
*[[setTableProtected]] » This function protects a table and makes it read-only.
*[[setTableToSql]] » This function is used to save the table in the database (sql).
*[[Sort_Functions]] » These functions are able to sort your tables by a key.
*[[table.compare]] » This function checks whether two given tables are equal.
*[[table.copy]] » This function copies a whole table and all the tables in that table.
*[[table.deepmerge]] » This function deep merges two tables. Every nested table will be correspondingly merged.
*[[table.element]] » This function returns a new table with only userdata content.
*[[table.empty]] » This function checks whether a table is empty.
*[[table.fromString]] » This function converts string to a table.
*[[table.getRandomRows]] » This function returns random rows from table.
*[[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]] » This function merges two or more tables together.
*[[table.random]] » This function retrieves a random value from a table.
*[[table.removeValue]] » This function removes a specified value from a table.
*[[table.size]] » This function returns the absolute size of a table.
*[[table.toString]] » This function converts table to a string.

=== ACL functions ===
*[[aclGroupClone]] » This function clone a group to another group with/without ACLs and/or objects.
*[[getAccountsRanks]] » This function is used to detect the account name groups and put them in the chat.
*[[getPlayerAcls]] » This function returns a table of all ACL groups on a player.
*[[getPlayersInACLGroup]] » This function returns all players in an ACL group.
*[[isPlayerInACL]] » This function checks if a player element is in an ACL group.
*[[renameAclGroup]] » This function gives an existing ACL group a new name.

=== Account functions ===
*[[getPlayerFromAccountName]] » This function is used to obtain a player by the name of his account.

=== Camera functions ===
*[[smoothMoveCamera]] » This function allows you to create a cinematic camera flight.

=== Cursor functions ===
*[[getCursorMovedOn]] » This function checks in which way the cursor is currently moving.

=== Drawing functions ===
*[[dxDrawAnimWindow]] » This function draws an animated 2D window on the screen.
*[[dxDrawBorderedRectangle]] » This is a function that will create a bordered rectangle.
*[[dxDrawBorderedText]] » This is a function that will create a bordered text.
*[[dxDrawDashedLine]] » This function draws a line with dashes.
*[[dxDrawGifImage]] » This function simulates the effect of a GIF image by using image sprites in 2D.
*[[dxDrawImage3D]] » This function draws a 3D image in GTA world.
*[[dxDrawImageOnElement]] » This function draws an image on any element.
*[[dxDrawLinedRectangle]] » This is a function that will create a rectangle outline with dx lines.
*[[dxDrawLoading]] » This function draws a loading bar on the screen.
*[[dxDrawOctagon3D]] » This function creates a 3D Octagon
*[[dxDrawPolygon]] » This function draws a custom polygon on the screen.
*[[dxDrawProgressBar]] » This function simulates a progress bar drawed using DirectDraw.
*[[dxDrawRectangle3D]] » This function draws a 3D rectangle in GTA world.
*[[dxDrawRectangleOnPlayer]] » This function draws a 3D rectangle above the player.
*[[dxDrawRing]] » This function draws a ring with dx lines.
*[[dxDrawRombo]] » This function creates a Rhombus.
*[[dxDrawSprite]] » This function draw a sprite in the 3D world.
*[[dxDrawTextOnElement]] » This function draws a text on any element.
*[[dxDrawTextOnRectangle]] » Esta funcion crea un rectangle con un texto dentro.
*[[dxDrawTriangle]] » This is a function that will create a triangle with dx lines.
*[[dxGetFontSizeFromHeight]] » This function calculates the font size from given height.
*[[dxGetRealFontHeight]] » This function calculates the height of a font.
*[[getScreenStartPositionFromBox]] » This function helps with getting the correct position for your dx-effects.
*[[wordWrap]] » This function breaks a long string into a table of separate lines limited to a specific length in pixels, for drawing separately.
*[[CreateRectangle3D]] » This is a function that will create a 3d rectangle on the player screen.

=== Effects functions ===
*[[attachEffect]] » This function allows you attach an effect to an element.

=== Element functions ===
*[[autoAttach]] » This function attaches one element into another at the same position and rotation they are.
*[[isElementPlayer]] » This function checks whether the element is a player or not.
*[[attachElementToBone]] » This function allows you to attach an element to ped bone accurately using new bone functions.
*[[getElementsInDimension]] » This function returns a table of elements that are in the specified dimension.
*[[getElementSpeed]] » This function returns the specified element's speed in m/s, km/h or mph.
*[[getElementsWithinMarker]] » This function returns a table of elements that are within a marker's collision shape.
*[[getElementUsingData]] » This function returns table elements that contains the elements data with the given key and value.
*[[getNearestElement]] » This function returns the nearest element (of a specific type) to a player.
*[[isElementInPhotograph]] » This function checks if an element is in the player's camera picture area.
*[[isElementInRange]] » This function allows you to check if an element's range to a main point is within the maximum range.
*[[isElementMoving]]» This function checks if an element is moving.
*[[isElementWithinAColShape]]» This function checks if an element is within a collision shape element.
*[[isElementInAir]]» This function checks if an element is in air or not.
*[[multi_check]] » This function checks one element to many, handy and clean.
*[[setElementSpeed]] » This function allows you to set the speed of an element in kph or mph units.
*[[getElementDirectionCardialPoint]] » This function returns the direction of the element according to the ''wind rose''.

=== Events ===
*[[onVehicleWeaponFire]] » This code implements an event that is triggered when a player in a vehicle fires a vehicle's weapon.

=== Input functions ===
*[[bindControlKeys]] » This function allows you to bind each key bound to a control individually. Doing this bypasses a little MTA restriction.
*[[getBoundControls]] » This function returns a table of control names that are bound to the specified key.
*[[unbindControlKeys]] » This function allows you to unbind each key bound to a control individually. Use this function with [[bindControlKeys]].

=== Data functions ===
*[[byte2human]] » This function converts an integer (number of bytes) into a human-readable unit.
*[[capitalize]] » This function capitalizes a given string.
*[[convertDate]] » This function converts date to another look.
*[[convertServerTickToTimeStamp]] » This function converts server ticks to a unix timestamp.
*[[convertTextToSpeech]] » This function converts the provided text to a speech in the provided language which players can hear.
*[[findRotation3D]] » This function takes two sets of XYZ coordinates. It returns the 3D direction from point A to point B.
*[[findRotation]] » This function takes two points and returns the direction from point A to point B.
*[[formatDate]] » This function formats a date on the basis of a format string and returns it.
*[[formatNumber]] » This function formats large numbers by adding commas.
*[[generateRandomASCIIString]] » This function returns a random string which uses ASCII characters. 
*[[generateString]] » This function generates a random string with any characters.
*[[getAge]] » This function calculates the age of a given birthday.
*[[getDistanceBetweenElements]] » Returns the distance between two elements.
*[[getDistanceBetweenPointAndSegment2D]] » This function takes point coordinates and line (a segment) starting and ending coordinates. It returns the shortest distance between the point and the line.
*[[getEasterDate]] » This function returns easter date monthday and month for a given year.
*[[getFreeDimension]] » This function get free dimension.
*[[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.
*[[getPointFromDistanceRotation]] » This function finds a point based on a starting point, direction and distance.
*[[getRealMonth]] » This function returns the current month name
*[[getRGColorFromPercentage]] »This function returns two integers representing red and green colors according to the specified percentage.
*[[getScreenRotationFromWorldPosition]] » This function returns a screen relative rotation to a world position.
*[[getTimestamp]] » This function returns the UNIX timestamp of a specified date and time.
*[[gradientString]] » This function transforms a string in a new coloured gradient string.
*[[hex2rgb]] » This function convert hex to rgb.
*[[hexColorToRGB]] » This function convert hex string/number to RGBA values.
*[[isLeapYear]] » This function returns a boolean representing if a given year is a leap year.
*[[isValidMail]] » This function checks whether a provided e-mail string is valid.
*[[removeHex]] » This function is used to remove hexadecimal numbers (colors, for example) from strings.
*[[RGBToHex]] » This function returns a string representing the color in hexadecimal.
*[[RGBToHSV]] » This function convert RGB to HSV color space.
*[[RGBToDecimal]] » This function convert RGB to Decimal color.
*[[secondsToTimeDesc]] » This function converts a plain seconds-integer into a user-friendly time description.
*[[string.count]] » This function counts the amount of occurences of a string in a string.
*[[string.explode]] » This function splits a string at a given separator pattern and returns a table with the pieces.
*[[string.insert]] » This function inserts a string within another string at a given position.
*[[switch]] » This function allows the value of a variable or expression to control the flow of program execution via a multiway branch.
*[[tocolor2rgba]] » This function convert tocolor to rgba.
*[[toHex]] » This function converts a decimal number to a hexadecimal number, as a fix to be used client-side.
*[[var dump]] » This function outputs information about one or more variables using outputConsole.
*[[wavelengthToRGBA]] » This function converts a physical wavelength of light to a RGBA color.

=== GUI functions ===
*[[centerWindow]] » This function centers a CEGUI window element responsively in any resolution.
*[[guiMoveElement]] » This function moves guiElement by/like using moveObject.
*[[guiSetStaticImageMovable]] » This function allows you to move a static image like a gui window.
*[[isMouseOnGUICloseButton]] » This function allows you to check whether the mouse cursor/pointer is within a gui-window's native close button.
*[[isMouseOnGuiElement]] » This function allows you to check whether or not your mouse is over a specific gui element, this is especially useful if the gui element has a parent. 
=====Comboboxes=====
*[[guiComboBoxAdjustHeight]] » This function adjusts a CEGUI combobox element to have the correct height.

=====Gridlists=====
*[[convertGridListToText]] » This function converts grid list contents to text.
*[[getGridListRowIndexFromText]] » This function returns the GridList row index from the specified text.
*[[guiGridListAddPlayers]] » This function add all online players to a grid list.
*[[guiGridListGetColumnIDFromTitle]] » This function gets a gridlist's column ID from the column title.
*[[guiGridListGetSelectedText]] » This function returns a string containing the inner text of a selected gridlist item.
*[[guiGridListSetColumnNonSortable]] » This function makes a gridlist column become non-sortable.
*[[isTextInGridList]] » This function checks if some text exist or not in the GridList.

=====Labels=====
*[[guiLabelAddEffect]] » This function add an effects to the gui-label like (shadow, outline).

=== Marker functions ===
*[[createMarkerAttachedTo]] » This function creates a marker that is attached to an element.

=== Math functions ===
*[[math.clamp]] » This function returns the number between range of numbers or it's minimum or maximum.
*[[math.getBezierPoint]] » Get N-th order bezier point.
*[[math.hypot]] » This function returns the Hypotenuse of the triangle given by sides x and y.
*[[math.isPointInPolygon]] » Check if point is inside polygon or not.
*[[math.lerp]] » Get val between two integer.
*[[math.percent]] » This function returns a percentage from two number values.
*[[math.polygonArea]] » Compute area of any polygon.
*[[math.randomDiff]] » Generates a pseudo-random integer that's always different from the last random number generated.
*[[math.rotVecToEulerAngle]] » Rotation Vector To Euler Angle
*[[math.round]] » Rounds a number whereas the number of decimals to keep and the method may be set.
*[[mathNumber]] » This function is a workaround for the client-side floating-point precision of 24-bits.
*[[reMap]] » Re-maps a number from one range to another.
*[[Math.percentProgress|math.percentProgress]] » Returns a percentage progress from two specific values.
*[[math.average]] » This function returns the simple arithmetic mean of multiple numbers.

=== Map functions ===
*[[assignLod]] » This function lets you conveniently generate and apply a LOD model to a mapping object.
*[[getWorldPositionFromMapPosition]] » This function converts an F11 map position to world position.

=== Ped functions ===
*[[getAlivePlayers (Client)|getAlivePlayers]] » This function returns a table of the alive players client-side.
*[[getAlivePlayersInTeam]] » This function returns a table of the alive players in a team.
*[[getGuestPlayers]] » This function gets a players not login or players Guest .
*[[getOnlineAdmins]] » This function returns a table of all logged-in administrators.
*[[getPedEyesPosition]] » This function allows you to get peds eyes position.
*[[getPedGender]] » This function allows you to get peds their gender.
*[[getPedMaxHealth]] » This function returns a pedestrians's maximum health by converting it from their maximum health stat.
*[[getPedMaxOxygenLevel]] » This function returns a ped's maximum oxygen level by converting it from their maximum underwater stamina stat.
*[[getPedWeaponSkill]] » This function returns a ped's corresponding weapon skill level name.
*[[getPedHitBone]] » This function gets the approximate number of the bone where the ped is hit.
*[[getPlayerFromNamePart]] » This function returns a player from partial name.
*[[getPlayerFromSerial]] » This function returns a player from their serial.
*[[getPlayersByData]] » This function returns a table of players that have the specified data name.
*[[getPlayersInPhotograph]] » This function returns a table of all players in photograph.
*[[getPlayersInVehicles]] » This function returns a table of the players insides vehicles from a specified dimension.
*[[isPedAiming]]» This function checks if a pedestrian is aiming their weapon.
*[[isPedAimingNearPed]] » This is similar to isPedAiming but uses a colshape to be more precise.
*[[isPedDiving]] » This feature checks that pedestrian is diving in the water.
*[[isPedDrivingVehicle]] » This function checks if a specified pedestrian is driving a vehicle.
*[[isPlayerInTeam]] » This function checks if a player is in a specified team.
*[[setPedAttack]] » This function will make a ped attack a specified target.
*[[setPedFollow]] » This function will make a ped follow a specified target.
*[[getPlayerNameFromID]] » This function will get the player name from the ID element data.

=== Player functions ===
*[[countPlayersInRange]] » This function returns the number of players that are within a certain range of the specified coordinates.
*[[getPlayerPreviousAndNextWeapon]] » This function returns the player previous and next weapon.
*[[getPlayersInRange]]» This function make a table of players within certain range.
*[[isPlayerHitByVehicle]]» This function cancels event when a element is hit by a vehicle.
*[[warpToPlayer]]» This function make player warp to another player.

=== Resource functions ===
*[[getFilesInResourceFolder]] » This function gets a list of files that are inside a folder of a resource.
*[[getResourceScripts]] » This function returns a table of the resource scripts.
*[[getResourceSettings]] » This function returns a table of the resource settings.
*[[getResourceSize]] » This function returns the size of a specified resource in kB(kilobyte)
*[[refreshResource]] » This function refreshes your resource if you changed any of the files
*[[setResourcePriority]] » This function set resource download priority group.

=== Sound functions ===
*[[isSoundFinished]] » This function checks if a sound element has finished.
*[[isSoundPlaying]] » This function checks if a sound element is playing or not.
*[[stopSoundSlowly]] » This function stop your sound element slowly.

=== Browser functions ===
*[[playVideo]] » This function plays a video on the screen.

=== Team functions ===
*[[getTeamFromColor]] » This function returns a team element by the specified color.
*[[getTeamWithFewestPlayers]] » This function returns a team element with least players of all the specified teams.

=== Vehicle functions ===
*[[findEmptyCarSeat]] » This function finds you the first empty seat in a vehicle.
*[[getNearestVehicle]] » This function gets the nearest vehicle to the specified player in a specified distance.
*[[getRandomVehicle]] » This function gets a random vehicle.
*[[getValidVehicleModels]] » This function returns a table of all valid vehicle models.
*[[getVehiclesCountByType]] » This function returns the amount of vehicles by the given type as an integer value.
*[[getVehicleTurnVelocityCenterOfMass]]» This function gets a vehicle's turn velocity relative to the vehicle's center or mass.
*[[isVehicleDoubleExhaust]] » This function checks is exhaust vehicle double.
*[[isVehicleEmpty]] » This function checks whether a vehicle is empty.
*[[isVehicleOccupied]] » This function checks if a specified vehicle is occupied.
*[[isVehicleOnRoof]] » This function checks whether vehicle is on roof.
*[[isVehicleOnFire]] » This function checks if the vehicle is on fire or not.
*[[isVehicleReversing]] » This function checks if a specified vehicle is moving backwards.
*[[isVehicleUpgraded]] » This function checks is vehicle upgraded by upgrade ID.
*[[setVehicleGravityPoint]] » This function sets a vehicle's gravity in the direction of a 3 dimensional coordinate with the strength specified.
*[[setVehicleTurnVelocityCenterOfMass]]» This function sets a vehicle's turn velocity relative to the vehicle's center or mass.
*[[setVehicleHandlingFromText]]» This function sets a vehicle's handling from text.

=== Weapon functions ===
*[[getJetpackWeaponsEnabled]] » This function returns a table of enabled weapons usable on a jetpack.

=== Object functions ===
*[[getDynamicDoorObjectOpenRatio]] » This function tells you how open a dynamic door is in a range from 0 to 1.
*[[isElementObject]] » This function tells you if an element is an object or no.

=== XML functions ===
*[[getXMLNodes]] » This function returns all children of a XML node.

=== Engine functions ===
*[[engineGetCOLsFromLibrary]] » This function gets the collision data from the col library.
*[[engineLoadIMGContainer]] » This function loads the IMG container.

=== Utility ===
*[[animate]] » This function allows you to use interpolateBetween without render event and easily used.
*[[callClientFunction]] » This function allows you to call any client-side function from the server's side.
*[[callServerFunction]] » This function allows you to call any server-side function from the client's side.
*[[check]] » This function checks if its arguments are of the right type and calls the error-function if one is not.
*[[checkPassiveTimer]] » This function allows you to use passive timers in your conditions. For example you want to prevent players repeatedly using a command.
*[[coroutine.resume]] » This function applies a fix for hidden coroutine error messages.
*[[compact]] » This function create table containing variables and their values.
*[[getBanFromName]] » This functions returns the ban of the given playername.
*[[getCurrentFPS]] » This function returns the frames per second at which GTA: SA is running.
*[[getSkinNameFromID]] » This function returns the name of the skin from the given id.
*[[IfElse]] » This function returns one of two values based on a boolean expression.
*[[isCharInString]] » This shared function allows you to check if a char specified is in a string value.
*[[isMouseInCircle]] » This function checks if a cursor position is in circular area or not.
*[[isMouseInPosition]] » This function allows you to check whether the mouse cursor/pointer is within a rectangular position.
*[[iterElements]] » This function returns ''a time-saving'' iterator for your for-loops.
*[[PlotTrajectoryAtTime]] » Calculate projectile/water trajectory.
*[[preprocessor]] » This function allow you to use gcc macros.
*[[vector3:compare]] » This method checks whether two vectors match, with optional precision.
*[[svgCreateRoundedRectangle]] » This function creates a rectangle with rounded edges.

<noinclude>[[Category:Useful Functions]]</noinclude>

CreateRectangle3D

2022-06-21T15:25:54Z

Hydra:

{{Useful Function}}
__NOTOC__
This function draws a 3d rectangle on the player screen.

* '''NOTE:''' only CLIENT-SIDE.

==Syntax==
<syntaxhighlight lang="lua">bool createRectangle3D ( float x, float y, float width, float height, int color, float rx, float ry, float rz )</syntaxhighlight>

===Required Arguments===
* '''X:''' Screen X position.
* '''Y:''' Screen Y position.
* '''WIDTH:''' The width of the rectangle.
* '''HEIGHT:''' The height of the rectangle.

===Optional Arguments===
* '''COLOR:''' The color of the rectangle. color in RGBA format tocolor(red, green, blue, alpha)
* '''RX:''' The x rotation of the rectangle.
* '''RY:''' The y rotation of the rectangle.
* '''RZ:''' The z rotation of the rectangle.

===Returns===
Returns a ''true'' if the operation was successful, ''false'' otherwise.

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

local resx, resy = guiGetScreenSize()

local rawShader = [[
texture tex;
technique replace {
pass P0 {
Texture[0] = tex;
}
}
]]

local renderRectangle = dxCreateRenderTarget(resx, resy, true)
local theRectangleShader = dxCreateShader(rawShader)

function createRectangle3D(x, y, w, h, color, rx, ry, rz)
local color = color or tocolor(255, 255, 255, 255)
local rx, ry, rz = rx, ry, rz or 0, 0, 0
if renderRectangle then
dxSetRenderTarget(renderRectangle, true)
dxDrawRectangle(x, y, w, h, color, false)
dxSetRenderTarget()
dxSetShaderValue(theRectangleShader, "texture", renderRectangle)
dxSetShaderTransform(theRectangleShader, rx, ry, rz)
dxDrawImage(x, y, w, h, theRectangleShader, 0, 0, 0, color, false)
end
end
</syntaxhighlight>
</section>

==Example==
This draws a white rectangle in the middle of the GTA world for no reason
<syntaxhighlight lang="lua">
local resx, resy = guiGetScreenSize()
local sx, sy = resx/1920, resy/1080

function TestDraw()
local cx, cy = getCursorPosition()
createRectangle3D(200 * sx, 300 * sy, 300 * sx, 120 * sy, tocolor(255, 0, 0, 255), cx, cy, 0)
end
addEventHandler("onClientRender", root, TestDraw)
</syntaxhighlight>

Author: Hydra45

==See Also==
{{Useful_Functions}}

CreateRectangle3D

2022-06-21T15:25:43Z

Hydra:

{{Useful Function}}
__NOTOC__
This function draws a 3d rectangle on the player screen.

* '''NOTE:''' only CLIENT-SIDE.

==Syntax==
<syntaxhighlight lang="lua">bool CreateRectangle3D ( float x, float y, float width, float height, int color, float rx, float ry, float rz )</syntaxhighlight>

===Required Arguments===
* '''X:''' Screen X position.
* '''Y:''' Screen Y position.
* '''WIDTH:''' The width of the rectangle.
* '''HEIGHT:''' The height of the rectangle.

===Optional Arguments===
* '''COLOR:''' The color of the rectangle. color in RGBA format tocolor(red, green, blue, alpha)
* '''RX:''' The x rotation of the rectangle.
* '''RY:''' The y rotation of the rectangle.
* '''RZ:''' The z rotation of the rectangle.

===Returns===
Returns a ''true'' if the operation was successful, ''false'' otherwise.

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

local resx, resy = guiGetScreenSize()

local rawShader = [[
texture tex;
technique replace {
pass P0 {
Texture[0] = tex;
}
}
]]

local renderRectangle = dxCreateRenderTarget(resx, resy, true)
local theRectangleShader = dxCreateShader(rawShader)

function createRectangle3D(x, y, w, h, color, rx, ry, rz)
local color = color or tocolor(255, 255, 255, 255)
local rx, ry, rz = rx, ry, rz or 0, 0, 0
if renderRectangle then
dxSetRenderTarget(renderRectangle, true)
dxDrawRectangle(x, y, w, h, color, false)
dxSetRenderTarget()
dxSetShaderValue(theRectangleShader, "texture", renderRectangle)
dxSetShaderTransform(theRectangleShader, rx, ry, rz)
dxDrawImage(x, y, w, h, theRectangleShader, 0, 0, 0, color, false)
end
end
</syntaxhighlight>
</section>

==Example==
This draws a white rectangle in the middle of the GTA world for no reason
<syntaxhighlight lang="lua">
local resx, resy = guiGetScreenSize()
local sx, sy = resx/1920, resy/1080

function TestDraw()
local cx, cy = getCursorPosition()
createRectangle3D(200 * sx, 300 * sy, 300 * sx, 120 * sy, tocolor(255, 0, 0, 255), cx, cy, 0)
end
addEventHandler("onClientRender", root, TestDraw)
</syntaxhighlight>

Author: Hydra45

==See Also==
{{Useful_Functions}}

CreateRectangle3D

2022-06-21T15:25:26Z

Hydra: Created page with "{{Useful Function}} __NOTOC__ This function draws a 3d rectangle on the player screen. * '''NOTE:''' only CLIENT-SIDE. ==Syntax== <syntaxhighlight lang="lua">bool CreateRectangle3D ( float x, float y, float width, float height, int color, float rx, float ry, float rz )</syntaxhighlight> ===Required Arguments=== * '''X:''' Screen X position. * '''Y:''' Screen Y position. * '''WIDTH:''' The width of the rectangle. * '''HEIGHT:''' The height of the rectangle. ===Option..."

{{Useful Function}}
__NOTOC__
This function draws a 3d rectangle on the player screen.

* '''NOTE:''' only CLIENT-SIDE.

==Syntax==
<syntaxhighlight lang="lua">bool CreateRectangle3D ( float x, float y, float width, float height, int color, float rx, float ry, float rz )</syntaxhighlight>

===Required Arguments===
* '''X:''' Screen X position.
* '''Y:''' Screen Y position.
* '''WIDTH:''' The width of the rectangle.
* '''HEIGHT:''' The height of the rectangle.

===Optional Arguments===
* '''COLOR:''' The color of the rectangle. color in RGBA format tocolor(red, green, blue, alpha)
* '''RX:''' The x rotation of the rectangle.
* '''RY:''' The y rotation of the rectangle.
* '''RZ:''' The z rotation of the rectangle.

===Returns===
Returns a ''true'' if the operation was successful, ''false'' otherwise.

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

local resx, resy = guiGetScreenSize()

local rawShader = [[
texture tex;
technique replace {
pass P0 {
Texture[0] = tex;
}
}
]]

local renderRectangle = dxCreateRenderTarget(resx, resy, true)
local theRectangleShader = dxCreateShader(rawShader)

function CreateRectangle3D(x, y, w, h, color, rx, ry, rz)
local color = color or tocolor(255, 255, 255, 255)
local rx, ry, rz = rx, ry, rz or 0, 0, 0
if renderRectangle then
dxSetRenderTarget(renderRectangle, true)
dxDrawRectangle(x, y, w, h, color, false)
dxSetRenderTarget()
dxSetShaderValue(theRectangleShader, "texture", renderRectangle)
dxSetShaderTransform(theRectangleShader, rx, ry, rz)
dxDrawImage(x, y, w, h, theRectangleShader, 0, 0, 0, color, false)
end
end
</syntaxhighlight>
</section>

==Example==
This draws a white rectangle in the middle of the GTA world for no reason
<syntaxhighlight lang="lua">
local resx, resy = guiGetScreenSize()
local sx, sy = resx/1920, resy/1080

function TestDraw()
local cx, cy = getCursorPosition()
CreateRectangle3D(200 * sx, 300 * sy, 300 * sx, 120 * sy, tocolor(255, 0, 0, 255), cx, cy, 0)
end
addEventHandler("onClientRender", root, TestDraw)
</syntaxhighlight>

Author: Hydra45

==See Also==
{{Useful_Functions}}

Template:Useful Functions

2022-06-21T15:13:30Z

Hydra: /* Drawing functions */

__NOTOC__
=== Table functions ===
*[[addTableChangeHandler]] » This function monitors the changes of a table.
*[[getTableFromSql]] » This functionality is used to obtain saved tables using the function ([https://wiki.multitheftauto.com/wiki/SetTableToSql SetTableToSql ]).
*[[isValueInTable]] » This function returns true if the value exists in the table, false if the value does not exist in the table.
*[[pairsByKeys]] » This function sort pairs table.
*[[rangeToTable]] » This function converts a string range to a table containing number values.
*[[setTableProtected]] » This function protects a table and makes it read-only.
*[[setTableToSql]] » This function is used to save the table in the database (sql).
*[[Sort_Functions]] » These functions are able to sort your tables by a key.
*[[table.compare]] » This function checks whether two given tables are equal.
*[[table.copy]] » This function copies a whole table and all the tables in that table.
*[[table.deepmerge]] » This function deep merges two tables. Every nested table will be correspondingly merged.
*[[table.element]] » This function returns a new table with only userdata content.
*[[table.empty]] » This function checks whether a table is empty.
*[[table.fromString]] » This function converts string to a table.
*[[table.getRandomRows]] » This function returns random rows from table.
*[[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]] » This function merges two or more tables together.
*[[table.random]] » This function retrieves a random value from a table.
*[[table.removeValue]] » This function removes a specified value from a table.
*[[table.size]] » This function returns the absolute size of a table.
*[[table.toString]] » This function converts table to a string.
*[[table.toStringArray]] » This function converts '''array''' to a string.

=== ACL functions ===
*[[aclGroupClone]] » This function clone a group to another group with/without ACLs and/or objects.
*[[getAccountsRanks]] » This function is used to detect the account name groups and put them in the chat.
*[[getPlayerAcls]] » This function returns a table of all ACL groups on a player.
*[[getPlayersInACLGroup]] » This function returns all players in an ACL group.
*[[isPlayerInACL]] » This function checks if a player element is in an ACL group.
*[[renameAclGroup]] » This function gives an existing ACL group a new name.

=== Account functions ===
*[[getPlayerFromAccountName]] » This function is used to obtain a player by the name of his account.

=== Camera functions ===
*[[smoothMoveCamera]] » This function allows you to create a cinematic camera flight.

=== Cursor functions ===
*[[getCursorMovedOn]] » This function checks in which way the cursor is currently moving.

=== Drawing functions ===
*[[dxDrawAnimWindow]] » This function draws an animated 2D window on the screen.
*[[dxDrawBorderedRectangle]] » This is a function that will create a bordered rectangle.
*[[dxDrawBorderedText]] » This is a function that will create a bordered text.
*[[dxDrawDashedLine]] » This function draws a line with dashes.
*[[dxDrawGifImage]] » This function simulates the effect of a GIF image by using image sprites in 2D.
*[[dxDrawImage3D]] » This function draws a 3D image in GTA world.
*[[dxDrawImageOnElement]] » This function draws an image on any element.
*[[dxDrawLinedRectangle]] » This is a function that will create a rectangle outline with dx lines.
*[[dxDrawLoading]] » This function draws a loading bar on the screen.
*[[dxDrawOctagon3D]] » This function creates a 3D Octagon
*[[dxDrawPolygon]] » This function draws a custom polygon on the screen.
*[[dxDrawProgressBar]] » This function simulates a progress bar drawed using DirectDraw.
*[[dxDrawRectangle3D]] » This function draws a 3D rectangle in GTA world.
*[[dxDrawRectangleOnPlayer]] » This function draws a 3D rectangle above the player.
*[[dxDrawRing]] » This function draws a ring with dx lines.
*[[dxDrawRombo]] » This function creates a Rhombus.
*[[dxDrawSprite]] » This function draw a sprite in the 3D world.
*[[dxDrawTextOnElement]] » This function draws a text on any element.
*[[dxDrawTextOnRectangle]] » Esta funcion crea un rectangle con un texto dentro.
*[[dxDrawTriangle]] » This is a function that will create a triangle with dx lines.
*[[dxGetFontSizeFromHeight]] » This function calculates the font size from given height.
*[[dxGetRealFontHeight]] » This function calculates the height of a font.
*[[getScreenStartPositionFromBox]] » This function helps with getting the correct position for your dx-effects.
*[[wordWrap]] » This function breaks a long string into a table of separate lines limited to a specific length in pixels, for drawing separately.
*[[CreateRectangle3D]] » This is a function that will create a 3d rectangle on the player screen.

=== Effects functions ===
*[[attachEffect]] » This function allows you attach an effect to an element.

=== Element functions ===
*[[autoAttach]] » This function attaches one element into another at the same position and rotation they are.
*[[isElementPlayer]] » This function checks whether the element is a player or not.
*[[attachElementToBone]] » This function allows you to attach an element to ped bone accurately using new bone functions.
*[[getElementsInDimension]] » This function returns a table of elements that are in the specified dimension.
*[[getElementSpeed]] » This function returns the specified element's speed in m/s, km/h or mph.
*[[getElementsWithinMarker]] » This function returns a table of elements that are within a marker's collision shape.
*[[getElementUsingData]] » This function returns table elements that contains the elements data with the given key and value.
*[[getNearestElement]] » This function returns the nearest element (of a specific type) to a player.
*[[isElementInPhotograph]] » This function checks if an element is in the player's camera picture area.
*[[isElementInRange]] » This function allows you to check if an element's range to a main point is within the maximum range.
*[[isElementMoving]]» This function checks if an element is moving.
*[[isElementWithinAColShape]]» This function checks if an element is within a collision shape element.
*[[isElementInAir]]» This function checks if an element is in air or not.
*[[multi_check]] » This function checks one element to many, handy and clean.
*[[setElementSpeed]] » This function allows you to set the speed of an element in kph or mph units.

=== Events ===
*[[onVehicleWeaponFire]] » This code implements an event that is triggered when a player in a vehicle fires a vehicle's weapon.

=== Input functions ===
*[[bindControlKeys]] » This function allows you to bind each key bound to a control individually. Doing this bypasses a little MTA restriction.
*[[getBoundControls]] » This function returns a table of control names that are bound to the specified key.
*[[unbindControlKeys]] » This function allows you to unbind each key bound to a control individually. Use this function with [[bindControlKeys]].

=== Data functions ===
*[[byte2human]] » This function converts an integer (number of bytes) into a human-readable unit.
*[[capitalize]] » This function capitalizes a given string.
*[[convertDate]] » This function converts date to another look.
*[[convertServerTickToTimeStamp]] » This function converts server ticks to a unix timestamp.
*[[convertTextToSpeech]] » This function converts the provided text to a speech in the provided language which players can hear.
*[[findRotation3D]] » This function takes two sets of XYZ coordinates. It returns the 3D direction from point A to point B.
*[[findRotation]] » This function takes two points and returns the direction from point A to point B.
*[[formatDate]] » This function formats a date on the basis of a format string and returns it.
*[[formatNumber]] » This function formats large numbers by adding commas.
*[[generateRandomASCIIString]] » This function returns a random string which uses ASCII characters. 
*[[generateString]] » This function generates a random string with any characters.
*[[getAge]] » This function calculates the age of a given birthday.
*[[getDistance]] » Returns the distance between two elements.
*[[getDistanceBetweenElements]] » Esta funcion sirve para obtener la distancia entre dos elementos.
*[[getDistanceBetweenPointAndSegment2D]] » This function takes point coordinates and line (a segment) starting and ending coordinates. It returns the shortest distance between the point and the line.
*[[getEasterDate]] » This function returns easter date monthday and month for a given year.
*[[getFreeDimension]] » This function get free dimension.
*[[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.
*[[getPointFromDistanceRotation]] » This function finds a point based on a starting point, direction and distance.
*[[getRealMonth]] » This function returns the current month name
*[[getRGColorFromPercentage]] »This function returns two integers representing red and green colors according to the specified percentage.
*[[getScreenRotationFromWorldPosition]] » This function returns a screen relative rotation to a world position.
*[[getTimestamp]] » This function returns the UNIX timestamp of a specified date and time.
*[[gradientString]] » This function transforms a string in a new coloured gradient string.
*[[hex2rgb]] » This function convert hex to rgb.
*[[hexColorToRGB]] » This function convert hex string/number to RGBA values.
*[[isLeapYear]] » This function returns a boolean representing if a given year is a leap year.
*[[isValidMail]] » This function checks whether a provided e-mail string is valid.
*[[removeHex]] » This function is used to remove hexadecimal numbers (colors, for example) from strings.
*[[RGBToHex]] » This function returns a string representing the color in hexadecimal.
*[[RGBToHSV]] » This function convert RGB to HSV color space.
*[[RGBToDecimal]] » This function convert RGB to Decimal color.
*[[secondsToTimeDesc]] » This function converts a plain seconds-integer into a user-friendly time description.
*[[string.count]] » This function counts the amount of occurences of a string in a string.
*[[string.explode]] » This function splits a string at a given separator pattern and returns a table with the pieces.
*[[string.insert]] » This function inserts a string within another string at a given position.
*[[switch]] » This function allows the value of a variable or expression to control the flow of program execution via a multiway branch.
*[[tocolor2rgba]] » This function convert tocolor to rgba.
*[[toHex]] » This function converts a decimal number to a hexadecimal number, as a fix to be used client-side.
*[[var dump]] » This function outputs information about one or more variables using outputConsole.
*[[wavelengthToRGBA]] » This function converts a physical wavelength of light to a RGBA color.

=== GUI functions ===
*[[centerWindow]] » This function centers a CEGUI window element responsively in any resolution.
*[[guiMoveElement]] » This function moves guiElement by/like using moveObject.
*[[guiSetStaticImageMovable]] » This function allows you to move a static image like a gui window.
*[[isMouseOnGUICloseButton]] » This function allows you to check whether the mouse cursor/pointer is within a gui-window's native close button.
*[[isMouseOnGuiElement]] » This function allows you to check whether or not your mouse is over a specific gui element, this is especially useful if the gui element has a parent. 
=====Comboboxes=====
*[[guiComboBoxAdjustHeight]] » This function adjusts a CEGUI combobox element to have the correct height.

=====Gridlists=====
*[[convertGridListToText]] » This function converts grid list contents to text.
*[[getGridListRowIndexFromText]] » This function returns the GridList row index from the specified text.
*[[guiGridListAddPlayers]] » This function add all online players to a grid list.
*[[guiGridListGetColumnIDFromTitle]] » This function gets a gridlist's column ID from the column title.
*[[guiGridListGetSelectedText]] » This function returns a string containing the inner text of a selected gridlist item.
*[[guiGridListSetColumnNonSortable]] » This function makes a gridlist column become non-sortable.
*[[guiGridListSetColumnsFixedWidth]] » This function makes a gridlist have all its columns fixed width.
*[[isTextInGridList]] » This function checks if some text exist or not in the GridList.

=====Labels=====
*[[guiLabelAddEffect]] » This function add an effects to the gui-label like (shadow, outline).

=== Marker functions ===
*[[createMarkerAttachedTo]] » This function creates a marker that is attached to an element.

=== Math functions ===
*[[math.clamp]] » This function returns the number between range of numbers or it's minimum or maximum.
*[[math.getBezierPoint]] » Get N-th order bezier point.
*[[math.hypot]] » This function returns the Hypotenuse of the triangle given by sides x and y.
*[[math.isPointInPolygon]] » Check if point is inside polygon or not.
*[[math.lerp]] » Get val between two integer.
*[[math.percent]] » This function returns a percentage from two number values.
*[[math.polygonArea]] » Compute area of any polygon.
*[[math.randomDiff]] » Generates a pseudo-random integer that's always different from the last random number generated.
*[[math.rotVecToEulerAngle]] » Rotation Vector To Euler Angle
*[[math.round]] » Rounds a number whereas the number of decimals to keep and the method may be set.
*[[mathNumber]] » This function is a workaround for the client-side floating-point precision of 24-bits.
*[[reMap]] » Re-maps a number from one range to another.
*[[Math.percentProgress|math.percentProgress]] » Returns a percentage progress from two specific values.
*[[math.average]] » This function returns the simple arithmetic mean of multiple numbers.

=== Map functions ===
*[[assignLod]] » This function lets you conveniently generate and apply a LOD model to a mapping object.
*[[getWorldPositionFromMapPosition]] » This function converts an F11 map position to world position.

=== Ped functions ===
*[[getAlivePlayers (Client)|getAlivePlayers]] » This function returns a table of the alive players client-side.
*[[getAlivePlayersInTeam]] » This function returns a table of the alive players in a team.
*[[getGuestPlayers]] » This function gets a players not login or players Guest .
*[[getOnlineAdmins]] » This function returns a table of all logged-in administrators.
*[[getPedEyesPosition]] » This function allows you to get peds eyes position.
*[[getPedGender]] » This function allows you to get peds their gender.
*[[getPedMaxHealth]] » This function returns a pedestrians's maximum health by converting it from their maximum health stat.
*[[getPedMaxOxygenLevel]] » This function returns a ped's maximum oxygen level by converting it from their maximum underwater stamina stat.
*[[getPedWeaponSkill]] » This function returns a ped's corresponding weapon skill level name.
*[[getPedHitBone]] » This function gets the approximate number of the bone where the ped is hit.
*[[getPlayerFromNamePart]] » This function returns a player from partial name.
*[[getPlayerFromSerial]] » This function returns a player from their serial.
*[[getPlayersByData]] » This function returns a table of players that have the specified data name.
*[[getPlayersInPhotograph]] » This function returns a table of all players in photograph.
*[[getPlayersInVehicles]] » This function returns a table of the players insides vehicles from a specified dimension.
*[[isPedAiming]]» This function checks if a pedestrian is aiming their weapon.
*[[isPedAimingNearPed]] » This is similar to isPedAiming but uses a colshape to be more precise.
*[[isPedDiving]] » This feature checks that pedestrian is diving in the water.
*[[isPedDrivingVehicle]] » This function checks if a specified pedestrian is driving a vehicle.
*[[isPlayerInTeam]] » This function checks if a player is in a specified team.
*[[setPedAttack]] » This function will make a ped attack a specified target.
*[[setPedFollow]] » This function will make a ped follow a specified target.
*[[getPlayerNameFromID]] » This function will get the player name from the ID element data.

=== Player functions ===
*[[countPlayersInRange]] » This function returns the number of players that are within a certain range of the specified coordinates.
*[[getPlayerPreviousAndNextWeapon]] » This function returns the player previous and next weapon.
*[[getPlayersInRange]]» This function make a table of players within certain range.
*[[isPlayerHitByVehicle]]» This function cancels event when a element is hit by a vehicle.
*[[warpToPlayer]]» This function make player warp to another player.

=== Resource functions ===
*[[getFilesInResourceFolder]] » This function gets a list of files that are inside a folder of a resource.
*[[getResourceScripts]] » This function returns a table of the resource scripts.
*[[getResourceSettings]] » This function returns a table of the resource settings.
*[[getResourceSize]] » This function returns the size of a specified resource in kB(kilobyte)
*[[refreshResource]] » This function refreshes your resource if you changed any of the files
*[[setResourcePriority]] » This function set resource download priority group.

=== Sound functions ===
*[[isSoundFinished]] » This function checks if a sound element has finished.
*[[isSoundPlaying]] » This function checks if a sound element is playing or not.
*[[stopSoundSlowly]] » This function stop your sound element slowly.

=== Browser functions ===
*[[playVideo]] » This function plays a video on the screen.

=== Team functions ===
*[[getTeamFromColor]] » This function returns a team element by the specified color.
*[[getTeamWithFewestPlayers]] » This function returns a team element with least players of all the specified teams.

=== Vehicle functions ===
*[[findEmptyCarSeat]] » This function finds you the first empty seat in a vehicle.
*[[getNearestVehicle]] » This function gets the nearest vehicle to the specified player in a specified distance.
*[[getRandomVehicle]] » This function gets a random vehicle.
*[[getValidVehicleModels]] » This function returns a table of all valid vehicle models.
*[[getVehiclesCountByType]] » This function returns the amount of vehicles by the given type as an integer value.
*[[getVehicleTurnVelocityCenterOfMass]]» This function gets a vehicle's turn velocity relative to the vehicle's center or mass.
*[[isVehicleDoubleExhaust]] » This function checks is exhaust vehicle double.
*[[isVehicleEmpty]] » This function checks whether a vehicle is empty.
*[[isVehicleOccupied]] » This function checks if a specified vehicle is occupied.
*[[isVehicleOnRoof]] » This function checks whether vehicle is on roof.
*[[isVehicleReversing]] » This function checks if a specified vehicle is moving backwards.
*[[isVehicleUpgraded]] » This function checks is vehicle upgraded by upgrade ID.
*[[setVehicleGravityPoint]] » This function sets a vehicle's gravity in the direction of a 3 dimensional coordinate with the strength specified.
*[[setVehicleTurnVelocityCenterOfMass]]» This function sets a vehicle's turn velocity relative to the vehicle's center or mass.

=== Weapon functions ===
*[[getJetpackWeaponsEnabled]] » This function returns a table of enabled weapons usable on a jetpack.

=== Object functions ===
*[[getDynamicDoorObjectOpenRatio]] » This function tells you how open a dynamic door is in a range from 0 to 1.
*[[isElementObject]] » This function tells you if an element is an object or no.

=== XML functions ===
*[[getXMLNodes]] » This function returns all children of a XML node.

=== Engine functions ===
*[[engineGetCOLsFromLibrary]] » This function gets the collision data from the col library.
*[[engineLoadIMGContainer]] » This function loads the IMG container.

=== Utility ===
*[[animate]] » This function allows you to use interpolateBetween without render event and easily used.
*[[callClientFunction]] » This function allows you to call any client-side function from the server's side.
*[[callServerFunction]] » This function allows you to call any server-side function from the client's side.
*[[check]] » This function checks if its arguments are of the right type and calls the error-function if one is not.
*[[checkPassiveTimer]] » This function allows you to use passive timers in your conditions. For example you want to prevent players r
epeatedly using a command.
*[[coroutine.resume]] » This function applies a fix for hidden coroutine error messages.
*[[compact]] » This function create table containing variables and their values.
*[[getBanFromName]] » This functions returns the ban of the given playername.
*[[getCurrentFPS]] » This function returns the frames per second at which GTA: SA is running.
*[[getSkinNameFromID]] » This function returns the name of the skin from the given id.
*[[IfElse]] » This function returns one of two values based on a boolean expression.
*[[isCharInString]] » This shared function allows you to check if a char specified is in a string value.
*[[isMouseInCircle]] » This function checks if a cursor position is in circular area or not.
*[[isMouseInPosition]] » This function allows you to check whether the mouse cursor/pointer is within a rectangular position.
*[[iterElements]] » This function returns ''a time-saving'' iterator for your for-loops.
*[[PlotTrajectoryAtTime]] » Calculate projectile/water trajectory.
*[[preprocessor]] » This function allow you to use gcc macros.
*[[vector3:compare]] » This method checks whether two vectors match, with optional precision.
*[[svgCreateRoundedRectangle]] » This function creates a rectangle with rounded edges.

<noinclude>[[Category:Useful Functions]]</noinclude>

Template:Useful Functions

2022-04-28T16:40:10Z

Hydra: /* Ped functions */

__NOTOC__
=== Table functions ===
*[[addTableChangeHandler]] » This function monitors the changes of a table.
*[[getTableFromSql]] » This functionality is used to obtain saved tables using the function ([https://wiki.multitheftauto.com/wiki/SetTableToSql SetTableToSql ]).
*[[isValueInTable]] » This function returns true if the value exists in the table, false if the value does not exist in the table.
*[[pairsByKeys]] » This function sort pairs table.
*[[rangeToTable]] » This function converts a string range to a table containing number values.
*[[setTableProtected]] » This function protects a table and makes it read-only.
*[[setTableToSql]] » This function is used to save the table in the database (sql).
*[[Sort_Functions]] » These functions are able to sort your tables by a key.
*[[table.compare]] » This function checks whether two given tables are equal.
*[[table.copy]] » This function copies a whole table and all the tables in that table.
*[[table.deepmerge]] » This function deep merges two tables. Every nested table will be correspondingly merged.
*[[table.element]] » This function returns a new table with only userdata content.
*[[table.empty]] » This function checks whether a table is empty.
*[[table.fromString]] » This function converts string to a table.
*[[table.getRandomRows]] » This function returns random rows from table.
*[[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]] » This function merges two or more tables together.
*[[table.random]] » This function retrieves a random value from a table.
*[[table.removeValue]] » This function removes a specified value from a table.
*[[table.size]] » This function returns the absolute size of a table.
*[[table.toString]] » This function converts table to a string.
*[[table.toStringArray]] » This function converts '''array''' to a string.

=== ACL functions ===
*[[aclGroupClone]] » This function clone a group to another group with/without ACLs and/or objects.
*[[getAccountsRanks]] » This function is used to detect the account name groups and put them in the chat.
*[[getPlayerAcls]] » This function returns a table of all ACL groups on a player.
*[[getPlayersInACLGroup]] » This function returns all players in an ACL group.
*[[isPlayerInACL]] » This function checks if a player element is in an ACL group.
*[[renameAclGroup]] » This function gives an existing ACL group a new name.

=== Account functions ===
*[[getPlayerFromAccountName]] » This function is used to obtain a player by the name of his account.

=== Camera functions ===
*[[smoothMoveCamera]] » This function allows you to create a cinematic camera flight.

=== Cursor functions ===
*[[getCursorMovedOn]] » This function checks in which way the cursor is currently moving.

=== Drawing functions ===
*[[dxDrawAnimWindow]] » This function draws an animated 2D window on the screen.
*[[dxDrawBorderedRectangle]] » This is a function that will create a bordered rectangle.
*[[dxDrawBorderedText]] » This is a function that will create a bordered text.
*[[dxDrawDashedLine]] » This function draws a line with dashes.
*[[dxDrawGifImage]] » This function simulates the effect of a GIF image by using image sprites in 2D.
*[[dxDrawImage3D]] » This function draws a 3D image in GTA world.
*[[dxDrawImageOnElement]] » This function draws an image on any element.
*[[dxDrawLinedRectangle]] » This is a function that will create a rectangle outline with dx lines.
*[[dxDrawLoading]] » This function draws a loading bar on the screen.
*[[dxDrawOctagon3D]] » This function creates a 3D Octagon
*[[dxDrawPolygon]] » This function draws a custom polygon on the screen.
*[[dxDrawProgressBar]] » This function simulates a progress bar drawed using DirectDraw.
*[[dxDrawRectangle3D]] » This function draws a 3D rectangle in GTA world.
*[[dxDrawRectangleOnPlayer]] » This function draws a 3D rectangle above the player.
*[[dxDrawRing]] » This function draws a ring with dx lines.
*[[dxDrawRombo]] » This function creates a Rhombus.
*[[dxDrawSprite]] » This function draw a sprite in the 3D world.
*[[dxDrawTextOnElement]] » This function draws a text on any element.
*[[dxDrawTextOnRectangle]] » Esta funcion crea un rectangle con un texto dentro.
*[[dxDrawTriangle]] » This is a function that will create a triangle with dx lines.
*[[dxGetFontSizeFromHeight]] » This function calculates the font size from given height.
*[[dxGetRealFontHeight]] » This function calculates the height of a font.
*[[getScreenStartPositionFromBox]] » This function helps with getting the correct position for your dx-effects.
*[[wordWrap]] » This function breaks a long string into a table of separate lines limited to a specific length in pixels, for drawing separately.

=== Effects functions ===
*[[attachEffect]] » This function allows you attach an effect to an element.

=== Element functions ===
*[[autoAttach]] » This function attaches one element into another at the same position and rotation they are.
*[[isElementPlayer]] » This function checks whether the element is a player or not.
*[[attachElementToBone]] » This function allows you to attach an element to ped bone accurately using new bone functions.
*[[getElementsInDimension]] » This function returns a table of elements that are in the specified dimension.
*[[getElementSpeed]] » This function returns the specified element's speed in m/s, km/h or mph.
*[[getElementsWithinMarker]] » This function returns a table of elements that are within a marker's collision shape.
*[[getElementUsingData]] » This function returns table elements that contains the elements data with the given key and value.
*[[getNearestElement]] » This function returns the nearest element (of a specific type) to a player.
*[[isElementInPhotograph]] » This function checks if an element is in the player's camera picture area.
*[[isElementInRange]] » This function allows you to check if an element's range to a main point is within the maximum range.
*[[isElementMoving]]» This function checks if an element is moving.
*[[isElementWithinAColShape]]» This function checks if an element is within a collision shape element.
*[[isElementInAir]]» This function checks if an element is in air or not.
*[[multi_check]] » This function checks one element to many, handy and clean.
*[[setElementSpeed]] » This function allows you to set the speed of an element in kph or mph units.

=== Events ===
*[[onVehicleWeaponFire]] » This code implements an event that is triggered when a player in a vehicle fires a vehicle's weapon.

=== Input functions ===
*[[bindControlKeys]] » This function allows you to bind each key bound to a control individually. Doing this bypasses a little MTA restriction.
*[[getBoundControls]] » This function returns a table of control names that are bound to the specified key.
*[[unbindControlKeys]] » This function allows you to unbind each key bound to a control individually. Use this function with [[bindControlKeys]].

=== Data functions ===
*[[byte2human]] » This function converts an integer (number of bytes) into a human-readable unit.
*[[capitalize]] » This function capitalizes a given string.
*[[convertDate]] » This function converts date to another look.
*[[convertServerTickToTimeStamp]] » This function converts server ticks to a unix timestamp.
*[[convertTextToSpeech]] » This function converts the provided text to a speech in the provided language which players can hear.
*[[findRotation3D]] » This function takes two sets of XYZ coordinates. It returns the 3D direction from point A to point B.
*[[findRotation]] » This function takes two points and returns the direction from point A to point B.
*[[formatDate]] » This function formats a date on the basis of a format string and returns it.
*[[formatNumber]] » This function formats large numbers by adding commas.
*[[generateRandomASCIIString]] » This function returns a random string which uses ASCII characters. 
*[[generateString]] » This function generates a random string with any characters.
*[[getAge]] » This function calculates the age of a given birthday.
*[[getDistance]] » Returns the distance between two elements.
*[[getDistanceBetweenElements]] » Esta funcion sirve para obtener la distancia entre dos elementos.
*[[getDistanceBetweenPointAndSegment2D]] » This function takes point coordinates and line (a segment) starting and ending coordinates. It returns the shortest distance between the point and the line.
*[[getEasterDate]] » This function returns easter date monthday and month for a given year.
*[[getFreeDimension]] » This function get free dimension.
*[[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.
*[[getPointFromDistanceRotation]] » This function finds a point based on a starting point, direction and distance.
*[[getRealMonth]] » This function returns the current month name
*[[getRGColorFromPercentage]] »This function returns two integers representing red and green colors according to the specified percentage.
*[[getScreenRotationFromWorldPosition]] » This function returns a screen relative rotation to a world position.
*[[getTimestamp]] » This function returns the UNIX timestamp of a specified date and time.
*[[gradientString]] » This function transforms a string in a new coloured gradient string.
*[[hex2rgb]] » This function convert hex to rgb.
*[[hexColorToRGB]] » This function convert hex string/number to RGBA values.
*[[isLeapYear]] » This function returns a boolean representing if a given year is a leap year.
*[[isValidMail]] » This function checks whether a provided e-mail string is valid.
*[[removeHex]] » This function is used to remove hexadecimal numbers (colors, for example) from strings.
*[[RGBToHex]] » This function returns a string representing the color in hexadecimal.
*[[RGBToHSV]] » This function convert RGB to HSV color space.
*[[secondsToTimeDesc]] » This function converts a plain seconds-integer into a user-friendly time description.
*[[string.count]] » This function counts the amount of occurences of a string in a string.
*[[string.explode]] » This function splits a string at a given separator pattern and returns a table with the pieces.
*[[string.insert]] » This function inserts a string within another string at a given position.
*[[switch]] » This function allows the value of a variable or expression to control the flow of program execution via a multiway branch.
*[[tocolor2rgba]] » This function convert tocolor to rgba.
*[[toHex]] » This function converts a decimal number to a hexadecimal number, as a fix to be used client-side.
*[[var dump]] » This function outputs information about one or more variables using outputConsole.
*[[wavelengthToRGBA]] » This function converts a physical wavelength of light to a RGBA color.

=== GUI functions ===
*[[centerWindow]] » This function centers a CEGUI window element responsively in any resolution.
*[[guiMoveElement]] » This function moves guiElement by/like using moveObject.
*[[guiSetStaticImageMovable]] » This function allows you to move a static image like a gui window.
*[[isMouseOnGUICloseButton]] » This function allows you to check whether the mouse cursor/pointer is within a gui-window's native close button.
*[[isMouseOnGuiElement]] » This function allows you to check whether or not your mouse is over a specific gui element, this is especially useful if the gui element has a parent. 
=====Comboboxes=====
*[[guiComboBoxAdjustHeight]] » This function adjusts a CEGUI combobox element to have the correct height.

=====Gridlists=====
*[[convertGridListToText]] » This function converts grid list contents to text.
*[[getGridListRowIndexFromText]] » This function returns the GridList row index from the specified text.
*[[guiGridListAddPlayers]] » This function add all online players to a grid list.
*[[guiGridListGetColumnIDFromTitle]] » This function gets a gridlist's column ID from the column title.
*[[guiGridListGetSelectedText]] » This function returns a string containing the inner text of a selected gridlist item.
*[[guiGridListSetColumnNonSortable]] » This function makes a gridlist column become non-sortable.
*[[guiGridListSetColumnsFixedWidth]] » This function makes a gridlist have all its columns fixed width.
*[[isTextInGridList]] » This function checks if some text exist or not in the GridList.

=====Labels=====
*[[guiLabelAddEffect]] » This function add an effects to the gui-label like (shadow, outline).

=== Marker functions ===
*[[createMarkerAttachedTo]] » This function creates a marker that is attached to an element.

=== Math functions ===
*[[math.clamp]] » This function returns the number between range of numbers or it's minimum or maximum.
*[[math.getBezierPoint]] » Get N-th order bezier point.
*[[math.hypot]] » This function returns the Hypotenuse of the triangle given by sides x and y.
*[[math.isPointInPolygon]] » Check if point is inside polygon or not.
*[[math.lerp]] » Get val between two integer.
*[[math.percent]] » This function returns a percentage from two number values.
*[[math.polygonArea]] » Compute area of any polygon.
*[[math.randomDiff]] » Generates a pseudo-random integer that's always different from the last random number generated.
*[[math.rotVecToEulerAngle]] » Rotation Vector To Euler Angle
*[[math.round]] » Rounds a number whereas the number of decimals to keep and the method may be set.
*[[mathNumber]] » This function is a workaround for the client-side floating-point precision of 24-bits.
*[[reMap]] » Re-maps a number from one range to another.
*[[Math.percentProgress|math.percentProgress]] » Returns a percentage progress from two specific values.
*[[math.average]] » This function returns the simple arithmetic mean of multiple numbers.

=== Map functions ===
*[[assignLod]] » This function lets you conveniently generate and apply a LOD model to a mapping object.
*[[getWorldPositionFromMapPosition]] » This function converts an F11 map position to world position.

=== Ped functions ===
*[[getAlivePlayers (Client)|getAlivePlayers]] » This function returns a table of the alive players client-side.
*[[getAlivePlayersInTeam]] » This function returns a table of the alive players in a team.
*[[getGuestPlayers]] » This function gets a players not login or players Guest .
*[[getOnlineAdmins]] » This function returns a table of all logged-in administrators.
*[[getPedEyesPosition]] » This function allows you to get peds eyes position.
*[[getPedGender]] » This function allows you to get peds their gender.
*[[getPedMaxHealth]] » This function returns a pedestrians's maximum health by converting it from their maximum health stat.
*[[getPedMaxOxygenLevel]] » This function returns a ped's maximum oxygen level by converting it from their maximum underwater stamina stat.
*[[getPedWeaponSkill]] » This function returns a ped's corresponding weapon skill level name.
*[[getPlayerFromNamePart]] » This function returns a player from partial name.
*[[getPlayerFromSerial]] » This function returns a player from their serial.
*[[getPlayersByData]] » This function returns a table of players that have the specified data name.
*[[getPlayersInPhotograph]] » This function returns a table of all players in photograph.
*[[getPlayersInVehicles]] » This function returns a table of the players insides vehicles from a specified dimension.
*[[isPedAiming]]» This function checks if a pedestrian is aiming their weapon.
*[[isPedAimingNearPed]] » This is similar to isPedAiming but uses a colshape to be more precise.
*[[isPedDiving]] » This feature checks that pedestrian is diving in the water.
*[[isPedDrivingVehicle]] » This function checks if a specified pedestrian is driving a vehicle.
*[[isPlayerInTeam]] » This function checks if a player is in a specified team.
*[[setPedAttack]] » This function will make a ped attack a specified target.
*[[setPedFollow]] » This function will make a ped follow a specified target.
*[[getPlayerNameFromID]] » This function will get the player name from the ID element data.

=== Player functions ===
*[[countPlayersInRange]] » This function returns the number of players that are within a certain range of the specified coordinates.
*[[getPlayerPreviousAndNextWeapon]] » This function returns the player previous and next weapon.
*[[getPlayersInRange]]» This function make a table of players within certain range.
*[[isPlayerHitByVehicle]]» This function cancels event when a element is hit by a vehicle.
*[[warpToPlayer]]» This function make player warp to another player.

=== Resource functions ===
*[[getFilesInResourceFolder]] » This function gets a list of files that are inside a folder of a resource.
*[[getResourceScripts]] » This function returns a table of the resource scripts.
*[[getResourceSettings]] » This function returns a table of the resource settings.
*[[getResourceSize]] » This function returns the size of a specified resource in kB(kilobyte)
*[[refreshResource]] » This function refreshes your resource if you changed any of the files
*[[setResourcePriority]] » This function set resource download priority group.

=== Sound functions ===
*[[isSoundFinished]] » This function checks if a sound element has finished.
*[[isSoundPlaying]] » This function checks if a sound element is playing or not.
*[[stopSoundSlowly]] » This function stop your sound element slowly.

=== Browser functions ===
*[[playVideo]] » This function plays a video on the screen.

=== Team functions ===
*[[getTeamFromColor]] » This function returns a team element by the specified color.
*[[getTeamWithFewestPlayers]] » This function returns a team element with least players of all the specified teams.

=== Vehicle functions ===
*[[findEmptyCarSeat]] » This function finds you the first empty seat in a vehicle.
*[[getNearestVehicle]] » This function gets the nearest vehicle to the specified player in a specified distance.
*[[getRandomVehicle]] » This function gets a random vehicle.
*[[getValidVehicleModels]] » This function returns a table of all valid vehicle models.
*[[getVehiclesCountByType]] » This function returns the amount of vehicles by the given type as an integer value.
*[[getVehicleTurnVelocityCenterOfMass]]» This function gets a vehicle's turn velocity relative to the vehicle's center or mass.
*[[isVehicleDoubleExhaust]] » This function checks is exhaust vehicle double.
*[[isVehicleEmpty]] » This function checks whether a vehicle is empty.
*[[isVehicleOccupied]] » This function checks if a specified vehicle is occupied.
*[[isVehicleOnRoof]] » This function checks whether vehicle is on roof.
*[[isVehicleReversing]] » This function checks if a specified vehicle is moving backwards.
*[[isVehicleUpgraded]] » This function checks is vehicle upgraded by upgrade ID.
*[[setVehicleGravityPoint]] » This function sets a vehicle's gravity in the direction of a 3 dimensional coordinate with the strength specified.
*[[setVehicleTurnVelocityCenterOfMass]]» This function sets a vehicle's turn velocity relative to the vehicle's center or mass.

=== Weapon functions ===
*[[getJetpackWeaponsEnabled]] » This function returns a table of enabled weapons usable on a jetpack.

=== Object functions ===
*[[getDynamicDoorObjectOpenRatio]] » This function tells you how open a dynamic door is in a range from 0 to 1.
*[[isElementObject]] » This function tells you if an element is an object or no.

=== XML functions ===
*[[getXMLNodes]] » This function returns all children of a XML node.

=== Engine functions ===
*[[engineGetCOLsFromLibrary]] » This function gets the collision data from the col library.
*[[engineLoadIMGContainer]] » This function loads the IMG container.

=== Utility ===
*[[animate]] » This function allows you to use interpolateBetween without render event and easily used.
*[[callClientFunction]] » This function allows you to call any client-side function from the server's side.
*[[callServerFunction]] » This function allows you to call any server-side function from the client's side.
*[[check]] » This function checks if its arguments are of the right type and calls the error-function if one is not.
*[[checkPassiveTimer]] » This function allows you to use passive timers in your conditions. For example you want to prevent players repeatedly using a command.
*[[coroutine.resume]] » This function applies a fix for hidden coroutine error messages.
*[[getBanFromName]] » This functions returns the ban of the given playername.
*[[getCurrentFPS]] » This function returns the frames per second at which GTA: SA is running.
*[[getSkinNameFromID]] » This function returns the name of the skin from the given id.
*[[IfElse]] » This function returns one of two values based on a boolean expression.
*[[isCharInString]] » This shared function allows you to check if a char specified is in a string value.
*[[isMouseInCircle]] » This function checks if a cursor position is in circular area or not.
*[[isMouseInPosition]] » This function allows you to check whether the mouse cursor/pointer is within a rectangular position.
*[[iterElements]] » This function returns ''a time-saving'' iterator for your for-loops.
*[[PlotTrajectoryAtTime]] » Calculate projectile/water trajectory.
*[[preprocessor]] » This function allow you to use gcc macros.
*[[vector3:compare]] » This method checks whether two vectors match, with optional precision.

<noinclude>[[Category:Useful Functions]]</noinclude>

Template:Useful Functions

2022-04-28T16:38:39Z

Hydra: /* Ped functions */

__NOTOC__
=== Table functions ===
*[[addTableChangeHandler]] » This function monitors the changes of a table.
*[[getTableFromSql]] » This functionality is used to obtain saved tables using the function ([https://wiki.multitheftauto.com/wiki/SetTableToSql SetTableToSql ]).
*[[isValueInTable]] » This function returns true if the value exists in the table, false if the value does not exist in the table.
*[[pairsByKeys]] » This function sort pairs table.
*[[rangeToTable]] » This function converts a string range to a table containing number values.
*[[setTableProtected]] » This function protects a table and makes it read-only.
*[[setTableToSql]] » This function is used to save the table in the database (sql).
*[[Sort_Functions]] » These functions are able to sort your tables by a key.
*[[table.compare]] » This function checks whether two given tables are equal.
*[[table.copy]] » This function copies a whole table and all the tables in that table.
*[[table.deepmerge]] » This function deep merges two tables. Every nested table will be correspondingly merged.
*[[table.element]] » This function returns a new table with only userdata content.
*[[table.empty]] » This function checks whether a table is empty.
*[[table.fromString]] » This function converts string to a table.
*[[table.getRandomRows]] » This function returns random rows from table.
*[[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]] » This function merges two or more tables together.
*[[table.random]] » This function retrieves a random value from a table.
*[[table.removeValue]] » This function removes a specified value from a table.
*[[table.size]] » This function returns the absolute size of a table.
*[[table.toString]] » This function converts table to a string.
*[[table.toStringArray]] » This function converts '''array''' to a string.

=== ACL functions ===
*[[aclGroupClone]] » This function clone a group to another group with/without ACLs and/or objects.
*[[getAccountsRanks]] » This function is used to detect the account name groups and put them in the chat.
*[[getPlayerAcls]] » This function returns a table of all ACL groups on a player.
*[[getPlayersInACLGroup]] » This function returns all players in an ACL group.
*[[isPlayerInACL]] » This function checks if a player element is in an ACL group.
*[[renameAclGroup]] » This function gives an existing ACL group a new name.

=== Account functions ===
*[[getPlayerFromAccountName]] » This function is used to obtain a player by the name of his account.

=== Camera functions ===
*[[smoothMoveCamera]] » This function allows you to create a cinematic camera flight.

=== Cursor functions ===
*[[getCursorMovedOn]] » This function checks in which way the cursor is currently moving.

=== Drawing functions ===
*[[dxDrawAnimWindow]] » This function draws an animated 2D window on the screen.
*[[dxDrawBorderedRectangle]] » This is a function that will create a bordered rectangle.
*[[dxDrawBorderedText]] » This is a function that will create a bordered text.
*[[dxDrawDashedLine]] » This function draws a line with dashes.
*[[dxDrawGifImage]] » This function simulates the effect of a GIF image by using image sprites in 2D.
*[[dxDrawImage3D]] » This function draws a 3D image in GTA world.
*[[dxDrawImageOnElement]] » This function draws an image on any element.
*[[dxDrawLinedRectangle]] » This is a function that will create a rectangle outline with dx lines.
*[[dxDrawLoading]] » This function draws a loading bar on the screen.
*[[dxDrawOctagon3D]] » This function creates a 3D Octagon
*[[dxDrawPolygon]] » This function draws a custom polygon on the screen.
*[[dxDrawProgressBar]] » This function simulates a progress bar drawed using DirectDraw.
*[[dxDrawRectangle3D]] » This function draws a 3D rectangle in GTA world.
*[[dxDrawRectangleOnPlayer]] » This function draws a 3D rectangle above the player.
*[[dxDrawRing]] » This function draws a ring with dx lines.
*[[dxDrawRombo]] » This function creates a Rhombus.
*[[dxDrawSprite]] » This function draw a sprite in the 3D world.
*[[dxDrawTextOnElement]] » This function draws a text on any element.
*[[dxDrawTextOnRectangle]] » Esta funcion crea un rectangle con un texto dentro.
*[[dxDrawTriangle]] » This is a function that will create a triangle with dx lines.
*[[dxGetFontSizeFromHeight]] » This function calculates the font size from given height.
*[[dxGetRealFontHeight]] » This function calculates the height of a font.
*[[getScreenStartPositionFromBox]] » This function helps with getting the correct position for your dx-effects.
*[[wordWrap]] » This function breaks a long string into a table of separate lines limited to a specific length in pixels, for drawing separately.

=== Effects functions ===
*[[attachEffect]] » This function allows you attach an effect to an element.

=== Element functions ===
*[[autoAttach]] » This function attaches one element into another at the same position and rotation they are.
*[[isElementPlayer]] » This function checks whether the element is a player or not.
*[[attachElementToBone]] » This function allows you to attach an element to ped bone accurately using new bone functions.
*[[getElementsInDimension]] » This function returns a table of elements that are in the specified dimension.
*[[getElementSpeed]] » This function returns the specified element's speed in m/s, km/h or mph.
*[[getElementsWithinMarker]] » This function returns a table of elements that are within a marker's collision shape.
*[[getElementUsingData]] » This function returns table elements that contains the elements data with the given key and value.
*[[getNearestElement]] » This function returns the nearest element (of a specific type) to a player.
*[[isElementInPhotograph]] » This function checks if an element is in the player's camera picture area.
*[[isElementInRange]] » This function allows you to check if an element's range to a main point is within the maximum range.
*[[isElementMoving]]» This function checks if an element is moving.
*[[isElementWithinAColShape]]» This function checks if an element is within a collision shape element.
*[[isElementInAir]]» This function checks if an element is in air or not.
*[[multi_check]] » This function checks one element to many, handy and clean.
*[[setElementSpeed]] » This function allows you to set the speed of an element in kph or mph units.

=== Events ===
*[[onVehicleWeaponFire]] » This code implements an event that is triggered when a player in a vehicle fires a vehicle's weapon.

=== Input functions ===
*[[bindControlKeys]] » This function allows you to bind each key bound to a control individually. Doing this bypasses a little MTA restriction.
*[[getBoundControls]] » This function returns a table of control names that are bound to the specified key.
*[[unbindControlKeys]] » This function allows you to unbind each key bound to a control individually. Use this function with [[bindControlKeys]].

=== Data functions ===
*[[byte2human]] » This function converts an integer (number of bytes) into a human-readable unit.
*[[capitalize]] » This function capitalizes a given string.
*[[convertDate]] » This function converts date to another look.
*[[convertServerTickToTimeStamp]] » This function converts server ticks to a unix timestamp.
*[[convertTextToSpeech]] » This function converts the provided text to a speech in the provided language which players can hear.
*[[findRotation3D]] » This function takes two sets of XYZ coordinates. It returns the 3D direction from point A to point B.
*[[findRotation]] » This function takes two points and returns the direction from point A to point B.
*[[formatDate]] » This function formats a date on the basis of a format string and returns it.
*[[formatNumber]] » This function formats large numbers by adding commas.
*[[generateRandomASCIIString]] » This function returns a random string which uses ASCII characters. 
*[[generateString]] » This function generates a random string with any characters.
*[[getAge]] » This function calculates the age of a given birthday.
*[[getDistance]] » Returns the distance between two elements.
*[[getDistanceBetweenElements]] » Esta funcion sirve para obtener la distancia entre dos elementos.
*[[getDistanceBetweenPointAndSegment2D]] » This function takes point coordinates and line (a segment) starting and ending coordinates. It returns the shortest distance between the point and the line.
*[[getEasterDate]] » This function returns easter date monthday and month for a given year.
*[[getFreeDimension]] » This function get free dimension.
*[[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.
*[[getPointFromDistanceRotation]] » This function finds a point based on a starting point, direction and distance.
*[[getRealMonth]] » This function returns the current month name
*[[getRGColorFromPercentage]] »This function returns two integers representing red and green colors according to the specified percentage.
*[[getScreenRotationFromWorldPosition]] » This function returns a screen relative rotation to a world position.
*[[getTimestamp]] » This function returns the UNIX timestamp of a specified date and time.
*[[gradientString]] » This function transforms a string in a new coloured gradient string.
*[[hex2rgb]] » This function convert hex to rgb.
*[[hexColorToRGB]] » This function convert hex string/number to RGBA values.
*[[isLeapYear]] » This function returns a boolean representing if a given year is a leap year.
*[[isValidMail]] » This function checks whether a provided e-mail string is valid.
*[[removeHex]] » This function is used to remove hexadecimal numbers (colors, for example) from strings.
*[[RGBToHex]] » This function returns a string representing the color in hexadecimal.
*[[RGBToHSV]] » This function convert RGB to HSV color space.
*[[secondsToTimeDesc]] » This function converts a plain seconds-integer into a user-friendly time description.
*[[string.count]] » This function counts the amount of occurences of a string in a string.
*[[string.explode]] » This function splits a string at a given separator pattern and returns a table with the pieces.
*[[string.insert]] » This function inserts a string within another string at a given position.
*[[switch]] » This function allows the value of a variable or expression to control the flow of program execution via a multiway branch.
*[[tocolor2rgba]] » This function convert tocolor to rgba.
*[[toHex]] » This function converts a decimal number to a hexadecimal number, as a fix to be used client-side.
*[[var dump]] » This function outputs information about one or more variables using outputConsole.
*[[wavelengthToRGBA]] » This function converts a physical wavelength of light to a RGBA color.

=== GUI functions ===
*[[centerWindow]] » This function centers a CEGUI window element responsively in any resolution.
*[[guiMoveElement]] » This function moves guiElement by/like using moveObject.
*[[guiSetStaticImageMovable]] » This function allows you to move a static image like a gui window.
*[[isMouseOnGUICloseButton]] » This function allows you to check whether the mouse cursor/pointer is within a gui-window's native close button.
*[[isMouseOnGuiElement]] » This function allows you to check whether or not your mouse is over a specific gui element, this is especially useful if the gui element has a parent. 
=====Comboboxes=====
*[[guiComboBoxAdjustHeight]] » This function adjusts a CEGUI combobox element to have the correct height.

=====Gridlists=====
*[[convertGridListToText]] » This function converts grid list contents to text.
*[[getGridListRowIndexFromText]] » This function returns the GridList row index from the specified text.
*[[guiGridListAddPlayers]] » This function add all online players to a grid list.
*[[guiGridListGetColumnIDFromTitle]] » This function gets a gridlist's column ID from the column title.
*[[guiGridListGetSelectedText]] » This function returns a string containing the inner text of a selected gridlist item.
*[[guiGridListSetColumnNonSortable]] » This function makes a gridlist column become non-sortable.
*[[guiGridListSetColumnsFixedWidth]] » This function makes a gridlist have all its columns fixed width.
*[[isTextInGridList]] » This function checks if some text exist or not in the GridList.

=====Labels=====
*[[guiLabelAddEffect]] » This function add an effects to the gui-label like (shadow, outline).

=== Marker functions ===
*[[createMarkerAttachedTo]] » This function creates a marker that is attached to an element.

=== Math functions ===
*[[math.clamp]] » This function returns the number between range of numbers or it's minimum or maximum.
*[[math.getBezierPoint]] » Get N-th order bezier point.
*[[math.hypot]] » This function returns the Hypotenuse of the triangle given by sides x and y.
*[[math.isPointInPolygon]] » Check if point is inside polygon or not.
*[[math.lerp]] » Get val between two integer.
*[[math.percent]] » This function returns a percentage from two number values.
*[[math.polygonArea]] » Compute area of any polygon.
*[[math.randomDiff]] » Generates a pseudo-random integer that's always different from the last random number generated.
*[[math.rotVecToEulerAngle]] » Rotation Vector To Euler Angle
*[[math.round]] » Rounds a number whereas the number of decimals to keep and the method may be set.
*[[mathNumber]] » This function is a workaround for the client-side floating-point precision of 24-bits.
*[[reMap]] » Re-maps a number from one range to another.
*[[Math.percentProgress|math.percentProgress]] » Returns a percentage progress from two specific values.
*[[math.average]] » This function returns the simple arithmetic mean of multiple numbers.

=== Map functions ===
*[[assignLod]] » This function lets you conveniently generate and apply a LOD model to a mapping object.
*[[getWorldPositionFromMapPosition]] » This function converts an F11 map position to world position.

=== Ped functions ===
*[[getAlivePlayers (Client)|getAlivePlayers]] » This function returns a table of the alive players client-side.
*[[getAlivePlayersInTeam]] » This function returns a table of the alive players in a team.
*[[getGuestPlayers]] » This function gets a players not login or players Guest .
*[[getOnlineAdmins]] » This function returns a table of all logged-in administrators.
*[[getPedEyesPosition]] » This function allows you to get peds eyes position.
*[[getPedGender]] » This function allows you to get peds their gender.
*[[getPedMaxHealth]] » This function returns a pedestrians's maximum health by converting it from their maximum health stat.
*[[getPedMaxOxygenLevel]] » This function returns a ped's maximum oxygen level by converting it from their maximum underwater stamina stat.
*[[getPedWeaponSkill]] » This function returns a ped's corresponding weapon skill level name.
*[[getPlayerFromNamePart]] » This function returns a player from partial name.
*[[getPlayerFromSerial]] » This function returns a player from their serial.
*[[getPlayersByData]] » This function returns a table of players that have the specified data name.
*[[getPlayersInPhotograph]] » This function returns a table of all players in photograph.
*[[getPlayersInVehicles]] » This function returns a table of the players insides vehicles from a specified dimension.
*[[isPedAiming]]» This function checks if a pedestrian is aiming their weapon.
*[[isPedAimingNearPed]] » This is similar to isPedAiming but uses a colshape to be more precise.
*[[isPedDiving]] » This feature checks that pedestrian is diving in the water.
*[[isPedDrivingVehicle]] » This function checks if a specified pedestrian is driving a vehicle.
*[[isPlayerInTeam]] » This function checks if a player is in a specified team.
*[[setPedAttack]] » This function will make a ped attack a specified target.
*[[setPedFollow]] » This function will make a ped follow a specified target.
*[[getPlayerNameFromID]] » This function will get the player name from the ID element data.
*[[getPlayerFromDimension]] » This function will get the player name from a dimension.

=== Player functions ===
*[[countPlayersInRange]] » This function returns the number of players that are within a certain range of the specified coordinates.
*[[getPlayerPreviousAndNextWeapon]] » This function returns the player previous and next weapon.
*[[getPlayersInRange]]» This function make a table of players within certain range.
*[[isPlayerHitByVehicle]]» This function cancels event when a element is hit by a vehicle.
*[[warpToPlayer]]» This function make player warp to another player.

=== Resource functions ===
*[[getFilesInResourceFolder]] » This function gets a list of files that are inside a folder of a resource.
*[[getResourceScripts]] » This function returns a table of the resource scripts.
*[[getResourceSettings]] » This function returns a table of the resource settings.
*[[getResourceSize]] » This function returns the size of a specified resource in kB(kilobyte)
*[[refreshResource]] » This function refreshes your resource if you changed any of the files
*[[setResourcePriority]] » This function set resource download priority group.

=== Sound functions ===
*[[isSoundFinished]] » This function checks if a sound element has finished.
*[[isSoundPlaying]] » This function checks if a sound element is playing or not.
*[[stopSoundSlowly]] » This function stop your sound element slowly.

=== Browser functions ===
*[[playVideo]] » This function plays a video on the screen.

=== Team functions ===
*[[getTeamFromColor]] » This function returns a team element by the specified color.
*[[getTeamWithFewestPlayers]] » This function returns a team element with least players of all the specified teams.

=== Vehicle functions ===
*[[findEmptyCarSeat]] » This function finds you the first empty seat in a vehicle.
*[[getNearestVehicle]] » This function gets the nearest vehicle to the specified player in a specified distance.
*[[getRandomVehicle]] » This function gets a random vehicle.
*[[getValidVehicleModels]] » This function returns a table of all valid vehicle models.
*[[getVehiclesCountByType]] » This function returns the amount of vehicles by the given type as an integer value.
*[[getVehicleTurnVelocityCenterOfMass]]» This function gets a vehicle's turn velocity relative to the vehicle's center or mass.
*[[isVehicleDoubleExhaust]] » This function checks is exhaust vehicle double.
*[[isVehicleEmpty]] » This function checks whether a vehicle is empty.
*[[isVehicleOccupied]] » This function checks if a specified vehicle is occupied.
*[[isVehicleOnRoof]] » This function checks whether vehicle is on roof.
*[[isVehicleReversing]] » This function checks if a specified vehicle is moving backwards.
*[[isVehicleUpgraded]] » This function checks is vehicle upgraded by upgrade ID.
*[[setVehicleGravityPoint]] » This function sets a vehicle's gravity in the direction of a 3 dimensional coordinate with the strength specified.
*[[setVehicleTurnVelocityCenterOfMass]]» This function sets a vehicle's turn velocity relative to the vehicle's center or mass.

=== Weapon functions ===
*[[getJetpackWeaponsEnabled]] » This function returns a table of enabled weapons usable on a jetpack.

=== Object functions ===
*[[getDynamicDoorObjectOpenRatio]] » This function tells you how open a dynamic door is in a range from 0 to 1.
*[[isElementObject]] » This function tells you if an element is an object or no.

=== XML functions ===
*[[getXMLNodes]] » This function returns all children of a XML node.

=== Engine functions ===
*[[engineGetCOLsFromLibrary]] » This function gets the collision data from the col library.
*[[engineLoadIMGContainer]] » This function loads the IMG container.

=== Utility ===
*[[animate]] » This function allows you to use interpolateBetween without render event and easily used.
*[[callClientFunction]] » This function allows you to call any client-side function from the server's side.
*[[callServerFunction]] » This function allows you to call any server-side function from the client's side.
*[[check]] » This function checks if its arguments are of the right type and calls the error-function if one is not.
*[[checkPassiveTimer]] » This function allows you to use passive timers in your conditions. For example you want to prevent players repeatedly using a command.
*[[coroutine.resume]] » This function applies a fix for hidden coroutine error messages.
*[[getBanFromName]] » This functions returns the ban of the given playername.
*[[getCurrentFPS]] » This function returns the frames per second at which GTA: SA is running.
*[[getSkinNameFromID]] » This function returns the name of the skin from the given id.
*[[IfElse]] » This function returns one of two values based on a boolean expression.
*[[isCharInString]] » This shared function allows you to check if a char specified is in a string value.
*[[isMouseInCircle]] » This function checks if a cursor position is in circular area or not.
*[[isMouseInPosition]] » This function allows you to check whether the mouse cursor/pointer is within a rectangular position.
*[[iterElements]] » This function returns ''a time-saving'' iterator for your for-loops.
*[[PlotTrajectoryAtTime]] » Calculate projectile/water trajectory.
*[[preprocessor]] » This function allow you to use gcc macros.
*[[vector3:compare]] » This method checks whether two vectors match, with optional precision.

<noinclude>[[Category:Useful Functions]]</noinclude>

GetPlayerNameFromID

2022-04-28T16:20:32Z

Hydra: Created page with "{{Useful Function}} __NOTOC__ This function will get the player name using the ID element data. ==Syntax== <syntaxhighlight lang="lua">bool getPlayerNameFromID(number theID, element theElement)</syntaxhighlight> ===Required Arguments=== * '''theID''': The id number. * '''theElement''': The player element. ==Code== <section name="Clientside script" class="client" show="true"> <syntaxhighlight lang="lua"> function getPlayerNameFromID(theID, theElement) if isElement(t..."

{{Useful Function}}
__NOTOC__
This function will get the player name using the ID element data.

==Syntax==
<syntaxhighlight lang="lua">bool getPlayerNameFromID(number theID, element theElement)</syntaxhighlight>

===Required Arguments===
* '''theID''': The id number.
* '''theElement''': The player element.

==Code==
<section name="Clientside script" class="client" show="true">
<syntaxhighlight lang="lua">
function getPlayerNameFromID(theID, theElement)
if isElement(theElement) and getElementType(theElement) == "player" and tonumber(theID) then
for k, v in ipairs(getElementsByType("player")) do
if getElementData(v, "ID") == getElementData(theElement, "ID") then
return getPlayerName(v)
else
iprint("Player not found")
end
end
end
end
</syntaxhighlight>
</section>

==Example==

'''The example will show you how to get the player name using getPlayerNameFromID'''

<syntaxhighlight lang="lua">
function SetIDOnJoin()
setElementData(source, "ID", math.random(1, 500))
end
addEventHandler("onPlayerJoin", root, SetIDOnJoin)

function getMyID(thePlayer, theCommand)
iprint(getPlayerNameFromID(getElementData(thePlayer, "ID"), thePlayer))
end
addCommandHandler("tid", getMyID)
</syntaxhighlight>

==Author==

'''by Hydra45'''
'''Discord: Hydra45#6859'''

==See Also==
{{Useful_Functions}}

Template:Useful Functions

2022-04-28T16:11:01Z

Hydra: /* Ped functions */

__NOTOC__
=== Table functions ===
*[[addTableChangeHandler]] » This function monitors the changes of a table.
*[[getTableFromSql]] » This functionality is used to obtain saved tables using the function ([https://wiki.multitheftauto.com/wiki/SetTableToSql SetTableToSql ]).
*[[isValueInTable]] » This function returns true if the value exists in the table, false if the value does not exist in the table.
*[[pairsByKeys]] » This function sort pairs table.
*[[rangeToTable]] » This function converts a string range to a table containing number values.
*[[setTableProtected]] » This function protects a table and makes it read-only.
*[[setTableToSql]] » This function is used to save the table in the database (sql).
*[[Sort_Functions]] » These functions are able to sort your tables by a key.
*[[table.compare]] » This function checks whether two given tables are equal.
*[[table.copy]] » This function copies a whole table and all the tables in that table.
*[[table.deepmerge]] » This function deep merges two tables. Every nested table will be correspondingly merged.
*[[table.element]] » This function returns a new table with only userdata content.
*[[table.empty]] » This function checks whether a table is empty.
*[[table.fromString]] » This function converts string to a table.
*[[table.getRandomRows]] » This function returns random rows from table.
*[[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]] » This function merges two or more tables together.
*[[table.random]] » This function retrieves a random value from a table.
*[[table.removeValue]] » This function removes a specified value from a table.
*[[table.size]] » This function returns the absolute size of a table.
*[[table.toString]] » This function converts table to a string.
*[[table.toStringArray]] » This function converts '''array''' to a string.

=== ACL functions ===
*[[aclGroupClone]] » This function clone a group to another group with/without ACLs and/or objects.
*[[getAccountsRanks]] » This function is used to detect the account name groups and put them in the chat.
*[[getPlayerAcls]] » This function returns a table of all ACL groups on a player.
*[[getPlayersInACLGroup]] » This function returns all players in an ACL group.
*[[isPlayerInACL]] » This function checks if a player element is in an ACL group.
*[[renameAclGroup]] » This function gives an existing ACL group a new name.

=== Account functions ===
*[[getPlayerFromAccountName]] » This function is used to obtain a player by the name of his account.

=== Camera functions ===
*[[smoothMoveCamera]] » This function allows you to create a cinematic camera flight.

=== Cursor functions ===
*[[getCursorMovedOn]] » This function checks in which way the cursor is currently moving.

=== Drawing functions ===
*[[dxDrawAnimWindow]] » This function draws an animated 2D window on the screen.
*[[dxDrawBorderedRectangle]] » This is a function that will create a bordered rectangle.
*[[dxDrawBorderedText]] » This is a function that will create a bordered text.
*[[dxDrawDashedLine]] » This function draws a line with dashes.
*[[dxDrawGifImage]] » This function simulates the effect of a GIF image by using image sprites in 2D.
*[[dxDrawImage3D]] » This function draws a 3D image in GTA world.
*[[dxDrawImageOnElement]] » This function draws an image on any element.
*[[dxDrawLinedRectangle]] » This is a function that will create a rectangle outline with dx lines.
*[[dxDrawLoading]] » This function draws a loading bar on the screen.
*[[dxDrawOctagon3D]] » This function creates a 3D Octagon
*[[dxDrawPolygon]] » This function draws a custom polygon on the screen.
*[[dxDrawProgressBar]] » This function simulates a progress bar drawed using DirectDraw.
*[[dxDrawRectangle3D]] » This function draws a 3D rectangle in GTA world.
*[[dxDrawRectangleOnPlayer]] » This function draws a 3D rectangle above the player.
*[[dxDrawRing]] » This function draws a ring with dx lines.
*[[dxDrawRombo]] » This function creates a Rhombus.
*[[dxDrawSprite]] » This function draw a sprite in the 3D world.
*[[dxDrawTextOnElement]] » This function draws a text on any element.
*[[dxDrawTextOnRectangle]] » Esta funcion crea un rectangle con un texto dentro.
*[[dxDrawTriangle]] » This is a function that will create a triangle with dx lines.
*[[dxGetFontSizeFromHeight]] » This function calculates the font size from given height.
*[[dxGetRealFontHeight]] » This function calculates the height of a font.
*[[getScreenStartPositionFromBox]] » This function helps with getting the correct position for your dx-effects.
*[[wordWrap]] » This function breaks a long string into a table of separate lines limited to a specific length in pixels, for drawing separately.

=== Effects functions ===
*[[attachEffect]] » This function allows you attach an effect to an element.

=== Element functions ===
*[[autoAttach]] » This function attaches one element into another at the same position and rotation they are.
*[[isElementPlayer]] » This function checks whether the element is a player or not.
*[[attachElementToBone]] » This function allows you to attach an element to ped bone accurately using new bone functions.
*[[getElementsInDimension]] » This function returns a table of elements that are in the specified dimension.
*[[getElementSpeed]] » This function returns the specified element's speed in m/s, km/h or mph.
*[[getElementsWithinMarker]] » This function returns a table of elements that are within a marker's collision shape.
*[[getElementUsingData]] » This function returns table elements that contains the elements data with the given key and value.
*[[getNearestElement]] » This function returns the nearest element (of a specific type) to a player.
*[[isElementInPhotograph]] » This function checks if an element is in the player's camera picture area.
*[[isElementInRange]] » This function allows you to check if an element's range to a main point is within the maximum range.
*[[isElementMoving]]» This function checks if an element is moving.
*[[isElementWithinAColShape]]» This function checks if an element is within a collision shape element.
*[[isElementInAir]]» This function checks if an element is in air or not.
*[[multi_check]] » This function checks one element to many, handy and clean.
*[[setElementSpeed]] » This function allows you to set the speed of an element in kph or mph units.

=== Events ===
*[[onVehicleWeaponFire]] » This code implements an event that is triggered when a player in a vehicle fires a vehicle's weapon.

=== Input functions ===
*[[bindControlKeys]] » This function allows you to bind each key bound to a control individually. Doing this bypasses a little MTA restriction.
*[[getBoundControls]] » This function returns a table of control names that are bound to the specified key.
*[[unbindControlKeys]] » This function allows you to unbind each key bound to a control individually. Use this function with [[bindControlKeys]].

=== Data functions ===
*[[byte2human]] » This function converts an integer (number of bytes) into a human-readable unit.
*[[capitalize]] » This function capitalizes a given string.
*[[convertDate]] » This function converts date to another look.
*[[convertServerTickToTimeStamp]] » This function converts server ticks to a unix timestamp.
*[[convertTextToSpeech]] » This function converts the provided text to a speech in the provided language which players can hear.
*[[findRotation3D]] » This function takes two sets of XYZ coordinates. It returns the 3D direction from point A to point B.
*[[findRotation]] » This function takes two points and returns the direction from point A to point B.
*[[formatDate]] » This function formats a date on the basis of a format string and returns it.
*[[formatNumber]] » This function formats large numbers by adding commas.
*[[generateRandomASCIIString]] » This function returns a random string which uses ASCII characters. 
*[[generateString]] » This function generates a random string with any characters.
*[[getAge]] » This function calculates the age of a given birthday.
*[[getDistance]] » Returns the distance between two elements.
*[[getDistanceBetweenElements]] » Esta funcion sirve para obtener la distancia entre dos elementos.
*[[getDistanceBetweenPointAndSegment2D]] » This function takes point coordinates and line (a segment) starting and ending coordinates. It returns the shortest distance between the point and the line.
*[[getEasterDate]] » This function returns easter date monthday and month for a given year.
*[[getFreeDimension]] » This function get free dimension.
*[[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.
*[[getPointFromDistanceRotation]] » This function finds a point based on a starting point, direction and distance.
*[[getRealMonth]] » This function returns the current month name
*[[getRGColorFromPercentage]] »This function returns two integers representing red and green colors according to the specified percentage.
*[[getScreenRotationFromWorldPosition]] » This function returns a screen relative rotation to a world position.
*[[getTimestamp]] » This function returns the UNIX timestamp of a specified date and time.
*[[gradientString]] » This function transforms a string in a new coloured gradient string.
*[[hex2rgb]] » This function convert hex to rgb.
*[[hexColorToRGB]] » This function convert hex string/number to RGBA values.
*[[isLeapYear]] » This function returns a boolean representing if a given year is a leap year.
*[[isValidMail]] » This function checks whether a provided e-mail string is valid.
*[[removeHex]] » This function is used to remove hexadecimal numbers (colors, for example) from strings.
*[[RGBToHex]] » This function returns a string representing the color in hexadecimal.
*[[RGBToHSV]] » This function convert RGB to HSV color space.
*[[secondsToTimeDesc]] » This function converts a plain seconds-integer into a user-friendly time description.
*[[string.count]] » This function counts the amount of occurences of a string in a string.
*[[string.explode]] » This function splits a string at a given separator pattern and returns a table with the pieces.
*[[string.insert]] » This function inserts a string within another string at a given position.
*[[switch]] » This function allows the value of a variable or expression to control the flow of program execution via a multiway branch.
*[[tocolor2rgba]] » This function convert tocolor to rgba.
*[[toHex]] » This function converts a decimal number to a hexadecimal number, as a fix to be used client-side.
*[[var dump]] » This function outputs information about one or more variables using outputConsole.
*[[wavelengthToRGBA]] » This function converts a physical wavelength of light to a RGBA color.

=== GUI functions ===
*[[centerWindow]] » This function centers a CEGUI window element responsively in any resolution.
*[[guiMoveElement]] » This function moves guiElement by/like using moveObject.
*[[guiSetStaticImageMovable]] » This function allows you to move a static image like a gui window.
*[[isMouseOnGUICloseButton]] » This function allows you to check whether the mouse cursor/pointer is within a gui-window's native close button.
*[[isMouseOnGuiElement]] » This function allows you to check whether or not your mouse is over a specific gui element, this is especially useful if the gui element has a parent. 
=====Comboboxes=====
*[[guiComboBoxAdjustHeight]] » This function adjusts a CEGUI combobox element to have the correct height.

=====Gridlists=====
*[[convertGridListToText]] » This function converts grid list contents to text.
*[[getGridListRowIndexFromText]] » This function returns the GridList row index from the specified text.
*[[guiGridListAddPlayers]] » This function add all online players to a grid list.
*[[guiGridListGetColumnIDFromTitle]] » This function gets a gridlist's column ID from the column title.
*[[guiGridListGetSelectedText]] » This function returns a string containing the inner text of a selected gridlist item.
*[[guiGridListSetColumnNonSortable]] » This function makes a gridlist column become non-sortable.
*[[guiGridListSetColumnsFixedWidth]] » This function makes a gridlist have all its columns fixed width.
*[[isTextInGridList]] » This function checks if some text exist or not in the GridList.

=====Labels=====
*[[guiLabelAddEffect]] » This function add an effects to the gui-label like (shadow, outline).

=== Marker functions ===
*[[createMarkerAttachedTo]] » This function creates a marker that is attached to an element.

=== Math functions ===
*[[math.clamp]] » This function returns the number between range of numbers or it's minimum or maximum.
*[[math.getBezierPoint]] » Get N-th order bezier point.
*[[math.hypot]] » This function returns the Hypotenuse of the triangle given by sides x and y.
*[[math.isPointInPolygon]] » Check if point is inside polygon or not.
*[[math.lerp]] » Get val between two integer.
*[[math.percent]] » This function returns a percentage from two number values.
*[[math.polygonArea]] » Compute area of any polygon.
*[[math.randomDiff]] » Generates a pseudo-random integer that's always different from the last random number generated.
*[[math.rotVecToEulerAngle]] » Rotation Vector To Euler Angle
*[[math.round]] » Rounds a number whereas the number of decimals to keep and the method may be set.
*[[mathNumber]] » This function is a workaround for the client-side floating-point precision of 24-bits.
*[[reMap]] » Re-maps a number from one range to another.
*[[Math.percentProgress|math.percentProgress]] » Returns a percentage progress from two specific values.
*[[math.average]] » This function returns the simple arithmetic mean of multiple numbers.

=== Map functions ===
*[[assignLod]] » This function lets you conveniently generate and apply a LOD model to a mapping object.
*[[getWorldPositionFromMapPosition]] » This function converts an F11 map position to world position.

=== Ped functions ===
*[[getAlivePlayers (Client)|getAlivePlayers]] » This function returns a table of the alive players client-side.
*[[getAlivePlayersInTeam]] » This function returns a table of the alive players in a team.
*[[getGuestPlayers]] » This function gets a players not login or players Guest .
*[[getOnlineAdmins]] » This function returns a table of all logged-in administrators.
*[[getPedEyesPosition]] » This function allows you to get peds eyes position.
*[[getPedGender]] » This function allows you to get peds their gender.
*[[getPedMaxHealth]] » This function returns a pedestrians's maximum health by converting it from their maximum health stat.
*[[getPedMaxOxygenLevel]] » This function returns a ped's maximum oxygen level by converting it from their maximum underwater stamina stat.
*[[getPedWeaponSkill]] » This function returns a ped's corresponding weapon skill level name.
*[[getPlayerFromNamePart]] » This function returns a player from partial name.
*[[getPlayerFromSerial]] » This function returns a player from their serial.
*[[getPlayersByData]] » This function returns a table of players that have the specified data name.
*[[getPlayersInPhotograph]] » This function returns a table of all players in photograph.
*[[getPlayersInVehicles]] » This function returns a table of the players insides vehicles from a specified dimension.
*[[isPedAiming]]» This function checks if a pedestrian is aiming their weapon.
*[[isPedAimingNearPed]] » This is similar to isPedAiming but uses a colshape to be more precise.
*[[isPedDiving]] » This feature checks that pedestrian is diving in the water.
*[[isPedDrivingVehicle]] » This function checks if a specified pedestrian is driving a vehicle.
*[[isPlayerInTeam]] » This function checks if a player is in a specified team.
*[[setPedAttack]] » This function will make a ped attack a specified target.
*[[setPedFollow]] » This function will make a ped follow a specified target.
*[[getPlayerNameFromID]] » This function will get the player name from the ID element data.

=== Player functions ===
*[[countPlayersInRange]] » This function returns the number of players that are within a certain range of the specified coordinates.
*[[getPlayerPreviousAndNextWeapon]] » This function returns the player previous and next weapon.
*[[getPlayersInRange]]» This function make a table of players within certain range.
*[[isPlayerHitByVehicle]]» This function cancels event when a element is hit by a vehicle.
*[[warpToPlayer]]» This function make player warp to another player.

=== Resource functions ===
*[[getFilesInResourceFolder]] » This function gets a list of files that are inside a folder of a resource.
*[[getResourceScripts]] » This function returns a table of the resource scripts.
*[[getResourceSettings]] » This function returns a table of the resource settings.
*[[getResourceSize]] » This function returns the size of a specified resource in kB(kilobyte)
*[[refreshResource]] » This function refreshes your resource if you changed any of the files
*[[setResourcePriority]] » This function set resource download priority group.

=== Sound functions ===
*[[isSoundFinished]] » This function checks if a sound element has finished.
*[[isSoundPlaying]] » This function checks if a sound element is playing or not.
*[[stopSoundSlowly]] » This function stop your sound element slowly.

=== Browser functions ===
*[[playVideo]] » This function plays a video on the screen.

=== Team functions ===
*[[getTeamFromColor]] » This function returns a team element by the specified color.
*[[getTeamWithFewestPlayers]] » This function returns a team element with least players of all the specified teams.

=== Vehicle functions ===
*[[findEmptyCarSeat]] » This function finds you the first empty seat in a vehicle.
*[[getNearestVehicle]] » This function gets the nearest vehicle to the specified player in a specified distance.
*[[getRandomVehicle]] » This function gets a random vehicle.
*[[getValidVehicleModels]] » This function returns a table of all valid vehicle models.
*[[getVehiclesCountByType]] » This function returns the amount of vehicles by the given type as an integer value.
*[[getVehicleTurnVelocityCenterOfMass]]» This function gets a vehicle's turn velocity relative to the vehicle's center or mass.
*[[isVehicleDoubleExhaust]] » This function checks is exhaust vehicle double.
*[[isVehicleEmpty]] » This function checks whether a vehicle is empty.
*[[isVehicleOccupied]] » This function checks if a specified vehicle is occupied.
*[[isVehicleOnRoof]] » This function checks whether vehicle is on roof.
*[[isVehicleReversing]] » This function checks if a specified vehicle is moving backwards.
*[[isVehicleUpgraded]] » This function checks is vehicle upgraded by upgrade ID.
*[[setVehicleGravityPoint]] » This function sets a vehicle's gravity in the direction of a 3 dimensional coordinate with the strength specified.
*[[setVehicleTurnVelocityCenterOfMass]]» This function sets a vehicle's turn velocity relative to the vehicle's center or mass.

=== Weapon functions ===
*[[getJetpackWeaponsEnabled]] » This function returns a table of enabled weapons usable on a jetpack.

=== Object functions ===
*[[getDynamicDoorObjectOpenRatio]] » This function tells you how open a dynamic door is in a range from 0 to 1.
*[[isElementObject]] » This function tells you if an element is an object or no.

=== XML functions ===
*[[getXMLNodes]] » This function returns all children of a XML node.

=== Engine functions ===
*[[engineGetCOLsFromLibrary]] » This function gets the collision data from the col library.
*[[engineLoadIMGContainer]] » This function loads the IMG container.

=== Utility ===
*[[animate]] » This function allows you to use interpolateBetween without render event and easily used.
*[[callClientFunction]] » This function allows you to call any client-side function from the server's side.
*[[callServerFunction]] » This function allows you to call any server-side function from the client's side.
*[[check]] » This function checks if its arguments are of the right type and calls the error-function if one is not.
*[[checkPassiveTimer]] » This function allows you to use passive timers in your conditions. For example you want to prevent players repeatedly using a command.
*[[coroutine.resume]] » This function applies a fix for hidden coroutine error messages.
*[[getBanFromName]] » This functions returns the ban of the given playername.
*[[getCurrentFPS]] » This function returns the frames per second at which GTA: SA is running.
*[[getSkinNameFromID]] » This function returns the name of the skin from the given id.
*[[IfElse]] » This function returns one of two values based on a boolean expression.
*[[isCharInString]] » This shared function allows you to check if a char specified is in a string value.
*[[isMouseInCircle]] » This function checks if a cursor position is in circular area or not.
*[[isMouseInPosition]] » This function allows you to check whether the mouse cursor/pointer is within a rectangular position.
*[[iterElements]] » This function returns ''a time-saving'' iterator for your for-loops.
*[[PlotTrajectoryAtTime]] » Calculate projectile/water trajectory.
*[[preprocessor]] » This function allow you to use gcc macros.
*[[vector3:compare]] » This method checks whether two vectors match, with optional precision.

<noinclude>[[Category:Useful Functions]]</noinclude>

SetPedAttack

2022-04-12T20:29:55Z

Hydra:

{{Useful Function}}
__NOTOC__
This function makes a ped to attack a player.
 
'''Only CLIENT-SIDE'''
 

==Syntax==
<syntaxhighlight lang="lua">bool setPedAttack(ped theElement, target element theTarget, weapon theWeapon, ammo theAmmo, slot thePedSlot)</syntaxhighlight>

===Required Arguments===
* '''theElement''': The ped element.
* '''theTarget''': The target element.
* '''theWeapon''': The weapon for the ped.
* '''theAmmo''': The weapon ammo for the ped.
* '''thePedSlot''': The weapon slot for the ped.

==Code==
{{RequiredFunctions|findRotation}}
<section name="Clientside script" class="client" show="true">
<syntaxhighlight lang="lua">
function setPedAttack(theElement, theTarget, theWeapon, theAmmo, thePedSlot)
if theElement then
local x, y, z = getElementPosition(theTarget)
local ex, ey, ez = getElementPosition(theElement)
local distance = getDistanceBetweenPoints3D(x, y, z, ex, ey, ez)
local rotation = findRotation(ex, ey, x, y)
setPedRotation(theElement, rotation)
setPedLookAt(theElement, x, y, z + 5)
setPedAimTarget(theElement, x, y, z)
givePedWeapon(theElement, theWeapon, theAmmo)
if distance > 3 then
setPedControlState(theElement, "forwards", true)
setPedControlState(theElement, "fire", false)
setPedWeaponSlot(theElement, 0)
else
setPedControlState(theElement, "fire", true)
setPedControlState(theElement, "forwards", false)
setPedWeaponSlot(theElement, thePedSlot)
end
if getPedControlState(theTarget, "forwards") or getPedControlState(theTarget, "sprint") or getPedControlState(theTarget, "backwards") then
setPedControlState(theElement, "fire", false)
setPedWeaponSlot(theElement, 0)
else
setPedControlState(theElement, "fire", true)
setPedWeaponSlot(theElement, thePedSlot)
end
end
end

_setPedRotation = setPedRotation
function setPedRotation(element, rot)
return _setPedRotation(element, rot)
end
</syntaxhighlight>
</section>

==Example==

'''The example will show you how you can make a ped attack a player'''

<syntaxhighlight lang="lua">
local ped = createPed(0, 0, 0, 5)

function TestAttack()
setPedAttack(ped, localPlayer, 38, 9999, 7)
end
addEventHandler("onClientRender", root, TestAttack)
</syntaxhighlight>

==Author==

'''by Hydra45'''
'''Discord: Hydra45#6859'''

==See Also==
{{Useful_Functions}}

SetPedFollow

2022-04-12T20:29:22Z

Hydra: Created page with "{{Useful Function}} __NOTOC__ This function makes a ped to follow a player. '''Only CLIENT-SIDE''' ==Syntax== <syntaxhighlight lang="lua">bool setPedFollow(ped theElement, target element theTarget)</syntaxhighlight> ===Required Arguments=== * '''theElement''': The ped element. * '''theTarget''': The target element. ==Code== {{RequiredFunctions|findRotation}} <section name="Clientside script" class="client" show="true"> <syntaxhighlight lang="lua"> function s..."

{{Useful Function}}
__NOTOC__
This function makes a ped to follow a player.
 
'''Only CLIENT-SIDE'''
 

==Syntax==
<syntaxhighlight lang="lua">bool setPedFollow(ped theElement, target element theTarget)</syntaxhighlight>

===Required Arguments===
* '''theElement''': The ped element.
* '''theTarget''': The target element.

==Code==
{{RequiredFunctions|findRotation}}
<section name="Clientside script" class="client" show="true">
<syntaxhighlight lang="lua">
function setPedFollow(theElement, theTarget)
if theElement then
local x, y, z = getElementPosition(theTarget)
local rx, ry, rz = getElementRotation(theTarget)
local ex, ey, ez = getElementPosition(theElement)
local distance = getDistanceBetweenPoints3D(x, y, z, ex, ey, ez)
local rotation = findRotation(ex, ey, x, y)
setPedRotation(theElement, rotation)
if distance > 2 then
setPedControlState(theElement, "forwards", true)
else
setPedControlState(theElement, "forwards", false)
end
end
end

_setPedRotation = setPedRotation
function setPedRotation(element, rot)
return _setPedRotation(element, rot)
end
</syntaxhighlight>
</section>

==Example==

'''The example will show you how you can make a ped follow a player'''

<syntaxhighlight lang="lua">
local ped = createPed(0, 0, 0, 5)

function TestFollow()
setPedFollow(ped, localPlayer)
end
addEventHandler("onClientRender", root, TestFollow)
</syntaxhighlight>

==Author==

'''by Hydra45'''
'''Discord: Hydra45#6859'''

==See Also==
{{Useful_Functions}}

Template:Useful Functions

2022-04-12T20:25:22Z

Hydra: /* Ped functions */

__NOTOC__
=== Table functions ===
*[[addTableChangeHandler]] » This function monitors the changes of a table.
*[[getTableFromSql]] » This functionality is used to obtain saved tables using the function ([https://wiki.multitheftauto.com/wiki/SetTableToSql SetTableToSql ]).
*[[isValueInTable]] » This function returns true if the value exists in the table, false if the value does not exist in the table.
*[[pairsByKeys]] » This function sort pairs table.
*[[rangeToTable]] » This function converts a string range to a table containing number values.
*[[setTableProtected]] » This function protects a table and makes it read-only.
*[[setTableToSql]] » This function is used to save the table in the database (sql).
*[[Sort_Functions]] » These functions are able to sort your tables by a key.
*[[table.compare]] » This function checks whether two given tables are equal.
*[[table.copy]] » This function copies a whole table and all the tables in that table.
*[[table.deepmerge]] » This function deep merges two tables. Every nested table will be correspondingly merged.
*[[table.element]] » This function returns a new table with only userdata content.
*[[table.empty]] » This function checks whether a table is empty.
*[[table.fromString]] » This function converts string to a table.
*[[table.getRandomRows]] » This function returns random rows from table.
*[[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]] » This function merges two or more tables together.
*[[table.random]] » This function retrieves a random value from a table.
*[[table.removeValue]] » This function removes a specified value from a table.
*[[table.size]] » This function returns the absolute size of a table.
*[[table.toString]] » This function converts table to a string.
*[[table.toStringArray]] » This function converts '''array''' to a string.

=== ACL functions ===
*[[aclGroupClone]] » This function clone a group to another group with/without ACLs and/or objects.
*[[getAccountsRanks]] » This function is used to detect the account name groups and put them in the chat.
*[[getPlayerAcls]] » This function returns a table of all ACL groups on a player.
*[[getPlayersInACLGroup]] » This function returns all players in an ACL group.
*[[isPlayerInACL]] » This function checks if a player element is in an ACL group.
*[[renameAclGroup]] » This function gives an existing ACL group a new name.

=== Account functions ===
*[[getPlayerFromAccountName]] » This function is used to obtain a player by the name of his account.

=== Camera functions ===
*[[smoothMoveCamera]] » This function allows you to create a cinematic camera flight.

=== Cursor functions ===
*[[getCursorMovedOn]] » This function checks in which way the cursor is currently moving.

=== Drawing functions ===
*[[dxDrawAnimWindow]] » This function draws an animated 2D window on the screen.
*[[dxDrawBorderedRectangle]] » This is a function that will create a bordered rectangle.
*[[dxDrawBorderedText]] » This is a function that will create a bordered text.
*[[dxDrawDashedLine]] » This function draws a line with dashes.
*[[dxDrawGifImage]] » This function simulates the effect of a GIF image by using image sprites in 2D.
*[[dxDrawImage3D]] » This function draws a 3D image in GTA world.
*[[dxDrawImageOnElement]] » This function draws an image on any element.
*[[dxDrawLinedRectangle]] » This is a function that will create a rectangle outline with dx lines.
*[[dxDrawLoading]] » This function draws a loading bar on the screen.
*[[dxDrawOctagon3D]] » This function creates a 3D Octagon
*[[dxDrawPolygon]] » This function draws a custom polygon on the screen.
*[[dxDrawProgressBar]] » This function simulates a progress bar drawed using DirectDraw.
*[[dxDrawRectangle3D]] » This function draws a 3D rectangle in GTA world.
*[[dxDrawRectangleOnPlayer]] » This function draws a 3D rectangle above the player.
*[[dxDrawRing]] » This function draws a ring with dx lines.
*[[dxDrawRombo]] » This function creates a Rhombus.
*[[dxDrawSprite]] » This function draw a sprite in the 3D world.
*[[dxDrawTextOnElement]] » This function draws a text on any element.
*[[dxDrawTextOnRectangle]] » Esta funcion crea un rectangle con un texto dentro.
*[[dxDrawTriangle]] » This is a function that will create a triangle with dx lines.
*[[dxGetFontSizeFromHeight]] » This function calculates the font size from given height.
*[[dxGetRealFontHeight]] » This function calculates the height of a font.
*[[getScreenStartPositionFromBox]] » This function helps with getting the correct position for your dx-effects.
*[[wordWrap]] » This function breaks a long string into a table of separate lines limited to a specific length in pixels, for drawing separately.

=== Effects functions ===
*[[attachEffect]] » This function allows you attach an effect to an element.

=== Element functions ===
*[[autoAttach]] » This function attaches one element into another at the same position and rotation they are.
*[[isElementPlayer]] » This function checks whether the element is a player or not.
*[[attachElementToBone]] » This function allows you to attach an element to ped bone accurately using new bone functions.
*[[getElementsInDimension]] » This function returns a table of elements that are in the specified dimension.
*[[getElementSpeed]] » This function returns the specified element's speed in m/s, km/h or mph.
*[[getElementsWithinMarker]] » This function returns a table of elements that are within a marker's collision shape.
*[[getElementUsingData]] » This function returns table elements that contains the elements data with the given key and value.
*[[getNearestElement]] » This function returns the nearest element (of a specific type) to a player.
*[[isElementInPhotograph]] » This function checks if an element is in the player's camera picture area.
*[[isElementInRange]] » This function allows you to check if an element's range to a main point is within the maximum range.
*[[isElementMoving]]» This function checks if an element is moving.
*[[isElementWithinAColShape]]» This function checks if an element is within a collision shape element.
*[[isElementInAir]]» This function checks if an element is in air or not.
*[[multi_check]] » This function checks one element to many, handy and clean.
*[[setElementSpeed]] » This function allows you to set the speed of an element in kph or mph units.

=== Events ===
*[[onVehicleWeaponFire]] » This code implements an event that is triggered when a player in a vehicle fires a vehicle's weapon.

=== Input functions ===
*[[bindControlKeys]] » This function allows you to bind each key bound to a control individually. Doing this bypasses a little MTA restriction.
*[[getBoundControls]] » This function returns a table of control names that are bound to the specified key.
*[[unbindControlKeys]] » This function allows you to unbind each key bound to a control individually. Use this function with [[bindControlKeys]].

=== Data functions ===
*[[byte2human]] » This function converts an integer (number of bytes) into a human-readable unit.
*[[capitalize]] » This function capitalizes a given string.
*[[convertDate]] » This function converts date to another look.
*[[convertServerTickToTimeStamp]] » This function converts server ticks to a unix timestamp.
*[[convertTextToSpeech]] » This function converts the provided text to a speech in the provided language which players can hear.
*[[findRotation3D]] » This function takes two sets of XYZ coordinates. It returns the 3D direction from point A to point B.
*[[findRotation]] » This function takes two points and returns the direction from point A to point B.
*[[formatDate]] » This function formats a date on the basis of a format string and returns it.
*[[formatNumber]] » This function formats large numbers by adding commas.
*[[generateRandomASCIIString]] » This function returns a random string which uses ASCII characters. 
*[[generateString]] » This function generates a random string with any characters.
*[[getAge]] » This function calculates the age of a given birthday.
*[[getDistance]] » Returns the distance between two elements.
*[[getDistanceBetweenElements]] » Esta funcion sirve para obtener la distancia entre dos elementos.
*[[getDistanceBetweenPointAndSegment2D]] » This function takes point coordinates and line (a segment) starting and ending coordinates. It returns the shortest distance between the point and the line.
*[[getEasterDate]] » This function returns easter date monthday and month for a given year.
*[[getFreeDimension]] » This function get free dimension.
*[[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.
*[[getPointFromDistanceRotation]] » This function finds a point based on a starting point, direction and distance.
*[[getRealMonth]] » This function returns the current month name
*[[getRGColorFromPercentage]] »This function returns two integers representing red and green colors according to the specified percentage.
*[[getScreenRotationFromWorldPosition]] » This function returns a screen relative rotation to a world position.
*[[getTimestamp]] » This function returns the UNIX timestamp of a specified date and time.
*[[gradientString]] » This function transforms a string in a new coloured gradient string.
*[[hex2rgb]] » This function convert hex to rgb.
*[[hexColorToRGB]] » This function convert hex string/number to RGBA values.
*[[isLeapYear]] » This function returns a boolean representing if a given year is a leap year.
*[[isValidMail]] » This function checks whether a provided e-mail string is valid.
*[[removeHex]] » This function is used to remove hexadecimal numbers (colors, for example) from strings.
*[[RGBToHex]] » This function returns a string representing the color in hexadecimal.
*[[RGBToHSV]] » This function convert RGB to HSV color space.
*[[secondsToTimeDesc]] » This function converts a plain seconds-integer into a user-friendly time description.
*[[string.count]] » This function counts the amount of occurences of a string in a string.
*[[string.explode]] » This function splits a string at a given separator pattern and returns a table with the pieces.
*[[string.insert]] » This function inserts a string within another string at a given position.
*[[switch]] » This function allows the value of a variable or expression to control the flow of program execution via a multiway branch.
*[[tocolor2rgba]] » This function convert tocolor to rgba.
*[[toHex]] » This function converts a decimal number to a hexadecimal number, as a fix to be used client-side.
*[[var dump]] » This function outputs information about one or more variables using outputConsole.
*[[wavelengthToRGBA]] » This function converts a physical wavelength of light to a RGBA color.

=== GUI functions ===
*[[centerWindow]] » This function centers a CEGUI window element responsively in any resolution.
*[[guiMoveElement]] » This function moves guiElement by/like using moveObject.
*[[guiSetStaticImageMovable]] » This function allows you to move a static image like a gui window.
*[[isMouseOnGUICloseButton]] » This function allows you to check whether the mouse cursor/pointer is within a gui-window's native close button.
*[[isMouseOnGuiElement]] » This function allows you to check whether or not your mouse is over a specific gui element, this is especially useful if the gui element has a parent. 
=====Comboboxes=====
*[[guiComboBoxAdjustHeight]] » This function adjusts a CEGUI combobox element to have the correct height.

=====Gridlists=====
*[[convertGridListToText]] » This function converts grid list contents to text.
*[[getGridListRowIndexFromText]] » This function returns the GridList row index from the specified text.
*[[guiGridListAddPlayers]] » This function add all online players to a grid list.
*[[guiGridListGetColumnIDFromTitle]] » This function gets a gridlist's column ID from the column title.
*[[guiGridListGetSelectedText]] » This function returns a string containing the inner text of a selected gridlist item.
*[[guiGridListSetColumnNonSortable]] » This function makes a gridlist column become non-sortable.
*[[guiGridListSetColumnsFixedWidth]] » This function makes a gridlist have all its columns fixed width.
*[[isTextInGridList]] » This function checks if some text exist or not in the GridList.

=====Labels=====
*[[guiLabelAddEffect]] » This function add an effects to the gui-label like (shadow, outline).

=== Marker functions ===
*[[createMarkerAttachedTo]] » This function creates a marker that is attached to an element.

=== Math functions ===
*[[math.clamp]] » This function returns the number between range of numbers or it's minimum or maximum.
*[[math.getBezierPoint]] » Get N-th order bezier point.
*[[math.hypot]] » This function returns the Hypotenuse of the triangle given by sides x and y.
*[[math.isPointInPolygon]] » Check if point is inside polygon or not.
*[[math.lerp]] » Get val between two integer.
*[[math.percent]] » This function returns a percentage from two number values.
*[[math.polygonArea]] » Compute area of any polygon.
*[[math.randomDiff]] » Generates a pseudo-random integer that's always different from the last random number generated.
*[[math.rotVecToEulerAngle]] » Rotation Vector To Euler Angle
*[[math.round]] » Rounds a number whereas the number of decimals to keep and the method may be set.
*[[mathNumber]] » This function is a workaround for the client-side floating-point precision of 24-bits.
*[[reMap]] » Re-maps a number from one range to another.
*[[Math.percentProgress|math.percentProgress]] » Returns a percentage progress from two specific values.
*[[math.average]] » This function returns the simple arithmetic mean of multiple numbers.

=== Map functions ===
*[[assignLod]] » This function lets you conveniently generate and apply a LOD model to a mapping object.
*[[getWorldPositionFromMapPosition]] » This function converts an F11 map position to world position.

=== Ped functions ===
*[[getAlivePlayers (Client)|getAlivePlayers]] » This function returns a table of the alive players client-side.
*[[getAlivePlayersInTeam]] » This function returns a table of the alive players in a team.
*[[getGuestPlayers]] » This function gets a players not login or players Guest .
*[[getOnlineAdmins]] » This function returns a table of all logged-in administrators.
*[[getPedEyesPosition]] » This function allows you to get peds eyes position.
*[[getPedGender]] » This function allows you to get peds their gender.
*[[getPedMaxHealth]] » This function returns a pedestrians's maximum health by converting it from their maximum health stat.
*[[getPedMaxOxygenLevel]] » This function returns a ped's maximum oxygen level by converting it from their maximum underwater stamina stat.
*[[getPedWeaponSkill]] » This function returns a ped's corresponding weapon skill level name.
*[[getPlayerFromNamePart]] » This function returns a player from partial name.
*[[getPlayerFromSerial]] » This function returns a player from their serial.
*[[getPlayersByData]] » This function returns a table of players that have the specified data name.
*[[getPlayersInPhotograph]] » This function returns a table of all players in photograph.
*[[getPlayersInVehicles]] » This function returns a table of the players insides vehicles from a specified dimension.
*[[isPedAiming]]» This function checks if a pedestrian is aiming their weapon.
*[[isPedAimingNearPed]] » This is similar to isPedAiming but uses a colshape to be more precise.
*[[isPedDiving]] » This feature checks that pedestrian is diving in the water.
*[[isPedDrivingVehicle]] » This function checks if a specified pedestrian is driving a vehicle.
*[[isPlayerInTeam]] » This function checks if a player is in a specified team.
*[[setPedAttack]] » This function will make a ped attack a specified target.
*[[setPedFollow]] » This function will make a ped follow a specified target.

=== Player functions ===
*[[countPlayersInRange]] » This function returns the number of players that are within a certain range of the specified coordinates.
*[[getPlayerPreviousAndNextWeapon]] » This function returns the player previous and next weapon.
*[[getPlayersInRange]]» This function make a table of players within certain range.
*[[isPlayerHitByVehicle]]» This function cancels event when a element is hit by a vehicle.
*[[warpToPlayer]]» This function make player warp to another player.

=== Resource functions ===
*[[getFilesInResourceFolder]] » This function gets a list of files that are inside a folder of a resource.
*[[getResourceScripts]] » This function returns a table of the resource scripts.
*[[getResourceSettings]] » This function returns a table of the resource settings.
*[[getResourceSize]] » This function returns the size of a specified resource in kB(kilobyte)
*[[refreshResource]] » This function refreshes your resource if you changed any of the files
*[[setResourcePriority]] » This function set resource download priority group.

=== Sound functions ===
*[[isSoundFinished]] » This function checks if a sound element has finished.
*[[isSoundPlaying]] » This function checks if a sound element is playing or not.
*[[stopSoundSlowly]] » This function stop your sound element slowly.

=== Browser functions ===
*[[playVideo]] » This function plays a video on the screen.

=== Team functions ===
*[[getTeamFromColor]] » This function returns a team element by the specified color.
*[[getTeamWithFewestPlayers]] » This function returns a team element with least players of all the specified teams.

=== Vehicle functions ===
*[[findEmptyCarSeat]] » This function finds you the first empty seat in a vehicle.
*[[getNearestVehicle]] » This function gets the nearest vehicle to the specified player in a specified distance.
*[[getRandomVehicle]] » This function gets a random vehicle.
*[[getValidVehicleModels]] » This function returns a table of all valid vehicle models.
*[[getVehiclesCountByType]] » This function returns the amount of vehicles by the given type as an integer value.
*[[getVehicleTurnVelocityCenterOfMass]]» This function gets a vehicle's turn velocity relative to the vehicle's center or mass.
*[[isVehicleDoubleExhaust]] » This function checks is exhaust vehicle double.
*[[isVehicleEmpty]] » This function checks whether a vehicle is empty.
*[[isVehicleOccupied]] » This function checks if a specified vehicle is occupied.
*[[isVehicleOnRoof]] » This function checks whether vehicle is on roof.
*[[isVehicleReversing]] » This function checks if a specified vehicle is moving backwards.
*[[isVehicleUpgraded]] » This function checks is vehicle upgraded by upgrade ID.
*[[setVehicleGravityPoint]] » This function sets a vehicle's gravity in the direction of a 3 dimensional coordinate with the strength specified.
*[[setVehicleTurnVelocityCenterOfMass]]» This function sets a vehicle's turn velocity relative to the vehicle's center or mass.

=== Weapon functions ===
*[[getJetpackWeaponsEnabled]] » This function returns a table of enabled weapons usable on a jetpack.

=== Object functions ===
*[[getDynamicDoorObjectOpenRatio]] » This function tells you how open a dynamic door is in a range from 0 to 1.
*[[isElementObject]] » This function tells you if an element is an object or no.

=== XML functions ===
*[[getXMLNodes]] » This function returns all children of a XML node.

=== Engine functions ===
*[[engineGetCOLsFromLibrary]] » This function gets the collision data from the col library.
*[[engineLoadIMGContainer]] » This function loads the IMG container.

=== Utility ===
*[[animate]] » This function allows you to use interpolateBetween without render event and easily used.
*[[callClientFunction]] » This function allows you to call any client-side function from the server's side.
*[[callServerFunction]] » This function allows you to call any server-side function from the client's side.
*[[check]] » This function checks if its arguments are of the right type and calls the error-function if one is not.
*[[checkPassiveTimer]] » This function allows you to use passive timers in your conditions. For example you want to prevent players repeatedly using a command.
*[[coroutine.resume]] » This function applies a fix for hidden coroutine error messages.
*[[getBanFromName]] » This functions returns the ban of the given playername.
*[[getCurrentFPS]] » This function returns the frames per second at which GTA: SA is running.
*[[getSkinNameFromID]] » This function returns the name of the skin from the given id.
*[[IfElse]] » This function returns one of two values based on a boolean expression.
*[[isCharInString]] » This shared function allows you to check if a char specified is in a string value.
*[[isMouseInCircle]] » This function checks if a cursor position is in circular area or not.
*[[isMouseInPosition]] » This function allows you to check whether the mouse cursor/pointer is within a rectangular position.
*[[iterElements]] » This function returns ''a time-saving'' iterator for your for-loops.
*[[PlotTrajectoryAtTime]] » Calculate projectile/water trajectory.
*[[preprocessor]] » This function allow you to use gcc macros.
*[[vector3:compare]] » This method checks whether two vectors match, with optional precision.

<noinclude>[[Category:Useful Functions]]</noinclude>

SetPedAttack

2022-04-12T20:23:09Z

Hydra: Created page with "{{Useful Function}} __NOTOC__ This function makes a ped to attack a player. '''Only CLIENT-SIDE''' ==Syntax== <syntaxhighlight lang="lua">bool setPedAttack(ped theElement, target element theTarget, weapon theWeapon, ammo theAmmo, slot thePedSlot)</syntaxhighlight> ===Required Arguments=== * '''theElement''': The ped element. * '''theTarget''': The target element. * '''theWeapon''': The weapon for the ped. * '''theAmmo''': The weapon ammo for the ped. * '''the..."

{{Useful Function}}
__NOTOC__
This function makes a ped to attack a player.
 
'''Only CLIENT-SIDE'''
 

==Syntax==
<syntaxhighlight lang="lua">bool setPedAttack(ped theElement, target element theTarget, weapon theWeapon, ammo theAmmo, slot thePedSlot)</syntaxhighlight>

===Required Arguments===
* '''theElement''': The ped element.
* '''theTarget''': The target element.
* '''theWeapon''': The weapon for the ped.
* '''theAmmo''': The weapon ammo for the ped.
* '''thePedSlot''': The weapon slot for the ped.

==Code==
{{RequiredFunctions|findRotation}}
<section name="Clientside script" class="client" show="true">
<syntaxhighlight lang="lua">
function setPedAttack(theElement, theTarget, theWeapon, theAmmo, thePedSlot)
if theElement then
local x, y, z = getElementPosition(theTarget)
local ex, ey, ez = getElementPosition(theElement)
local distance = getDistanceBetweenPoints3D(x, y, z, ex, ey, ez)
local rotation = findRotation(ex, ey, x, y)
setPedRotation(theElement, rotation)
setPedLookAt(theElement, x, y, z + 5)
setPedAimTarget(theElement, x, y, z)
givePedWeapon(theElement, theWeapon, theAmmo)
if distance > 3 then
setPedControlState(theElement, "forwards", true)
setPedControlState(theElement, "fire", false)
setPedWeaponSlot(theElement, 0)
else
setPedControlState(theElement, "fire", true)
setPedControlState(theElement, "forwards", false)
setPedWeaponSlot(theElement, thePedSlot)
end
if getPedControlState(theTarget, "forwards") or getPedControlState(theTarget, "sprint") or getPedControlState(theTarget, "backwards") then
setPedControlState(theElement, "fire", false)
setPedWeaponSlot(theElement, 0)
else
setPedControlState(theElement, "fire", true)
setPedWeaponSlot(theElement, thePedSlot)
end
end
end

_setPedRotation = setPedRotation
function setPedRotation(element, rot)
return _setPedRotation(element, rot)
end
</syntaxhighlight>
</section>

==Example==

'''The example will show you how you can make a ped attack a player'''

<syntaxhighlight lang="lua">
local ped = createPed(0, 0, 0, 5)

function TestAttack()
setPedAttack(ped, localPlayer, 38, 9999, 7)
end
addCommandHandler("attackme", TestAttack)
</syntaxhighlight>

==Author==

'''by Hydra45'''
'''Discord: Hydra45#6859'''

==See Also==
{{Useful_Functions}}

Template:Useful Functions

2022-04-12T20:10:36Z

Hydra: /* Ped functions */

__NOTOC__
=== Table functions ===
*[[addTableChangeHandler]] » This function monitors the changes of a table.
*[[getTableFromSql]] » This functionality is used to obtain saved tables using the function ([https://wiki.multitheftauto.com/wiki/SetTableToSql SetTableToSql ]).
*[[isValueInTable]] » This function returns true if the value exists in the table, false if the value does not exist in the table.
*[[pairsByKeys]] » This function sort pairs table.
*[[rangeToTable]] » This function converts a string range to a table containing number values.
*[[setTableProtected]] » This function protects a table and makes it read-only.
*[[setTableToSql]] » This function is used to save the table in the database (sql).
*[[Sort_Functions]] » These functions are able to sort your tables by a key.
*[[table.compare]] » This function checks whether two given tables are equal.
*[[table.copy]] » This function copies a whole table and all the tables in that table.
*[[table.deepmerge]] » This function deep merges two tables. Every nested table will be correspondingly merged.
*[[table.element]] » This function returns a new table with only userdata content.
*[[table.empty]] » This function checks whether a table is empty.
*[[table.fromString]] » This function converts string to a table.
*[[table.getRandomRows]] » This function returns random rows from table.
*[[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]] » This function merges two or more tables together.
*[[table.random]] » This function retrieves a random value from a table.
*[[table.removeValue]] » This function removes a specified value from a table.
*[[table.size]] » This function returns the absolute size of a table.
*[[table.toString]] » This function converts table to a string.
*[[table.toStringArray]] » This function converts '''array''' to a string.

=== ACL functions ===
*[[aclGroupClone]] » This function clone a group to another group with/without ACLs and/or objects.
*[[getAccountsRanks]] » This function is used to detect the account name groups and put them in the chat.
*[[getPlayerAcls]] » This function returns a table of all ACL groups on a player.
*[[getPlayersInACLGroup]] » This function returns all players in an ACL group.
*[[isPlayerInACL]] » This function checks if a player element is in an ACL group.
*[[renameAclGroup]] » This function gives an existing ACL group a new name.

=== Account functions ===
*[[getPlayerFromAccountName]] » This function is used to obtain a player by the name of his account.

=== Camera functions ===
*[[smoothMoveCamera]] » This function allows you to create a cinematic camera flight.

=== Cursor functions ===
*[[getCursorMovedOn]] » This function checks in which way the cursor is currently moving.

=== Drawing functions ===
*[[dxDrawAnimWindow]] » This function draws an animated 2D window on the screen.
*[[dxDrawBorderedRectangle]] » This is a function that will create a bordered rectangle.
*[[dxDrawBorderedText]] » This is a function that will create a bordered text.
*[[dxDrawDashedLine]] » This function draws a line with dashes.
*[[dxDrawGifImage]] » This function simulates the effect of a GIF image by using image sprites in 2D.
*[[dxDrawImage3D]] » This function draws a 3D image in GTA world.
*[[dxDrawImageOnElement]] » This function draws an image on any element.
*[[dxDrawLinedRectangle]] » This is a function that will create a rectangle outline with dx lines.
*[[dxDrawLoading]] » This function draws a loading bar on the screen.
*[[dxDrawOctagon3D]] » This function creates a 3D Octagon
*[[dxDrawPolygon]] » This function draws a custom polygon on the screen.
*[[dxDrawProgressBar]] » This function simulates a progress bar drawed using DirectDraw.
*[[dxDrawRectangle3D]] » This function draws a 3D rectangle in GTA world.
*[[dxDrawRectangleOnPlayer]] » This function draws a 3D rectangle above the player.
*[[dxDrawRing]] » This function draws a ring with dx lines.
*[[dxDrawRombo]] » This function creates a Rhombus.
*[[dxDrawSprite]] » This function draw a sprite in the 3D world.
*[[dxDrawTextOnElement]] » This function draws a text on any element.
*[[dxDrawTextOnRectangle]] » Esta funcion crea un rectangle con un texto dentro.
*[[dxDrawTriangle]] » This is a function that will create a triangle with dx lines.
*[[dxGetFontSizeFromHeight]] » This function calculates the font size from given height.
*[[dxGetRealFontHeight]] » This function calculates the height of a font.
*[[getScreenStartPositionFromBox]] » This function helps with getting the correct position for your dx-effects.
*[[wordWrap]] » This function breaks a long string into a table of separate lines limited to a specific length in pixels, for drawing separately.

=== Effects functions ===
*[[attachEffect]] » This function allows you attach an effect to an element.

=== Element functions ===
*[[autoAttach]] » This function attaches one element into another at the same position and rotation they are.
*[[isElementPlayer]] » This function checks whether the element is a player or not.
*[[attachElementToBone]] » This function allows you to attach an element to ped bone accurately using new bone functions.
*[[getElementsInDimension]] » This function returns a table of elements that are in the specified dimension.
*[[getElementSpeed]] » This function returns the specified element's speed in m/s, km/h or mph.
*[[getElementsWithinMarker]] » This function returns a table of elements that are within a marker's collision shape.
*[[getElementUsingData]] » This function returns table elements that contains the elements data with the given key and value.
*[[getNearestElement]] » This function returns the nearest element (of a specific type) to a player.
*[[isElementInPhotograph]] » This function checks if an element is in the player's camera picture area.
*[[isElementInRange]] » This function allows you to check if an element's range to a main point is within the maximum range.
*[[isElementMoving]]» This function checks if an element is moving.
*[[isElementWithinAColShape]]» This function checks if an element is within a collision shape element.
*[[isElementInAir]]» This function checks if an element is in air or not.
*[[multi_check]] » This function checks one element to many, handy and clean.
*[[setElementSpeed]] » This function allows you to set the speed of an element in kph or mph units.

=== Events ===
*[[onVehicleWeaponFire]] » This code implements an event that is triggered when a player in a vehicle fires a vehicle's weapon.

=== Input functions ===
*[[bindControlKeys]] » This function allows you to bind each key bound to a control individually. Doing this bypasses a little MTA restriction.
*[[getBoundControls]] » This function returns a table of control names that are bound to the specified key.
*[[unbindControlKeys]] » This function allows you to unbind each key bound to a control individually. Use this function with [[bindControlKeys]].

=== Data functions ===
*[[byte2human]] » This function converts an integer (number of bytes) into a human-readable unit.
*[[capitalize]] » This function capitalizes a given string.
*[[convertDate]] » This function converts date to another look.
*[[convertServerTickToTimeStamp]] » This function converts server ticks to a unix timestamp.
*[[convertTextToSpeech]] » This function converts the provided text to a speech in the provided language which players can hear.
*[[findRotation3D]] » This function takes two sets of XYZ coordinates. It returns the 3D direction from point A to point B.
*[[findRotation]] » This function takes two points and returns the direction from point A to point B.
*[[formatDate]] » This function formats a date on the basis of a format string and returns it.
*[[formatNumber]] » This function formats large numbers by adding commas.
*[[generateRandomASCIIString]] » This function returns a random string which uses ASCII characters. 
*[[generateString]] » This function generates a random string with any characters.
*[[getAge]] » This function calculates the age of a given birthday.
*[[getDistance]] » Returns the distance between two elements.
*[[getDistanceBetweenElements]] » Esta funcion sirve para obtener la distancia entre dos elementos.
*[[getDistanceBetweenPointAndSegment2D]] » This function takes point coordinates and line (a segment) starting and ending coordinates. It returns the shortest distance between the point and the line.
*[[getEasterDate]] » This function returns easter date monthday and month for a given year.
*[[getFreeDimension]] » This function get free dimension.
*[[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.
*[[getPointFromDistanceRotation]] » This function finds a point based on a starting point, direction and distance.
*[[getRealMonth]] » This function returns the current month name
*[[getRGColorFromPercentage]] »This function returns two integers representing red and green colors according to the specified percentage.
*[[getScreenRotationFromWorldPosition]] » This function returns a screen relative rotation to a world position.
*[[getTimestamp]] » This function returns the UNIX timestamp of a specified date and time.
*[[gradientString]] » This function transforms a string in a new coloured gradient string.
*[[hex2rgb]] » This function convert hex to rgb.
*[[hexColorToRGB]] » This function convert hex string/number to RGBA values.
*[[isLeapYear]] » This function returns a boolean representing if a given year is a leap year.
*[[isValidMail]] » This function checks whether a provided e-mail string is valid.
*[[removeHex]] » This function is used to remove hexadecimal numbers (colors, for example) from strings.
*[[RGBToHex]] » This function returns a string representing the color in hexadecimal.
*[[RGBToHSV]] » This function convert RGB to HSV color space.
*[[secondsToTimeDesc]] » This function converts a plain seconds-integer into a user-friendly time description.
*[[string.count]] » This function counts the amount of occurences of a string in a string.
*[[string.explode]] » This function splits a string at a given separator pattern and returns a table with the pieces.
*[[string.insert]] » This function inserts a string within another string at a given position.
*[[switch]] » This function allows the value of a variable or expression to control the flow of program execution via a multiway branch.
*[[tocolor2rgba]] » This function convert tocolor to rgba.
*[[toHex]] » This function converts a decimal number to a hexadecimal number, as a fix to be used client-side.
*[[var dump]] » This function outputs information about one or more variables using outputConsole.
*[[wavelengthToRGBA]] » This function converts a physical wavelength of light to a RGBA color.

=== GUI functions ===
*[[centerWindow]] » This function centers a CEGUI window element responsively in any resolution.
*[[guiMoveElement]] » This function moves guiElement by/like using moveObject.
*[[guiSetStaticImageMovable]] » This function allows you to move a static image like a gui window.
*[[isMouseOnGUICloseButton]] » This function allows you to check whether the mouse cursor/pointer is within a gui-window's native close button.
*[[isMouseOnGuiElement]] » This function allows you to check whether or not your mouse is over a specific gui element, this is especially useful if the gui element has a parent. 
=====Comboboxes=====
*[[guiComboBoxAdjustHeight]] » This function adjusts a CEGUI combobox element to have the correct height.

=====Gridlists=====
*[[convertGridListToText]] » This function converts grid list contents to text.
*[[getGridListRowIndexFromText]] » This function returns the GridList row index from the specified text.
*[[guiGridListAddPlayers]] » This function add all online players to a grid list.
*[[guiGridListGetColumnIDFromTitle]] » This function gets a gridlist's column ID from the column title.
*[[guiGridListGetSelectedText]] » This function returns a string containing the inner text of a selected gridlist item.
*[[guiGridListSetColumnNonSortable]] » This function makes a gridlist column become non-sortable.
*[[guiGridListSetColumnsFixedWidth]] » This function makes a gridlist have all its columns fixed width.
*[[isTextInGridList]] » This function checks if some text exist or not in the GridList.

=====Labels=====
*[[guiLabelAddEffect]] » This function add an effects to the gui-label like (shadow, outline).

=== Marker functions ===
*[[createMarkerAttachedTo]] » This function creates a marker that is attached to an element.

=== Math functions ===
*[[math.clamp]] » This function returns the number between range of numbers or it's minimum or maximum.
*[[math.getBezierPoint]] » Get N-th order bezier point.
*[[math.hypot]] » This function returns the Hypotenuse of the triangle given by sides x and y.
*[[math.isPointInPolygon]] » Check if point is inside polygon or not.
*[[math.lerp]] » Get val between two integer.
*[[math.percent]] » This function returns a percentage from two number values.
*[[math.polygonArea]] » Compute area of any polygon.
*[[math.randomDiff]] » Generates a pseudo-random integer that's always different from the last random number generated.
*[[math.rotVecToEulerAngle]] » Rotation Vector To Euler Angle
*[[math.round]] » Rounds a number whereas the number of decimals to keep and the method may be set.
*[[mathNumber]] » This function is a workaround for the client-side floating-point precision of 24-bits.
*[[reMap]] » Re-maps a number from one range to another.
*[[Math.percentProgress|math.percentProgress]] » Returns a percentage progress from two specific values.
*[[math.average]] » This function returns the simple arithmetic mean of multiple numbers.

=== Map functions ===
*[[assignLod]] » This function lets you conveniently generate and apply a LOD model to a mapping object.
*[[getWorldPositionFromMapPosition]] » This function converts an F11 map position to world position.

=== Ped functions ===
*[[getAlivePlayers (Client)|getAlivePlayers]] » This function returns a table of the alive players client-side.
*[[getAlivePlayersInTeam]] » This function returns a table of the alive players in a team.
*[[getGuestPlayers]] » This function gets a players not login or players Guest .
*[[getOnlineAdmins]] » This function returns a table of all logged-in administrators.
*[[getPedEyesPosition]] » This function allows you to get peds eyes position.
*[[getPedGender]] » This function allows you to get peds their gender.
*[[getPedMaxHealth]] » This function returns a pedestrians's maximum health by converting it from their maximum health stat.
*[[getPedMaxOxygenLevel]] » This function returns a ped's maximum oxygen level by converting it from their maximum underwater stamina stat.
*[[getPedWeaponSkill]] » This function returns a ped's corresponding weapon skill level name.
*[[getPlayerFromNamePart]] » This function returns a player from partial name.
*[[getPlayerFromSerial]] » This function returns a player from their serial.
*[[getPlayersByData]] » This function returns a table of players that have the specified data name.
*[[getPlayersInPhotograph]] » This function returns a table of all players in photograph.
*[[getPlayersInVehicles]] » This function returns a table of the players insides vehicles from a specified dimension.
*[[isPedAiming]]» This function checks if a pedestrian is aiming their weapon.
*[[isPedAimingNearPed]] » This is similar to isPedAiming but uses a colshape to be more precise.
*[[isPedDiving]] » This feature checks that pedestrian is diving in the water.
*[[isPedDrivingVehicle]] » This function checks if a specified pedestrian is driving a vehicle.
*[[isPlayerInTeam]] » This function checks if a player is in a specified team.
*[[setPedAttack]] » This function will make a ped attack a specified target.

=== Player functions ===
*[[countPlayersInRange]] » This function returns the number of players that are within a certain range of the specified coordinates.
*[[getPlayerPreviousAndNextWeapon]] » This function returns the player previous and next weapon.
*[[getPlayersInRange]]» This function make a table of players within certain range.
*[[isPlayerHitByVehicle]]» This function cancels event when a element is hit by a vehicle.
*[[warpToPlayer]]» This function make player warp to another player.

=== Resource functions ===
*[[getFilesInResourceFolder]] » This function gets a list of files that are inside a folder of a resource.
*[[getResourceScripts]] » This function returns a table of the resource scripts.
*[[getResourceSettings]] » This function returns a table of the resource settings.
*[[getResourceSize]] » This function returns the size of a specified resource in kB(kilobyte)
*[[refreshResource]] » This function refreshes your resource if you changed any of the files
*[[setResourcePriority]] » This function set resource download priority group.

=== Sound functions ===
*[[isSoundFinished]] » This function checks if a sound element has finished.
*[[isSoundPlaying]] » This function checks if a sound element is playing or not.
*[[stopSoundSlowly]] » This function stop your sound element slowly.

=== Browser functions ===
*[[playVideo]] » This function plays a video on the screen.

=== Team functions ===
*[[getTeamFromColor]] » This function returns a team element by the specified color.
*[[getTeamWithFewestPlayers]] » This function returns a team element with least players of all the specified teams.

=== Vehicle functions ===
*[[findEmptyCarSeat]] » This function finds you the first empty seat in a vehicle.
*[[getNearestVehicle]] » This function gets the nearest vehicle to the specified player in a specified distance.
*[[getRandomVehicle]] » This function gets a random vehicle.
*[[getValidVehicleModels]] » This function returns a table of all valid vehicle models.
*[[getVehiclesCountByType]] » This function returns the amount of vehicles by the given type as an integer value.
*[[getVehicleTurnVelocityCenterOfMass]]» This function gets a vehicle's turn velocity relative to the vehicle's center or mass.
*[[isVehicleDoubleExhaust]] » This function checks is exhaust vehicle double.
*[[isVehicleEmpty]] » This function checks whether a vehicle is empty.
*[[isVehicleOccupied]] » This function checks if a specified vehicle is occupied.
*[[isVehicleOnRoof]] » This function checks whether vehicle is on roof.
*[[isVehicleReversing]] » This function checks if a specified vehicle is moving backwards.
*[[isVehicleUpgraded]] » This function checks is vehicle upgraded by upgrade ID.
*[[setVehicleGravityPoint]] » This function sets a vehicle's gravity in the direction of a 3 dimensional coordinate with the strength specified.
*[[setVehicleTurnVelocityCenterOfMass]]» This function sets a vehicle's turn velocity relative to the vehicle's center or mass.

=== Weapon functions ===
*[[getJetpackWeaponsEnabled]] » This function returns a table of enabled weapons usable on a jetpack.

=== Object functions ===
*[[getDynamicDoorObjectOpenRatio]] » This function tells you how open a dynamic door is in a range from 0 to 1.
*[[isElementObject]] » This function tells you if an element is an object or no.

=== XML functions ===
*[[getXMLNodes]] » This function returns all children of a XML node.

=== Engine functions ===
*[[engineGetCOLsFromLibrary]] » This function gets the collision data from the col library.
*[[engineLoadIMGContainer]] » This function loads the IMG container.

=== Utility ===
*[[animate]] » This function allows you to use interpolateBetween without render event and easily used.
*[[callClientFunction]] » This function allows you to call any client-side function from the server's side.
*[[callServerFunction]] » This function allows you to call any server-side function from the client's side.
*[[check]] » This function checks if its arguments are of the right type and calls the error-function if one is not.
*[[checkPassiveTimer]] » This function allows you to use passive timers in your conditions. For example you want to prevent players repeatedly using a command.
*[[coroutine.resume]] » This function applies a fix for hidden coroutine error messages.
*[[getBanFromName]] » This functions returns the ban of the given playername.
*[[getCurrentFPS]] » This function returns the frames per second at which GTA: SA is running.
*[[getSkinNameFromID]] » This function returns the name of the skin from the given id.
*[[IfElse]] » This function returns one of two values based on a boolean expression.
*[[isCharInString]] » This shared function allows you to check if a char specified is in a string value.
*[[isMouseInCircle]] » This function checks if a cursor position is in circular area or not.
*[[isMouseInPosition]] » This function allows you to check whether the mouse cursor/pointer is within a rectangular position.
*[[iterElements]] » This function returns ''a time-saving'' iterator for your for-loops.
*[[PlotTrajectoryAtTime]] » Calculate projectile/water trajectory.
*[[preprocessor]] » This function allow you to use gcc macros.
*[[vector3:compare]] » This method checks whether two vectors match, with optional precision.

<noinclude>[[Category:Useful Functions]]</noinclude>

IsElementObject

2021-12-17T23:20:49Z

Hydra:

{{Useful_Function}}
This function tells you if an element is an object or no.

==Syntax==
<syntaxhighlight lang="lua">float isElementObject ( element theElement )</syntaxhighlight>

===Required Arguments===
*'''theElement:''' The element that you wish to check if is an object or no.

===Returns===
Returns an object.

==Code==
<syntaxhighlight lang="lua">
function isElementObject(element)
if isElement(element) and getElementType(element) == "object" then
return element
end
end
</syntaxhighlight>

'''Author: Hydra45'''
{{Useful_Functions}}

IsElementObject

2021-12-17T23:19:56Z

Hydra: Created page with "{{Useful_Function}} This function tells you if an element is an object or no. ==Syntax== <syntaxhighlight lang="lua">float isElementObject ( element theElement )</syntaxhighlight> ===Required Arguments=== *'''theElement:''' The element that you wish to check if is an object or no. ===Returns=== Returns an object. ==Code== <syntaxhighlight lang="lua"> function isElementObject(element) if isElement(element) and getElementType(element) == "object" then return e..."

Template:Useful Functions

2021-12-17T23:17:48Z

Hydra: /* Object functions */

__NOTOC__
=== Table functions ===
*[[addTableChangeHandler]] » This function monitors the changes of a table.
*[[getTableFromSql]] » This functionality is used to obtain saved tables using the function ([https://wiki.multitheftauto.com/wiki/SetTableToSql SetTableToSql ]).
*[[isValueInTable]] » This function returns true if the value exists in the table, false if the value does not exist in the table.
*[[pairsByKeys]] » This function sort pairs table.
*[[rangeToTable]] » This function converts a string range to a table containing number values.
*[[setTableProtected]] » This function protects a table and makes it read-only.
*[[setTableToSql]] » This function is used to save the table in the database (sql).
*[[Sort_Functions]] » These functions are able to sort your tables by a key.
*[[table.compare]] » This function checks whether two given tables are equal.
*[[table.copy]] » This function copies a whole table and all the tables in that table.
*[[table.deepmerge]] » This function deep merges two tables. Every nested table will be correspondingly merged.
*[[table.element]] » This function returns a new table with only userdata content.
*[[table.empty]] » This function checks whether a table is empty.
*[[table.fromString]] » This function converts string to a table.
*[[table.getRandomRows]] » This function returns random rows from table.
*[[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]] » This function merges two or more tables together.
*[[table.random]] » This function retrieves a random value from a table.
*[[table.removeValue]] » This function removes a specified value from a table.
*[[table.size]] » This function returns the absolute size of a table.
*[[table.toString]] » This function converts table to a string.
*[[table.toStringArray]] » This function converts '''array''' to a string.

=== ACL functions ===
*[[aclGroupClone]] » This function clone a group to another group with/without ACLs and/or objects.
*[[getAccountsRanks]] » This function is used to detect the account name groups and put them in the chat.
*[[getPlayerAcls]] » This function returns a table of all ACL groups on a player.
*[[getPlayersInACLGroup]] » This function returns all players in an ACL group.
*[[isPlayerInACL]] » This function checks if a player element is in an ACL group.
*[[renameAclGroup]] » This function gives an existing ACL group a new name.

=== Account functions ===
*[[getPlayerFromAccountName]] » This function is used to obtain a player by the name of his account.

=== Camera functions ===
*[[smoothMoveCamera]] » This function allows you to create a cinematic camera flight.

=== Cursor functions ===
*[[getCursorMovedOn]] » This function checks in which way the cursor is currently moving.

=== Drawing functions ===
*[[dxDrawAnimWindow]] » This function draws an animated 2D window on the screen.
*[[dxDrawBorderedRectangle]] » This is a function that will create a bordered rectangle.
*[[dxDrawBorderedText]] » This is a function that will create a bordered text.
*[[dxDrawDashedLine]] » This function draws a line with dashes.
*[[dxDrawGifImage]] » This function simulates the effect of a GIF image by using image sprites in 2D.
*[[dxDrawImage3D]] » This function draws a 3D image in GTA world.
*[[dxDrawImageOnElement]] » This function draws an image on any element.
*[[dxDrawLinedRectangle]] » This is a function that will create a rectangle outline with dx lines.
*[[dxDrawLoading]] » This function draws a loading bar on the screen.
*[[dxDrawOctagon3D]] » This function creates a 3D Octagon
*[[dxDrawPolygon]] » This function draws a custom polygon on the screen.
*[[dxDrawProgressBar]] » This function simulates a progress bar drawed using DirectDraw.
*[[dxDrawRectangle3D]] » This function draws a 3D rectangle in GTA world.
*[[dxDrawRectangleOnPlayer]] » This function draws a 3D rectangle above the player.
*[[dxDrawRing]] » This function draws a ring with dx lines.
*[[dxDrawRombo]] » This function creates a Rhombus.
*[[dxDrawSprite]] » This function draw a sprite in the 3D world.
*[[dxDrawTextOnElement]] » This function draws a text on any element.
*[[dxDrawTextOnRectangle]] » Esta funcion crea un rectangle con un texto dentro.
*[[dxDrawTriangle]] » This is a function that will create a triangle with dx lines.
*[[dxGetFontSizeFromHeight]] » This function calculates the font size from given height.
*[[dxGetRealFontHeight]] » This function calculates the height of a font.
*[[getScreenStartPositionFromBox]] » This function helps with getting the correct position for your dx-effects.
*[[wordWrap]] » This function breaks a long string into a table of separate lines limited to a specific length in pixels, for drawing separately.

=== Effects functions ===
*[[attachEffect]] » This function allows you attach an effect to an element.

=== Element functions ===
*[[isElementPlayer]] » This function checks whether the element is a player or not.
*[[attachElementToBone]] » This function allows you to attach an element to ped bone accurately using new bone functions.
*[[getElementsInDimension]] » This function returns a table of elements that are in the specified dimension.
*[[getElementSpeed]] » This function returns the specified element's speed in m/s, km/h or mph.
*[[getElementsWithinMarker]] » This function returns a table of elements that are within a marker's collision shape.
*[[getElementUsingData]] » This function returns table elements that contains the elements data with the given key and value.
*[[getNearestElement]] » This function returns the nearest element (of a specific type) to a player.
*[[isElementInPhotograph]] » This function checks if an element is in the player's camera picture area.
*[[isElementInRange]] » This function allows you to check if an element's range to a main point is within the maximum range.
*[[isElementMoving]]» This function checks if an element is moving.
*[[isElementWithinAColShape]]» This function checks if an element is within a collision shape element.
*[[isElementInAir]]» This function checks if an element is in air or not.
*[[multi_check]] » This function checks one element to many, handy and clean.
*[[setElementSpeed]] » This function allows you to set the speed of an element in kph or mph units.

=== Events ===
*[[onVehicleWeaponFire]] » This code implements an event that is triggered when a player in a vehicle fires a vehicle's weapon.

=== Input functions ===
*[[bindControlKeys]] » This function allows you to bind each key bound to a control individually. Doing this bypasses a little MTA restriction.
*[[getBoundControls]] » This function returns a table of control names that are bound to the specified key.
*[[getClipboard]] » This event returns the contents of the clipboard by pressing ctrl + v / ctrl + V. Event triggered ONLY if cursor is showing.
*[[unbindControlKeys]] » This function allows you to unbind each key bound to a control individually. Use this function with [[bindControlKeys]].

=== Data functions ===
*[[byte2human]] » This function converts an integer (number of bytes) into a human-readable unit.
*[[capitalize]] » This function capitalizes a given string.
*[[convertDate]] » This function converts date to another look.
*[[convertServerTickToTimeStamp]] » This function converts server ticks to a unix timestamp.
*[[convertTextToSpeech]] » This function converts the provided text to a speech in the provided language which players can hear.
*[[findRotation3D]] » This function takes two sets of XYZ coordinates. It returns the 3D direction from point A to point B.
*[[findRotation]] » This function takes two points and returns the direction from point A to point B.
*[[formatDate]] » This function formats a date on the basis of a format string and returns it.
*[[formatNumber]] » This function formats large numbers by adding commas.
*[[generateRandomASCIIString]] » This function returns a random string which uses ASCII characters. 
*[[generateString]] » This function generates a random string with any characters.
*[[getAge]] » This function calculates the age of a given birthday.
*[[getDistance]] » Returns the distance between two elements.
*[[getDistanceBetweenElements]] » Esta funcion sirve para obtener la distancia entre dos elementos.
*[[getDistanceBetweenPointAndSegment2D]] » This function takes point coordinates and line (a segment) starting and ending coordinates. It returns the shortest distance between the point and the line.
*[[getEasterDate]] » This function returns easter date monthday and month for a given year.
*[[getFreeDimension]] » This function get free dimension.
*[[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.
*[[getPointFromDistanceRotation]] » This function finds a point based on a starting point, direction and distance.
*[[getRealMonth]] » This function returns the current month name
*[[getRGColorFromPercentage]] »This function returns two integers representing red and green colors according to the specified percentage.
*[[getScreenRotationFromWorldPosition]] » This function returns a screen relative rotation to a world position.
*[[getTimestamp]] » This function returns the UNIX timestamp of a specified date and time.
*[[gradientString]] » This function transforms a string in a new coloured gradient string.
*[[hex2rgb]] » This function convert hex to rgb.
*[[hexColorToRGB]] » This function convert hex string/number to RGBA values.
*[[isLeapYear]] » This function returns a boolean representing if a given year is a leap year.
*[[isValidMail]] » This function checks whether a provided e-mail string is valid.
*[[removeHex]] » This function is used to remove hexadecimal numbers (colors, for example) from strings.
*[[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.
*[[string.count]] » This function counts the amount of occurences of a string in a string.
*[[string.explode]] » This function splits a string at a given separator pattern and returns a table with the pieces.
*[[string.insert]] » This function inserts a string within another string at a given position.
*[[switch]] » This function allows the value of a variable or expression to control the flow of program execution via a multiway branch.
*[[tocolor2rgba]] » This function convert tocolor to rgba.
*[[toHex]] » This function converts a decimal number to a hexadecimal number, as a fix to be used client-side.
*[[var dump]] » This function outputs information about one or more variables using outputConsole.
*[[wavelengthToRGBA]] » This function converts a physical wavelength of light to a RGBA color.

=== GUI functions ===
*[[centerWindow]] » This function centers a CEGUI window element responsively in any resolution.
*[[guiMoveElement]] » This function moves guiElement by/like using moveObject.
*[[guiSetStaticImageMovable]] » This function allows you to move a static image like a gui window.
*[[isMouseOnGUICloseButton]] » This function allows you to check whether the mouse cursor/pointer is within a gui-window's native close button.
*[[isMouseOnGuiElement]] » This function allows you to check whether or not your mouse is over a specific gui element, this is especially useful if the gui element has a parent. 
=====Comboboxes=====
*[[guiComboBoxAdjustHeight]] » This function adjusts a CEGUI combobox element to have the correct height.

=====Gridlists=====
*[[convertGridListToText]] » This function converts grid list contents to text.
*[[getGridListRowIndexFromText]] » This function returns the GridList row index from the specified text.
*[[guiGridListAddPlayers]] » This function add all online players to a grid list.
*[[guiGridListGetColumnIDFromTitle]] » This function gets a gridlist's column ID from the column title.
*[[guiGridListGetSelectedText]] » This function returns a string containing the inner text of a selected gridlist item.
*[[guiGridListSetColumnNonSortable]] » This function makes a gridlist column become non-sortable.
*[[guiGridListSetColumnsFixedWidth]] » This function makes a gridlist have all its columns fixed width.
*[[isTextInGridList]] » This function checks if some text exist or not in the GridList.

=====Labels=====
*[[guiLabelAddEffect]] » This function add an effects to the gui-label like (shadow, outline).

=== Marker functions ===
*[[createMarkerAttachedTo]] » This function creates a marker that is attached to an element.

=== Math functions ===
*[[math.clamp]] » This function returns the number between range of numbers or it's minimum or maximum.
*[[math.getBezierPoint]] » Get N-th order bezier point.
*[[math.hypot]] » This function returns the Hypotenuse of the triangle given by sides x and y.
*[[math.isPointInPolygon]] » Check if point is inside polygon or not.
*[[math.lerp]] » Get val between two integer.
*[[math.percent]] » This function returns a percentage from two number values.
*[[math.polygonArea]] » Compute area of any polygon.
*[[math.randomDiff]] » Generates a pseudo-random integer that's always different from the last random number generated.
*[[math.rotVecToEulerAngle]] » Rotation Vector To Euler Angle
*[[math.round]] » Rounds a number whereas the number of decimals to keep and the method may be set.
*[[mathNumber]] » This function is a workaround for the client-side floating-point precision of 24-bits.
*[[reMap]] » Re-maps a number from one range to another.
*[[Math.percentProgress|math.percentProgress]] » Returns a percentage progress from two specific values.

=== Map functions ===
*[[assignLod]] » This function lets you conveniently generate and apply a LOD model to a mapping object.
*[[getWorldPositionFromMapPosition]] » This function converts an F11 map position to world position.

=== Ped functions ===
*[[getAlivePlayers (Client)|getAlivePlayers]] » This function returns a table of the alive players client-side.
*[[getAlivePlayersInTeam]] » This function returns a table of the alive players in a team.
*[[getGuestPlayers]] » This function gets a players not login or players Guest .
*[[getOnlineAdmins]] » This function returns a table of all logged-in administrators.
*[[getPedEyesPosition]] » This function allows you to get peds eyes position.
*[[getPedGender]] » This function allows you to get peds their gender.
*[[getPedMaxHealth]] » This function returns a pedestrians's maximum health by converting it from their maximum health stat.
*[[getPedMaxOxygenLevel]] » This function returns a ped's maximum oxygen level by converting it from their maximum underwater stamina stat.
*[[getPedWeaponSkill]] » This function returns a ped's corresponding weapon skill level name.
*[[getPlayerFromNamePart]] » This function returns a player from partial name.
*[[getPlayerFromSerial]] » This function returns a player from their serial.
*[[getPlayersByData]] » This function returns a table of players that have the specified data name.
*[[getPlayersInPhotograph]] » This function returns a table of all players in photograph.
*[[getPlayersInVehicles]] » This function returns a table of the players insides vehicles from a specified dimension.
*[[isPedAiming]]» This function checks if a pedestrian is aiming their weapon.
*[[isPedAimingNearPed]] » This is similar to isPedAiming but uses a colshape to be more precise.
*[[isPedDiving]] » This feature checks that pedestrian is diving in the water.
*[[isPedDrivingVehicle]] » This function checks if a specified pedestrian is driving a vehicle.
*[[isPlayerInTeam]] » This function checks if a player is in a specified team.

=== Player functions ===
*[[countPlayersInRange]] » This function returns the number of players that are within a certain range of the specified coordinates.
*[[getPlayerPreviousAndNextWeapon]] » This function returns the player previous and next weapon.
*[[getPlayersInRange]]» This function make a table of players within certain range.
*[[isPlayerHitByVehicle]]» This function cancels event when a element is hit by a vehicle.
*[[warpToPlayer]]» This function make player warp to another player.

=== Resource functions ===
*[[getFilesInResourceFolder]] » This function gets a list of files that are inside a folder of a resource.
*[[getResourceScripts]] » This function returns a table of the resource scripts.
*[[getResourceSettings]] » This function returns a table of the resource settings.
*[[getResourceSize]] » This function returns the size of a specified resource in kB(kilobyte)
*[[refreshResource]] » This function refreshes your resource if you changed any of the files
*[[setResourcePriority]] » This function set resource download priority group.

=== Sound functions ===
*[[isSoundFinished]] » This function checks if a sound element has finished.
*[[isSoundPlaying]] » This function checks if a sound element is playing or not.
*[[stopSoundSlowly]] » This function stop your sound element slowly.

=== Browser functions ===
*[[playVideo]] » This function plays a video on the screen.

=== Team functions ===
*[[getTeamFromColor]] » This function returns a team element by the specified color.
*[[getTeamWithFewestPlayers]] » This function returns a team element with least players of all the specified teams.

=== Vehicle functions ===
*[[findEmptyCarSeat]] » This function finds you the first empty seat in a vehicle.
*[[getNearestVehicle]] » This function gets the nearest vehicle to the specified player in a specified distance.
*[[getRandomVehicle]] » This function gets a random vehicle.
*[[getValidVehicleModels]] » This function returns a table of all valid vehicle models.
*[[getVehiclesCountByType]] » This function returns the amount of vehicles by the given type as an integer value.
*[[getVehicleTurnVelocityCenterOfMass]]» This function gets a vehicle's turn velocity relative to the vehicle's center or mass.
*[[isVehicleDoubleExhaust]] » This function checks is exhaust vehicle double.
*[[isVehicleEmpty]] » This function checks whether a vehicle is empty.
*[[isVehicleOccupied]] » This function checks if a specified vehicle is occupied.
*[[isVehicleOnRoof]] » This function checks whether vehicle is on roof.
*[[isVehicleReversing]] » This function checks if a specified vehicle is moving backwards.
*[[isVehicleUpgraded]] » This function checks is vehicle upgraded by upgrade ID.
*[[setVehicleGravityPoint]] » This function sets a vehicle's gravity in the direction of a 3 dimensional coordinate with the strength specified.
*[[setVehicleTurnVelocityCenterOfMass]]» This function sets a vehicle's turn velocity relative to the vehicle's center or mass.

=== Weapon functions ===
*[[getJetpackWeaponsEnabled]] » This function returns a table of enabled weapons usable on a jetpack.

=== Object functions ===
*[[getDynamicDoorObjectOpenRatio]] » This function tells you how open a dynamic door is in a range from 0 to 1.
*[[isElementObject]] » This function tells you if an element is an object or no.

=== XML functions ===
*[[getXMLNodes]] » This function returns all children of a XML node.

=== Engine functions ===
*[[engineGetCOLsFromLibrary]] » This function gets the collision data from the col library.
*[[engineLoadIMGContainer]] » This function loads the IMG container.

=== Utility ===
*[[animate]] » This function allows you to use interpolateBetween without render event and easily used.
*[[callClientFunction]] » This function allows you to call any client-side function from the server's side.
*[[callServerFunction]] » This function allows you to call any server-side function from the client's side.
*[[check]] » This function checks if its arguments are of the right type and calls the error-function if one is not.
*[[checkPassiveTimer]] » This function allows you to use passive timers in your conditions. For example you want to prevent players repeatedly using a command.
*[[coroutine.resume]] » This function applies a fix for hidden coroutine error messages.
*[[getBanFromName]] » This functions returns the ban of the given playername.
*[[getCurrentFPS]] » This function returns the frames per second at which GTA: SA is running.
*[[getSkinNameFromID]] » This function returns the name of the skin from the given id.
*[[IfElse]] » This function returns one of two values based on a boolean expression.
*[[isCharInString]] » This shared function allows you to check if a char specified is in a string value.
*[[isMouseInCircle]] » This function checks if a cursor position is in circular area or not.
*[[isMouseInPosition]] » This function allows you to check whether the mouse cursor/pointer is within a rectangular position.
*[[iterElements]] » This function returns ''a time-saving'' iterator for your for-loops.
*[[PlotTrajectoryAtTime]] » Calculate projectile/water trajectory.
*[[preprocessor]] » This function allow you to use gcc macros.
*[[vector3:compare]] » This method checks whether two vectors match, with optional precision.

<noinclude>[[Category:Useful Functions]]</noinclude>