PL/createMarker
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
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 widoczność.
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 znacznik elementu, który został utworzony lub zwraca 'false' Jeśli argumenty są błędne.
Przykłady
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
Autor: Tararysz12; utworzono: 16:40, 31 Sierpnia 2016 (CEST)
Author: Tararysz12; created: 14:40, 31 Aug 2016 (UTC)