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