Multi Theft Auto: Wiki - User contributions [en]

PL/Introduction to Scripting the GUI

2020-11-04T20:26:42Z

Tararysz12: Poprawka linku

Jedną z ważnych funkcji MTA:SA jest możliwość stworzenia spersonalizowanego GUI (ang. Graphic User Interface), czyli graficznego interfejsu użytkownika. GUI składa się z okien, przycisków, pól do edycji, pól do wyboru... Prawie wszystkie standardowe komponenty dostępne w środowiskach GUI. Mogą być one wyświetlane, kiedy gracz jest w grze i zostać użyte np. do wejścia i wyjścia tradycyjnych poleceń.

[[Image:AdminGUI.png|thumb|Admin Console GUI]]

==Samouczek robienia okna logowania==
W tym samouczku zrobimy proste okno logowania z dwoma polami edycji i przyciskiem. Okno będzie wyświetlać się po wejściu do gry, a po kliknięciu przycisku gracz zostanie zespawnowany. Samouczek będzie kontynuował tryb gry, który zrobiliśmy w [[Wstęp_do_pisania_skryptów|Wstęp do pisania skryptów]] ''(Jeśli korzystasz z [[Wstęp_do_pisania_skryptów|Wstęp do pisania skryptów]], musisz usunąć lub zakomentować linijkę [[spawnPlayer]] w funkcji "joinHandler" w Twoim kodzie, ponieważ w tym samouczku zastąpimy ją GUI. Zapoznajmy się także ze skryptami po stronie klienta.

===Wyświetlanie okna===
Wszystkie interfejsy GUI muszą być robione po stronie klienta. Dobrym nawykiem jest także zachowanie wszystkich skryptów po stronie klienta w osobnych folderach.

Przejdź do katalogu /Twój folder MTA/mods/deathmatch/resources/myserver/ i stwórz folder o nazwie "client". W folderze /client/ stwórz plik tekstowy i nazwij go "gui.lua".

W tym pliku napiszemy funkcję, która będzie wyświetlać okno. Do stworzenia okna użyjemy [[guiCreateWindow]]:
<syntaxhighlight lang="lua">
function createLoginWindow()
-- definiujemy pozycje okna w osi X i Y
local X = 0.375
local Y = 0.375
-- definiujemy rozmiar okna, szerokość i wysokość
local Width = 0.25
local Height = 0.25
-- tworzymy okno i zapisujemy je pod zmienną "wdwLogin"
-- kliknij na nazwę funkcji, aby przejść do jej dokumentacji
wdwLogin = guiCreateWindow(X, Y, Width, Height, "Logowanie", true)
end
</syntaxhighlight>

===Skalowanie relatywne i absolutne===
Note that the final argument passed to guiCreateWindow in the above example is ''true''. This indicates that the coordinates and dimensions of the window are '''relative''', meaning they are a ''percentage'' of the total screen size. This means that if the far left side of the screen is 0, and the far right is 1, an X position of 0.5 would represent the center point of the screen. Similarly, if the top of the screen is 0 and the bottom is 1, a Y position of 0.2 would be 20% of the way down the screen. The same principles apply to both Width and Height as well (with a Width value of 0.5 meaning the window will be half as wide as the screen).

The alternative to using relative values is using '''absolute''' (by passing ''false'' instead of true to guiCreateWindow). Absolute values are calculated as the total number of pixels from the top-left corner of the parent (if no GUI element parent is specified, the parent is the screen itself). If we assume a screen resolution of 1920x1200, the far left side of the screen being 0 pixels and the far-right being 1920 pixels, an X position of 960 will represent the center point of the screen. Similarly, if the top of the screen is 0 pixels and the bottom is 1200, a Y position of 20 would be 20 pixels down from the top of the screen. The same principles apply to both Width and Height as well (with a Width value of 50 meaning the window will be 50 pixels wide). ''You can use [[guiGetScreenSize]] and a little maths to calculate certain absolute positions.''

The differences between using relative and absolute values are quite simple; GUI created using absolute values will always remain exactly the same pixel size and position, while GUI created using relative values will always be a percentage of its parent's size.

Absolute is generally easier to maintain when editing code by hand, however, your choice of type depends on the situation you are using it for.

For the purposes of this introduction, we will be using relative values.

===Adding the components===
Next, we'll add the text labels (saying "username:" and "password:"), edit boxes (for entering your data), and a button to log in.

To create buttons we use [[guiCreateButton]] and to create edit boxes use [[guiCreateEdit]]:

'''Note that we are now writing more code for our existing 'createLoginWindow' function. This is not a new function and is meant to replace what you already have.'''
<syntaxhighlight lang="lua">
function createLoginWindow()
local X = 0.375
local Y = 0.375
local Width = 0.25
local Height = 0.25
wdwLogin = guiCreateWindow(X, Y, Width, Height, "Please Log In", true)

-- define new X and Y positions for the first label
X = 0.0825
Y = 0.2
-- define new Width and Height values for the first label
Width = 0.25
Height = 0.25
-- create the first label, note the final argument passed is 'wdwLogin' meaning the window
-- we created above is the parent of this label (so all the position and size values are now relative to the position of that window)
guiCreateLabel(X, Y, Width, Height, "Username", true, wdwLogin)
-- alter the Y value, so the second label is slightly below the first
Y = 0.5
guiCreateLabel(X, Y, Width, Height, "Password", true, wdwLogin)

X = 0.415
Y = 0.2
Width = 0.5
Height = 0.15
edtUser = guiCreateEdit(X, Y, Width, Height, "", true, wdwLogin)
Y = 0.5
edtPass = guiCreateEdit(X, Y, Width, Height, "", true, wdwLogin)
-- set the maximum character length for the username and password fields to 50
guiEditSetMaxLength(edtUser, 50)
guiEditSetMaxLength(edtPass, 50)

X = 0.415
Y = 0.7
Width = 0.25
Height = 0.2
btnLogin = guiCreateButton(X, Y, Width, Height, "Log In", true, wdwLogin)

-- make the window invisible
guiSetVisible(wdwLogin, false)
end
</syntaxhighlight>
Note that every GUI component created is a child of the window, this is done by specifying the parent element (wdwLogin, in this case) when creating the component.

This is very useful because not only does it mean that all the components are attached to the window and will move with it, but also that any changes done to the parent window will be applied down the tree to these child components. For example, we can now hide all of the GUI we just created by simply hiding the window:
<syntaxhighlight lang="lua">
guiSetVisible(wdwLogin, false) --hides all the GUI we made so we can show them to the player at the appropriate moment.
</syntaxhighlight>

===Using the function we wrote===
The createLoginWindow function is now complete, but it won't do anything until we call it. It is recommended to create all GUI when the client resource starts, hide them, and show them to the player later when needed. Therefore, we'll write an event handler for "[[onClientResourceStart]]" to create the window:
<syntaxhighlight lang="lua">
-- attach the event handler to the root element of the resource
-- this means it will only trigger when its own resource is started
addEventHandler("onClientResourceStart", getResourceRootElement(),
function ()
createLoginWindow()
end
)
</syntaxhighlight>

As this is a login window, we now need to show the window when the player joins the game.
This can be done using the same event, "[[onClientResourceStart]]", so we can modify the above code to include showing the window:

'''Note that we are now writing more code for our existing 'onClientResourceStart' handler. This is not a new event handler and is meant to replace what you already have.'''
<syntaxhighlight lang="lua">
addEventHandler("onClientResourceStart", getResourceRootElement(),
function ()
-- create the log in window and its components
createLoginWindow()

-- output a brief welcome message to the player
outputChatBox("Welcome to My MTA:SA Server, please log in.")

-- if the GUI was successfully created, then show the GUI to the player
if (wdwLogin ~= nil) then
guiSetVisible(wdwLogin, true)
else
-- if the GUI hasn't been properly created, tell the player
outputChatBox("An unexpected error has occurred and the login GUI has not been created.")
end

-- enable the player's cursor (so they can select and click on the components)
showCursor(true)
-- set the input focus onto the GUI, allowing players (for example) to press 'T' without the chatbox opening
guiSetInputEnabled(true)
end
)
</syntaxhighlight>

Note that we have a simple security check before making the window visible, so in the unlikely event that the window has not been created, meaning wdwLogin is not a valid element, we don't get an error and just inform the player what has happened.
In the next step, we will create the button functionality for the login button.

==Scripting the button==
Now that we have created our GUI and shown it to the player, we need to make it work.

===Detecting the click===
When the player clicks on any part of the GUI, the event "[[onClientGUIClick]]" will be triggered for the GUI component you clicked on. This allows us to easily detect any clicks on the GUI elements we want to use.
For example, we can attach the event to the btnLogin button to catch any clicks on it:
<syntaxhighlight lang="lua">
-- attach the event onClientGUIClick to btnLogin and set it to trigger the 'clientSubmitLogin' function
addEventHandler("onClientGUIClick", btnLogin, clientSubmitLogin, false)
</syntaxhighlight>
'''Note the final argument passed is "false". This indicates that the event will only trigger directly on btnLogin, not if the event has propagated up or down the tree. Setting this to "true" while attaching to GUI elements will mean that clicking on any element in the same branch will trigger this event.'''

This line of code can now be added inside the createLoginWindow function. It is a common mistake to try and attach events to non-existent GUI elements, so make sure you always attach your events '''after''' the GUI element (in this case, the button) has been created:

'''Note that we are now writing more code for our existing 'createLoginWindow' function.'''
<syntaxhighlight lang="lua">
function createLoginWindow()
-- create all our GUI elements
...

-- now add our onClientGUIClick event to the button we just created
addEventHandler("onClientGUIClick", btnLogin, clientSubmitLogin, false)
</syntaxhighlight>

===Managing the click===
Now that we can detect when the player clicks on the button, we need to write code to manage what happens when they do.
In our [[onClientGUIClick]] event handle, we told it to call the function clientSubmitLogin whenever btnLogin is clicked.
Therefore, we can now use the function clientSubmitLogin to control what happens when the button is clicked:
<syntaxhighlight lang="lua">
-- create the function and define the 'button' and 'state' parameters
-- (these are passed automatically by onClientGUIClick)
function clientSubmitLogin(button,state)
-- if our login button was clicked with the left mouse button, and the state of the mouse button is up
if button == "left" and state == "up" then
-- move the input focus back onto the game (allowing players to move around, open the chatbox, etc)
guiSetInputEnabled(false)
-- hide the window and all the components
guiSetVisible(wdwLogin, false)
-- hide the mouse cursor
showCursor(false)
end
end
</syntaxhighlight>
Now, when the button is clicked, the window will be hidden and all controls will be returned to the player. Next, we will tell the server to allow the player to spawn.

===Triggering the server===
Triggering the server can be done using [[triggerServerEvent]]. This allows you to trigger a specified event on the server from the client. The same can be done in reverse using [[triggerClientEvent]].
Here, we use the [[triggerServerEvent]] function to call our own custom event on the server, named "submitLogin", which will then control the spawning of the player serverside.

'''Note that we are now writing more code for our existing 'clientSubmitLogin' function. This is not a new function and is meant to replace what you already have.'''
<syntaxhighlight lang="lua">
function clientSubmitLogin(button,state)
if button == "left" and state == "up" then
-- get the text entered in the 'username' field
local username = guiGetText(edtUser)
-- get the text entered in the 'password' field
local password = guiGetText(edtPass)

-- if the username and password both exist
if username and password then
-- trigger the server event 'submitLogin' and pass the username and password to it
triggerServerEvent("submitLogin", getRootElement(), username, password)

-- hide the gui, hide the cursor and return control to the player
guiSetInputEnabled(false)
guiSetVisible(wdwLogin, false)
showCursor(false)
else
-- otherwise, output a message to the player, do not trigger the server
-- and do not hide the gui
outputChatBox("Please enter a username and password.")
end
end
end
</syntaxhighlight>

===Creating the serverside event===
At this point we now have all the code needed on the client-side, so open up your serverside 'script.lua' file (from the [[Scripting Introduction|Introduction to Scripting]]) or another suitable serverside file to work with.

On the server-side, recall that we are spawning the player as soon as they log in.
So, first of all, we will need to define the custom event that we used before on the client. This can be done using [[addEvent]] and [[addEventHandler]].
<syntaxhighlight lang="lua">
-- create our loginHandler function, with a username and password parameters (passed from the client GUI)
function loginHandler(username,password)

end

-- define our custom event, and allow it to be triggered from the client ('true')
addEvent("submitLogin",true)
-- add an event handler so that when submitLogin is triggered, the function loginHandler is called
addEventHandler("submitLogin",root,loginHandler)
</syntaxhighlight>

===Logging in===
Now we have a function that is called through the custom event 'submitLogin', we can start to work on logging in and spawning the player, using our 'loginHandler' function:
<syntaxhighlight lang="lua">
function loginHandler(username,password)
-- check that the username and password are correct
if username == "user" and password == "apple" then
-- the player has successfully logged in, so spawn them
if (client) then
spawnPlayer(client, 1959.55, -1714.46, 10)
fadeCamera(client, true)
setCameraTarget(client, client)
outputChatBox("Welcome to My Server.", client)
end
else
-- if the username or password are not correct, output a message to the player
outputChatBox("Invalid username and password. Please re-connect and try again.",client)
end
end

addEvent("submitLogin",true)
addEventHandler("submitLogin",root,loginHandler)
</syntaxhighlight>
'''For the purposes of this tutorial, a very basic username and password system is shown. For a more comprehensive alternative, you can use the Account System or a MySQL database.'''

Also note the use of the variable "client", it's an internal variable used by MTA to identify the player who triggered the event.

Finally, do not forget to include the new gui.lua file in the meta.xml of the main resource, and label it as a client script:
<syntaxhighlight lang="xml">
<script src="client/gui.lua" type="client" />
</syntaxhighlight>

At this point, we now have a basic login window that checks the player's username and password when the login button is clicked. If they are correct, the player is automatically spawned.

For further help with GUI, see the [[:Category:GUI_Tutorials|GUI tutorials]].

[[Category:GUI_Tutorials]]
[[hu:Introduction to Scripting the GUI]]
[[it:Introduzione_allo_scripting_della_GUI]]
[[ru:Introduction to Scripting the GUI]]
[[es:Introducción a la Programación de GUI]]
[[zh-cn:脚本编写介绍 - 带有图形界面]]

PL/Introduction to Scripting the GUI

2020-11-04T20:25:05Z

Tararysz12: Do dokończenia

Jedną z ważnych funkcji MTA:SA jest możliwość stworzenia spersonalizowanego GUI (ang. Graphic User Interface), czyli graficznego interfejsu użytkownika. GUI składa się z okien, przycisków, pól do edycji, pól do wyboru... Prawie wszystkie standardowe komponenty dostępne w środowiskach GUI. Mogą być one wyświetlane, kiedy gracz jest w grze i zostać użyte np. do wejścia i wyjścia tradycyjnych poleceń.

[[Image:AdminGUI.png|thumb|Admin Console GUI]]

==Samouczek robienia okna logowania==
W tym samouczku zrobimy proste okno logowania z dwoma polami edycji i przyciskiem. Okno będzie wyświetlać się po wejściu do gry, a po kliknięciu przycisku gracz zostanie zespawnowany. Samouczek będzie kontynuował tryb gry, który zrobiliśmy w [[PL/Scripting Introduction|Wprowadzenie do skryptowania]] ''(Jeśli używasz [[PL/Scripting Introduction|Wprowadzenie do skrytpowania]], musisz usunąć lub zakomentować linijkę [[spawnPlayer]] w funkcji "joinHandler" w Twoim kodzie, ponieważ w tym samouczku zastąpimy ją GUI. Zapoznajmy się także ze skryptami po stronie klienta.

===Wyświetlanie okna===
Wszystkie interfejsy GUI muszą być robione po stronie klienta. Dobrym nawykiem jest także zachowanie wszystkich skryptów po stronie klienta w osobnych folderach.

Przejdź do katalogu /Twój folder MTA/mods/deathmatch/resources/myserver/ i stwórz folder o nazwie "client". W folderze /client/ stwórz plik tekstowy i nazwij go "gui.lua".

W tym pliku napiszemy funkcję, która będzie wyświetlać okno. Do stworzenia okna użyjemy [[guiCreateWindow]]:
<syntaxhighlight lang="lua">
function createLoginWindow()
-- definiujemy pozycje okna w osi X i Y
local X = 0.375
local Y = 0.375
-- definiujemy rozmiar okna, szerokość i wysokość
local Width = 0.25
local Height = 0.25
-- tworzymy okno i zapisujemy je pod zmienną "wdwLogin"
-- kliknij na nazwę funkcji, aby przejść do jej dokumentacji
wdwLogin = guiCreateWindow(X, Y, Width, Height, "Logowanie", true)
end
</syntaxhighlight>

===Skalowanie relatywne i absolutne===
Note that the final argument passed to guiCreateWindow in the above example is ''true''. This indicates that the coordinates and dimensions of the window are '''relative''', meaning they are a ''percentage'' of the total screen size. This means that if the far left side of the screen is 0, and the far right is 1, an X position of 0.5 would represent the center point of the screen. Similarly, if the top of the screen is 0 and the bottom is 1, a Y position of 0.2 would be 20% of the way down the screen. The same principles apply to both Width and Height as well (with a Width value of 0.5 meaning the window will be half as wide as the screen).

The alternative to using relative values is using '''absolute''' (by passing ''false'' instead of true to guiCreateWindow). Absolute values are calculated as the total number of pixels from the top-left corner of the parent (if no GUI element parent is specified, the parent is the screen itself). If we assume a screen resolution of 1920x1200, the far left side of the screen being 0 pixels and the far-right being 1920 pixels, an X position of 960 will represent the center point of the screen. Similarly, if the top of the screen is 0 pixels and the bottom is 1200, a Y position of 20 would be 20 pixels down from the top of the screen. The same principles apply to both Width and Height as well (with a Width value of 50 meaning the window will be 50 pixels wide). ''You can use [[guiGetScreenSize]] and a little maths to calculate certain absolute positions.''

The differences between using relative and absolute values are quite simple; GUI created using absolute values will always remain exactly the same pixel size and position, while GUI created using relative values will always be a percentage of its parent's size.

Absolute is generally easier to maintain when editing code by hand, however, your choice of type depends on the situation you are using it for.

For the purposes of this introduction, we will be using relative values.

===Adding the components===
Next, we'll add the text labels (saying "username:" and "password:"), edit boxes (for entering your data), and a button to log in.

To create buttons we use [[guiCreateButton]] and to create edit boxes use [[guiCreateEdit]]:

'''Note that we are now writing more code for our existing 'createLoginWindow' function. This is not a new function and is meant to replace what you already have.'''
<syntaxhighlight lang="lua">
function createLoginWindow()
local X = 0.375
local Y = 0.375
local Width = 0.25
local Height = 0.25
wdwLogin = guiCreateWindow(X, Y, Width, Height, "Please Log In", true)

-- define new X and Y positions for the first label
X = 0.0825
Y = 0.2
-- define new Width and Height values for the first label
Width = 0.25
Height = 0.25
-- create the first label, note the final argument passed is 'wdwLogin' meaning the window
-- we created above is the parent of this label (so all the position and size values are now relative to the position of that window)
guiCreateLabel(X, Y, Width, Height, "Username", true, wdwLogin)
-- alter the Y value, so the second label is slightly below the first
Y = 0.5
guiCreateLabel(X, Y, Width, Height, "Password", true, wdwLogin)

X = 0.415
Y = 0.2
Width = 0.5
Height = 0.15
edtUser = guiCreateEdit(X, Y, Width, Height, "", true, wdwLogin)
Y = 0.5
edtPass = guiCreateEdit(X, Y, Width, Height, "", true, wdwLogin)
-- set the maximum character length for the username and password fields to 50
guiEditSetMaxLength(edtUser, 50)
guiEditSetMaxLength(edtPass, 50)

X = 0.415
Y = 0.7
Width = 0.25
Height = 0.2
btnLogin = guiCreateButton(X, Y, Width, Height, "Log In", true, wdwLogin)

-- make the window invisible
guiSetVisible(wdwLogin, false)
end
</syntaxhighlight>
Note that every GUI component created is a child of the window, this is done by specifying the parent element (wdwLogin, in this case) when creating the component.

This is very useful because not only does it mean that all the components are attached to the window and will move with it, but also that any changes done to the parent window will be applied down the tree to these child components. For example, we can now hide all of the GUI we just created by simply hiding the window:
<syntaxhighlight lang="lua">
guiSetVisible(wdwLogin, false) --hides all the GUI we made so we can show them to the player at the appropriate moment.
</syntaxhighlight>

===Using the function we wrote===
The createLoginWindow function is now complete, but it won't do anything until we call it. It is recommended to create all GUI when the client resource starts, hide them, and show them to the player later when needed. Therefore, we'll write an event handler for "[[onClientResourceStart]]" to create the window:
<syntaxhighlight lang="lua">
-- attach the event handler to the root element of the resource
-- this means it will only trigger when its own resource is started
addEventHandler("onClientResourceStart", getResourceRootElement(),
function ()
createLoginWindow()
end
)
</syntaxhighlight>

As this is a login window, we now need to show the window when the player joins the game.
This can be done using the same event, "[[onClientResourceStart]]", so we can modify the above code to include showing the window:

'''Note that we are now writing more code for our existing 'onClientResourceStart' handler. This is not a new event handler and is meant to replace what you already have.'''
<syntaxhighlight lang="lua">
addEventHandler("onClientResourceStart", getResourceRootElement(),
function ()
-- create the log in window and its components
createLoginWindow()

-- output a brief welcome message to the player
outputChatBox("Welcome to My MTA:SA Server, please log in.")

-- if the GUI was successfully created, then show the GUI to the player
if (wdwLogin ~= nil) then
guiSetVisible(wdwLogin, true)
else
-- if the GUI hasn't been properly created, tell the player
outputChatBox("An unexpected error has occurred and the login GUI has not been created.")
end

-- enable the player's cursor (so they can select and click on the components)
showCursor(true)
-- set the input focus onto the GUI, allowing players (for example) to press 'T' without the chatbox opening
guiSetInputEnabled(true)
end
)
</syntaxhighlight>

Note that we have a simple security check before making the window visible, so in the unlikely event that the window has not been created, meaning wdwLogin is not a valid element, we don't get an error and just inform the player what has happened.
In the next step, we will create the button functionality for the login button.

==Scripting the button==
Now that we have created our GUI and shown it to the player, we need to make it work.

===Detecting the click===
When the player clicks on any part of the GUI, the event "[[onClientGUIClick]]" will be triggered for the GUI component you clicked on. This allows us to easily detect any clicks on the GUI elements we want to use.
For example, we can attach the event to the btnLogin button to catch any clicks on it:
<syntaxhighlight lang="lua">
-- attach the event onClientGUIClick to btnLogin and set it to trigger the 'clientSubmitLogin' function
addEventHandler("onClientGUIClick", btnLogin, clientSubmitLogin, false)
</syntaxhighlight>
'''Note the final argument passed is "false". This indicates that the event will only trigger directly on btnLogin, not if the event has propagated up or down the tree. Setting this to "true" while attaching to GUI elements will mean that clicking on any element in the same branch will trigger this event.'''

This line of code can now be added inside the createLoginWindow function. It is a common mistake to try and attach events to non-existent GUI elements, so make sure you always attach your events '''after''' the GUI element (in this case, the button) has been created:

'''Note that we are now writing more code for our existing 'createLoginWindow' function.'''
<syntaxhighlight lang="lua">
function createLoginWindow()
-- create all our GUI elements
...

-- now add our onClientGUIClick event to the button we just created
addEventHandler("onClientGUIClick", btnLogin, clientSubmitLogin, false)
</syntaxhighlight>

===Managing the click===
Now that we can detect when the player clicks on the button, we need to write code to manage what happens when they do.
In our [[onClientGUIClick]] event handle, we told it to call the function clientSubmitLogin whenever btnLogin is clicked.
Therefore, we can now use the function clientSubmitLogin to control what happens when the button is clicked:
<syntaxhighlight lang="lua">
-- create the function and define the 'button' and 'state' parameters
-- (these are passed automatically by onClientGUIClick)
function clientSubmitLogin(button,state)
-- if our login button was clicked with the left mouse button, and the state of the mouse button is up
if button == "left" and state == "up" then
-- move the input focus back onto the game (allowing players to move around, open the chatbox, etc)
guiSetInputEnabled(false)
-- hide the window and all the components
guiSetVisible(wdwLogin, false)
-- hide the mouse cursor
showCursor(false)
end
end
</syntaxhighlight>
Now, when the button is clicked, the window will be hidden and all controls will be returned to the player. Next, we will tell the server to allow the player to spawn.

===Triggering the server===
Triggering the server can be done using [[triggerServerEvent]]. This allows you to trigger a specified event on the server from the client. The same can be done in reverse using [[triggerClientEvent]].
Here, we use the [[triggerServerEvent]] function to call our own custom event on the server, named "submitLogin", which will then control the spawning of the player serverside.

'''Note that we are now writing more code for our existing 'clientSubmitLogin' function. This is not a new function and is meant to replace what you already have.'''
<syntaxhighlight lang="lua">
function clientSubmitLogin(button,state)
if button == "left" and state == "up" then
-- get the text entered in the 'username' field
local username = guiGetText(edtUser)
-- get the text entered in the 'password' field
local password = guiGetText(edtPass)

-- if the username and password both exist
if username and password then
-- trigger the server event 'submitLogin' and pass the username and password to it
triggerServerEvent("submitLogin", getRootElement(), username, password)

-- hide the gui, hide the cursor and return control to the player
guiSetInputEnabled(false)
guiSetVisible(wdwLogin, false)
showCursor(false)
else
-- otherwise, output a message to the player, do not trigger the server
-- and do not hide the gui
outputChatBox("Please enter a username and password.")
end
end
end
</syntaxhighlight>

===Creating the serverside event===
At this point we now have all the code needed on the client-side, so open up your serverside 'script.lua' file (from the [[Scripting Introduction|Introduction to Scripting]]) or another suitable serverside file to work with.

On the server-side, recall that we are spawning the player as soon as they log in.
So, first of all, we will need to define the custom event that we used before on the client. This can be done using [[addEvent]] and [[addEventHandler]].
<syntaxhighlight lang="lua">
-- create our loginHandler function, with a username and password parameters (passed from the client GUI)
function loginHandler(username,password)

end

-- define our custom event, and allow it to be triggered from the client ('true')
addEvent("submitLogin",true)
-- add an event handler so that when submitLogin is triggered, the function loginHandler is called
addEventHandler("submitLogin",root,loginHandler)
</syntaxhighlight>

===Logging in===
Now we have a function that is called through the custom event 'submitLogin', we can start to work on logging in and spawning the player, using our 'loginHandler' function:
<syntaxhighlight lang="lua">
function loginHandler(username,password)
-- check that the username and password are correct
if username == "user" and password == "apple" then
-- the player has successfully logged in, so spawn them
if (client) then
spawnPlayer(client, 1959.55, -1714.46, 10)
fadeCamera(client, true)
setCameraTarget(client, client)
outputChatBox("Welcome to My Server.", client)
end
else
-- if the username or password are not correct, output a message to the player
outputChatBox("Invalid username and password. Please re-connect and try again.",client)
end
end

addEvent("submitLogin",true)
addEventHandler("submitLogin",root,loginHandler)
</syntaxhighlight>
'''For the purposes of this tutorial, a very basic username and password system is shown. For a more comprehensive alternative, you can use the Account System or a MySQL database.'''

Also note the use of the variable "client", it's an internal variable used by MTA to identify the player who triggered the event.

Finally, do not forget to include the new gui.lua file in the meta.xml of the main resource, and label it as a client script:
<syntaxhighlight lang="xml">
<script src="client/gui.lua" type="client" />
</syntaxhighlight>

At this point, we now have a basic login window that checks the player's username and password when the login button is clicked. If they are correct, the player is automatically spawned.

For further help with GUI, see the [[:Category:GUI_Tutorials|GUI tutorials]].

[[Category:GUI_Tutorials]]
[[hu:Introduction to Scripting the GUI]]
[[it:Introduzione_allo_scripting_della_GUI]]
[[ru:Introduction to Scripting the GUI]]
[[es:Introducción a la Programación de GUI]]
[[zh-cn:脚本编写介绍 - 带有图形界面]]

Strona główna

2020-11-04T20:04:22Z

Tararysz12: Update flag

{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |
<div style="/*border: 1px solid #D8D8D8;*/ padding-left: 15px; padding-right: 15px; height: 100%;">
[[File:Mtalogo.png|left|100px|link=http://wiki.multitheftauto.com/]]'''Witaj na polskiej wiki [[PL/Multi Theft Auto|Multi Theft Auto]].''' Znajdziesz tutaj wiele informacji na temat korzystania z Multi Theft Auto.

Jest wiele [[PL/How you can help|rzeczy które możesz zrobić]], aby pomóc nam w rozwijaniu MTA - stworzyć mapę, tryb gry, pomóc w dokumentowaniu funkcji, napisać przykładowy kod, napisać poradnik lub po prostu grać w MTA i zgłaszać błędy, które znajdziesz.

Jeśli masz jakieś pytania bądź problemy związane z pisaniem skryptów, zapytaj nas na [[PL/IRC Channel|kanale IRC]].
<br/><br/>[ Przestań bawić się samemu! :) ]
</div>
|}
{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |
|-
|width="50%" style="vertical-align:top;" |<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>Graj</h3>
<div style="background: #FFEEAA; border: 1px solid #FFCD19;">
[[File:Go-down.png|link=http://mtasa.com/]] ''' [http://mtasa.com/ Pobierz Multi Theft Auto: San Andreas {{Current Version|full}}]'''</div>
* [[PL/Where to buy GTASA|Gdzie kupić GTASA]] [[Image:Plflag.png|Artykuł w języku polskim]]
* [[PL/Client Manual|Obsługa klienta]] [[Image:Plflag.png|Artykuł w języku polskim]]

* [[PL/Changes_in_{{padleft:|5|{{Current Version|full}}}}| Zmiany w {{padleft:|5|{{Current Version|full}}}}]] [[Image:Plflag.png|Artykuł w języku polskim]]
* [[PL/Known_Issues_-_FAQ|Znane problemy]] [[Image:Plflag.png|Artykuł w języku polskim]] / [[Image:usen.gif|Artykuł w języku angielskim]]
* [[PL/Migracja_z_MTA:Race_do_MTA:SA_1.0.x|Migracja z MTA:Race do MTA:SA {{padleft:|3|{{Current Version|full}}}}]] [[Image:Plflag.png|Artykuł w języku polskim]]
* [[PL/Server Manual|Obsługa serwera]] [[Image:Plflag.png|Artykuł w języku polskim]]
* [[Map manager|Menadżer map]] [[Image:usen.gif|Artykuł w języku angielskim]]

<h3>Edytor map</h3>
*[[PL/Resource:Editor|Instrukcja]] [[Image:Plflag.png|Artykuł w języku polskim]]
*[[PL/Resource:Editor/EDF|Edytor Właściwości Mapy]] [[Image:Plflag.png|Artykuł w języku polskim]] / [[Image:usen.gif|Artykuł w języku angielskim]]
*[[Resource:Editor/Plugins|Pluginy]] [[Image:usen.gif|Artykuł w języku angielskim]]
*[[PL/Resource:Editor#FAQ|Najczęściej zadawane pytania]] [[Image:Plflag.png|Artykuł w języku polskim]]
</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>Bazy danych</h3>
Ta sekcja opisuje wszystkie możliwości Lua umożliwiane przez MTA lub zasoby.
* [[PL/Category:Resource|Katalog zasobów]] - Musisz je poznać, aby tworzyć właściwe skrypty
* [[PL/Client side scripts|Skrypty po stronie klienta]] [[Image:Plflag.png|Artykuł w języku polskim]]
* [[PL/Modules|Moduły]] [[Image:Plflag.png|Artykuł w języku polskim]]
</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>Rozwijanie Multi Theft Auto</h3>
[[File:Go-down.png|link=http://nightly.mtasa.com/]] [http://nightly.mtasa.com/ Nightly builds]
* [[Compiling_MTASA|Kompilacja MTASA na Windows]] [[Image:usen.gif|Artykuł w języku angielskim]]
* [[Building_MTASA_Server_on_GNU_Linux|Kompilacja MTASA na GNU/Linux]] [[Image:usen.gif|Artykuł w języku angielskim]]
* [[Coding guidelines|Wytyczne dot. pisania kodu]] [[Image:usen.gif|Artykuł w języku angielskim]]
* [https://github.com/multitheftauto/mtasa-blue Repozytorium Github]
* [[Roadmap]] [[Image:usen.gif|Artykuł w języku angielskim]]
* [http://bugs.mtasa.com/ Bugtracker]
* [[Branches|Branże]] [[Image:usen.gif|Artykuł w języku angielskim]]
</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>Polskie Wiki - jak możesz pomóc?</h3>
* Pomóż tłumaczyć hasła, przy których jest angielska flaga
* Twórz hasła, które istnieją w angielskiej wiki, a których u nas brakuje
** Staraj się, aby nowe artykuły miały takie same nazwy (angielskie), a jedynie poprzedzane były przedrostkiem PL/ - przykład: [[PL/Character_Skins]]
* Zwołaj znajomych, informuj na forach, niech inni dowiedzą się o takiej możliwości!
* Jeśli nie masz pomysłu na edycję, wykonaj coś z [[PL/Todo|tej listy]]. Możesz ją także rozbudować.
</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>Społeczność</h3>
* [http://forum.multitheftauto.com/ Forum]
* Discord: [https://forum.mtasa.com/topic/95008-multi-theft-autos-official-discord-server/ Oficjalny serwer Discord MTA]
* IRC: [irc://irc.multitheftauto.com/mta irc.multitheftauto.com #mta]
* [http://community.mtasa.com/ MTA Community] - dodaj lub pobierz skrypty
* [http://twitter.com/#!/MTAQA/ Twitter] - [http://www.youtube.com/user/MTAQA Youtube] - [http://plus.google.com/102014133442331779727/ Google+] - [http://www.moddb.com/mods/multi-theft-auto-san-andreas ModDB]
</div>

| width="50%" style="vertical-align:top;" |

<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>Skryptowanie</h3>
* [[Wstęp do pisania skryptów|Wstęp do pisania skryptów]] [[Image:Plflag.png|Artykuł w języku polskim]] / [[Image:usen.gif|Artykuł w języku angielskim]]
* [[Introduction to Scripting the GUI|Wstęp do pisania skryptów GUI]] [[Image:usen.gif|Artykuł w języku angielskim]]
* [[Debugging|Poradnik debugowania]] [[Image:usen.gif|Artykuł w języku angielskim]] - Jak znaleźć błędy w swoich skryptach
* [[Resources|Wstęp do zasobów]] [[Image:usen.gif|Artykuł w języku angielskim]]
** [[Resource Web Access|Dostęp WWW do zasobów]] [[Image:usen.gif|Artykuł w języku angielskim]] - Jak pisać strony WWW z wykorzystaniem zasobów
** [[:Category:Resource|Katalog zasobów]] [[Image:usen.gif|Artykuł w języku angielskim]]
** [[PL/Meta.xml|Meta.xml]] [[Image:Plflag.png|Artykuł w języku polskim]] - każdy zasób jest definiowany przez plik meta
** [[ACL]] [[Image:usen.gif|Artykuł w języku angielskim]] - Access Control List, który jest niezbędny, aby skrypty działały
* [[Writing_Gamemodes|Pisanie gamemodów]] [[Image:usen.gif|Artykuł w języku angielskim]]
* [[PL/Useful_Functions|Przydatne funkcje]] [[Image:Plflag.png|Artykuł w polskim]] / [[Image:usen.gif|Artykuł w języku angielskim]]
Linki na fora
* [https://forum.mtasa.com/forum/71-scripting/ Forum na temat skryptowania]
* [https://forum.mtasa.com/forum/123-tutorials/ Forum z poradnikami do skryptowania]
* [https://forum.mtasa.com/topic/24702-mtasa-wiki-offline-copies-online-mirrors/ Kopie Wiki]
<div style="float:right; width: 32px;">[[File:start-here.png|link=]]</div>
<h3>Pomoc dotycząca LUA</h3>
Strony zaprojektowane, by pomóc Ci zrozumieć język 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>Odwołania</h3>
* [[PL/Funkcje po stronie klienta|Funkcje po stronie klienta]] [[Image:Plflag.png|Artykuł w języku polskim]]
* [[PL/Client Scripting Events|Zdarzenia po stronie klienta]] [[Image:Plflag.png|Artykuł w języku polskim]]
* [[Server Scripting Functions|Funkcje po stronie serwera]] [[Image:usen.gif|Artykuł w języku angielskim]]
* [[Server Scripting Events|Zdarzenia po stronie serwera]] [[Image:usen.gif|Artykuł w języku angielskim]]

* [[PL/MTA Classes|Klasy MTA]] [[Image:Plflag.png|Artykuł w języku polskim]] / [[Image:usen.gif|Artykuł w języku angielskim]] -- Szczegółowe opisy wszystkich typów MTA
** [[Element|Elementy MTA]] [[Image:usen.gif|Artykuł w języku angielskim]] / [[Element tree|Drzewo elementów]] [[Image:usen.gif|Artykuł w języku angielskim]]
</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>[[PL/Id|Listy ID]]</h3>
*[[PL/Animations|Animacje]] [[Image:Plflag.png|Artykuł w języku polskim]]
*[[PL/Character Skins|Skiny postaci]] [[Image:Plflag.png|Artykuł w języku polskim]]
*[[PL/CJ_Clothes|Ubrania]] [[Image:Plflag.png|Artykuł w języku polskim]]
*[[PL/Garage|Garaże]] [[Image:Plflag.png|Artykuł w języku polskim]]
*[[PL/Interior IDs|Interiory]] [[Image:Plflag.png|Artykuł w języku polskim]]
*[[PL/Material IDs|Materiały]] [[Image:Plflag.png|Artykuł w języku polskim]]
*[[PL/Projectiles|Pociski]] [[Image:Plflag.png|Artykuł w języku polskim]]
*[[PL/Radar Blips|Znaczniki]] [[Image:Plflag.png|Artykuł w języku polskim]]
*[[PL/Sounds|Dźwięki]] [[Image:Plflag.png|Artykuł w języku polskim]]
*[[PL/Vehicle IDs|Pojazdy]] [[Image:Plflag.png|Artykuł w języku polskim]]
*[[PL/Vehicle Colors|Kolory pojazdów]] [[Image:Plflag.png|Artykuł w języku polskim]]
*[[PL/Vehicle Upgrades|Modyfikacje pojazdów]] [[Image:Plflag.png|Artykuł w języku polskim]]
*[[PL/Vehicle variants|Warianty pojazdów]] [[Image:Plflag.png|Artykuł w języku polskim]]
*[[PL/Vehicle component manipulation|Manipulowanie komponentami pojazdów]] [[Image:Plflag.png|Artykuł w języku polskim]]
*[[PL/Weapons|Bronie]] [[Image:Plflag.png|Artykuł w języku polskim]]
*[[PL/Weather|Pogoda]] [[Image:Plflag.png|Artykuł w języku polskim]] / [[Image:usen.gif|Artykuł w języku angielskim]]
</div>
<div style="padding:4px 8px 8px 8px; margin:10px;">
[[File:Osi symbol.png|75px|link=http://opensource.org/|left]]
'''Multi Theft Auto''' jest '''Otwartym Oprogramowaniem'''.
<br/>To znaczy, że każdy może pomóc w byciu Multi Theft Auto lepszym!
</div>
|-
| colspan="2" |
|}
{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |
<div style="padding-left: 15px; padding-right: 15px;" class="plainlinks">
[[File:MTALogo_8ball.png|left|85px|link=Archive]]
<ul style="list-style: none; width: 200px; float: left;">
<li>'''O [[PL/Multi Theft Auto|Multi Theft Auto]]'''</li>
<li>[[PL/Archive|Archiwum]]</li>
<li>[[Press Coverage|MTA w mediach]]</li>
<li>[http://code.google.com/p/mtasa-blue/people/list Developerzy]</li>
</ul>
<ul style="list-style: none; width: 200px; float: left;">
<li>'''Multi Theft Auto 0.5'''</li>
<li>[[PL/Archive#Multi_Theft_Auto_0.5|Pobierz]]</li>
<li>[[MTA 0.5r2 Known Issues|Zauważone problemy]]</li>
</ul>
<ul style="list-style: none; width: 200px; float: left;">
<li>'''Statystyki Wiki'''</li>
<li>{{NUMBEROFARTICLES}} artykuły</li>
<li>{{NUMBEROFPAGES}} strony</li>
<li>{{NUMBEROFFILES}} pliki</li>
</ul>
<ul style="list-style: none; width: 240px; float: left;">
<li>{{NUMBEROFEDITS}} edycji</li>
<li>{{NUMBEROFADMINS}} administratorów</li>
<li>{{NUMBEROFUSERS}} zarejestrowanych użytkowników</li>
<li>{{NUMBEROFACTIVEUSERS}} aktywnych użytkowników</li>
</ul>
</div>
|}

__NOTOC__
__NOEDITSECTION__
{{Languages list|pl}}

User talk:Tararysz12

2018-05-07T14:33:28Z

Tararysz12: Tararysz12 moved page User talk:Tararysz12 to User talk:FileEX: New Nick

#REDIRECT [[User talk:FileEX]]

User talk:FileEX

2018-05-07T14:33:28Z

Tararysz12: Tararysz12 moved page User talk:Tararysz12 to User talk:FileEX: New Nick

Jeśli chcesz to podpisuj przetłumaczone strony - spoko. Ale nie podpisuj szablonów... --[[User:ThePiotrek|ThePiotrek]] ([[User talk:ThePiotrek|talk]]) 19:53, 4 September 2016 (UTC)
::Ja bym powiedział, że podpisywanie tłumaczonych artykułów też jest zbędne. Ta informacja jest już przecież zawarta w historii edycji, znajdującej się przy każdym artykule. Ewentualnie, można też wpisywać przetłumaczone przez siebie strony na swojej stronie użytkownika - nie ma tu żadnego problemu. Natomiast same artykuły powinny zawierać tylko treść, która faktycznie interesuje użytkownika. --[[User:JHXP|JHXP]] ([[User talk:JHXP|talk]]) 09:55, 15 September 2016 (UTC)
+1 --[[User:ThePiotrek|ThePiotrek]] ([[User talk:ThePiotrek|talk]]) 18:06, 15 September 2016 (UTC)

User:FileEX

2018-05-07T14:33:27Z

Tararysz12: Tararysz12 moved page User:Tararysz12 to User:FileEX: New Nick

[[File:skiturystyka.pl_2620.jpg]]

==Moje prace/ My Job==

===Funkcje / Function===
*[[PL/createPickup]]<br/>
*[[PL/createMarker]]<br/>
*[[PL/kickPlayer]]<br/>
*[[PL/setElementFrozen]]<br/>
*[[PL/createBlipAttachedTo]]<br/>

===Zdarzenia/Event===
*[[PL/onMarkerHit]]<br/>
===Inne/Other===
*Spolszczone typy markerów.
*{{PL/Marker_types}}

Pozdrawiam, :)

PL/Server Scripting Functions

2018-03-23T21:41:04Z

Tararysz12: Update translation #1

<pageclass class="server"></pageclass>
{{PL/Adding_Pages_to_Categories_and_Templates}}
Strona z listą wszystkich funkcji '''server-side''' które zostały zaimplementowane. Jeżeli brakuje Ci jakiejś funkcji lub jakiegoś zdarzenia, możesz napisać tutaj [[Requested Functions and Events]] lub http://bugs.mtasa.com.

Kliknij w [[Modules]] aby zobaczyć listę nie rodzimych server-side funkcji i modułów które są dostępne.

Po więcej funkcji zajrzyj w [[Useful_Functions|useful functions page]].

'''Funkcje client-side można znaleźć w tym odnośniku: [[Client Scripting Functions]].'''
__TOC__

==Account functions==
{{Account_functions}}

==ACL functions==
{{ACL_functions}}

==Admin functions==
{{Admin_functions}}

==Audio functions==
{{Audio_functions}}

==Announcement functions==
{{Announce_functions}}

==Blip functions==
{{Blip_functions}}

==Camera functions==
{{Camera functions}}

==Collision shape functions==
{{Collision shape functions}}

==Clothes and body functions==
{{Clothes and body functions}}

==Cursor functions==
{{Cursor_functions}}

==Element functions==
{{Element functions}}

==Event functions==
{{Event_functions}}

==Explosion functions==
{{Explosion_functions}}

==File functions==
{{File_functions}}

==HTTP functions==
{{HTTP_functions}}

==Input functions==
{{Input_functions}}

==Map functions==
{{Map_functions}}

==Marker functions==
{{Marker functions}}

==Matrix functions==
{{Shared_matrix_functions}}

==Module functions==
{{Module functions}}

==Object functions==
{{Object functions}}

==Ped functions==
{{Ped_functions}}

==Pickup functions==
{{Pickup functions}}

==Player functions==
{{Player functions}}

==Radar area functions==
{{Radar area functions}}

==Resource functions==
{{Resource functions}}

==Server functions==
{{Server functions}}

==Settings registry functions==
{{Settings registry functions}}

==SQL functions==
{{SQL_functions}}

==Team functions==
{{Team functions}}

==Text functions==
{{Text functions}}

==Utility functions==
{{Utility functions}}

==UTF8 Library==
{{UTF8 functions}}

==Vehicle functions==
{{Vehicle functions}}

==Water functions==
{{Water functions}}

==Weapon functions==
{{Weapon functions}}

==World functions==
{{World functions}}

==XML functions==
{{XML functions}}

[[tr:Server Scripting Functions]]
[[ar:Server Scripting Functions]]
[[ru:Server Scripting Functions]]
[[es:Funciones_del_Server]]
[[de:Server-Seitige Scripting Funktionen]]
[[pl:Server Scripting Functions]]

PL/Funkcje po stronie klienta

2018-03-23T21:36:54Z

Tararysz12:

<pageclass class="client"></pageclass>
{{PL/Adding_Pages_to_Categories_and_Templates}}
Ta strona przedstawia wszystkie funkcje dostępne po stronie '''klienta''', które zostały zaimplementowane jako natywne funkcje . By zaproponować nową funkcję lub nowe zdarzenie, napisz [[Requested Functions and Events]].

Po więcej funkcji sprawdź [[Useful_Functions|useful functions page]].
__TOC__

==Funkcje dźwięków==
{{Client_audio_functions}}

==Funkcje znaczników (blipów)==
{{Client_blip_functions}}

==Funkcje przeglądarki (CEF)==
{{CEF_functions}}

==Funkcje kamery==
{{Client_camera_functions}}

==Funkcje ubrań i ciała==
{{Client_Clothes and body functions}}

==Funkcje kolizji figur (colshape)==
{{Client_collision_shape_functions}}

==Funkcje kursora==
{{Client_cursor_functions}}

==Funkcje rysowania (DXGui)==
{{Drawing_functions}}

==Funkcje efektów==
{{Client_Effects_functions}}

==Funkcje elementów==
{{Client_element_functions}}

==Funkcje silnika gry==
{{Engine_functions}}

==Funkcje zdarzeń==
{{Client_event_functions}}

==Funkcje eksplozji==
{{Client_explosion_functions}}

==Funkcje plików==
{{Client file functions}}

==Funkcje ognia==
{{Client fire functions}}

==Funkcje GUI==
{{GUI_functions}}

==Funkcje wejścia==
{{Client_input_functions}}

==Funkcje światła==
{{Client_light_functions}}

==Funkcje znaczników 3D (markery)==
{{Client_marker_functions}}

==Funkcje macieży (matrycy)==
{{Shared_matrix_functions}}

==Funkcje obiektów==
{{Client_object_functions}}

==Funkcje wyjścia==
{{Client_output_functions}}

==Funkcje pedów==
{{Client_ped_functions}}

==Funkcje znaczników (pickup)==
{{Client_pickup_functions}}

==Funkcje gracza==
{{Client_player_functions}}

==Funkcje pocisków==
{{Client_projectile_functions}}

==Funkcje obszarów radaru==
{{Client_radar-area_functions}}

==Funkcje zasobów==
{{Client_resource_functions}}

==Funkcje światła poszukiwawczego==
{{Client_searchlight_functions}}

==Funkcje drużyn (team)==
{{Client_team_functions}}

==Funkcje użyteczne==
{{Client_utility_functions}}

==Biblioteka UTF8==
{{UTF8 functions}}

==Funkcje pojazdów==
{{Client_vehicle_functions}}

==Funkcje wody==
{{Client_water_functions}}

==Funkcje broni==
{{Client_weapon_functions}}

==Funkcje tworzonych broni==
<strike>Dokumentacje można znaleźć [http://code.google.com/p/mtasa-blue/source/detail?r=4555 tutaj] [https://github.com/multitheftauto/mtasa-blue/commit/c0ac461867e24fe5fc471fe373ec6212e8736c01 (GitHub)] i [http://code.google.com/p/mtasa-blue/source/detail?r=4557 tutaj] [https://github.com/multitheftauto/mtasa-blue/commit/9c2464b5e0c7d0f2915a9b46273832cd950af48e (GitHub)]</strike>
{{Client_weapon_creation_functions}}

==Funkcje świata==
{{Client_world_functions}}

==Funkcje XML==
{{Client XML functions}}

[[ar:Client Scripting Functions]]
[[pl:Funkcje po stronie klienta]]
[[it:Funzioni Client-side]]
[[ru:Client Scripting Functions]]
[[es:Funciones del cliente]]
[[de:Clientseitige_Funktionen]]
[[tr:Client Taraflı Fonksiyonlar]]
[[pt-br:Funções de Scripting do Cliente]]
[[zh-cn:客户端脚本函数]]

PL/Funkcje po stronie klienta

2018-03-23T21:35:40Z

Tararysz12: Update and fix page

<pageclass class="client"></pageclass>
{{Adding_Pages_to_Categories_and_Templates}}
Ta strona przedstawia wszystkie funkcje dostępne po stronie '''klienta''', które zostały zaimplementowane jako natywne funkcje . By zaproponować nową funkcję lub nowe zdarzenie, napisz [[Requested Functions and Events]].

Po więcej funkcji sprawdź [[Useful_Functions|useful functions page]].
__TOC__

==Funkcje dźwięków==
{{Client_audio_functions}}

==Funkcje znaczników (blipów)==
{{Client_blip_functions}}

==Funkcje przeglądarki (CEF)==
{{CEF_functions}}

==Funkcje kamery==
{{Client_camera_functions}}

==Funkcje ubrań i ciała==
{{Client_Clothes and body functions}}

==Funkcje kolizji figur (colshape)==
{{Client_collision_shape_functions}}

==Funkcje kursora==
{{Client_cursor_functions}}

==Funkcje rysowania (DXGui)==
{{Drawing_functions}}

==Funkcje efektów==
{{Client_Effects_functions}}

==Funkcje elementów==
{{Client_element_functions}}

==Funkcje silnika gry==
{{Engine_functions}}

==Funkcje zdarzeń==
{{Client_event_functions}}

==Funkcje eksplozji==
{{Client_explosion_functions}}

==Funkcje plików==
{{Client file functions}}

==Funkcje ognia==
{{Client fire functions}}

==Funkcje GUI==
{{GUI_functions}}

==Funkcje wejścia==
{{Client_input_functions}}

==Funkcje światła==
{{Client_light_functions}}

==Funkcje znaczników 3D (markery)==
{{Client_marker_functions}}

==Funkcje macieży (matrycy)==
{{Shared_matrix_functions}}

==Funkcje obiektów==
{{Client_object_functions}}

==Funkcje wyjścia==
{{Client_output_functions}}

==Funkcje pedów==
{{Client_ped_functions}}

==Funkcje znaczników (pickup)==
{{Client_pickup_functions}}

==Funkcje gracza==
{{Client_player_functions}}

==Funkcje pocisków==
{{Client_projectile_functions}}

==Funkcje obszarów radaru==
{{Client_radar-area_functions}}

==Funkcje zasobów==
{{Client_resource_functions}}

==Funkcje światła poszukiwawczego==
{{Client_searchlight_functions}}

==Funkcje drużyn (team)==
{{Client_team_functions}}

==Funkcje użyteczne==
{{Client_utility_functions}}

==Biblioteka UTF8==
{{UTF8 functions}}

==Funkcje pojazdów==
{{Client_vehicle_functions}}

==Funkcje wody==
{{Client_water_functions}}

==Funkcje broni==
{{Client_weapon_functions}}

==Funkcje tworzonych broni==
<strike>Dokumentacje można znaleźć [http://code.google.com/p/mtasa-blue/source/detail?r=4555 tutaj] [https://github.com/multitheftauto/mtasa-blue/commit/c0ac461867e24fe5fc471fe373ec6212e8736c01 (GitHub)] i [http://code.google.com/p/mtasa-blue/source/detail?r=4557 tutaj] [https://github.com/multitheftauto/mtasa-blue/commit/9c2464b5e0c7d0f2915a9b46273832cd950af48e (GitHub)]</strike>
{{Client_weapon_creation_functions}}

==Funkcje świata==
{{Client_world_functions}}

==Funkcje XML==
{{Client XML functions}}

[[ar:Client Scripting Functions]]
[[pl:Funkcje po stronie klienta]]
[[it:Funzioni Client-side]]
[[ru:Client Scripting Functions]]
[[es:Funciones del cliente]]
[[de:Clientseitige_Funktionen]]
[[tr:Client Taraflı Fonksiyonlar]]
[[pt-br:Funções de Scripting do Cliente]]
[[zh-cn:客户端脚本函数]]

Template:PL/See also/Server event

2018-03-23T20:46:07Z

Tararysz12: Created page with "===Funkcje zdarzeń=== {{Event functions}}"

===Funkcje zdarzeń===
{{Event functions}}

Template:See also/Server event

2018-03-23T20:41:40Z

Tararysz12: /* {{{1}}} */

==See Also==
===Event functions===
{{Event functions}}

PL/OutputChatBoxWithEnter

2018-03-23T20:39:27Z

Tararysz12:

{{PL/Useful Function}}
__NOTOC__Funkcja ta wyświetla wiadomość na chacie, może ona być wyświetlona dla wybranych graczy lub dla wszystkich graczy. Jak normalny [[outputChatBox]]. Funkcja ta nalicza znaki "\n" (entery) w tekście i rozdziela tekst na tyle wiadomości ile jest enterów.

==Składnia==
<section name="Serwer" class="server" show="true">
<syntaxhighlight lang="lua">bool outputChatBoxWithEnter ( string text [, element visibleTo=getRootElement(), int r=231, int g=217, int b=176, bool colorCoded=false ] )</syntaxhighlight>
==Wymagane Argumenty==
*'''text:''' Ciąg znaków, który ma zostać wyświetlony na chacie. Jeśli ma więcej niż 256 znaków nie pojawi się na chacie.

==Opcjonalne Argumenty==
{{PL/OptionalArg}}
*'''visibleTo:''' Argument ten określa komu ma zostać wyświetlona wiadomość. Domyślnie są to wszyscy gracze. Zobacz [[visibility]].
*'''r:''' Liczba określająca ilość "czerwieni" w kolorze tekstu. Domyślna wartość to 231.
*'''g:''' Liczba określająca ilość "zieleni" w kolorze tekstu. Domyślna wartość to 217.
*'''b:''' Liczba określająca ilość "niebieskiego" w kolorze tekstu. Domyślna wartość to 176.
*'''colorCoded:''' Wartość logiczna (boolean) określająca czy mają być brane pod uwagę znaczniki "#RRGGBB" (kolor heksadecymalny) czy też nie.
Uwaga: Format #RRGGBB musi zawierać wielkie litery, a-f nie jest akceptowane, natomiast A-F to domyślne wartości RGB w tym formacie: "#E7D9B0".
</section>
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">bool outputChatBoxWithEnter ( string text [, int r=231, int g=217, int b=176, bool colorCoded=false ] )</syntaxhighlight>

==Wymgane Argumenty==
*'''text:''' Ciąg znaków, który ma zostać wyświetlony na chacie. Jeśli ma więcej niż 256 znaków nie pojawi się na chacie.

==Opcjonalne Argumenty==
{{PL/OptionalArg}}
*'''r:''' Liczba określająca ilość "czerwieni" w kolorze tekstu. Domyślna wartość to 231.
*'''g:''' Liczba określająca ilość "zieleni" w kolorze tekstu. Domyślna wartość to 217.
*'''b:''' Liczba określająca ilość "niebieskiego" w kolorze tekstu. Domyślna wartość to 176.
*'''colorCoded:''' Wartość logiczna (boolean) określająca czy mają być brane pod uwagę znaczniki "#RRGGBB" (kolor heksadecymalny) czy też nie.
Uwaga: Format #RRGGBB musi zawierać wielkie litery, a-f nie jest akceptowane, natomiast A-F to domyślne wartości RGB w tym formacie: "#E7D9B0".

</section>

==Źródło==
<section name="Serwer" class="server" show="true">
<syntaxhighlight lang="lua">
function outputChatBoxWithEnter(text,who,r,g,b,colorCoded)
if text then
local who = who or getRootElement();
local r,g,b = r,g,b or 231,217,176;
local colorCoded = colorCoded or false;
for t in string.gmatch(text,"([^%\n]+)") do
outputChatBox(t,who,r,g,b,colorCoded);
end
end
end
</syntaxhighlight>
</section>

<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
function outputChatBoxWithEnter(text,r,g,b,colorCoded)
if text then
local r,g,b = r,g,b or 231,217,176;
local colorCoded = colorCoded or false;
for t in string.gmatch(text,"([^%\n]+)") do
outputChatBox(t,r,g,b,colorCoded);
end
end
end
</syntaxhighlight>
</section>

==Przykład==
<section name="Serwer" class="server" show="true">
'''Przykład 1:''' Przykład ten wysyła wiadomość do wszystkich graczy.
<syntaxhighlight lang="lua">
x = 5
y = 10
-- wyświetlamy wiadomość
outputChatBoxWithEnter ( "Ja mam " .. x .. " jabłek oraz\n" .. y .. " pomarańczy." )
</syntaxhighlight>

'''Przykład 2:''' Przykład ten wyświetla wiadomość na chacie "Czerwony Biały", gdzie czerwony jest oznaczony kolorem czerwonym, a biały białym.
<syntaxhighlight lang="lua">
outputChatBoxWithEnter ( "#FF0000Czerwony\n#FFFFFFBiały", getRootElement(), 255, 0, 0, true )
</syntaxhighlight>
</section>

<section name="Client" class="client" show="true">
'''Przykład 1:''' Przykład ten wyświetla nasz nick po wpisaniu komendy /mojnick.
<syntaxhighlight lang="lua">
addCommandHandler("mojnick",function()
outputChatBoxWithEnter("Twój nick to\n"..getPlayerName(localPlayer),255,133,175)
end)
</syntaxhighlight>

'''Przykład 2:''' Przykład ten wyświetla wiadomość na chacie "Czarny Biały", gdzie czarny jest oznaczony kolorem czarnym, a biały białym.
<syntaxhighlight lang="lua">
outputChatBoxWithEnter("#000000Czarny\n#FFFFFFBiały",255,255,255,true)
</syntaxhighlight>
</section>

==Zobacz Też==
{{Useful_Functions}}

PL/OutputChatBoxWithEnter

2018-03-23T20:38:41Z

Tararysz12:

PL/Hsv2rgb

2018-03-23T20:35:49Z

Tararysz12:

__NOTOC__
{{PL/Useful Function}}
Funkcja ta zwraca podany kolor HSV w postaci RGB.

==Składnia==
<syntaxhighlight lang="lua">string hsv2rgb ( int h, int s, int v)</syntaxhighlight>

===Wymagane Argumenty===
* '''h:''' Wartość 'hue' (0-359).
* '''s:''' Wartość 'saturation' (0-100).
* '''v:''' Wartość 'value' (0-100).

==Źródło==
<syntaxhighlight lang="lua">
function hsv2rgb(h, s, v)
local r, g, b
local i = math.floor(h * 6)
local f = h * 6 - i
local p = v * (1 - s)
local q = v * (1 - f * s)
local t = v * (1 - (1 - f) * s)
local switch = i % 6
if switch == 0 then
r = v g = t b = p
elseif switch == 1 then
r = q g = v b = p
elseif switch == 2 then
r = p g = v b = t
elseif switch == 3 then
r = p g = q b = v
elseif switch == 4 then
r = t g = p b = v
elseif switch == 5 then
r = v g = p b = q
end
return math.floor(r*255), math.floor(g*255), math.floor(b*255)
end
</syntaxhighlight>

==Przykład==
<syntaxhighlight lang="lua">
local color = hsv2rgb(283,99,100)
outputChatBox(color)
</syntaxhighlight>

==Zobacz Również==
{{Useful_Functions}}

PL/createBlipAttachedTo

2018-03-23T20:30:01Z

Tararysz12:

__NOTOC__
{{PL/Shared function}}
Funkcja ta tworzy [[blip|znacznik]], który jest dołączony do [[element|elementu]]. Znacznik ten jest wyświetlany jako ikona na radarze gracza, i podąża on razem z [[element|elementem]] do którego jest 'przyklejony'.

==Składnia==
<section name="Serwer" class="server" show="true">
<syntaxhighlight lang="lua">
blip createBlipAttachedTo ( element elementToAttachTo [, int icon = 0, int size = 2, int r = 255, int g = 0, int b = 0, int a = 255, int ordering = 0, float visibleDistance = 99999.0, visibleTo = getRootElement( ) ] )
</syntaxhighlight>
</section>
<section name="Klient" class="client" show="true">
<syntaxhighlight lang="lua">
blip createBlipAttachedTo ( element elementToAttachTo [, int icon = 0, int size = 2, int r = 255, int g = 0, int b = 0, int a = 255, int ordering = 0, float visibleDistance = 99999.0] )
</syntaxhighlight>
</section>

{{PL/OOP||[[Blip]].createAttachedTo||}}

===Wymagane Argumenty===
*'''elementToAttachTo:''' [[element]] do którego ma zostać 'przyklejony' znacznik.

===Opcjonalne Argumenty===
{{PL/OptionalArg}}
*'''icon:''' Ikonka znacznika która ma być widoczna. Spis ikonek: [[PL/Radar_Blips|Ikonki]].
*'''size:''' Rozmiar znacznika na radarze. Domyślnie jest to 2.
*'''r:''' Ilość koloru czerwieni (0-255). Ma zastosowanie tylko w przypadku znacznika typu "Marker". Domyślna ilość to 255.
*'''g:''' Ilość koloru zieleni (0-255). Ma zastosowanie tylko w przypadku znacznika typu "Marker". Domyślna ilość to 0.
*'''b:''' Ilość koloru niebieskości (0-255). Ma zastosowanie tylko w przypadku znacznika typu "Marker". Domyślna ilość to 0.
*'''a:''' Ilość alfa (przezroczystości) (0-255). Ma zastosowanie tylko w przypadku znacznika typu "Marker" Domyślna ilość to 255.
{{New feature/item|3|1.0||
*'''ordering:''' Liczba całkowita określająca wysokość położenia znacznika (-32768 - 32767). Przydatny argument podczas tworzenia blipów znajdujących się w jednym miejscu, ponieważ możemy zdecydować, który z nich będzie na wierzchu. Domyślnie 0.
*'''visibleDistance:''' Odległość z jakiej widoczny ma być znacznik (0 - 65535).
}}
<section name="Serwer" class="server" show="true">
*'''visibleTo:''' Dla kogo ma być widoczny znacznik. Domyślnie jest widoczny dla wszystkich. Zajrzyj [[visibility|widoczność|]].
</section>

===Wynik===
Zwraca [[blip|znacznik]] jeśli znacznik został utworzony pomyślnie, lub ''false'' jeśli nie został utworzony pomyślnie.

==Przykład==
<section name="Serwer" class="server" show="true">
Ten przykład tworzy znacznik na radarze przyklejony do losowego gracza widoczny dla wszystkich. Gdy gracz się porusza to znacznik na radarze porusza się razem z nim. Może to byś wykorzystywane do zaznaczenia losowego gracza.
<syntaxhighlight lang="lua">
-- losujemy gracza
function setupRandomRobber ()
local myPlayer = getRandomPlayer ()
-- Tworzy znacznik o ikonie gotówki czyli "$" przyczepiony do gracza. Widoczny tylko dla każdego (bez argumentu 'visibleTo').
local myBlip = createBlipAttachedTo ( myPlayer, 52 )
end

setupRandomRobber()
</syntaxhighlight>
</section>

==Zobacz Również==
{{Blip_functions}}

PL/Player

2018-03-23T20:26:30Z

Tararysz12:

__NOTOC__
Gracze to postać którą kieruje klient (użytkownik komputera). Gracz tworzy się podczas połączenia się z serwerem i zostaje usunięty gdy klient rozłącza się z serwerem. Gracze nie mogą zostać stworzeni ani usunięci w żaden inny sposób.

Typem elementu tej klasy jest '''"player"'''.

==Podobne funkcje==
===Klient===
{{Client player functions}}
===Serwer===
{{Player functions}}
[[Category:Element Types]]

[[it:Elemento Player]]
[[ru:Element/Player]]
[[es:Elemento/Player]]
[[de:Element/Player]]
[[en:Element/Player]]

DxDrawJumpedRectangle

2018-02-17T16:25:46Z

Tararysz12: Blanked the page

PL/OutputChatBoxWithEnter

2018-02-10T16:47:51Z

Tararysz12: Created page with "{{PL/Useful Function}} __NOTOC__ Funkcja ta wyświetla wiadomość na chacie, może ona być wyświetlona dla wybranych graczy lub dla wszystkich graczy. Jak normalny output..."

{{PL/Useful Function}}
__NOTOC__
Funkcja ta wyświetla wiadomość na chacie, może ona być wyświetlona dla wybranych graczy lub dla wszystkich graczy. Jak normalny [[outputChatBox]]. Funkcja ta nalicza znaki "\n" (entery) w tekście i rozdziela tekst na tyle wiadomości ile jest enterów.

==Składnia==
<section name="Serwer" class="server" show="true">
<syntaxhighlight lang="lua">bool outputChatBoxWithEnter ( string text [, element visibleTo=getRootElement(), int r=231, int g=217, int b=176, bool colorCoded=false ] )</syntaxhighlight>
==Wymagane Argumenty==
*'''text:''' Ciąg znaków, który ma zostać wyświetlony na chacie. Jeśli ma więcej niż 256 znaków nie pojawi się na chacie.

==Opcjonalne Argumenty==
{{PL/OptionalArg}}
*'''visibleTo:''' Argument ten określa komu ma zostać wyświetlona wiadomość. Domyślnie są to wszyscy gracze. Zobacz [[visibility]].
*'''r:''' Liczba określająca ilość "czerwieni" w kolorze tekstu. Domyślna wartość to 231.
*'''g:''' Liczba określająca ilość "zieleni" w kolorze tekstu. Domyślna wartość to 217.
*'''b:''' Liczba określająca ilość "niebieskiego" w kolorze tekstu. Domyślna wartość to 176.
*'''colorCoded:''' Wartość logiczna (boolean) określająca czy mają być brane pod uwagę znaczniki "#RRGGBB" (kolor heksadecymalny) czy też nie.
Uwaga: Format #RRGGBB musi zawierać wielkie litery, a-f nie jest akceptowane, natomiast A-F to domyślne wartości RGB w tym formacie: "#E7D9B0".
</section>
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">bool outputChatBoxWithEnter ( string text [, int r=231, int g=217, int b=176, bool colorCoded=false ] )</syntaxhighlight>

==Wymgane Argumenty==
*'''text:''' Ciąg znaków, który ma zostać wyświetlony na chacie. Jeśli ma więcej niż 256 znaków nie pojawi się na chacie.

==Opcjonalne Argumenty==
{{PL/OptionalArg}}
*'''r:''' Liczba określająca ilość "czerwieni" w kolorze tekstu. Domyślna wartość to 231.
*'''g:''' Liczba określająca ilość "zieleni" w kolorze tekstu. Domyślna wartość to 217.
*'''b:''' Liczba określająca ilość "niebieskiego" w kolorze tekstu. Domyślna wartość to 176.
*'''colorCoded:''' Wartość logiczna (boolean) określająca czy mają być brane pod uwagę znaczniki "#RRGGBB" (kolor heksadecymalny) czy też nie.
Uwaga: Format #RRGGBB musi zawierać wielkie litery, a-f nie jest akceptowane, natomiast A-F to domyślne wartości RGB w tym formacie: "#E7D9B0".

</section>

==Źródło==
<section name="Serwer" class="server" show="true">
<syntaxhighlight lang="lua">
function outputChatBoxWithEnter(text,who,r,g,b,colorCoded)
if text then
local who = who or getRootElement();
local r,g,b = r,g,b or 231,217,176;
local colorCoded = colorCoded or false;
for t in string.gmatch(text,"([^%\n]+)") do
outputChatBox(t,who,r,g,b,colorCoded);
end
end
end
</syntaxhighlight>
</section>

<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
function outputChatBoxWithEnter(text,r,g,b,colorCoded)
if text then
local r,g,b = r,g,b or 231,217,176;
local colorCoded = colorCoded or false;
for t in string.gmatch(text,"([^%\n]+)") do
outputChatBox(t,r,g,b,colorCoded);
end
end
end
</syntaxhighlight>
</section>

==Przykład==
<section name="Serwer" class="server" show="true">
'''Przykład 1:''' Przykład ten wysyła wiadomość do wszystkich graczy.
<syntaxhighlight lang="lua">
x = 5
y = 10
-- wyświetlamy wiadomość
outputChatBoxWithEnter ( "Ja mam " .. x .. " jabłek oraz\n" .. y .. " pomarańczy." )
</syntaxhighlight>

'''Przykład 2:''' Przykład ten wyświetla wiadomość na chacie "Czerwony Biały", gdzie czerwony jest oznaczony kolorem czerwonym, a biały białym.
<syntaxhighlight lang="lua">
outputChatBoxWithEnter ( "#FF0000Czerwony\n#FFFFFFBiały", getRootElement(), 255, 0, 0, true )
</syntaxhighlight>
</section>

<section name="Client" class="client" show="true">
'''Przykład 1:''' Przykład ten wyświetla nasz nick po wpisaniu komendy /mojnick.
<syntaxhighlight lang="lua">
addCommandHandler("mojnick",function()
outputChatBoxWithEnter("Twój nick to\n"..getPlayerName(localPlayer),255,133,175)
end)
</syntaxhighlight>

'''Przykład 2:''' Przykład ten wyświetla wiadomość na chacie "Czarny Biały", gdzie czarny jest oznaczony kolorem czarnym, a biały białym.
<syntaxhighlight lang="lua">
outputChatBoxWithEnter("#000000Czarny\n#FFFFFFBiały",255,255,255,true)
</syntaxhighlight>
</section>

Autor: Tararysz12

==Zobacz Też==
{{Useful_Functions}}

DxDrawJumpedElement

2017-10-09T13:06:34Z

Tararysz12: Tararysz12 moved page DxDrawJumpedElement to DxDrawJumpedRectangle: Funkcja przedstawia tylko skaczące rectangle.

#REDIRECT [[DxDrawJumpedRectangle]]

DxDrawJumpedRectangle

2017-10-09T13:06:34Z

Tararysz12: Tararysz12 moved page DxDrawJumpedElement to DxDrawJumpedRectangle: Funkcja przedstawia tylko skaczące rectangle.

{{PL/Useful Function}}
<lowercasetitle/>
__NOTOC__
Funkcja rysuje skaczący element dxDraw a konkretnie [[dxDrawRectangle]] w podanych współrzędnych, trzeba użyć [[onClientRender]] do poprawnego działania.

==Składnia==
<syntaxhighlight lang="lua">bool dxDrawJumpedRectangle(posX,posY,width,height [color = white, postGUI = false] )</syntaxhighlight>

===Wymagane argumenty===
* '''posX''': Liczba reprezentująca absolutną pozycję X na ekranie.
* '''posY''': Liczba reprezentująca absolutną pozycję Y na ekranie.
* '''widht''': Liczba reprezentująca szerokość elementu.
* '''height''': Liczba reprezentująca wysokość elementu.

===Opcjonalne argumenty===
{{PL/OptionalArg}}
* '''color''': Liczba reprezentująca kolor R,G,B,A.
* '''postGUI''': Argument odpowiadający za to, że element jest zawsze na wierzchu.

===Wynik===
Zwraca ''true'' jeśli element został stworzony prawidłowo, lub ''false'' jeśli wystąpił jakiś problem.

==Źródło==
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
function dxDrawJumpedRectangle(posX,posY,width,height,color,postGUI)
if ( type( posX ) ~= "number" ) or ( type( posY ) ~= "number" ) or ( type( width ) ~= "number" ) or ( type( height ) ~= "number" ) then
return false
end
color = color or tocolor(255,255,255,255)
postGUI = type(postGUI) == "boolean" and postGUI or false
local sinus = math.sin(getTickCount()/500)*3
dxDrawRectangle(posX,posY+sinus,width,heigt,color,postGUI)
return true
end
</syntaxhighlight>
</section>
<br />'''Autor:''Tararysz12
<br />
==Przykład==
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
addEventHandler("onClientRender",root,function()
dxDrawJumpedRectangle(200,200,300,400,tocolor(255,255,0,200),false)
end)
</syntaxhighlight>
</section>

==Zobacz również==
{{Useful_Functions}}

2017-01-10T14:52:38Z

Tararysz12:

__NOTOC__
{{PL/Shared function}}
Funkcja ta tworzy element 'pickup' w świecie GTA w którym, możemy pobrać życie, pancerz lub broń.

==Składnia==
<syntaxhighlight lang="lua">
pickup createPickup ( float x, float y, float z, int theType, int amount/weapon/model, [ int respawnTime = 30000, int ammo = 50 ] )
</syntaxhighlight>
{{PL/OOP||Pickup}}

===Wymagane Argumenty===
* '''x''': Liczba zmiennoprzecinkowa określająca współrzędną X znacznika na mapie.
* '''y''': Liczba zmiennoprzecinkowa określająca współrzędną Y znacznika na mapie.
* '''z''': Liczba zmiennoprzecinkowa określająca współrzędną Z znacznika na mapie.
* '''theType''': Liczba całkowita reprezentująca następujące typy:
** '''0''': Życie
** '''1''': Pancerz
** '''2''': Broń
** '''3''': Zwyczajny

* '''amount''': Liczba całkowita reprezentująca ilość życia, pancerza jaką ma przypisaną pickup.
'''LUB'''
* '''weapon''': Jeśli typem pickup'a jest broń to reprezentuje [[PL/Weapons|ID Broni]] W przypadku zestawu broni argument amunicji może być używany.
'''LUB'''
* '''model''': Jeśli typ pickupa jest standardowy wtedy możemy nadać mu id czyli wygląd modelu. Poniżej lista ID

** '''1212:''' Pieniądze (Zwitek gotówki)
** '''1240:''' Życie (serce)
** '''1242:''' Pancerz (kamizelka)
** '''1239:''' Informacyjny (znak zapytania ?)
** '''1272:''' Dom (niebieski)
** '''1273:''' Dom (zielony)
** '''1274:''' Pieniądze (znaczek dolara $)
** '''1241:''' Adrenalina (kapsułka)
** '''1247:''' Przekupstwo
** '''1248:''' Znaczek GTA III
** '''1252:''' Bomba z GTA III
** '''1253:''' Zdjęcie
** '''1254:''' Czaszka
** '''1274:''' Ikona pieniążka
** '''1275:''' Niebieska koszulka
** '''1277:''' Dysk zapisu
** '''1313:''' 2 czaski
** '''1276:''' Posąg tiki
** '''1310:''' Spadochron
** '''1318:''' Strzałka w dół
** '''1279:''' Wiązka narkotyków
'''LUB'''
** '''Inne ID modeli'''

===Opcjonalne Argumenty===
{{PL/OptionalArg}}
* '''respawnTime''': Ilość czasu w milisekundach po której ma się zrespawnować pickup od momentu wejścia w niego (UWAGA argument jest ignorowany na stronie klienta)
* '''ammo''': Liczba całkowita reprezentująca ilość amunicji, argument ważny jest tylko gdy typem pickup'a jest broń.

===Wynik===
Zwraca [[pickup]] [[element]] jeśli pickup został stworzony pomyślnie, w przeciwnym wypadku zwraca 'false'.

==Przykład==
<section name="Server" class="server" show="true">
Przykład tworzy pickup z ikonką jego broni gdy gracz zginie.
<syntaxhighlight lang="lua">
function createDeathPickup ( totalammo, killer, killerweapon, bodypart ) --kiedy gracz ginie
x, y, z = getElementPosition ( source ) --pobieramy pozycję osoby, która zginęła i definiujemy jako x,y,z
currentweapon = getPlayerWeapon ( source ) --pobieramy ostatnią posiadaną broń przed śmiercią
createPickup ( x, y, z, 2, currentweapon, 10000, totalammo )
end
addEventHandler ( "onPlayerWasted", getRootElement(), createDeathPickup ) --add an event handler for onPlayerWasted
</syntaxhighlight>
</section>
<section name="Server" class="server" show="false">
Przykład ten tworzy pickup'a (pieniążka) w miejscu gdzie gracz zginął i ustawia mu wartość.
<syntaxhighlight lang="lua">
function createDeathPickup ( totalammo, killer, killerweapon, bodypart ) --kiedy gracz ginie
x, y, z = getElementPosition ( source ) --pobieramy pozycję osoby, która zginęła i definiujemy jako x,y,z
local money=createPickup ( x, y, z, 3, 1212, 10000)
local playermoney = getPlayerMoney(source) --pobieramy ilość posiadanej gotówki osoby, która zginęła
setElementData(money,"Amount",playermoney) --nadajemy wartość dla pickup'a
takePlayerMoney(source,playermoney) --zabieramy wszystkie pieniądze gracza który zginął
end
addEventHandler ( "onPlayerWasted", getRootElement(), createDeathPickup ) --add an event handler for onPlayerWasted
</syntaxhighlight>
</section>

==Zobacz Też==

{{Pickup functions}}

2016-09-07T15:11:32Z

Tararysz12: /* See Also */

==Zobacz również==
==={{{1}}}===
{{{{{1}}}}}
===Event functions===
{{Event functions}}

PL/onMarkerHit

2016-09-07T15:11:10Z

Tararysz12:

PL/onMarkerHit

2016-09-07T15:10:56Z

Tararysz12:

2016-09-01T11:17:30Z

Tararysz12:

{{Resource page}}
__NOTOC__
EDF oznacza 'Edytor Definiowania Pliku' EDF są pliki XML z rozszerzeniem .edf opisujące elementy niestandardowe używane przez zasoby, typy elementów które nie mają znaczenia dla samego MTA. Przykładami są: & lt; & gt;, spawnpoint & lt; & gt;, flag & lt; checkpoint & gt; itd. One także są wykorzystywane do definiowania ustawień, które są używane przez gamemody, które są umieszczane pod & lt; Settings & gt; tag w obrębie zasobu 'meta.xml'

==Wprowadzenie==
Niektóre zasoby używają niestandardowych elementów mapy. Przechwytywane flagi, gamemody na przykład będzie trzeba prawdopodobnie użyć & lt; & gt flags; Elementy które zawierają pozycje flag i zespołów. Gdy mapa jest załadowana gamemode szuka & lt; & gt flags; elementy i instaluje flagi odpowiednio - na przykład poprzez utworzenie obiektu z flagą i kształt kolizji.

The problem with these custom elements is that, unlike built-in MTA elements, the map editor has no idea of their meaning. How should a <flag> element be visually represented? What properties does it have? Without telling the editor this information, you could not use it to create these custom elements and would instead have to resort to manually editing the .map file with a text editor. Fortunately this isn't necessary: any resource can contain an editor definition file that describes the custom map elements used by that resource.

==Using definition files in the editor==
As described in the [[Resource:Editor|main editor manual]], to be able to create the custom elements of a resource in your map you need to add it in the ''Definitions'' window. Click the ''Definitions'' button in the main menu and double click the resource in the left list. Then close the window and roll the mousewheel in the element panel until the resource comes up. At that point you can create and manipulate custom elements of that resource like any other element.

==Writing EDF files==
EDF files are simply XML files with an .edf extension. We'll start with an example: the EDF of the Capture the Orb gamemode.

<syntaxhighlight lang="xml">
<def name="Capture the Orb">
<element name="orb" friendlyname="Orb spawnpoint" instructions="Place your orb in a position that can be collected.">
<data name="position" type="coord3d" default="0,0,0" />
<marker size="0.5" type="corona" color="#ffff00ff" />
</element>
<element name="objective" friendlyname="Objective point" instructions="Place your objective point in a position that can be reached.">
<data name="position" type="coord3d" default="0,0,0" />
<marker size="3" type="cylinder" color="#9370dbaa" />
</element>
<element name="spawnpoint" friendlyname="Spawnpoint">
<object editorOnly="true" model="3092" posZ="1" />
<data name="position" type="coord3d" default="0,0,0" />
<data name="rotation" type="coord3d" default="0,0,0" />
<data name="skin" type="skinID" default="0" />
</element>
</def>
</syntaxhighlight>

As you can see, the syntax is fairly straightforward. The root element, <def>, contains a number of <element>s. Each of these <element>s describes a custom element and specifies its name, visual representation and available properties.

===Visual representation===

Any child node of an <element> that is not a <data> node is part of the visual representation. There can be one or more objects, markers, pickups etc. For each representation element you can optionally specify a position (posX, posY, posZ) and rotation (rotX, rotY, rotZ): these are ''relative'' to the position and rotation of the represented custom element. Using the above Capture the Orb example, if you were to create a spawnpoint at (30, 14, 3), the editor would display an object of model 3092 at (30, 14, 4) to represent it, because the object's posZ of 1 is added to the spawnpoint's z position of 3.

===Properties===

Properties of a custom element are described by <data> nodes. Some property names have a special meaning, like ''position'' and ''rotation'': these can be changed by moving and rotating the element in the editor. The other properties can be changed in the Properties window.

===Property-dependent visual representation===

It is possible to make the representation of a custom element depend on one or more of the element's properties. Take as example a <checkpoint> element of a race gamemode that contains a <marker> for representation: the checkpoint has several attributes like color and size that should be reflected in the marker. To accomplish this, specify something of the form ''!propertyname!'' in one or more of the representing element's attributes. For example:

<syntaxhighlight lang="xml">
<def name="Race">
<element name="checkpoint" friendlyname="Race checkpoint">
<data name="position" type="coord3d" required="true" default="0,0,0" />

<data name="type" type="selection:checkpoint,ring" required="true" default="checkpoint" />
<data name="size" type="number" required="true" default="2.25"/>
<data name="color" type="color" required="false" default="#ff0000ff" />
...

<marker type="!type!" size="!size!" color="!color!" />
</element>
</def>
</syntaxhighlight>

Now whenever the "type", "size" or "color" property of a checkpoint is changed, the new value will be copied to its marker, and the marker's visual appearance changes accordingly.

===Integrating in a resource===

Once you've written your EDF, save it as an .edf file in your resource's folder and add an "edf:definition" attribute to your meta.xml's <info> tag, like so:

<syntaxhighlight lang="xml">
<meta>
<info author="erorr404" type="gamemode" ... edf:definition="cto.edf" />
...
</meta>
</syntaxhighlight>

==EDF reference==

===Built-in elements===
These are the elements you can use for representing your custom elements, along with their properties.

{| cellspacing="1"
! style="background-color: #EEE" colspan="2" | <blip>
|-
! style="background-color: #EEE"|Property
! style="background-color: #EEE"|Type
|-
| style="background-color: #EEE"|position
| style="background-color: #EEE"|coord3d
|-
| style="background-color: #EEE"|icon
| style="background-color: #EEE"|blipID
|-
| style="background-color: #EEE"|size
| style="background-color: #EEE"|integer
|-
| style="background-color: #EEE"|color
| style="background-color: #EEE"|color
|-
| style="background-color: #EEE"|dimension
| style="background-color: #EEE"|integer
|}

{| cellspacing="1"
! style="background-color: #EEE" colspan="2" | <marker>
|-
! style="background-color: #EEE"|Property
! style="background-color: #EEE"|Type
|-
| style="background-color: #EEE"|position
| style="background-color: #EEE"|coord3d
|-
| style="background-color: #EEE"|type
| style="background-color: #EEE"|markerType
|-
| style="background-color: #EEE"|size
| style="background-color: #EEE"|number
|-
| style="background-color: #EEE"|color
| style="background-color: #EEE"|color
|-
| style="background-color: #EEE"|interior
| style="background-color: #EEE"|integer
|-
| style="background-color: #EEE"|dimension
| style="background-color: #EEE"|integer
|}

{| cellspacing="1"
! style="background-color: #EEE" colspan="2" | <object>
|-
! style="background-color: #EEE"|Property
! style="background-color: #EEE"|Type
|-
| style="background-color: #EEE"|model
| style="background-color: #EEE"|objectID
|-
| style="background-color: #EEE"|position
| style="background-color: #EEE"|coord3d
|-
| style="background-color: #EEE"|rotation
| style="background-color: #EEE"|coord3d
|-
| style="background-color: #EEE"|interior
| style="background-color: #EEE"|integer
|-
| style="background-color: #EEE"|dimension
| style="background-color: #EEE"|integer
|}

{| cellspacing="1"
! style="background-color: #EEE" colspan="2" | <ped>
|-
! style="background-color: #EEE"|Property
! style="background-color: #EEE"|Type
|-
| style="background-color: #EEE"|position
| style="background-color: #EEE"|coord3d
|-
| style="background-color: #EEE"|model
| style="background-color: #EEE"|skinID
|-
| style="background-color: #EEE"|rotZ
| style="background-color: #EEE"|number
|-
| style="background-color: #EEE"|interior
| style="background-color: #EEE"|integer
|-
| style="background-color: #EEE"|dimension
| style="background-color: #EEE"|integer
|}

{| cellspacing="1"
! style="background-color: #EEE" colspan="2" | <pickup>
|-
! style="background-color: #EEE"|Property
! style="background-color: #EEE"|Type
|-
| style="background-color: #EEE"|position
| style="background-color: #EEE"|coord3d
|-
| style="background-color: #EEE"|type
| style="background-color: #EEE"|pickupType
|-
| style="background-color: #EEE"|amount
| style="background-color: #EEE"|number
|-
| style="background-color: #EEE"|respawn
| style="background-color: #EEE"|integer
|-
| style="background-color: #EEE"|interior
| style="background-color: #EEE"|integer
|-
| style="background-color: #EEE"|dimension
| style="background-color: #EEE"|integer
|}

{| cellspacing="1"
! style="background-color: #EEE" colspan="2" | <vehicle>
|-
! style="background-color: #EEE"|Property
! style="background-color: #EEE"|Type
|-
| style="background-color: #EEE"|model
| style="background-color: #EEE"|vehicleID
|-
| style="background-color: #EEE"|position
| style="background-color: #EEE"|coord3d
|-
| style="background-color: #EEE"|rotation
| style="background-color: #EEE"|coord3d
|-
| style="background-color: #EEE"|color
| style="background-color: #EEE"|vehiclecolors
|-
| style="background-color: #EEE"|upgrades
| style="background-color: #EEE"|vehicleupgrades
|-
| style="background-color: #EEE"|plate
| style="background-color: #EEE"|plate
|-
| style="background-color: #EEE"|interior
| style="background-color: #EEE"|integer
|-
| style="background-color: #EEE"|dimension
| style="background-color: #EEE"|integer
|}

{| cellspacing="1"
! style="background-color: #EEE" colspan="2" | <radararea>
|-
! style="background-color: #EEE"|Property
! style="background-color: #EEE"|Type
|-
| style="background-color: #EEE"|posX
| style="background-color: #EEE"|number
|-
| style="background-color: #EEE"|posY
| style="background-color: #EEE"|number
|-
| style="background-color: #EEE"|sizeX
| style="background-color: #EEE"|number
|-
| style="background-color: #EEE"|sizeY
| style="background-color: #EEE"|number
|-
| style="background-color: #EEE"|color
| style="background-color: #EEE"|color
|-
| style="background-color: #EEE"|dimension
| style="background-color: #EEE"|integer
|}

===Built-in property names===
Properties with these names have a special meaning to the editor and can be modified by other means than the Properties window.
{| cellspacing="1"
! style="background-color: #EEE"|Name
! style="background-color: #EEE"|Type
|-
! style="background-color: #EEE"|position
| style="background-color: #EEE"|coord3d
|-
! style="background-color: #EEE"|rotation
| style="background-color: #EEE"|coord3d
|}

===Property types===
These are the types you can choose from for the properties (<data>) of your custom elements.

====Primitives====
{| cellspacing="1"
! style="background-color: #EEE"|Name
! style="background-color: #EEE"|Description
! style="background-color: #EEE"|Value
|-
! style="background-color: #EEE"|boolean
| style="background-color: #EEE"|Simple boolean value.
| style="background-color: #EEE"|"true" or "false"
|-
! style="background-color: #EEE"|natural
| style="background-color: #EEE"|Natural number (whole and non-negative).
| style="background-color: #EEE"| 
|-
! style="background-color: #EEE"|integer
| style="background-color: #EEE"|Whole number.
| style="background-color: #EEE"| 
|-
! style="background-color: #EEE"|number
| style="background-color: #EEE"|Rational number.
| style="background-color: #EEE"| 
|-
! style="background-color: #EEE"|string
| style="background-color: #EEE"|Simple string of text.
| style="background-color: #EEE"| 
|-
! style="background-color: #EEE"|color
| style="background-color: #EEE"|color, with or without alpha.
| style="background-color: #EEE"|#RRGGBB or #RRGGBBAA
|}

====Coordinates====
{| cellspacing="1"
! style="background-color: #EEE"|Name
! style="background-color: #EEE"|Description
! style="background-color: #EEE"|Value
|-
! style="background-color: #EEE"|camera
| style="background-color: #EEE"|Position and lookat coordinates for the camera.
| style="background-color: #EEE"|posX,posY,posZ,lookatX,lookatY,lookatZ
|-
! style="background-color: #EEE"|coord3d
| style="background-color: #EEE"|3-component vector, typically used for positions and rotations.
| style="background-color: #EEE"|x,y,z
|}

====Vehicles====
{| cellspacing="1"
! style="background-color: #EEE"|Name
! style="background-color: #EEE"|Description
! style="background-color: #EEE"|Value
|-
! style="background-color: #EEE"|plate
| style="background-color: #EEE"|Number plate text for a vehicle.
| style="background-color: #EEE"| 
|-
! style="background-color: #EEE"|vehiclecolors
| style="background-color: #EEE"|colors of a vehicle
| style="background-color: #EEE"|colorID1,colorID2,colorID3,colorID4
|-
! style="background-color: #EEE"|vehicleupgrades
| style="background-color: #EEE"|Upgrades of a vehicle
| style="background-color: #EEE"|upgradeID1,upgradeID2,...
|}

====Model ID's====
{| cellspacing="1"
! style="background-color: #EEE"|Name
! style="background-color: #EEE"|Description
! style="background-color: #EEE"|Value
|-
! style="background-color: #EEE"|blipID
| style="background-color: #EEE"|Picture ID for blips
| style="background-color: #EEE"| 
|-
! style="background-color: #EEE"|objectID
| style="background-color: #EEE"|Model ID for objects
| style="background-color: #EEE"| 
|-
! style="background-color: #EEE"|pickupType
| style="background-color: #EEE"|Armor, health or weapon
| style="background-color: #EEE"|"armor", "health" or numeric weapon ID
|-
! style="background-color: #EEE"|skinID
| style="background-color: #EEE"|Skin ID for peds
| style="background-color: #EEE"| 
|-
! style="background-color: #EEE"|vehicleID
| style="background-color: #EEE"|Model ID for vehicles
| style="background-color: #EEE"| 
|-
! style="background-color: #EEE"|weaponID
| style="background-color: #EEE"|Weapon, e.g. M4
| style="background-color: #EEE"|Numeric weapon ID, e.g. 31
|}

====Colshapes and markers====
{| cellspacing="1"
! style="background-color: #EEE"|Name
! style="background-color: #EEE"|Description
! style="background-color: #EEE"|Value
|-
! style="background-color: #EEE"|colshapeType
| style="background-color: #EEE"|collision circle, cube, rectangle, sphere or tube
| style="background-color: #EEE"|One of: "colcircle", "colcube", "colrectangle", "colsphere", "coltube"
|-
! style="background-color: #EEE"|markerType
| style="background-color: #EEE"|Arrow, checkpoint, corona, cylinder or ring marker.
| style="background-color: #EEE"|One of: "arrow", "checkpoint", "corona", "cylinder", "ring"
|-
|}

====Specials====
{| cellspacing="1"
! style="background-color: #EEE"|Name
! style="background-color: #EEE"|Description
! style="background-color: #EEE"|Value
|-
! style="background-color: #EEE"|element:type
| style="background-color: #EEE"|Element of a certain type, for example: element:flag
| style="background-color: #EEE"|The element's ID
|-
! style="background-color: #EEE"|selection:val1,val2,...
| style="background-color: #EEE"|Shows a dropdown box from which to pick one value.
| style="background-color: #EEE"|The selected value
|}
[[ru:Resource:Editor/EDF]]

PL/Resource:Editor/EDF

2016-09-01T11:17:17Z

Tararysz12:

{{PL/Resource}}
__NOTOC__
EDF oznacza 'Edytor Definiowania Pliku' EDF są pliki XML z rozszerzeniem .edf opisujące elementy niestandardowe używane przez zasoby, typy elementów które nie mają znaczenia dla samego MTA. Przykładami są: & lt; & gt;, spawnpoint & lt; & gt;, flag & lt; checkpoint & gt; itd. One także są wykorzystywane do definiowania ustawień, które są używane przez gamemody, które są umieszczane pod & lt; Settings & gt; tag w obrębie zasobu 'meta.xml'

==Wprowadzenie==
Niektóre zasoby używają niestandardowych elementów mapy. Przechwytywane flagi, gamemody na przykład będzie trzeba prawdopodobnie użyć & lt; & gt flags; Elementy które zawierają pozycje flag i zespołów. Gdy mapa jest załadowana gamemode szuka & lt; & gt flags; elementy i instaluje flagi odpowiednio - na przykład poprzez utworzenie obiektu z flagą i kształt kolizji.

The problem with these custom elements is that, unlike built-in MTA elements, the map editor has no idea of their meaning. How should a <flag> element be visually represented? What properties does it have? Without telling the editor this information, you could not use it to create these custom elements and would instead have to resort to manually editing the .map file with a text editor. Fortunately this isn't necessary: any resource can contain an editor definition file that describes the custom map elements used by that resource.

==Using definition files in the editor==
As described in the [[Resource:Editor|main editor manual]], to be able to create the custom elements of a resource in your map you need to add it in the ''Definitions'' window. Click the ''Definitions'' button in the main menu and double click the resource in the left list. Then close the window and roll the mousewheel in the element panel until the resource comes up. At that point you can create and manipulate custom elements of that resource like any other element.

==Writing EDF files==
EDF files are simply XML files with an .edf extension. We'll start with an example: the EDF of the Capture the Orb gamemode.

<syntaxhighlight lang="xml">
<def name="Capture the Orb">
<element name="orb" friendlyname="Orb spawnpoint" instructions="Place your orb in a position that can be collected.">
<data name="position" type="coord3d" default="0,0,0" />
<marker size="0.5" type="corona" color="#ffff00ff" />
</element>
<element name="objective" friendlyname="Objective point" instructions="Place your objective point in a position that can be reached.">
<data name="position" type="coord3d" default="0,0,0" />
<marker size="3" type="cylinder" color="#9370dbaa" />
</element>
<element name="spawnpoint" friendlyname="Spawnpoint">
<object editorOnly="true" model="3092" posZ="1" />
<data name="position" type="coord3d" default="0,0,0" />
<data name="rotation" type="coord3d" default="0,0,0" />
<data name="skin" type="skinID" default="0" />
</element>
</def>
</syntaxhighlight>

As you can see, the syntax is fairly straightforward. The root element, <def>, contains a number of <element>s. Each of these <element>s describes a custom element and specifies its name, visual representation and available properties.

===Visual representation===

Any child node of an <element> that is not a <data> node is part of the visual representation. There can be one or more objects, markers, pickups etc. For each representation element you can optionally specify a position (posX, posY, posZ) and rotation (rotX, rotY, rotZ): these are ''relative'' to the position and rotation of the represented custom element. Using the above Capture the Orb example, if you were to create a spawnpoint at (30, 14, 3), the editor would display an object of model 3092 at (30, 14, 4) to represent it, because the object's posZ of 1 is added to the spawnpoint's z position of 3.

===Properties===

Properties of a custom element are described by <data> nodes. Some property names have a special meaning, like ''position'' and ''rotation'': these can be changed by moving and rotating the element in the editor. The other properties can be changed in the Properties window.

===Property-dependent visual representation===

It is possible to make the representation of a custom element depend on one or more of the element's properties. Take as example a <checkpoint> element of a race gamemode that contains a <marker> for representation: the checkpoint has several attributes like color and size that should be reflected in the marker. To accomplish this, specify something of the form ''!propertyname!'' in one or more of the representing element's attributes. For example:

<syntaxhighlight lang="xml">
<def name="Race">
<element name="checkpoint" friendlyname="Race checkpoint">
<data name="position" type="coord3d" required="true" default="0,0,0" />

<data name="type" type="selection:checkpoint,ring" required="true" default="checkpoint" />
<data name="size" type="number" required="true" default="2.25"/>
<data name="color" type="color" required="false" default="#ff0000ff" />
...

<marker type="!type!" size="!size!" color="!color!" />
</element>
</def>
</syntaxhighlight>

Now whenever the "type", "size" or "color" property of a checkpoint is changed, the new value will be copied to its marker, and the marker's visual appearance changes accordingly.

===Integrating in a resource===

Once you've written your EDF, save it as an .edf file in your resource's folder and add an "edf:definition" attribute to your meta.xml's <info> tag, like so:

<syntaxhighlight lang="xml">
<meta>
<info author="erorr404" type="gamemode" ... edf:definition="cto.edf" />
...
</meta>
</syntaxhighlight>

==EDF reference==

===Built-in elements===
These are the elements you can use for representing your custom elements, along with their properties.

{| cellspacing="1"
! style="background-color: #EEE" colspan="2" | <blip>
|-
! style="background-color: #EEE"|Property
! style="background-color: #EEE"|Type
|-
| style="background-color: #EEE"|position
| style="background-color: #EEE"|coord3d
|-
| style="background-color: #EEE"|icon
| style="background-color: #EEE"|blipID
|-
| style="background-color: #EEE"|size
| style="background-color: #EEE"|integer
|-
| style="background-color: #EEE"|color
| style="background-color: #EEE"|color
|-
| style="background-color: #EEE"|dimension
| style="background-color: #EEE"|integer
|}

{| cellspacing="1"
! style="background-color: #EEE" colspan="2" | <marker>
|-
! style="background-color: #EEE"|Property
! style="background-color: #EEE"|Type
|-
| style="background-color: #EEE"|position
| style="background-color: #EEE"|coord3d
|-
| style="background-color: #EEE"|type
| style="background-color: #EEE"|markerType
|-
| style="background-color: #EEE"|size
| style="background-color: #EEE"|number
|-
| style="background-color: #EEE"|color
| style="background-color: #EEE"|color
|-
| style="background-color: #EEE"|interior
| style="background-color: #EEE"|integer
|-
| style="background-color: #EEE"|dimension
| style="background-color: #EEE"|integer
|}

{| cellspacing="1"
! style="background-color: #EEE" colspan="2" | <object>
|-
! style="background-color: #EEE"|Property
! style="background-color: #EEE"|Type
|-
| style="background-color: #EEE"|model
| style="background-color: #EEE"|objectID
|-
| style="background-color: #EEE"|position
| style="background-color: #EEE"|coord3d
|-
| style="background-color: #EEE"|rotation
| style="background-color: #EEE"|coord3d
|-
| style="background-color: #EEE"|interior
| style="background-color: #EEE"|integer
|-
| style="background-color: #EEE"|dimension
| style="background-color: #EEE"|integer
|}

{| cellspacing="1"
! style="background-color: #EEE" colspan="2" | <ped>
|-
! style="background-color: #EEE"|Property
! style="background-color: #EEE"|Type
|-
| style="background-color: #EEE"|position
| style="background-color: #EEE"|coord3d
|-
| style="background-color: #EEE"|model
| style="background-color: #EEE"|skinID
|-
| style="background-color: #EEE"|rotZ
| style="background-color: #EEE"|number
|-
| style="background-color: #EEE"|interior
| style="background-color: #EEE"|integer
|-
| style="background-color: #EEE"|dimension
| style="background-color: #EEE"|integer
|}

{| cellspacing="1"
! style="background-color: #EEE" colspan="2" | <pickup>
|-
! style="background-color: #EEE"|Property
! style="background-color: #EEE"|Type
|-
| style="background-color: #EEE"|position
| style="background-color: #EEE"|coord3d
|-
| style="background-color: #EEE"|type
| style="background-color: #EEE"|pickupType
|-
| style="background-color: #EEE"|amount
| style="background-color: #EEE"|number
|-
| style="background-color: #EEE"|respawn
| style="background-color: #EEE"|integer
|-
| style="background-color: #EEE"|interior
| style="background-color: #EEE"|integer
|-
| style="background-color: #EEE"|dimension
| style="background-color: #EEE"|integer
|}

{| cellspacing="1"
! style="background-color: #EEE" colspan="2" | <vehicle>
|-
! style="background-color: #EEE"|Property
! style="background-color: #EEE"|Type
|-
| style="background-color: #EEE"|model
| style="background-color: #EEE"|vehicleID
|-
| style="background-color: #EEE"|position
| style="background-color: #EEE"|coord3d
|-
| style="background-color: #EEE"|rotation
| style="background-color: #EEE"|coord3d
|-
| style="background-color: #EEE"|color
| style="background-color: #EEE"|vehiclecolors
|-
| style="background-color: #EEE"|upgrades
| style="background-color: #EEE"|vehicleupgrades
|-
| style="background-color: #EEE"|plate
| style="background-color: #EEE"|plate
|-
| style="background-color: #EEE"|interior
| style="background-color: #EEE"|integer
|-
| style="background-color: #EEE"|dimension
| style="background-color: #EEE"|integer
|}

{| cellspacing="1"
! style="background-color: #EEE" colspan="2" | <radararea>
|-
! style="background-color: #EEE"|Property
! style="background-color: #EEE"|Type
|-
| style="background-color: #EEE"|posX
| style="background-color: #EEE"|number
|-
| style="background-color: #EEE"|posY
| style="background-color: #EEE"|number
|-
| style="background-color: #EEE"|sizeX
| style="background-color: #EEE"|number
|-
| style="background-color: #EEE"|sizeY
| style="background-color: #EEE"|number
|-
| style="background-color: #EEE"|color
| style="background-color: #EEE"|color
|-
| style="background-color: #EEE"|dimension
| style="background-color: #EEE"|integer
|}

===Built-in property names===
Properties with these names have a special meaning to the editor and can be modified by other means than the Properties window.
{| cellspacing="1"
! style="background-color: #EEE"|Name
! style="background-color: #EEE"|Type
|-
! style="background-color: #EEE"|position
| style="background-color: #EEE"|coord3d
|-
! style="background-color: #EEE"|rotation
| style="background-color: #EEE"|coord3d
|}

===Property types===
These are the types you can choose from for the properties (<data>) of your custom elements.

====Primitives====
{| cellspacing="1"
! style="background-color: #EEE"|Name
! style="background-color: #EEE"|Description
! style="background-color: #EEE"|Value
|-
! style="background-color: #EEE"|boolean
| style="background-color: #EEE"|Simple boolean value.
| style="background-color: #EEE"|"true" or "false"
|-
! style="background-color: #EEE"|natural
| style="background-color: #EEE"|Natural number (whole and non-negative).
| style="background-color: #EEE"| 
|-
! style="background-color: #EEE"|integer
| style="background-color: #EEE"|Whole number.
| style="background-color: #EEE"| 
|-
! style="background-color: #EEE"|number
| style="background-color: #EEE"|Rational number.
| style="background-color: #EEE"| 
|-
! style="background-color: #EEE"|string
| style="background-color: #EEE"|Simple string of text.
| style="background-color: #EEE"| 
|-
! style="background-color: #EEE"|color
| style="background-color: #EEE"|color, with or without alpha.
| style="background-color: #EEE"|#RRGGBB or #RRGGBBAA
|}

====Coordinates====
{| cellspacing="1"
! style="background-color: #EEE"|Name
! style="background-color: #EEE"|Description
! style="background-color: #EEE"|Value
|-
! style="background-color: #EEE"|camera
| style="background-color: #EEE"|Position and lookat coordinates for the camera.
| style="background-color: #EEE"|posX,posY,posZ,lookatX,lookatY,lookatZ
|-
! style="background-color: #EEE"|coord3d
| style="background-color: #EEE"|3-component vector, typically used for positions and rotations.
| style="background-color: #EEE"|x,y,z
|}

====Vehicles====
{| cellspacing="1"
! style="background-color: #EEE"|Name
! style="background-color: #EEE"|Description
! style="background-color: #EEE"|Value
|-
! style="background-color: #EEE"|plate
| style="background-color: #EEE"|Number plate text for a vehicle.
| style="background-color: #EEE"| 
|-
! style="background-color: #EEE"|vehiclecolors
| style="background-color: #EEE"|colors of a vehicle
| style="background-color: #EEE"|colorID1,colorID2,colorID3,colorID4
|-
! style="background-color: #EEE"|vehicleupgrades
| style="background-color: #EEE"|Upgrades of a vehicle
| style="background-color: #EEE"|upgradeID1,upgradeID2,...
|}

====Model ID's====
{| cellspacing="1"
! style="background-color: #EEE"|Name
! style="background-color: #EEE"|Description
! style="background-color: #EEE"|Value
|-
! style="background-color: #EEE"|blipID
| style="background-color: #EEE"|Picture ID for blips
| style="background-color: #EEE"| 
|-
! style="background-color: #EEE"|objectID
| style="background-color: #EEE"|Model ID for objects
| style="background-color: #EEE"| 
|-
! style="background-color: #EEE"|pickupType
| style="background-color: #EEE"|Armor, health or weapon
| style="background-color: #EEE"|"armor", "health" or numeric weapon ID
|-
! style="background-color: #EEE"|skinID
| style="background-color: #EEE"|Skin ID for peds
| style="background-color: #EEE"| 
|-
! style="background-color: #EEE"|vehicleID
| style="background-color: #EEE"|Model ID for vehicles
| style="background-color: #EEE"| 
|-
! style="background-color: #EEE"|weaponID
| style="background-color: #EEE"|Weapon, e.g. M4
| style="background-color: #EEE"|Numeric weapon ID, e.g. 31
|}

====Colshapes and markers====
{| cellspacing="1"
! style="background-color: #EEE"|Name
! style="background-color: #EEE"|Description
! style="background-color: #EEE"|Value
|-
! style="background-color: #EEE"|colshapeType
| style="background-color: #EEE"|collision circle, cube, rectangle, sphere or tube
| style="background-color: #EEE"|One of: "colcircle", "colcube", "colrectangle", "colsphere", "coltube"
|-
! style="background-color: #EEE"|markerType
| style="background-color: #EEE"|Arrow, checkpoint, corona, cylinder or ring marker.
| style="background-color: #EEE"|One of: "arrow", "checkpoint", "corona", "cylinder", "ring"
|-
|}

====Specials====
{| cellspacing="1"
! style="background-color: #EEE"|Name
! style="background-color: #EEE"|Description
! style="background-color: #EEE"|Value
|-
! style="background-color: #EEE"|element:type
| style="background-color: #EEE"|Element of a certain type, for example: element:flag
| style="background-color: #EEE"|The element's ID
|-
! style="background-color: #EEE"|selection:val1,val2,...
| style="background-color: #EEE"|Shows a dropdown box from which to pick one value.
| style="background-color: #EEE"|The selected value
|}
[[ru:Resource:Editor/EDF]]