tranquillity Wiki Rss Feed

Updated Wiki: Home

AlexYakobovich — Fri, 04 May 2012 17:18:01 GMT

Project Description
Tranquillity is a compact, easy to use and highly extendible 3D particle system for Windows Phone 7 XNA projects.

For installation/integration, check out the Getting Started Guide. To learn how to use Tranquillity check out Using Tranquillity.

The project is currently in beta; be sure to leave your comments and report bugs. You can get in touch with me on twitter (@ayakobovich).

If you end up using this project in your game, please credit by mentioning that your project particles are powered by Tranquillity.

Updated Wiki: Using Tranquillity

AlexYakobovich — Tue, 27 Dec 2011 01:07:46 GMT

Using Tranquillity

Using Tranquillity is easy; most tasks can be achieved in a couple of lines of code. The demo project included with the source showcases more advanced scenarios including AppHub’s fire, smoke and explosion samples.

Particle Manager

All particle properties, behavior and drawing are managed by Tranquillity’s ParticleManager. ParticleManager is a DrawableGameComponent that can simply be added to your Game’s component collection.

   1:  ParticleManager particleManager;

2:

   3:  ...

4:

   5:  public Game1()

   6:  {

   7:      ...

8:

   9:      particleManager = new ParticleManager(this);

  10:      Components.Add(particleManager);

11:

  12:      ...

  13:  }

The ParticleManager needs to know how your world is being viewed. Use the SetMatrices method to set the view and projection matrices.

Particle Systems

A ParticleSystem defines a group of particles that share a texture representation. There are two base particle system types in Tranquillity:

StaticParticleSystem: All particles in this system have static properties. Once a particle is added to this system type, it cannot move, grow, change color, etc. Although particles can be added and removed to/from this system on the fly, it is ideal for static allocation of particles.

DynamicParticleSystem: A dynamic particle system contains particles that can have a velocity, rotation, lifespan and can be affected by various affectors.

Creating and registering a particle system

To create a system, specify the maximum capacity and the texture to be used for this system in the LoadContent method. For example, create a dynamic particle system:

   1:  DynamicParticleSystem particleSystem = new DynamicParticleSystem(1000, texture);

The texture can be either an image or a 1x1 pixel, which can be generated on the fly:

   1:  Texture2D pixel = new Texture2D(GraphicsDevice, 1, 1);

   2:  pixel.SetData<Color>(new Color[1] { Color.White });

Add the system to the particle manager:

   1:  particleManager.AddParticleSystem(particleSystem);

Optionally, a custom BlendState can be specified:

   1:  particleManager.AddParticleSystem(particleSystem, BlendState.Additive);

Particles

The overloaded AddParticle method can be used to add particles to any system. The RandomHelper class can be used to randomize the generation of particles. For example:

   1:  particleSystem.AddParticle(
            RandomHelper.Vector3Between(Vector3.Up, Vector3.Down),
            RandomHelper.Color(),
            RandomHelper.NormalizedVector3(),
            RandomHelper.Float(),
            TimeSpan.FromSeconds(RandomHelper.IntBetween(1, 3))
       );

Use the RemoveAt method to remove a particle at the given index.

Particle Emitters

Emission of particles can be automated using a particle emitter. To create a custom particle emitter, implement the IParticleEmitter interface:

   1:  public class CustomParticleEmitter : IParticleEmitter

Implementing the Update method will allow the emitter to automatically emit particles in the particle system it is added to. The Emit method can be used to emit particles manually.

An emitter can be added to any dynamic particle system:

   1:  particleSystem.AddEmitter(new CustomParticleEmitter());

Particle Affectors

A particle affector can affect one or more properties of all particles in a system. There are three default affectors in Tranquillity that use the particle’s age as the time factor:

Decelerate: Slows a particle down to a complete stop towards the end of its lifespan. This affectors affects only particles that have a velocity.

Fadeout: Reduces the alpha of a particle until it becomes completely transparent towards the end of its lifespan.

Shrink: Reduces the size of a particle until it disappears completely towards the end of its lifespan.

To create a custom particle affector, implement the IParticleAffector interface:

   1:  public class CustomParticleAffector : IParticleAffector

Implementing the Affect method will allow the affector to access the properties of the parameter particle.

An affector can be added to any dynamic particle system:

   1:  particleSystem.AddAffector(new CustomParticleAffector());

Updated Wiki: Using Tranquillity

AlexYakobovich — Tue, 27 Dec 2011 01:07:04 GMT

Using Tranquillity

Particle Manager

   1:  ParticleManager particleManager;

2:

   3:  ...

4:

   5:  public Game1()

   6:  {

   7:      ...

8:

   9:      particleManager = new ParticleManager(this);

  10:      Components.Add(particleManager);

11:

  12:      ...

  13:  }

The ParticleManager needs to know how your world is being viewed. You will need to use the SetMatrices method to set the view and projection matrices.

Particle Systems

A ParticleSystem defines a group of particles that share a texture representation. There are two base particle system types in Tranquillity:

DynamicParticleSystem: A dynamic particle system contains particles that can have a velocity, rotation, lifespan and can be affected by various affectors.

Creating and registering a particle system

To create a system, specify the maximum capacity and the texture to be used for this system in the LoadContent method. For example, create a dynamic particle system:

   1:  DynamicParticleSystem particleSystem = new DynamicParticleSystem(1000, texture);

The texture can be either an image or a 1x1 pixel, which can be generated on the fly:

   1:  Texture2D pixel = new Texture2D(GraphicsDevice, 1, 1);

   2:  pixel.SetData<Color>(new Color[1] { Color.White });

Add the system to the particle manager:

   1:  particleManager.AddParticleSystem(particleSystem);

Optionally, a custom BlendState can be specified:

   1:  particleManager.AddParticleSystem(particleSystem, BlendState.Additive);

Particles

The overloaded AddParticle method can be used to add particles to any system. The RandomHelper class can be used to randomize the generation of particles. For example:

   1:  particleSystem.AddParticle(
            RandomHelper.Vector3Between(Vector3.Up, Vector3.Down),
            RandomHelper.Color(),
            RandomHelper.NormalizedVector3(),
            RandomHelper.Float(),
            TimeSpan.FromSeconds(RandomHelper.IntBetween(1, 3))
       );

Use the RemoveAt method to remove a particle at the given index.

Particle Emitters

Emission of particles can be automated using a particle emitter. To create a custom particle emitter, implement the IParticleEmitter interface:

   1:  public class CustomParticleEmitter : IParticleEmitter

Implementing the Update method will allow the emitter to automatically emit particles in the particle system it is added to. The Emit method can be used to emit particles manually.

An emitter can be added to any dynamic particle system:

   1:  particleSystem.AddEmitter(new CustomParticleEmitter());

Particle Affectors

A particle affector can affect one or more properties of all particles in a system. There are three default affectors in Tranquillity that use the particle’s age as the time factor:

Decelerate: Slows a particle down to a complete stop towards the end of its lifespan. This affectors affects only particles that have a velocity.

Fadeout: Reduces the alpha of a particle until it becomes completely transparent towards the end of its lifespan.

Shrink: Reduces the size of a particle until it disappears completely towards the end of its lifespan.

To create a custom particle affector, implement the IParticleAffector interface:

   1:  public class CustomParticleAffector : IParticleAffector

Implementing the Affect method will allow the affector to access the properties of the parameter particle.

An affector can be added to any dynamic particle system:

   1:  particleSystem.AddAffector(new CustomParticleAffector());

Updated Wiki: Using Tranquillity

AlexYakobovich — Mon, 19 Dec 2011 04:26:09 GMT

Using Tranquillity

Particle Manager

   1:  ParticleManager particleManager;

2:

   3:  ...

4:

   5:  public Game1()

   6:  {

   7:      ...

8:

   9:      particleManager = new ParticleManager(this);

  10:      Components.Add(particleManager);

11:

  12:      ...

  13:  }

Particle Systems

A ParticleSystem defines a group of particles that share a texture representation. There are two base particle system types in Tranquillity:

StaticParticleSystem: All particles in this system have static properties. Once a particle is added to this system type, it cannot move, grow, change color, etc. Although particles can be added and removed to/from this system on the fly, it is ideal for static allocation of particles.
DynamicParticleSystem: A dynamic particle system contains particles that can have a velocity, rotation, lifespan and can be affected by various affectors.

Creating and registering a particle system

To create a system, specify the maximum capacity and the texture to be used for this system in the LoadContent method. For example, create a dynamic particle system:

   1:  DynamicParticleSystem particleSystem = new DynamicParticleSystem(1000, texture);

The texture can be either an image or a 1x1 pixel, which can be generated on the fly:

   1:  Texture2D pixel = new Texture2D(GraphicsDevice, 1, 1);

   2:  pixel.SetData<Color>(new Color[1] { Color.White });

Add the system to the particle manager:

   1:  particleManager.AddParticleSystem(particleSystem);

Optionally, a custom BlendState can be specified:

   1:  particleManager.AddParticleSystem(particleSystem, BlendState.Additive);

Particles

The overloaded AddParticle method can be used to add particles to any system. The RandomHelper class can be used to randomize the generation of particles. For example:

   1:  particleSystem.AddParticle(
            RandomHelper.Vector3Between(Vector3.Up, Vector3.Down),
            RandomHelper.Color(),
            RandomHelper.NormalizedVector3(),
            RandomHelper.Float(),
            TimeSpan.FromSeconds(RandomHelper.IntBetween(1, 3))
       );

Use the RemoveAt method to remove a particle at the given index.

Particle Emitters

Emission of particles can be automated using a particle emitter. To create a custom particle emitter, implement the IParticleEmitter interface:

   1:  public class CustomParticleEmitter : IParticleEmitter

Implementing the Update method will allow the emitter to automatically emit particles in the particle system it is added to. The Emit method can be used to emit particles manually.

An emitter can be added to any dynamic particle system:

   1:  particleSystem.AddEmitter(new CustomParticleEmitter());

Particle Affectors

A particle affector can affect one or more properties of all particles in a system. There are three default affectors in Tranquillity that use the particle’s age as the time factor:

Decelerate: Slows a particle down to a complete stop towards the end of its lifespan. This affectors affects only particles that have a velocity.
Fadeout: Reduces the alpha of a particle until it becomes completely transparent towards the end of its lifespan.
Shrink: Reduces the size of a particle until it disappears completely towards the end of its lifespan.

To create a custom particle affector, implement the IParticleAffector interface:

   1:  public class CustomParticleAffector : IParticleAffector

Implementing the Affect method will allow the affector to access the properties of the parameter particle.

An affector can be added to any dynamic particle system:

   1:  particleSystem.AddAffector(new CustomParticleAffector());

Updated Wiki: Using Tranquillity

AlexYakobovich — Mon, 19 Dec 2011 04:25:29 GMT

Using Tranquillity

Particle Manager

   1:  ParticleManager particleManager;

2:

   3:  ...

4:

   5:  public Game1()

   6:  {

   7:      ...

8:

   9:      particleManager = new ParticleManager(this);

  10:      Components.Add(particleManager);

11:

  12:      ...

  13:  }

Particle Systems

A ParticleSystem defines a group of particles that share a texture representation. There are two base particle system types in Tranquillity:

StaticParticleSystem: All particles in this system have static properties. Once a particle is added to this system type, it cannot move, grow, change color, etc. Although particles can be added and removed to/from this system on the fly, it is ideal for static allocation of particles.
DynamicParticleSystem: A dynamic particle system contains particles that can have a velocity, rotation, lifespan and can be affected by various affectors.

Creating and registering a particle system

To create a system, specify the maximum capacity and the texture to be used for this system in the LoadContent method. For example, create a dynamic particle system:

   1:  DynamicParticleSystem particleSystem = new DynamicParticleSystem(1000, texture);

The texture can be either an image or a 1x1 pixel, which can be generated on the fly:

   1:  Texture2D pixel = new Texture2D(GraphicsDevice, 1, 1);

   2:  pixel.SetData<Color>(new Color[1] { Color.White });

Add the system to the particle manager:

   1:  particleManager.AddParticleSystem(particleSystem);

Optionally, a custom BlendState can be specified:

   1:  particleManager.AddParticleSystem(particleSystem, BlendState.Additive);

Particles

The overloaded AddParticle method can be used to add particles to any system. The RandomHelper class can be used to randomize the generation of particles. For example:

   1:  particleSystem.AddParticle(
            RandomHelper.Vector3Between(Vector3.Up, Vector3.Down),
            RandomHelper.Color(),
            RandomHelper.NormalizedVector3(),
            RandomHelper.Float(),
            TimeSpan.FromSeconds(RandomHelper.IntBetween(1, 3))
       );

Use the RemoveAt method to remove a particle at the given index.

Particle Emitters

Emission of particles can be automated using a particle emitter. To create a custom particle emitter, implement the IParticleEmitter interface:

   1:  public class CustomParticleEmitter : IParticleEmitter

Implementing the Update method will allow the emitter to automatically emit particles in the particle system it is added to. The Emit method can be used to emit particles manually.

An emitter can be added to any dynamic particle system:

   1:  particleSystem.AddEmitter(new CustomParticleEmitter());

Particle Affectors

A particle affector can affect one or more properties of all particles in a system. There are three default affectors in Tranquillity that use the particle’s age as the time factor:

Decelerate: Slows a particle down to a complete stop towards the end of its lifespan. This affectors affects only particles that have a velocity.
Fadeout: Reduces the alpha of a particle until it becomes completely transparent towards the end of its lifespan.
Shrink: Reduces the size of a particle until it disappears completely towards the end of its lifespan.

To create a custom particle affectors, implement the IParticleAffector interface:

   1:  public class CustomParticleAffector : IParticleAffector

Implementing the Affect method will the affector to access the properties of the parameter particle.

An affector can be added to any dynamic particle system:

   1:  particleSystem.AddAffector(new CustomParticleAffector());

Updated Wiki: Using Tranquillity

AlexYakobovich — Mon, 19 Dec 2011 04:24:46 GMT

Using Tranquillity

Particle Manager

   1:  ParticleManager particleManager;

2:

   3:  ...

4:

   5:  public Game1()

   6:  {

   7:      ...

8:

   9:      particleManager = new ParticleManager(this);

  10:      Components.Add(particleManager);

11:

  12:      ...

  13:  }

Particle Systems

A ParticleSystem defines a group of particles that share a texture representation. There are two base particle system types in Tranquillity:

StaticParticleSystem: All particles in this system have static properties. Once a particle is added to this system type, it cannot move, grow, change color, etc. Although particles can be added and removed to/from this system on the fly, it is ideal for static allocation of particles.
DynamicParticleSystem: A dynamic particle system contains particles that can have a velocity, rotation, lifespan and can be affected by various affectors.

Creating and registering a particle system

To create a system, specify the maximum capacity and the texture to be used for this system in the LoadContent method. For example, create a dynamic particle system:

   1:  DynamicParticleSystem particleSystem = new DynamicParticleSystem(1000, texture);

The texture can be either an image or a 1x1 pixel, which can be generated on the fly:

   1:  Texture2D pixel = new Texture2D(GraphicsDevice, 1, 1);

   2:  pixel.SetData<Color>(new Color[1] { Color.White });

Add the system to the particle manager:

   1:  particleManager.AddParticleSystem(particleSystem);

Optionally, a custom BlendState can be specified:

   1:  particleManager.AddParticleSystem(particleSystem, BlendState.Additive);

Particles

The overloaded AddParticle method can be used to add particles to any system. The RandomHelper class can be used to randomize the generation of particles. For example:

   1:  particleSystem.AddParticle(
            RandomHelper.Vector3Between(Vector3.Up, Vector3.Down),
            RandomHelper.Color(),
            RandomHelper.NormalizedVector3(),
            RandomHelper.Float(),
            TimeSpan.FromSeconds(RandomHelper.IntBetween(1, 3))
       );

Use the RemoveAt method to remove a particle at the given index.

Particle Emitters

Emission of particles can be automated using a particle emitter. To create a custom particle emitter, implement the IParticleEmitter interface:

   1:  public class CustomParticleEmitter : IParticleEmitter

Implementing the Update method will allow the emitter to automatically emit particles in the particle system it is added to. The Emit method can be used to emit particles manually.

An emitter can be added to any dynamic particle system:

   1:  particleSystem.AddEmitter(new CustomParticleEmitter());

Particle Affectors

A particle affector can affect one or more properties of all particles in a system. There are three default affectors in Tranquillity that use the particle’s age as the time factor:

Decelerate: Slows a particle down to a complete stop towards the end of its lifespan. This affectors affects only particles that have a velocity.
Fadeout: Reduces the alpha of a particle until it becomes completely transparent towards the end of its lifespan.
Shrink: Reduces the size of a particle until it disappears completely invisible towards the end of its lifespan.

To create a custom particle affectors, implement the IParticleAffector interface:

   1:  public class CustomParticleAffector : IParticleAffector

Implementing the Affect method will the affector to access the properties of the parameter particle.

An affector can be added to any dynamic particle system:

   1:  particleSystem.AddAffector(new CustomParticleAffector());

Updated Wiki: Home

AlexYakobovich — Mon, 19 Dec 2011 04:20:13 GMT

Project Description
Tranquillity is a compact, easy to use and highly extendible 3D particle system for Windows Phone 7 XNA projects.

For installation/integration, check out the Getting Started Guide. To learn how to use Tranquillity check out Using Tranquillity.

The project is currently in beta; be sure to leave your comments and report bugs. You can get in touch with me on twitter (@ayakobovich).

If you end up using this project in your game, please credit by mentioning that your project particles are powered by Tranquillity.

Updated Wiki: Using Tranquillity

AlexYakobovich — Sat, 17 Dec 2011 05:52:21 GMT

Using Tranquillity

Particle Manager

   1:  ParticleManager particleManager;

2:

   3:  ...

4:

   5:  public Game1()

   6:  {

   7:      ...

8:

   9:      particleManager = new ParticleManager(this);

  10:      Components.Add(particleManager);

11:

  12:      ...

  13:  }

Particle Systems

A ParticleSystem defines a group of particles that share a texture representation. There are two base particle system types in Tranquillity:

StaticParticleSystem: All particles in this system have static properties. Once a particle is added to this system type, it cannot move, grow, change color, etc. Although particles can be added and removed to/from this system on the fly, it is ideal for static allocation of particles.
DynamicParticleSystem: A dynamic particle system contains particles that can have a velocity, rotation, lifespan and can be affected by various affectors.

Creating and registering a particle system

To create a system, specify the maximum capacity and the texture to be used for this system in the LoadContent method. For example, create a dynamic particle system:

   1:  DynamicParticleSystem particleSystem = new DynamicParticleSystem(1000, texture);

The texture can be either an image or a 1x1 pixel, which can be generated on the fly:

   1:  Texture2D pixel = new Texture2D(GraphicsDevice, 1, 1);

   2:  pixel.SetData<Color>(new Color[1] { Color.White });

Add the system to the particle manager:

   1:  particleManager.AddParticleSystem(particleSystem);

Optionally, a custom BlendState can be specified:

   1:  particleManager.AddParticleSystem(particleSystem, BlendState.Additive);

Particles

The overloaded AddParticle method can be used to add particles to any system. The RandomHelper class can be used to randomize the generation of particles. For example:

   1:  particleSystem.AddParticle(
            RandomHelper.Vector3Between(Vector3.Up, Vector3.Down),
            RandomHelper.Color(),
            RandomHelper.NormalizedVector3(),
            RandomHelper.Float(),
            TimeSpan.FromSeconds(RandomHelper.IntBetween(1, 3))
       );

Use the RemoveAt method to remove a particle at the given index.

Particle Emitters

Emission of particles can be automated using a particle emitter. To create a custom particle emitter, implement the IParticleEmitter interface:

   1:  public class CustomParticleEmitter : IParticleEmitter

Implementing the Update method will allow the emitter to automatically emit particles in the particle system it is added to. The Emit method can be used to emit particles manually.

An emitter can be added to any dynamic particle system:

   1:  particleSystem.AddEmitter(new CustomParticleEmitter());

Particle Affectors

A particle affector can affect one or more properties of all particles in a system. There are three default affectors in Tranquillity that use the particle’s age as the time factor:

Decelerate: Slows a particle down to a complete stop towards the end of its lifespan. This affectors affects only particle that have a velocity.
Fadeout: Reduces the alpha of a particle until it becomes completely transparent towards the end of its lifespan.
Shrink: Reduces the size of a particle until it disappears completely invisible towards the end of its lifespan.

To create a custom particle affectors, implement the IParticleAffector interface:

   1:  public class CustomParticleAffector : IParticleAffector

Implementing the Affect method will the affector to access the properties of the parameter particle.

An affector can be added to any dynamic particle system:

   1:  particleSystem.AddAffector(new CustomParticleAffector());

Updated Wiki: Documentation

AlexYakobovich — Sat, 17 Dec 2011 05:51:20 GMT

Getting Started

Using Tranquillity

Updated Wiki: Getting Started

AlexYakobovich — Sat, 17 Dec 2011 05:50:00 GMT

Getting Started

You have two easy options to integrate Tranquillity into your project/engine.

Reference the DLL

If you downloaded the binary release, simply copy it (and optionally the associated .xml documentation file) to a convenient location within your solution project. If you don’t already have it, it would be useful to create a “Dependencies” folder where you can keep all of your binary dependencies.

Once you copied the library file, right-click on your project and select Add Reference.

Navigate to the folder where you placed the library file, select it and press Ok.

Build from source

To work with the source code, download the Tranquillity repository in the solution directory.
To include the project in your solution, right-click on the solution, hover over Add and select Existing Project.

Navigate to the Tranquillity folder in your solution folder, select Tranquillity.csproj and press Ok.
Once the Tranquillity project is included in your solution, right-click your game/engine project’s Reference and select Add Reference.

Select Tranquillity under the Projects tab and press Ok.

You’re done! Check out Using Tranquillity to learning how to use it.

Updated Wiki: Getting Started

AlexYakobovich — Sat, 17 Dec 2011 05:49:13 GMT

Getting Started

You have two easy options to integrate Tranquillity into your project/engine.

Reference the DLL

Build from source

You’re done! Check out Using Tranquillity to get started with the code.

Updated Wiki: Documentation

AlexYakobovich — Sat, 17 Dec 2011 05:47:19 GMT

Getting Started

You have two easy options to integrate Tranquillity into your project/engine.

Reference the DLL

Build from source

You’re done! Check out Using Tranquillity to get started with the code.

Updated Wiki: Home

AlexYakobovich — Sat, 17 Dec 2011 05:45:50 GMT

Project Description
Tranquillity is a compact, easy to use and highly extendible 3D particle system for Windows Phone 7 XNA projects.

For installation/integration, check out the Getting Started Guide. To learn how to use Tranquillity check out Using Tranquillity.

The project is currently in beta; be sure to leave your comments and report bugs. You can get in touch with me on twitter (@ayakobovich).

If you end up using this project in your game, please credit by mentioning that your project particles are powered by Tranquillity.

Updated Wiki: Home

AlexYakobovich — Sat, 17 Dec 2011 05:45:19 GMT

Project Description
Tranquillity is a compact, easy to use and highly extendible 3D particle system for Windows Phone 7 XNA projects.

For installation/integration, check out the Getting Started Guide. To learn how to use Tranquillity check out Using Tranquillity.

The project is currently in beta; be sure to leave your comments and report bugs. You can get in touch with me on twitter (@ayakobovich).

If you end up using this project in your game, please credit by mentioning that your project particles are powered by Tranquillity.

Updated Wiki: Using Tranquillity

AlexYakobovich — Sat, 17 Dec 2011 05:43:31 GMT

Using Tranquillity

Particle Manager

   1:  ParticleManager particleManager;

2:

   3:  ...

4:

   5:  public Game1()

   6:  {

   7:      ...

8:

   9:      particleManager = new ParticleManager(this);

  10:      Components.Add(particleManager);

11:

  12:      ...

  13:  }

Particle Systems

A ParticleSystem defines a group of particles that share a texture representation. There are two base particle system types in Tranquillity:

StaticParticleSystem: All particles in this system have static properties. Once a particle is added to this system type, it cannot move, grow, change color, etc. Although particles can be added and removed to/from this system on the fly, it is ideal for static allocation of particles.
DynamicParticleSystem: A dynamic particle system contains particles that can have a velocity, rotation, lifespan and can be affected by various affectors.

Creating and registering a particle system

To create a system, specify the maximum capacity and the texture to be used for this system in the LoadContent method. For example, create a dynamic particle system:

   1:  DynamicParticleSystem particleSystem = new DynamicParticleSystem(1000, texture);

The texture can be either an image or a 1x1 pixel, which can be generated on the fly:

   1:  Texture2D pixel = new Texture2D(GraphicsDevice, 1, 1);

   2:  pixel.SetData<Color>(new Color[1] { Color.White });

Add the system to the particle manager:

   1:  particleManager.AddParticleSystem(particleSystem);

Optionally, a custom BlendState can be specified:

   1:  particleManager.AddParticleSystem(particleSystem, BlendState.Additive);

Particles

The overloaded AddParticle method can be used to add particles to any system. The RandomHelper class can be used to randomize the generation of particles. For example:

   1:  particleSystem.AddParticle(
            RandomHelper.Vector3Between(Vector3.Up, Vector3.Down),
            RandomHelper.Color(),
            RandomHelper.NormalizedVector3(),
            RandomHelper.Float(),
            TimeSpan.FromSeconds(RandomHelper.IntBetween(1, 3))
       );

Use the RemoveAt method to remove a particle at the given index.

Particle Emitters

Emission of particles can be automated using a particle emitter. To create a custom particle emitter, implement the IParticleEmitter interface:

   1:  public class CustomParticleEmitter : IParticleEmitter

Implementing the Update method will allow the emitter to automatically emit particles in the particle system it is added to. The Emit method can be used to emit particles manually.

An emitter can be added to any dynamic particle system:

   1:  particleManager.AddEmitter(new CustomParticleEmitter());

Particle Affectors

A particle affector can affect one or more properties of all particles in a system. There are three default affectors in Tranquillity that use the particle’s age as the time factor:

Decelerate: Slows a particle down to a complete stop towards the end of its lifespan. This affectors affects only particle that have a velocity.
Fadeout: Reduces the alpha of a particle until it becomes completely transparent towards the end of its lifespan.
Shrink: Reduces the size of a particle until it disappears completely invisible towards the end of its lifespan.

To create a custom particle affectors, implement the IParticleAffector interface:

   1:  public class CustomParticleAffector : IParticleAffector

Implementing the Affect method will the affector to access the properties of the parameter particle.

An affector can be added to any dynamic particle system:

   1:  particleManager.AddAffector(new CustomParticleAffector());

Updated Wiki: Using Tranquillity

AlexYakobovich — Sat, 17 Dec 2011 05:42:49 GMT

Using Tranquillity

Particle Manager

   1:  ParticleManager particleManager;

2:

   3:  ...

4:

   5:  public Game1()

   6:  {

   7:      ...

8:

   9:      particleManager = new ParticleManager(this);

  10:      Components.Add(particleManager);

11:

  12:      ...

  13:  }

Particle Systems

A ParticleSystem defines a group of particles that share a texture representation. There are two base particle system types in Tranquillity:

StaticParticleSystem: All particles in this system have static properties. Once a particle is added to this system type, it cannot move, grow, change color, etc. Although particles can be added and removed to/from this system on the fly, it is ideal for static allocation of particles.
DynamicParticleSystem: A dynamic particle system contains particles that can have a velocity, rotation, lifespan and can be affected by various affectors.

Creating and registering a particle system

To create a system, specify the maximum capacity and the texture to be used for this system in the LoadContent method. For example, create a dynamic particle system:

   1:  DynamicParticleSystem particleSystem = new DynamicParticleSystem(1000, texture);

The texture can be either an image or a 1x1 pixel, which can be generated on the fly:

   1:  Texture2D pixel = new Texture2D(GraphicsDevice, 1, 1);

   2:  pixel.SetData<Color>(new Color[1] { Color.White });

Add the system to the particle manager:

   1:  particleManager.AddParticleSystem(particleSystem);

Optionally, a custom BlendState can be specified:

   1:  particleManager.AddParticleSystem(particleSystem, BlendState.Additive);

Particles

The overloaded AddParticle method can be used to add particles to any system. The RandomHelper class can be used to randomize the generation of particles. For example:

   1:  particleSystem.AddParticle(
            RandomHelper.Vector3Between(Vector3.Up, Vector3.Down),
            RandomHelper.Color(),
            RandomHelper.NormalizedVector3(),
            RandomHelper.Float(),
            TimeSpan.FromSeconds(RandomHelper.IntBetween(1, 3))
       );

Use the RemoveAt method to remove a particle at the given index.

Particle Emitters

Emission of particles can be automated using a particle emitter. To create a custom particle emitter, implement the IParticleEmitter interface:

   1:  public class CustomParticleEmitter : IParticleEmitter

Implementing the Update method will allow the emitter to automatically emit particles in the particle system it is added to. The Emit method can be used to emit particles manually.

An emitter can be added to any dynamic particle system:

   1:  particleManager.AddEmitter(new CustomParticleEmitter());

Particle Affectors

A particle affector can affect one or more properties of all particles in a system. There are three default affectors in Tranquillity that use the particle’s age as the time factor:

Decelerate: Slows a particle down to a complete stop towards the end of its lifespan. This affectors affects only particle that have a velocity.
Fadeout: Reduces the alpha of a particle until it becomes completely transparent towards the end of its lifespan.
Shrink: Reduces the size of a particle until it disappears completely invisible towards the end of its lifespan.

To create a custom particle affectors, implement the IParticleAffector interface:

   1:  public class CustomParticleAffector : IParticleAffector

Implementing the Affect method will the affector to access the properties of the parameter particle.

An affector can be added to any dynamic particle system:

   1:  particleManager.AddAffector(new CustomParticleAffector());

Updated Wiki: Using Tranquillity

AlexYakobovich — Sat, 17 Dec 2011 05:39:07 GMT

Using Tranquillity

Particle Manager

   1:  ParticleManager particleManager;

2:

   3:  ...

4:

   5:  public Game1()

   6:  {

   7:      ...

8:

   9:      particleManager = new ParticleManager(this);

  10:      Components.Add(particleManager);

11:

  12:      ...

  13:  }

Particle Systems

A ParticleSystem defines a group of particles that share a texture representation. There are two base particle system types in Tranquillity:

StaticParticleSystem: All particles in this system have static properties. Once a particle is added to this system type, it cannot move, grow, change color, etc. Although particles can be added and removed to/from this system on the fly, it is ideal for static allocation of particles.
DynamicParticleSystem: A dynamic particle system contains particles that can have a velocity, rotation, lifespan and can be affected by various affectors.

Creating and registering a particle system

To create a system, specify the maximum capacity and the texture to be used for this system in the LoadContent method. For example, create a dynamic particle system:

   1:  DynamicParticleSystem particleSystem = new DynamicParticleSystem(1000, texture);

The texture can be either an image or a 1x1 pixel, which can be generated on the fly:

   1:  Texture2D pixel = new Texture2D(GraphicsDevice, 1, 1);

   2:  pixel.SetData<Color>(new Color[1] { Color.White });

Add the system to the particle manager:

   1:  particleManager.AddParticleSystem(particleSystem);

Optionally, a custom BlendState can be specified:

   1:  particleManager.AddParticleSystem(particleSystem, BlendState.Additive);

Particles

The overloaded AddParticle method can be used to add particles to any system. The RandomHelper class can be used to randomize the generation of particles. For example:

   1:  particleSystem.AddParticle(
            RandomHelper.Vector3Between(Vector3.Up, Vector3.Down),
            RandomHelper.Color(),
            RandomHelper.NormalizedVector3(),
            RandomHelper.Float(),
            TimeSpan.FromSeconds(RandomHelper.IntBetween(1, 3))
       );

Use the RemoveAt method to remove a particle at the given index.

Particle Emitters

Emission of particles can be automated using a particle emitter. To create a custom particle emitter, implement the IParticleEmitter interface:

   1:  public class CustomParticleEmitter : IParticleEmitter

Implementing the Update method will allow the emitter to automatically emit particles in the particle system it is added to. The Emit method can be used to emit particles manually.

An emitter can be added to any dynamic particle system:

   1:  particleManager.AddEmitter(new CustomParticleEmitter());

Particle Affectors

A particle affector can affect one or more properties of all particles in a system. There are three default affectors in Tranquillity that use the particle’s age as the time factor:

Decelerate: Slows a particle down to a complete stop towards the end of its lifespan. This affectors affects only particle that have a velocity.
Fadeout: Reduces the alpha of a particle until it becomes completely transparent towards the end of its lifespan.
Shrink: Reduces the size of a particle until it disappears completely invisible towards the end of its lifespan.

To create a custom particle affectors, implement the IParticleAffector interface:

   1:  public class CustomParticleAffector : IParticleAffector

Implementing the Affect method will the affector to access the properties of the parameter particle.

An affector can be added to any dynamic particle system:

   1:  particleManager.AddAffector(new CustomParticleAffector());

Updated Wiki: Temporary Post Used For Theme Detection (cc5e704c-54e0-4a13-91e8-3d78cfb4d6a6 - 3bfe001a-32de-4114-a6b4-4005b770f6d7)

AlexYakobovich — Fri, 16 Dec 2011 22:00:26 GMT

This is a temporary post that was not deleted. Please delete this manually. (208b3e3e-ca19-4ff1-81ed-9a42e84e0a49 - 3bfe001a-32de-4114-a6b4-4005b770f6d7)

Updated Wiki: Using Tranquillity

AlexYakobovich — Fri, 16 Dec 2011 06:36:00 GMT

Using Tranquillity

All particle properties, behavior and drawing are managed by Tranquillity’s ParticleManager.

Particle Manager

ParticleManager is a DrawableGameComponent that can simply be added to your Game’s component collection.

   1:  ParticleManager particleManager;

2:

   3:  ...

4:

   5:  public Game1()

   6:  {

   7:      ...

8:

   9:      particleManager = new ParticleManager(this);

  10:      Components.Add(particleManager);

11:

  12:      ...

  13:  }

Particle Systems

A ParticleSystem defines a group of particles that share a texture representation. There are two base particle system types in Tranquillity:

StaticParticleSystem: As the name implies, all particles in this system have static properties. Once a particle is added to this system type, it cannot move, grow, change color, etc. Although particles can be added and removed to/from this system on the fly, it is ideal for static allocation of particles.
DynamicParticleSystem: A dynamic particle system contains particles that can have a velocity, rotation, lifespan and can be affected by various affectors.

Creating and registering a particle system

To create a system, specify the maximum capacity and the texture to be used for this system in the LoadContent() method. For example, create a dynamic particle system:

   1:  DynamicParticleSystem particleSystem = new DynamicParticleSystem(1000, texture);

The texture can be either an image or a 1x1 pixel, which can be generated on the fly:

   1:  Texture2D pixel = new Texture2D(GraphicsDevice, 1, 1);

   2:  pixel.SetData<Color>(new Color[1] { Color.White });

Add the system to the particle manager:

   1:  particleManager.AddParticleSystem(particleSystem);

Optionally, a custom BlendState can be specified:

   1:  particleManager.AddParticleSystem(particleSystem, BlendState.Additive);

Particles

The overloaded AddParticle method can be used to add particles to any system. The RandomHelper class can be used to randomize the generation of particles. For example:

   1:  particleSystem.AddParticle(
            RandomHelper.Vector3Between(Vector3.Up, Vector3.Down),
            RandomHelper.Color(),
            RandomHelper.NormalizedVector3(),
            RandomHelper.Float(),
            TimeSpan.FromSeconds(RandomHelper.IntBetween(1, 3))
       );

Use the RemoveAt method to remove a particle at the given index.

Updated Wiki: Using Tranquillity

AlexYakobovich — Fri, 16 Dec 2011 06:30:36 GMT

Using Tranquillity

All particle properties, behavior and drawing are managed by Tranquillity’s ParticleManager.

Particle Manager

ParticleManager is a DrawableGameComponent that can simply be added to your Game’s component collection.

   1:  ParticleManager particleManager;

2:

   3:  ...

4:

   5:  public Game1()

   6:  {

   7:      ...

8:

   9:      particleManager = new ParticleManager(this);

  10:      Components.Add(particleManager);

11:

  12:      ...

  13:  }

Particle Systems

A ParticleSystem defines a group of particles that share a texture representation. There are two base particle system types in Tranquillity:

StaticParticleSystem: As the name implies, all particles in this system have static properties. Once a particle is added to this system type, it cannot move, grow, change color, etc. Although particles can be added and removed to/from this system on the fly, it is ideal for static allocation of particles.
DynamicParticleSystem: A dynamic particle system contains particles that can have a velocity, rotation, lifespan and can be affected by various affectors.

Creating and registering a particle system

To create a system, specify the maximum capacity and the texture to be used for this system in the LoadContent() method. For example, create a dynamic particle system:

   1:  DynamicParticleSystem particleSystem = new DynamicParticleSystem(1000, texture);

The texture can be either an image or a 1x1 pixel, which can be generated on the fly:

   1:  Texture2D pixel = new Texture2D(GraphicsDevice, 1, 1);

   2:  pixel.SetData<Color>(new Color[1] { Color.White });

Add the system to the particle manager:

   1:  particleManager.AddParticleSystem(explosionParticleSystem);

Particles

The overloaded AddParticle method can be used to add particles to any system. The RandomHelper class can be used to randomize the generation of particles. For example:

   1:  particleSystem.AddParticle(
            RandomHelper.Vector3Between(Vector3.Up, Vector3.Down),
            RandomHelper.Color(),
            RandomHelper.NormalizedVector3(),
            RandomHelper.Float(),
            TimeSpan.FromSeconds(RandomHelper.IntBetween(1, 3)));

Use the RemoveAt method to remove a particle at the given index.