Gorilla.Particle.Snow Unit Reference
Pre-configured snow particle emitter with spiral falling motion.
TGorillaSnowParticleEmitter
Realistic snowfall effect with integrated spiral and wind influencers.
Inheritance: TGorillaParticleEmitter → TGorillaSnowParticleEmitter
Platforms: All Gorilla platforms
Unit: Gorilla.Particle.Snow
Constructor/Destructor
Create
constructor Create(AOwner: TComponent); override;
Creates snow emitter with preconfigured settings:
- Spiral falling motion
- Small white particles
- Color fading
- Optional wind effect
- Sprite sheet animation
Destroy
destructor Destroy(); override;
Cleans up snow emitter resources.
Properties
SpawnSize
property SpawnSize: Single;
Relative spawning area size (0.0 - 1.0) from top of emitter downwards.
Default: 0.05 (5% of emitter height)
Usage:
// Spawn in top 10% of emitter
LSnow.SpawnSize := 0.1;
// Spawn across full height (not recommended)
LSnow.SpawnSize := 1.0;
Note: Lower values create more natural snowfall appearance.
Spiral (Read-Only)
property Spiral: TGorillaSpiralParticleInfluencer read FSpiral;
Integrated spiral influencer for realistic snowflake motion.
Usage:
// Adjust spiral intensity
LSnow.Spiral.Spirals := 15; // More spirals
// Disable spiral
LSnow.Spiral.Enabled := False;
Wind (Read-Only)
property Wind: TGorillaWindParticleInfluencer read FWind;
Integrated wind influencer for directing snowfall.
Default: Disabled
Usage:
// Enable wind
LSnow.Wind.Enabled := True;
LSnow.Wind.Force.Point := Point3D(-3, 0, 0); // Gentle breeze
LSnow.Wind.Size.Point := Point3D(100, 50, 50);
Colored (Read-Only)
property Colored: TGorillaColoredParticleInfluencer read FColored;
Integrated color influencer for snowflake fading.
Default: Light gray/white to transparent
ParticleMaterial (Read-Only)
property ParticleMaterial: TGorillaParticleMaterialSource read GetParticleMaterial;
Attached particle material source for snowflake textures.
Default Configuration
The snow emitter is preconfigured with these settings:
| Property | Value | Description |
|---|---|---|
| EmitParticles | 1 | Particles per interval |
| MaxParticles | 1024 | Maximum active particles |
| EmitTime | 16ms | ~60 FPS updates |
| AutoEmit | True | Automatic emission |
| Reuse | True | Particle caching enabled |
| ParticleSize | 0.1-2 | Small snowflakes |
| ParticleLifeTime | 5-10 seconds | Lifetime range |
| ParticleWeight | 0.3-0.5 | Light particles |
| SpawnSize | 0.05 | 5% from top |
| SpriteSheet | 7×7 | Animated sprites |
Integrated Influencers
- TGorillaSpiralParticleInfluencer - Spiral falling motion (10 spirals)
- TGorillaColoredParticleInfluencer - White to transparent fade
- TGorillaWindParticleInfluencer - Optional wind effect (disabled by default)
Examples
Basic Snowfall
var
LSnow: TGorillaSnowParticleEmitter;
begin
LSnow := TGorillaSnowParticleEmitter.Create(Self);
LSnow.Parent := GorillaViewport1;
LSnow.Camera := Camera1;
// Cover large area
LSnow.Width := 100;
LSnow.Height := 50;
LSnow.Depth := 100;
LSnow.Start();
end;
Snow with Wind
var
LSnow: TGorillaSnowParticleEmitter;
begin
LSnow := TGorillaSnowParticleEmitter.Create(Self);
LSnow.Parent := GorillaViewport1;
LSnow.Camera := Camera1;
LSnow.Width := 100;
LSnow.Height := 50;
LSnow.Depth := 100;
// Enable gentle wind
LSnow.Wind.Enabled := True;
LSnow.Wind.Force.Point := Point3D(-2, 0, 0); // Light breeze
LSnow.Wind.Origin.Point := Point3D(0, 25, 0);
LSnow.Wind.Size.Point := Point3D(100, 50, 100);
LSnow.Start();
end;
Heavy Snowfall
var
LHeavySnow: TGorillaSnowParticleEmitter;
begin
LHeavySnow := TGorillaSnowParticleEmitter.Create(Self);
LHeavySnow.Parent := GorillaViewport1;
LHeavySnow.Camera := Camera1;
LHeavySnow.Width := 100;
LHeavySnow.Height := 50;
LHeavySnow.Depth := 100;
// More particles
LHeavySnow.EmitParticles := 5;
LHeavySnow.MaxParticles := 3000;
// Larger flakes
LHeavySnow.ParticleSize.Preset(2, 4, 1, False);
// More spiraling
LHeavySnow.Spiral.Spirals := 20;
LHeavySnow.Start();
end;
Light Flurries
var
LFlurries: TGorillaSnowParticleEmitter;
begin
LFlurries := TGorillaSnowParticleEmitter.Create(Self);
LFlurries.Parent := GorillaViewport1;
LFlurries.Camera := Camera1;
LFlurries.Width := 50;
LFlurries.Height := 30;
LFlurries.Depth := 50;
// Very few particles
LFlurries.EmitTime := 50; // Slower emission
LFlurries.EmitParticles := 1;
LFlurries.MaxParticles := 200;
// Tiny flakes
LFlurries.ParticleSize.Preset(0.5, 1, 10, False);
LFlurries.Start();
end;
Blizzard
var
LBlizzard: TGorillaSnowParticleEmitter;
begin
LBlizzard := TGorillaSnowParticleEmitter.Create(Self);
LBlizzard.Parent := GorillaViewport1;
LBlizzard.Camera := Camera1;
LBlizzard.Width := 150;
LBlizzard.Height := 75;
LBlizzard.Depth := 150;
// Many particles
LBlizzard.EmitParticles := 10;
LBlizzard.MaxParticles := 5000;
// Strong wind
LBlizzard.Wind.Enabled := True;
LBlizzard.Wind.Force.Point := Point3D(-15, 0, 5); // Strong diagonal wind
LBlizzard.Wind.Size.Point := Point3D(150, 75, 150);
// Less spiraling (wind-blown)
LBlizzard.Spiral.Spirals := 5;
// Faster falling
LBlizzard.ParticleVelocity.RangeY.Preset(4000, 7000, 1000, False);
LBlizzard.Start();
end;
Gentle Snow
var
LGentleSnow: TGorillaSnowParticleEmitter;
begin
LGentleSnow := TGorillaSnowParticleEmitter.Create(Self);
LGentleSnow.Parent := GorillaViewport1;
LGentleSnow.Camera := Camera1;
LGentleSnow.Width := 75;
LGentleSnow.Height := 40;
LGentleSnow.Depth := 75;
// Moderate emission
LGentleSnow.EmitParticles := 2;
LGentleSnow.MaxParticles := 1500;
// Slow falling
LGentleSnow.ParticleVelocity.RangeY.Preset(1500, 3000, 1000, False);
// Maximum spiraling
LGentleSnow.Spiral.Spirals := 25;
LGentleSnow.Start();
end;
Tips
Performance
- Adjust MaxParticles based on visible area
- Use lower EmitParticles for light snow
- Consider async mode for heavy snowfall (> 3000 particles)
Visual Quality
- Position emitter above camera view
- Match emitter dimensions to scene size
- Enable wind for dynamic snowfall
- Use sprite sheet animation for variety
Realism
- Vary spiral intensity based on wind
- Use smaller particles for distant views
- Combine with fog effects
- Add sound effects for immersion
Optimization
- Reduce SpawnSize for better distribution
- Lower ParticleLifeTime for localized snow
- Disable spiral for performance gain (less realistic)
See Also
- Gorilla.Particle.Rain - Rain emitter
- Gorilla.Particle.Emitter - Base emitter class
- Gorilla.Particle.Influencer - Spiral and wind influencers
- Particle System User Guide