1 files changed, 61 insertions, 0 deletions
diff --git a/engine/src/core/com/jme3/effect/influencers/ParticleInfluencer.java b/engine/src/core/com/jme3/effect/influencers/ParticleInfluencer.java
new file mode 100644
index 0000000..56c8cf9
--- /dev/null
+++ b/engine/src/core/com/jme3/effect/influencers/ParticleInfluencer.java
@@ -0,0 +1,61 @@
+package com.jme3.effect.influencers;
+
+import com.jme3.effect.Particle;
+import com.jme3.effect.ParticleEmitter;
+import com.jme3.effect.shapes.EmitterShape;
+import com.jme3.export.Savable;
+import com.jme3.math.Vector3f;
+
+/**
+ * An interface that defines the methods to affect initial velocity of the particles.
+ * @author Marcin Roguski (Kaelthas)
+ */
+public interface ParticleInfluencer extends Savable, Cloneable {
+
+    /**
+     * This method influences the particle.
+     * @param particle
+     *        particle to be influenced
+     * @param emitterShape
+     *        the shape of it emitter
+     */
+    void influenceParticle(Particle particle, EmitterShape emitterShape);
+
+    /**
+     * This method clones the influencer instance.
+     * @return cloned instance
+     */
+    public ParticleInfluencer clone();
+
+    /**
+     * @param initialVelocity
+     *        Set the initial velocity a particle is spawned with,
+     *        the initial velocity given in the parameter will be varied according
+     *        to the velocity variation set in {@link ParticleEmitter#setVelocityVariation(float) }.
+     *        A particle will move toward its velocity unless it is effected by the
+     *        gravity.
+     */
+    void setInitialVelocity(Vector3f initialVelocity);
+
+    /**
+     * This method returns the initial velocity.
+     * @return the initial velocity
+     */
+    Vector3f getInitialVelocity();
+
+    /**
+     * @param variation
+     *        Set the variation by which the initial velocity
+     *        of the particle is determined. <code>variation</code> should be a value
+     *        from 0 to 1, where 0 means particles are to spawn with exactly
+     *        the velocity given in {@link ParticleEmitter#setStartVel(com.jme3.math.Vector3f) },
+     *        and 1 means particles are to spawn with a completely random velocity.
+     */
+    void setVelocityVariation(float variation);
+
+    /**
+     * This method returns the velocity variation.
+     * @return the velocity variation
+     */
+    float getVelocityVariation();
+}