PL/createBlip: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Created page with "__NOTOC__ {{PL/Shared function}} Funkcja ta umożliwia stworzenie blipu, który będzie wyświetlał się na radarze gracza. ==Składnia== <section name="Serwer" cl...")
 
m (Blip? Lepiej brzmi znacznik)
Line 1: Line 1:
__NOTOC__  
__NOTOC__  
{{PL/Shared function}}
{{PL/Shared function}}
Funkcja ta umożliwia stworzenie [[blip|blipu]], który będzie wyświetlał się na radarze gracza.
Funkcja ta umożliwia stworzenie [[blip|znacznika]], który będzie wyświetlał się na radarze gracza.


==Składnia==
==Składnia==
Line 16: Line 16:
{{PL/OOP||[[Blip]]}}
{{PL/OOP||[[Blip]]}}
===Wymagane argumenty===  
===Wymagane argumenty===  
*'''x:''' Liczba zmiennoprzecinkowa określająca współrzędną X blipu na mapie.
*'''x:''' Liczba zmiennoprzecinkowa określająca współrzędną X znacznika na mapie.
*'''y:''' Liczba zmiennoprzecinkowa określająca współrzędną Y blipu 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 blipu na mapie.
*'''z:''' Liczba zmiennoprzecinkowa określająca współrzędną Z znacznika na mapie.


===Opcjonalne argumenty===  
===Opcjonalne argumenty===  
{{PL/OptionalArg}}  
{{PL/OptionalArg}}  
*'''icon:''' Liczba całkowita określająca ikonę blipu, którą możesz wybrać [[Blip Icons|tutaj]]. Domyślnie ''0''.
*'''icon:''' Liczba całkowita określająca ikonę znacznika, ich listę możesz znaleźć [[Blip Icons|tutaj]]. Domyślnie ''0''.
*'''size:''' Liczba całkowita określająca rozmiar blipu. Dotyczy tylko ikony o ID 0. Domyślnie ''2''.
*'''size:''' Liczba całkowita określająca rozmiar znacznika. Dotyczy tylko ikony o ID 0. Domyślnie ''2''.
*'''g:''' Wartość koloru zielonego w blipie (0 - 255). Dotyczy tylko ikony o ID 0. Domyślnie ''0''.
*'''g:''' Wartość koloru zielonego w znaczniku (0 - 255). Dotyczy tylko ikony o ID 0. Domyślnie ''0''.
*'''b:''' Wartość koloru niebieskiego w blipie (0 - 255). Dotyczy tylko ikony o ID 0. Domyślnie ''0''.
*'''b:''' Wartość koloru niebieskiego w znaczniku (0 - 255). Dotyczy tylko ikony o ID 0. Domyślnie ''0''.
*'''a:''' Wartość przezroczystości blipu (0 - 255). Dotyczy tylko ikony o ID 0. Domyślnie ''255''.
*'''a:''' Wartość przezroczystości znacznika (0 - 255). Dotyczy tylko ikony o ID 0. Domyślnie ''255''.
{{New feature/item|3|1.0||
{{New feature/item|3|1.0||
*'''ordering:''' Liczba całkowita określająca wysokość położenia blipu (-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''.
*'''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:''' Liczba zmiennoprzecinkowa określająca odległość, z jakiej widoczny jest blip. Domyślnie ''99999.0''.
*'''visibleDistance:''' Liczba zmiennoprzecinkowa określająca odległość, z jakiej widoczny jest znacznik. Domyślnie ''99999.0''.
}}
}}
<section name="Serwer" class="server" show="true">
<section name="Serwer" class="server" show="true">
*'''visibleTo:''' Dzięki temu argumentowi możesz sprecyzować, dla kogo blip będzie widoczny. Po więcej informacji zajrzyj [[visibility|tutaj]]. Domyślnie, blip jest widoczny dla wszystkich graczy (''getRootElement()'').  
*'''visibleTo:''' Dzięki temu argumentowi możesz sprecyzować, dla kogo znacznik będzie widoczny. Po więcej informacji zajrzyj [[visibility|tutaj]]. Domyślnie, znacznik jest widoczny dla wszystkich graczy (''getRootElement()'').  
</section>
</section>


===Wynik===
===Wynik===
Zwraca [[element]] [[blip|blipu]], jeśli został on pomyślnie utworzony. W każdym innym przypadku zwraca ''false''.
Zwraca [[element]] [[blip|znacznika]], jeśli został on pomyślnie utworzony. W każdym innym przypadku zwraca ''false''.


==Przykłady==  
==Przykłady==  
<section name="Serwer" class="server" show="true">
<section name="Serwer" class="server" show="true">
'''Przykład nr 1:''' Ten przykład tworzy blip, który będzie podążał za losowym graczem.
'''Przykład nr 1:''' Ten przykład tworzy znacznik, który będzie podążał za losowym graczem.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
local randomPlayer = getRandomPlayer( ) -- zaczynamy od wylosowania gracza
local randomPlayer = getRandomPlayer( ) -- zaczynamy od wylosowania gracza
local x, y, z = getElementPosition( player ) -- następnie pobieramy jego pozycję...
local x, y, z = getElementPosition( player ) -- następnie pobieramy jego pozycję...
local playerBlip = createBlip( x, y, z, 58, 0, 0, 0, 255 ) -- ...i tworzymy w tym miejscu blip...
local playerBlip = createBlip( x, y, z, 58, 0, 0, 0, 255 ) -- ...i tworzymy w tym miejscu znacznik...
setElementParent( playerBlip, randomPlayer ) -- ...któremu następnie każemy podążać za graczem
setElementParent( playerBlip, randomPlayer ) -- ...któremu następnie każemy podążać za graczem
</syntaxhighlight>
</syntaxhighlight>

Revision as of 11:53, 22 July 2016

Funkcja ta umożliwia stworzenie znacznika, który będzie wyświetlał się na radarze gracza.

Składnia

Click to collapse [-]
Serwer
blip createBlip ( float x, float y, float z [, 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( ) ] )
Click to collapse [-]
Klient
blip createBlip ( float x, float y, float z [, 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 ] )

Składnia OOP Pomocy, nie rozumiem!

Metoda: Blip(...)

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.

  • icon: Liczba całkowita określająca ikonę znacznika, ich listę możesz znaleźć tutaj. Domyślnie 0.
  • size: Liczba całkowita określająca rozmiar znacznika. Dotyczy tylko ikony o ID 0. Domyślnie 2.
  • g: Wartość koloru zielonego w znaczniku (0 - 255). Dotyczy tylko ikony o ID 0. Domyślnie 0.
  • b: Wartość koloru niebieskiego w znaczniku (0 - 255). Dotyczy tylko ikony o ID 0. Domyślnie 0.
  • a: Wartość przezroczystości znacznika (0 - 255). Dotyczy tylko ikony o ID 0. Domyślnie 255.
  • 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: Liczba zmiennoprzecinkowa określająca odległość, z jakiej widoczny jest znacznik. Domyślnie 99999.0.
Click to collapse [-]
Serwer
  • visibleTo: Dzięki temu argumentowi możesz sprecyzować, dla kogo znacznik będzie widoczny. Po więcej informacji zajrzyj tutaj. Domyślnie, znacznik jest widoczny dla wszystkich graczy (getRootElement()).

Wynik

Zwraca element znacznika, jeśli został on pomyślnie utworzony. W każdym innym przypadku zwraca false.

Przykłady

Click to collapse [-]
Serwer

Przykład nr 1: Ten przykład tworzy znacznik, który będzie podążał za losowym graczem.

local randomPlayer = getRandomPlayer( ) -- zaczynamy od wylosowania gracza
local x, y, z = getElementPosition( player ) -- następnie pobieramy jego pozycję...
local playerBlip = createBlip( x, y, z, 58, 0, 0, 0, 255 ) -- ...i tworzymy w tym miejscu znacznik...
setElementParent( playerBlip, randomPlayer ) -- ...któremu następnie każemy podążać za graczem


Autor: GabWas; utworzono: 23:03, 21 Lip 2016 (CEST)
Author: GabWas; created: 21:03, 21 Jul 2016 (UTC)

Zobacz również