/usr/include/OGRE/OgreParticleAffector.h is in libogre-dev 1.7.4+dfsg1-7.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 | /*
-----------------------------------------------------------------------------
This source file is part of OGRE
(Object-oriented Graphics Rendering Engine)
For the latest info, see http://www.ogre3d.org/
Copyright (c) 2000-2011 Torus Knot Software Ltd
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.
-----------------------------------------------------------------------------
*/
#ifndef __ParticleAffector_H__
#define __ParticleAffector_H__
#include "OgrePrerequisites.h"
#include "OgreString.h"
#include "OgreStringInterface.h"
namespace Ogre {
/** \addtogroup Core
* @{
*/
/** \addtogroup Effects
* @{
*/
/** Abstract class defining the interface to be implemented by particle affectors.
@remarks
Particle affectors modify particles in a particle system over their lifetime. They can be
grouped into types, e.g. 'vector force' affectors, 'fader' affectors etc; each type will
modify particles in a different way, using different parameters.
@par
Because there are so many types of affectors you could use, OGRE chooses not to dictate
the available types. It comes with some in-built, but allows plugins or applications to extend the affector types available.
This is done by subclassing ParticleAffector to have the appropriate emission behaviour you want,
and also creating a subclass of ParticleAffectorFactory which is responsible for creating instances
of your new affector type. You register this factory with the ParticleSystemManager using
addAffectorFactory, and from then on affectors of this type can be created either from code or through
text particle scripts by naming the type.
@par
This same approach is used for ParticleEmitters (which are the source of particles in a system).
This means that OGRE is particularly flexible when it comes to creating particle system effects,
with literally infinite combinations of affector and affector types, and parameters within those
types.
*/
class _OgreExport ParticleAffector : public StringInterface, public FXAlloc
{
protected:
/// Name of the type of affector, MUST be initialised by subclasses
String mType;
/** Internal method for setting up the basic parameter definitions for a subclass.
@remarks
Because StringInterface holds a dictionary of parameters per class, subclasses need to
call this to ask the base class to add it's parameters to their dictionary as well.
Can't do this in the constructor because that runs in a non-virtual context.
@par
The subclass must have called it's own createParamDictionary before calling this method.
*/
void addBaseParameters(void) { /* actually do nothing - for future possible use */ }
ParticleSystem* mParent;
public:
ParticleAffector(ParticleSystem* parent): mParent(parent) {}
/** Virtual destructor essential. */
virtual ~ParticleAffector();
/** Method called to allow the affector to initialize all newly created particles in the system.
@remarks
This is where the affector gets the chance to initialize it's effects to the particles of a system.
The affector is expected to initialize some or all of the particles in the system
passed to it, depending on the affector's approach.
@param
pParticle Pointer to a Particle to initialize.
*/
virtual void _initParticle(Particle* pParticle)
{
/* by default do nothing */
(void)pParticle;
}
/** Method called to allow the affector to 'do it's stuff' on all active particles in the system.
@remarks
This is where the affector gets the chance to apply it's effects to the particles of a system.
The affector is expected to apply it's effect to some or all of the particles in the system
passed to it, depending on the affector's approach.
@param
pSystem Pointer to a ParticleSystem to affect.
@param
timeElapsed The number of seconds which have elapsed since the last call.
*/
virtual void _affectParticles(ParticleSystem* pSystem, Real timeElapsed) = 0;
/** Returns the name of the type of affector.
@remarks
This property is useful for determining the type of affector procedurally so another
can be created.
*/
const String &getType(void) const { return mType; }
};
/** @} */
/** @} */
}
#endif
|