particle_react_util¶

Quelle: base/tealdef/gui/main/particle_react_util.d.tl

Hinweise

Hilfsfunktionen für 2D-Partikeleffekte der GUI (builtin.ParticleSystem2d): Vorgaben für die Animationen beim Stufenaufstieg des Unternehmens und beim Freischalten, dazu ein Builder, der aus einer einfachen Tabelle einen ParticleSystem2dEmitter macht.

ParticleReactUtil¶

record global base/tealdef/gui/main/particle_react_util.d.tl:3

global record ParticleReactUtil

Laden: local particle_react_util = ug_require "::/gui/main/particle_react_util.tl" as ParticleReactUtil

Hinweise

Hilfsfunktionen für Partikeleffekte der GUI.

Funktionen

makeCompanyLevelUpParticles(overrides? : Emitter) : {Builtin.Type.ParticleSystem2dEmitter} base/tealdef/gui/main/particle_react_util.d.tl:51

Aufruf: particle_react_util.makeCompanyLevelUpParticles(…)

Hinweise

Erzeugt die aufsteigenden goldenen Sterne des Effekts beim Stufenaufstieg des Unternehmens.

Parameter	Typ	Beschreibung
`overrides?`	`Emitter`	Optionale Emitter-Felder, die die Werte der Vorgabe ersetzen (zum Beispiel `emissionEnabled`).

Rückgabe {Builtin.Type.ParticleSystem2dEmitter}: Die Emitter-Liste für builtin.ParticleSystem2d{ emitters = ... }.

Beispiel

-- aus game_bar.tl
builtin.ParticleSystem2d{
    emitters = particle_react_util.makeCompanyLevelUpParticles({
        emissionEnabled = state:old().applyDiff > 0
    })
}

Im Basisspiel verwendet: 1-mal in 1 Datei

base/content/gui/gui/game_bar/game_bar.tl:425

emitters = particle_react_util.makeCompanyLevelUpParticles({

makeUnlockAnimationParticles(overrides1? : Emitter, overrides2? : Emitter) : {Builtin.Type.ParticleSystem2dEmitter} base/tealdef/gui/main/particle_react_util.d.tl:53

Aufruf: particle_react_util.makeUnlockAnimationParticles(…)

Hinweise

Erzeugt den Sternenregen der Freischalt-Animation (eine kurze Phase nach innen, dann eine Explosion aus goldenen und weißen Sternen).

Parameter	Typ	Beschreibung
`overrides1?`	`Emitter`	Optionale Emitter-Felder, die die Werte der ersten Phase ersetzen.
`overrides2?`	`Emitter`	Optionale Emitter-Felder, die die Werte der zweiten Phase ersetzen.

Rückgabe {Builtin.Type.ParticleSystem2dEmitter}: Die Emitter-Liste für builtin.ParticleSystem2d.

Im Basisspiel verwendet: 1-mal in 1 Datei

base/content/game_mechanics/game_mechanics/company/company.tl:85

emitters = particle_react_util.makeUnlockAnimationParticles(

makeParticleSystem2dEmitter(...: Emitter) : Builtin.Type.ParticleSystem2dEmitter base/tealdef/gui/main/particle_react_util.d.tl:55

Aufruf: particle_react_util.makeParticleSystem2dEmitter(…)

Hinweise

Erzeugt einen ParticleSystem2dEmitter aus einer oder mehreren Emitter-Tabellen; spätere Tabellen überschreiben frühere.

Rückgabe Builtin.Type.ParticleSystem2dEmitter

Details

Einfache Zahlen, Vec2f-Werte und Listen von Kurvenpunkten werden in die passenden ParticleParam*-Typen verpackt. Du kannst also lifeTime = 1.5 schreiben statt api.type.ParticleParamFloat.new(1.5).

ParticleReactUtil.Emitter¶

record base/tealdef/gui/main/particle_react_util.d.tl:6

record Emitter

Simplified proxy for creating particle emitters See Builtin.Type.ParticleSystem2dEmitter for details on the parameters

Im Basisspiel verwendet: 6-mal in 1 Datei

base/content/gui/gui/main/particle_react_util.tl:6

particle_react_util.makeCompanyLevelUpParticles = function(overrides? : ParticleReactUtil.Emitter) : {Builtin.Type.ParticleSystem2dEmitter}

Felder

Name	Typ	Beschreibung
`emissionEnabled`	`boolean`	Ob der Emitter gerade Partikel ausstößt.
`speed`	`number`	Faktor, der die Emissionsrate verlangsamt oder beschleunigt.
`texture`	`string`	Textur eines Partikels.
`duration`	`number \| any`	number\|ParticleParamFloat.RandomMinMax\|ParticleParamFloat.ComponentWiseMinMax
`emissionInterval`	`number \| any`	number\|ParticleParamFloat.RandomMinMax\|ParticleParamFloat.ComponentWiseMinMax
`burstCount`	`number \| any`	number\|ParticleParamFloat.RandomMinMax\|ParticleParamFloat.ComponentWiseMinMax
`burstInterval`	`number \| any`	number\|ParticleParamFloat.RandomMinMax\|ParticleParamFloat.ComponentWiseMinMax
`lifeTime`	`number \| any`	number\|ParticleParamFloat.RandomMinMax\|ParticleParamFloat.ComponentWiseMinMax
`subEmitters`	`{Builtin.Type.ParticleSystem2dSubEmitter}`	Unter-Emitter, die von den Partikeln dieses Emitters starten; einfache Tabellen mit `emitterIndex` werden umgewandelt.
`shape`	`Builtin.Type.ParticleSystem2dEmitterShape`	Form des Emitters (Inhaltsrechteck oder Kreis).
`velocity`	`Vec2f \| any`	Vec2f\|ParticleParamVec2f.RandomMinMax\|ParticleParamVec2f.ComponentWiseMinMax
`velocityByDirection`	`number \| any`	number\|ParticleParamFloat.RandomMinMax\|ParticleParamFloat.ComponentWiseMinMax
`velocityOverLifeTime`	`{ParticleParamCurveVec2f.CurvePoint}`	Zusätzliche Geschwindigkeitskurve über die Lebensdauer des Partikels, als Liste von Kurvenpunkten.
`gravity`	`Vec2f \| any`	Vec2f\|ParticleParamVec2f.RandomMinMax\|ParticleParamVec2f.ComponentWiseMinMax
`orientation`	`Vec2f`	Bezugsvektor der Ausrichtung für Drehberechnungen (Standard `{0, -1}`).
`rotationByDirection`	`number \| any`	number\|ParticleParamFloat.RandomMinMax\|ParticleParamFloat.ComponentWiseMinMax
`rotation`	`number \| any`	number\|ParticleParamFloat.RandomMinMax\|ParticleParamFloat.ComponentWiseMinMax
`rotationSpeed`	`number \| any`	number\|ParticleParamFloat.RandomMinMax\|ParticleParamFloat.ComponentWiseMinMax
`rotationSpeedByDirection`	`number \| any`	number\|ParticleParamFloat.RandomMinMax\|ParticleParamFloat.ComponentWiseMinMax
`colorOverLifeTime`	`{ParticleParamCurveVec3f.CurvePoint}`	Farbkurve (RGB) über die Lebensdauer des Partikels, als Liste von Kurvenpunkten.
`alphaOverLifeTime`	`{ParticleParamCurveFloat.CurvePoint}`	Alpha-Kurve über die Lebensdauer des Partikels, als Liste von Kurvenpunkten.
`size`	`Vec2f \| any`	Vec2f\|ParticleParamVec2f.RandomMinMax\|ParticleParamVec2f.ComponentWiseMinMax
`scaleOverLifeTime`	`{ParticleParamCurveVec2f.CurvePoint}`	Größenkurve über die Lebensdauer des Partikels, als Liste von Kurvenpunkten.