fxCreateParticle

Injeta partículas soltas num sistema de partículas do jogo, com cor, tamanho e duração escolhidos por você.

Sintaxe

bool fxCreateParticle ( string sistema, number x, number y, number z, number dx, number dy, number dz, number r, number g, number b, number a [, bool corAleatoria = false, number quantidade = 1, number brilho = 1.0, number tamanho = 0.3, bool tamanhoAleatorio = false, number duracao = 1.0 ] )

Parâmetros

Nome	Tipo	Padrão	Descrição
sistema	string	—	Nome do sistema de partículas. Veja a tabela abaixo.
x, y, z	number	—	Posição das partículas.
dx, dy, dz	number	—	Direção base em que elas se movem. Cada partícula recebe um desvio aleatório em cima dela.
r, g, b, a	number	—	Cor e opacidade, de 0 a 255.
corAleatoria	bool	false	Varia a cor de cada partícula em torno da cor informada.
quantidade	number	1	Quantas partículas criar. A parte fracionária é descartada; 0 não cria nada.
brilho	number	1.0	Multiplicador de brilho.
tamanho	number	0.3	Tamanho de cada partícula.
tamanhoAleatorio	bool	false	Varia o tamanho de cada partícula em torno do valor informado.
duracao	number	1.0	Quanto tempo as partículas duram.

Sistemas de partículas aceitos

blood, boat_splash, bubble, car_debris, collision_smoke, gunshell, sand, sand2, huge_smoke, smoke, spark, spark2, splash, wake, water_splash, wheel_dirt, glass.

O nome é comparado sem diferenciar maiúsculas de minúsculas.

Retorno

true sempre que os argumentos forem válidos — mesmo que nada apareça na tela, como com uma quantidade igual a 0 ou antes de o mundo estar sendo desenhado.

Argumentos inválidos geram um erro de Lua em vez de devolver false: um nome de sistema desconhecido, um valor ausente ou não numérico (ou NaN ou infinito) onde se espera um número, uma quantidade negativa, ou algo que não seja booleano em corAleatoria ou tamanhoAleatorio.

Exemplo

-- baforada de fumaça branca subindo
fxCreateParticle("smoke", 2000.0, 1500.0, 15.0, 0, 0, 1,
                 255, 255, 255, 120,
                 false, 25, 1.0, 0.8, true, 2.0)