CreateMarker: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
mNo edit summary
(Spolszczenie/Translate)
Line 1: Line 1:
__NOTOC__
__NOTOC__
{{Server client function}}
{{PL/Server client function}}
This function creates a marker. A marker is a 3D model in the world that can highlight a particular point or area, often used to instruct players where to go to perform actions such as entering buildings.
Funkcja ta tworzy znacznik. Znacznik to obiekt 3D w świecie. Za pomocą tego można wyznaczyć dany punkt lub obszar. Funkcji tej często się używa do przemieszczania graczy lub aby dać możliwość wejścia do jakiegoś budynku (Interioru).


There are various limits that govern the maximum number of each type that can be visible at once. These are:
Istnieją różne typy markerów między innymi:
* Coronas: 32
* Coronas: 32
* Checkpoints, Rings, Cylinders and Arrows combined: 32
* Przystanek/Punkt, Pierścień, Cylinder i Strzałki: 32


You are able to create as many markers as you wish (memory and element limit permitting), but the player will only be able to see the nearest ones up to the limit.
Możesz stworzyć tak dużo znaczników ile tylko chcesz. Ale gracz będzie mógł zobaczyć je tylko z odpowiedniej odległości.


==Syntax==
==Składnia==
<section name="Server" class="server" show="true">
<section name="Serwer" class="server" show="true">
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
marker createMarker ( float x, float y, float z [, string theType = "checkpoint", float size = 4.0, int r = 0, int g = 0, int b = 255, int a = 255, visibleTo = getRootElement( ) ] )
marker createMarker ( float x, float y, float z [, string theType = "checkpoint", float size = 4.0, int r = 0, int g = 0, int b = 255, int a = 255, visibleTo = getRootElement( ) ] )
</syntaxhighlight>
</syntaxhighlight>
{{OOP||Marker}}
{{PL/OOP||Marker}}
===Required Arguments===
===Wymagane Argumenty===
* '''x''': A floating point number representing the X coordinate on the map.
* '''x''': Liczba zmiennoprzecinkowa określająca współrzędną X znacznika na mapie.
* '''y''': A floating point number representing the Y coordinate on the map.
* '''y''': Liczba zmiennoprzecinkowa określająca współrzędną Y znacznika na mapie.
* '''z''': A floating point number representing the Z coordinate on the map.
* '''z''': Liczba zmiennoprzecinkowa określająca współrzędną Z znacznika na mapie.


===Optional arguments===
===Opcjonalne Argumenty===
{{OptionalArg}}
{{PL/OptionalArg}}
* '''theType''': The visual type of the marker to be created. Possible values:
* '''theType''': Typ znacznika jaki ma zostać utworzony. Możliwe do wyboru:
{{Marker_types}}
{{Marker_types}}
* '''size''': The diameter of the marker to be created, in meters.
* '''size''': Rozmiar znacznika który ma zostać utworzony w metrach.
* '''r''': An integer number representing the amount of red to use in the colouring of the marker (0 - 255).
* '''r''': Liczba całkowita określająca liczbę czerwieni do zabarwienia znacznika (0 - 255).
* '''g''': An integer number representing the amount of green to use in the colouring of the marker (0 - 255).
* '''g''': Liczba całkowita określająca liczbę zieleni do zabarwienia znacznika (0 - 255).
* '''b''': An integer number representing the amount of blue to use in the colouring of the marker (0 - 255).
* '''b''': Liczba całkowita określająca liczbę niebieskości do zabarwienia znacznika (0 - 255).
* '''a''': An integer number representing the amount of alpha to use in the colouring of the marker (0 - 255 where 0 is transparent and 255 is opaque).
* '''a''': Liczba całkowita określająca liczbę alfa do zabarwienia znacznika (0 - 255, gdzie 0 oznacza przezroczysty a 255 nieprzezroczysty).
* '''visibleTo''': This defines which elements can see the marker. Defaults to visible to everyone. See [[visibility]].
* '''visibleTo''': Ten argument określa dla kogo ma być widoczny dany znacznik. Domyślnie jest widoczny dla wszystkich. Zobacz [[visibility]].
</section>
</section>
<section name="Client" class="client" show="true">
<section name="Klient" class="client" show="true">
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
marker createMarker ( float x, float y, float z [, string theType = "checkpoint", float size = 4.0, int r = 0, int g = 0, int b = 255, int a = 255 ] )
marker createMarker ( float x, float y, float z [, string theType = "checkpoint", float size = 4.0, int r = 0, int g = 0, int b = 255, int a = 255 ] )
</syntaxhighlight>
</syntaxhighlight>
{{OOP||Marker}}
{{PL/OOP||Marker}}
===Required Arguments===
===Wymagane Argumenty===
* '''x''': A floating point number representing the X coordinate on the map.
* '''x''': Liczba zmiennoprzecinkowa określająca współrzędną X znacznika na mapie.
* '''y''': A floating point number representing the Y coordinate on the map.
* '''y''': Liczba zmiennoprzecinkowa określająca współrzędną Y znacznika na mapie.
* '''z''': A floating point number representing the Z coordinate on the map.
* '''z''': Liczba zmiennoprzecinkowa określająca współrzędną Z znacznika na mapie.


===Optional arguments===
===Opcjonalne Argumenty===
{{OptionalArg}}
{{PL/OptionalArg}}
* '''theType''': The visual type of the marker to be created. Possible values:
* '''theType''': Typ znacznika jaki ma zostać utworzony. Możliwe do wyboru:
{{Marker_types}}
{{Marker_types}}
* '''size''': The diameter of the marker to be created, in meters.
* '''size''': Rozmiar znacznika który ma zostać utworzony w metrach.
* '''r''': An integer number representing the amount of red to use in the colouring of the marker (0 - 255).
* '''r''': Liczba całkowita określająca liczbę czerwieni do zabarwienia znacznika (0 - 255).
* '''g''': An integer number representing the amount of green to use in the colouring of the marker (0 - 255).
* '''g''': Liczba całkowita określająca liczbę zieleni do zabarwienia znacznika (0 - 255).
* '''b''': An integer number representing the amount of blue to use in the colouring of the marker (0 - 255).
* '''b''': Liczba całkowita określająca liczbę niebieskości do zabarwienia znacznika (0 - 255).
* '''a''': An integer number representing the amount of alpha to use in the colouring of the marker (0 - 255 where 0 is transparent and 255 is opaque).
* '''a''': Liczba całkowita określająca liczbę alfa do zabarwienia znacznika (0 - 255, gdzie 0 oznacza przezroczysty a 255 nieprzezroczysty).
</section>
</section>


===Returns===
===Wynik===
Returns the [[marker]] element that was created, or ''false'' if the arguments are incorrect.
Zwraca [[marker]] elementu, który został utworzony lub zwraca 'false' Jeśli argumenty są błędne.


==Example==
==Przykłady==
<section name="Example 1" class="server" show="true">
<section name="Serwer" class="server" show="true">
This example creates a marker next to the player when they type 'createmarker':
Przykład tworzy znacznik obok miejsca w którym znajduje się obecnie gracz:
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
-- this function is called whenever someone types 'createmarker' in the console:
-- ta funkcja jest wywoływana gdy wpiszemy createmarker w konsoli:
function consoleCreateMarker ( thePlayer, commandName )
function consoleCreateMarker ( thePlayer, commandName )
   if ( thePlayer ) then
   if ( thePlayer ) then
       local x, y, z = getElementPosition ( thePlayer ) -- get the player's position
       local x, y, z = getElementPosition ( thePlayer ) -- pobiera pozycję gracza
       -- create a cylindrical marker next to the player:
       -- create a cylindrical marker next to the player:
       local theMarker = createMarker ( x + 2, y + 2, z, "cylinder", 1.5, 255, 255, 0, 170 )
       local theMarker = createMarker ( x + 2, y + 2, z, "cylinder", 1.5, 255, 255, 0, 170 )
       if ( theMarker ) then -- check if the marker was created successfully
       if ( theMarker ) then -- sprawdza czy marker został prawidłowo utworzony
         outputConsole ( "Marker created successfully", thePlayer )
         outputConsole ( "Marker created successfully", thePlayer )
       else
       else
Line 76: Line 76:
</section>
</section>


== Markers types ==
== Rodzaje Markerów ==
[[File:Markers.png|1000px]]
[[File:Markers.png|1000px]]


==See Also==
 
<br/>
''Autor: [[User:Tararysz12|marcin778]]; utworzono: 16:40, 31 Sierpnia  2016 (CEST)''
<br/>''Author: [[User:Tararysz12|marcin778]]; created: 14:40, 31 Aug 2016 (UTC)''
 
 
==Zobacz również==
{{Marker functions}}
{{Marker functions}}
[[en:createMarker]]
[[ru:createMarker]]
[[ru:createMarker]]
[[ar:createMarker]]
[[ar:createMarker]]

Revision as of 14:43, 31 August 2016

Template:PL/Server client function Funkcja ta tworzy znacznik. Znacznik to obiekt 3D w świecie. Za pomocą tego można wyznaczyć dany punkt lub obszar. Funkcji tej często się używa do przemieszczania graczy lub aby dać możliwość wejścia do jakiegoś budynku (Interioru).

Istnieją różne typy markerów między innymi:

  • Coronas: 32
  • Przystanek/Punkt, Pierścień, Cylinder i Strzałki: 32

Możesz stworzyć tak dużo znaczników ile tylko chcesz. Ale gracz będzie mógł zobaczyć je tylko z odpowiedniej odległości.

Składnia

Click to collapse [-]
Serwer
marker createMarker ( float x, float y, float z [, string theType = "checkpoint", float size = 4.0, int r = 0, int g = 0, int b = 255, int a = 255, visibleTo = getRootElement( ) ] )

Składnia OOP Pomocy, nie rozumiem!

Metoda: Marker(...)

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.

Opcjonalne Argumenty

UWAGA: Kiedy korzystasz z opcjonalnych argumentów, musisz uzupełnić wszystkie argumenty przed tym, którego chcesz użyć. Aby uzyskać więcej informacji na ten temat, zajrzyj tutaj.

  • theType: Typ znacznika jaki ma zostać utworzony. Możliwe do wyboru:
    • "checkpoint": A race checkpoint. These are very tall, but not infinite, light pillars. Checkpoints snap to ground and become invisible after going over a certain Z height.
    • "ring": Doughnut shaped ring, normally used for aircraft.
    • "cylinder": Small glowing ground ring. These are the glow markers you walk into to activate missions or events in single player.
    • "arrow": Arrow pointing down. These are the arrows on the doors you can enter in single player, except MTA's are not animated by default.
    • "corona": A glowing ball of light.
  • size: Rozmiar znacznika który ma zostać utworzony w metrach.
  • r: Liczba całkowita określająca liczbę czerwieni do zabarwienia znacznika (0 - 255).
  • g: Liczba całkowita określająca liczbę zieleni do zabarwienia znacznika (0 - 255).
  • b: Liczba całkowita określająca liczbę niebieskości do zabarwienia znacznika (0 - 255).
  • a: Liczba całkowita określająca liczbę alfa do zabarwienia znacznika (0 - 255, gdzie 0 oznacza przezroczysty a 255 nieprzezroczysty).
  • visibleTo: Ten argument określa dla kogo ma być widoczny dany znacznik. Domyślnie jest widoczny dla wszystkich. Zobacz visibility.
Click to collapse [-]
Klient
marker createMarker ( float x, float y, float z [, string theType = "checkpoint", float size = 4.0, int r = 0, int g = 0, int b = 255, int a = 255 ] )

Składnia OOP Pomocy, nie rozumiem!

Metoda: Marker(...)

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.

Opcjonalne Argumenty

UWAGA: Kiedy korzystasz z opcjonalnych argumentów, musisz uzupełnić wszystkie argumenty przed tym, którego chcesz użyć. Aby uzyskać więcej informacji na ten temat, zajrzyj tutaj.

  • theType: Typ znacznika jaki ma zostać utworzony. Możliwe do wyboru:
    • "checkpoint": A race checkpoint. These are very tall, but not infinite, light pillars. Checkpoints snap to ground and become invisible after going over a certain Z height.
    • "ring": Doughnut shaped ring, normally used for aircraft.
    • "cylinder": Small glowing ground ring. These are the glow markers you walk into to activate missions or events in single player.
    • "arrow": Arrow pointing down. These are the arrows on the doors you can enter in single player, except MTA's are not animated by default.
    • "corona": A glowing ball of light.
  • size: Rozmiar znacznika który ma zostać utworzony w metrach.
  • r: Liczba całkowita określająca liczbę czerwieni do zabarwienia znacznika (0 - 255).
  • g: Liczba całkowita określająca liczbę zieleni do zabarwienia znacznika (0 - 255).
  • b: Liczba całkowita określająca liczbę niebieskości do zabarwienia znacznika (0 - 255).
  • a: Liczba całkowita określająca liczbę alfa do zabarwienia znacznika (0 - 255, gdzie 0 oznacza przezroczysty a 255 nieprzezroczysty).

Wynik

Zwraca marker elementu, który został utworzony lub zwraca 'false' Jeśli argumenty są błędne.

Przykłady

Click to collapse [-]
Serwer

Przykład tworzy znacznik obok miejsca w którym znajduje się obecnie gracz:

-- ta funkcja jest wywoływana gdy wpiszemy createmarker w konsoli:
function consoleCreateMarker ( thePlayer, commandName )
   if ( thePlayer ) then
      local x, y, z = getElementPosition ( thePlayer ) -- pobiera pozycję gracza
      -- create a cylindrical marker next to the player:
      local theMarker = createMarker ( x + 2, y + 2, z, "cylinder", 1.5, 255, 255, 0, 170 )
      if ( theMarker ) then -- sprawdza czy marker został prawidłowo utworzony
         outputConsole ( "Marker created successfully", thePlayer )
      else
         outputConsole ( "Failed to create marker", thePlayer )
      end
   end
end
addCommandHandler ( "createmarker", consoleCreateMarker )

Rodzaje Markerów

Markers.png



Autor: marcin778; utworzono: 16:40, 31 Sierpnia 2016 (CEST)
Author: marcin778; created: 14:40, 31 Aug 2016 (UTC)


Zobacz również