View source for IT/createBlip

{{IT/MainP}}
__NOTOC__ 
{{IT/Funzioni server client}}
Questa funzione crea un [[IT/Elemento|elemento]] [[IT/Elemento/Blip|segnalino]], che viene mostrato come un icona nel radar del client.

==Sintassi==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
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()] )
</syntaxhighlight> 

===Argomenti richiesti=== 
*'''x:''' La posizione x del segnalino, nelle coordinate del mondo.
*'''y:''' La posizione y del segnalino, nelle coordinate del mondo.
*'''z:''' La posizione z del segnalino, nelle coordinate del mondo.

===Argomenti opzionali=== 
{{IT/Argomenti opzionali}}
*'''icon:''' L'icona del segnalino del radar. Valori validi sono:
{{IT/Segnalini radar}}
*'''size:''' La grandezza del segnalino del radar. Di default è 2.
*'''r:''' La quantità di colore rosso nel colore del segnalino (0 - 255). Applicabile solo all'icona ''nessuna''. Di default è 255. 
*'''g:''' La quantità di colore verde nel colore del segnalino (0 - 255). Applicabile solo all'icona ''nessuna''. Di default è 0.
*'''b:''' La quantità di colore blu nel colore del segnalino (0 - 255). Applicabile solo all'icona ''nessuna''. Di default è 0.
*'''a:''' L'opacità del segnalino (0 - 255). Di default è 255.
{{IT/Caratteristiche nuove|3|1.0|
*'''ordering:''' Questo definisce l'ordinamento del segnalino nello Z-Level (-32768 - 32767). Di default è 0.
*'''visibleDistance:''' La distanza massima dalla telecamera alla quale il segnalino è ancora visibile
}}
*'''visibleTo:''' Quali elementi possono vedere il segnalino. Di default è visibile a tutti. Vedere [[IT/Visibility|Visibilità]].
</section>
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
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 ] )
</syntaxhighlight> 

===Argomenti richiesti=== 
*'''x:''' La posizione x del segnalino, nelle coordinate del mondo.
*'''y:''' La posizione y del segnalino, nelle coordinate del mondo.
*'''z:''' La posizione z del segnalino, nelle coordinate del mondo.

===Argomenti opzionali=== 
{{IT/Segnalini radar}}
*'''size:''' La grandezza del segnalino del radar. Di default è 2.
*'''r:''' La quantità di colore rosso nel colore del segnalino (0 - 255). Applicabile solo all'icona ''nessuna''. Di default è 255. 
*'''g:''' La quantità di colore verde nel colore del segnalino (0 - 255). Applicabile solo all'icona ''nessuna''. Di default è 0.
*'''b:''' La quantità di colore blu nel colore del segnalino (0 - 255). Applicabile solo all'icona ''nessuna''. Di default è 0.
*'''a:''' L'opacità del segnalino (0 - 255). Di default è 255.
{{IT/Caratteristiche nuove|3|1.0|
*'''ordering:''' Questo definisce l'ordinamento del segnalino nello Z-Level (-32768 - 32767). Di default è 0.
*'''visibleDistance:''' La distanza massima dalla telecamera alla quale il segnalino è ancora visibile
}}

==Valori restituiti==
Restituisce l'[[IT/Elemento|elemento]] [[IT/Elemento/Blip|segnalino]] se è stato creato con successo, altrimenti restituisce ''false''.

==Esempio== 
<section name="Server" class="server" show="true">
'''Esempio 1:''' Questo esempio crea un segnalino nel radar nella posizione di un giocatore a caso e fa in modo che sia visibile solo a quel giocatore.
<syntaxhighlight lang="lua">
-- Scegli un giocatore casuale
myPlayer = getRandomPlayer ()
-- Recupera la posizione del giocatore e conservala nelle variabili x, y e z
x,y,z = getElementPosition ( myPlayer )
-- Creare un segnalino nel radar nella posizione del giocatore, con l'icona del 'dollaro' e visibile solo a quel giocatore
myBlip = createBlip ( x, y, z, 51, 0, 0, 0, 255, myPlayer )
</syntaxhighlight>

'''Esempio 2:''' Questo esempio attribuisce un segnalino ad un giocatore. È possibile collegare un segnalino ad un elemento semplicemente impostandolo come genitore di questo elemento.
<syntaxhighlight lang="lua">
-- Scegli un giocatore casuale
myPlayer = getRandomPlayer ()
-- Creare un segnalino nel radar in mezzo alla mappa
myBlip = createBlip ( 0, 0, 0 )
-- Fai diventare il giocatore il genitore del segnalino, in modo che il segnalino segue il giocatore
setElementParent ( myBlip, myPlayer )
</section>

==Vedi anche==
{{IT/Blip functions}}