setWeaponTarget

Define para onde a arma aponta. São três formas.

Sintaxe

bool setWeaponTarget ( weapon arma, element alvo [, number subAlvo = 255 ] )
bool setWeaponTarget ( weapon arma, number x, number y, number z )
bool setWeaponTarget ( weapon arma, nil )

Parâmetros

Nome	Tipo	Padrão	Descrição
alvo	element	—	Elemento a perseguir. A arma acompanha ele enquanto existir.
subAlvo	number	255	Qual parte do alvo mirar — veja a nota abaixo.
x, y, z	number	—	Ponto fixo do mundo para onde apontar.
nil	—	—	Tira o alvo e volta para a mira fixa. O nil precisa ser passado explicitamente: omitir o argumento 2 devolve false.

Retorno

true se a mira foi definida, false se a arma for inválida ou os argumentos não formarem nenhuma das três formas (por exemplo, um subAlvo que não é número). O motivo vai para o console de debug.

Sobre o subAlvo

O significado de subAlvo depende do alvo:

• Ped — o número do osso, repassado direto para o motor. 255 mira na pelve. Fora isso, esta API não define uma lista de ossos válidos — use um número que você já saiba que funciona no seu caso.
• Veículo — uma roda: de 0 a 3 mira naquela roda, qualquer outro valor (inclusive o padrão 255) mira no próprio veículo.
• Jogador — ignorado. A arma mantém o osso que já tinha, que é a pelve a menos que um alvo ped anterior tenha definido outro.

-- persegue um jogador
setWeaponTarget(minhaArma, algumJogador)

-- aponta para um ponto fixo
setWeaponTarget(minhaArma, 1481.5, -1770.2, 18.8)

-- volta para a mira fixa
setWeaponTarget(minhaArma, nil)

Cuidado

Se o elemento alvo for destruído, a arma volta sozinha para a mira fixa e continua atirando para a frente. Se ela não deve mais atirar, coloque o estado em ready junto.

Veja também

• getWeaponTarget — Lê o alvo atual.