View source for PL/createMarker

__NOTOC__
{{PL/Shared 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==
<section name="Serwer" class="server" show="true">
<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( ) ] )
</syntaxhighlight>
{{PL/OOP||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===
{{PL/OptionalArg}}
* '''theType''': Typ znacznika jaki ma zostać utworzony. Możliwe do wyboru:
{{Marker_types}}
* '''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|widoczność]].
</section>
<section name="Klient" class="client" show="true">
<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 ] )
</syntaxhighlight>
{{PL/OOP||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===
{{PL/OptionalArg}}
* '''theType''': Typ znacznika jaki ma zostać utworzony. Możliwe do wyboru:
{{Marker_types}}
* '''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).
</section>

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

==Przykłady==
<section name="Serwer" class="server" show="true">
Przykład tworzy znacznik obok miejsca w którym znajduje się obecnie gracz:
<syntaxhighlight lang="lua">
-- 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 )
</syntaxhighlight>
</section>

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


<br/>
''Autor: [[User:Tararysz12|Tararysz12]]; utworzono: 16:40, 31 Sierpnia  2016 (CEST)''
<br/>''Author: [[User:Tararysz12|Tararysz12]]; created: 14:40, 31 Aug 2016 (UTC)''


==Zobacz również==
{{Marker functions}}
[[en:createMarker]]
[[ru:createMarker]]
[[ar:createMarker]]