Obsolete Particle Functions

These functions deal with the manipulation of particles.

The following functions for particle attractors have been removed:

FunctionDescription
part_attractor_createCreates a new attractor in the given particle system. It returns the index of the attractor. This index must be used in all calls below to set the properties of the attractor.
part_attractor_destroyDestroys attractor ind in the particle system. Call this if you don't need it anymore to save space.
part_attractor_destroy_allDestroys all attractors in the particle system that have been created.
part_attractor_exists Returns whether the indicated attractor exists in the particle system.
part_attractor_clearClears the attractor ind to its default settings.
part_attractor_positionSets the position of attractor ind to (x,y).
part_attractor_forceSets the force parameters of attractor ind.

The following functions for particle changers have been removed:

FunctionDescription
part_changer_createCreates a new changer in the given particle system. It returns the index of the changer. This index must be used in all calls below to set the properties of the changer.
part_changer_destroyDestroys changer ind in the particle system. Call this if you don't need it anymore to save space.
part_changer_destroy_allDestroys all changers in the particle system that have been created.
part_changer_existsReturns whether the indicated changer exists in the particle system.
part_changer_clearClears the changer ind to its default settings.
part_changer_regionSets the region for the changer.
part_changer_typesSets which particle type the changer must change into what other type.
part_changer_kindSets the kind for the changer.

The following functions for particle deflectors have been removed:

FunctionDescription
part_deflector_createCreates a new deflector in the given particle system. It returns the index of the deflector. This index must be used in all calls below to set the properties of the deflector.
part_deflector_destroyDestroys deflector ind in the particle system. Call this if you don't need it anymore to save space.
part_deflector_destroy_allDestroys all deflectors in the particle system that have been created.
part_deflector_existsReturns whether the indicated deflector exists in the particle system.
part_deflector_clearClears the deflector ind to its default settings.
part_deflector_regionSets the region for the deflector.
part_deflector_kindSets the kind for the deflector.
part_deflector_frictionSets the friction for the deflector.

The following functions for particle destroyers have been removed:

FunctionDescription
part_destroyer_createCreates a new destroyer in the given particle system. It returns the index of the destroyer. This index must be used in all calls below to set the properties of the destroyer.
part_destroyer_destroyDestroys destroyer ind in the particle system. Call this if you don't need it anymore to save space.
part_destroyer_destroy_allDestroys all destroyers in the particle system that have been created.
part_destroyer_existsReturns whether the indicated destroyer exists in the particle system.
part_destroyer_clearClears the destroyer ind to its default settings.
part_destroyer_regionSets the region for the destroyer.

Why These Are Obsolete

Particles are normally very fast to process due to the fact that they are normally just graphical effects which, once fired off, are left to do their own thing based on the parameters set for them when you created the system. These routines, however, could be used to change particle properties after they have been created in a game, which means that each particle has to be tracked and dealt with in an individual manner. As this is horribly slow and defeats the purpose of particles (as they are meant to be used for fast graphical effects)


Back: Obsolete Functions
Next: Sound Functions

© Copyright YoYo Games Ltd. 2018 All Rights Reserved