Blips

Blips são os ícones que aparecem no radar e no mapa. Um blip pode ficar parado em uma coordenada ou seguir outro elemento (um jogador, um veículo, um objeto) enquanto ele se move.

As funções que recebem coordenadas aceitam tanto três números soltos quanto um Vector3 no lugar deles — createBlip(Vector3(x, y, z)) funciona igual a createBlip(x, y, z).

Os blips criados por um resource são destruídos junto com ele.

Estas 12 funções existem no servidor e no cliente. Você pode usá-las em scripts declarados em server_files, client_files ou shared_files.

Limites

Estes limites valem para todas as funções da página:

Propriedade	Faixa	Observação
Ícone	0 – 63	Fora da faixa, a chamada falha.
Tamanho	0 – 255	Valores acima de 25 são reduzidos para 25.
Cor (r, g, b, a)	0 – 255 por canal	a é a opacidade: 0 invisível, 255 opaco.
Ordem	-32768 – 32767	Quem tem valor maior é desenhado por cima.
Distância visível	0 – 65535	Distância em unidades do jogo.

O cliente aplica essas faixas de outro jeito. Um valor negativo, NaN ou algo que não é número faz a chamada falhar com um aviso, mas um valor acima do topo da faixa não é recusado: ele dá a volta como um estouro de inteiro (um canal de cor 300 vira 44, uma ordem 40000 vira -25536). Um ícone que ainda fique acima de 63 falha, e um tamanho acima de 25 é reduzido com um aviso.

No cliente todo setter também exige um blip como primeiro argumento (qualquer outra coisa falha com um aviso); ele altera esse blip e os blips abaixo dele, e devolve o resultado do próprio blip.

createBlip Cria um blip parado em uma posição do mapa.

createBlipAttachedTo Cria um blip preso a um elemento.

getBlipIcon Devolve o ícone atual de um blip.

getBlipSize Devolve o tamanho atual de um blip.

getBlipColor Devolve a cor de um blip.

getBlipOrdering Devolve a ordem de desenho de um blip.

getBlipVisibleDistance Devolve a distância máxima em que o blip ainda aparece.

setBlipIcon Troca o ícone de um blip.

setBlipSize Troca o tamanho de um blip.

setBlipColor Troca a cor de um blip.

setBlipOrdering Define qual blip é desenhado por cima quando dois se sobrepõem.

setBlipVisibleDistance Define a partir de que distância o blip some do radar.