CoolBasic SDK

CreateColorParticleEffect

Include "cbSpecialFX.cb"

KUVAUS
Tällä funktiolla voit luoda pieniä partikkeli efektejä, kuten veri-tai vesiroiskeita, savupöllähdyksiä, kipinöitä ja niin edelleen. Efektit päivitetään joko UpdateEffects tai UpdateParticleEffects funktioilla.

Funktion viimeinen parametri määrittelee partikkelien värit.
Parametri on merkkijono ja tässä muutama esimerkki:

rgb,0-255
Arvotaan väriarvo väliltä 0-255 joka vaikuttaa kaikkiin värikomponentteihin (RED, GREEN, BLUE) eli tuloksena on harmaasävy väliltä musta-valkoinen.

r,0-255
Punaisen sävy väliltä musta-punainen

gb,0-255:r255
Arvotaan väriarvo väliltä 0-255 joka annetaan vihreälle ja siniselle.
Kaksoispisteen perässä annetaan värikomponenteille vakioarvo eli tässä tapauksessa punainen saa arvon 255.
Lopputulos on jokin punaisen sävy väliltä punainen-valkoinen.

:r255,g255 tai rg,255
Tulos on aina keltainen. Ensimmäisessä esimerkissä annetaan punaiselle ja vihreälle vakioarvot ja toisessa arvotaan väriarvo väliltä 255-255 joka sijoitetaan komponenteille RED ja GREEN.

:r255|:r255,g255
Eri värimäärityksiä voi yhdistää |-merkillä (pystyviiva/putki). Näistä ohjelma arpoo jonkun jota sitten käytetään kuten aiemmin on kuvattu.
Tässä tapauksessa tulos on aina joko punainen tai keltainen jota voisi käyttää vaikka kipinäefektissä.

KÄYTTÖ
CreateColorParticleEffect(x, y, dir, range, amount, size1, size2, speed1, speed2, shrink1, shrink2, fade1, fade2, gx, gy, colors)
dir = Partikkelien lähtösuunta
range = Kuinka laajalle alueelle partikkelit leviää alkaen kulmasta "dir"
amount = Partikkelien lukumäärä
size1 = Pienin mahdollinen partikkeli
size2 = Suurin mahdollinen partikkeli
speed1 = Pienin lähtönopeus (pikseliä sekunnissa)
speed2 = Suurin lähtönopeus (pikseliä sekunnissa)
shrink1 = Pienin yksittäisen partikkelin kutistuma (pikseliä sekunnissa)
shrink2 = Suurin yksittäisen partikkelin kutistuma (pikseliä sekunnissa)
fade1 = Vaalennus/tummennus. Pienin nopeus (väriarvoa sekunnissa)
fade2 = Vaalennus/tummennus. Suurin nopeus (väriarvoa sekunnissa)
gx = Vaikutus sivuttaisliikkeeseem esim tuuli. (pikseliä sekunnissa)
gy = Vaikutus pystyliikkeesees esim painovoima. (pikseliä sekunnissa)
colors$ = Partikkelin väri, ks. yllä

Katso myös: UpdateParticleEffectsUpdateEffects

ESIMERKKI
// Katso esimerkkiohjelma ParticleEffectExample.cb