ParticleEmitter (libGDX Core 1.6.0 API)

java.lang.Object
- com.badlogic.gdx.graphics.g2d.ParticleEmitter

public class ParticleEmitter
extends Object

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`ParticleEmitter.GradientColorValue`
`static class`	`ParticleEmitter.NumericValue`
`static class`	`ParticleEmitter.Particle`
`static class`	`ParticleEmitter.ParticleValue`
`static class`	`ParticleEmitter.RangedNumericValue`
`static class`	`ParticleEmitter.ScaledNumericValue`
`static class`	`ParticleEmitter.SpawnEllipseSide`
`static class`	`ParticleEmitter.SpawnShape`
`static class`	`ParticleEmitter.SpawnShapeValue`

Field Summary

Fields
Modifier and Type Field and Description

float duration

float durationTimer

Fields
Modifier and Type	Field and Description
`float`	`duration`
`float`	`durationTimer`

Constructor Summary

Constructors
Constructor and Description

ParticleEmitter()

ParticleEmitter(BufferedReader reader)

ParticleEmitter(ParticleEmitter emitter)

Constructors
Constructor and Description
`ParticleEmitter()`
`ParticleEmitter(BufferedReader reader)`
`ParticleEmitter(ParticleEmitter emitter)`

Method Summary

Methods
Modifier and Type	Method and Description
`void`	`addParticle()`
`void`	`addParticles(int count)`
`void`	`allowCompletion()` Ignores the `continuous` setting until the emitter is started again.
`boolean`	`cleansUpBlendFunction()`
`void`	`draw(Batch batch)`
`void`	`draw(Batch batch, float delta)` Updates and draws the particles.
`void`	`flipY()`
`int`	`getActiveCount()`
`ParticleEmitter.ScaledNumericValue`	`getAngle()`
`BoundingBox`	`getBoundingBox()` Returns the bounding box for all active particles.
`ParticleEmitter.RangedNumericValue`	`getDelay()`
`ParticleEmitter.RangedNumericValue`	`getDuration()`
`ParticleEmitter.ScaledNumericValue`	`getEmission()`
`ParticleEmitter.ScaledNumericValue`	`getGravity()`
`String`	`getImagePath()`
`ParticleEmitter.ScaledNumericValue`	`getLife()`
`ParticleEmitter.ScaledNumericValue`	`getLifeOffset()`
`int`	`getMaxParticleCount()`
`int`	`getMinParticleCount()`
`String`	`getName()`
`float`	`getPercentComplete()`
`ParticleEmitter.ScaledNumericValue`	`getRotation()`
`ParticleEmitter.ScaledNumericValue`	`getScale()`
`ParticleEmitter.ScaledNumericValue`	`getSpawnHeight()`
`ParticleEmitter.SpawnShapeValue`	`getSpawnShape()`
`ParticleEmitter.ScaledNumericValue`	`getSpawnWidth()`
`Sprite`	`getSprite()`
`ParticleEmitter.GradientColorValue`	`getTint()`
`ParticleEmitter.ScaledNumericValue`	`getTransparency()`
`ParticleEmitter.ScaledNumericValue`	`getVelocity()`
`ParticleEmitter.ScaledNumericValue`	`getWind()`
`float`	`getX()`
`ParticleEmitter.RangedNumericValue`	`getXOffsetValue()`
`float`	`getY()`
`ParticleEmitter.RangedNumericValue`	`getYOffsetValue()`
`boolean`	`isAdditive()`
`boolean`	`isAligned()`
`boolean`	`isAttached()`
`boolean`	`isBehind()`
`boolean`	`isComplete()`
`boolean`	`isContinuous()`
`boolean`	`isPremultipliedAlpha()`
`void`	`load(BufferedReader reader)`
`void`	`reset()`
`void`	`save(Writer output)`
`void`	`setAdditive(boolean additive)`
`void`	`setAligned(boolean aligned)`
`void`	`setAttached(boolean attached)`
`void`	`setBehind(boolean behind)`
`void`	`setCleansUpBlendFunction(boolean cleansUpBlendFunction)` Set whether to automatically return the `Batch`'s blend function to the alpha-blending default (GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA) when done drawing.
`void`	`setContinuous(boolean continuous)`
`void`	`setFlip(boolean flipX, boolean flipY)`
`void`	`setImagePath(String imagePath)`
`void`	`setMaxParticleCount(int maxParticleCount)`
`void`	`setMinParticleCount(int minParticleCount)`
`void`	`setName(String name)`
`void`	`setPosition(float x, float y)`
`void`	`setPremultipliedAlpha(boolean premultipliedAlpha)`
`void`	`setSprite(Sprite sprite)`
`void`	`start()`
`void`	`update(float delta)`

Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

duration
```
public float duration
```

durationTimer
```
public float durationTimer
```

Constructor Detail

ParticleEmitter
```
public ParticleEmitter()
```

ParticleEmitter

public ParticleEmitter(BufferedReader reader)
                throws IOException

Throws:: IOException

ParticleEmitter

public ParticleEmitter(ParticleEmitter emitter)

Method Detail

setMaxParticleCount

public void setMaxParticleCount(int maxParticleCount)

addParticle
```
public void addParticle()
```

addParticles
```
public void addParticles(int count)
```

update
```
public void update(float delta)
```

draw
```
public void draw(Batch batch)
```

draw
```
public void draw(Batch batch,
        float delta)
```
Updates and draws the particles. This is slightly more efficient than calling update(float) and draw(Batch) separately.

start
```
public void start()
```

reset
```
public void reset()
```

setPosition

public void setPosition(float x,
               float y)

setSprite
```
public void setSprite(Sprite sprite)
```

allowCompletion
```
public void allowCompletion()
```
Ignores the continuous setting until the emitter is started again. This allows the emitter to stop smoothly.

getSprite
```
public Sprite getSprite()
```

getName
```
public String getName()
```

setName
```
public void setName(String name)
```

getLife

public ParticleEmitter.ScaledNumericValue getLife()

getScale

public ParticleEmitter.ScaledNumericValue getScale()

getRotation

public ParticleEmitter.ScaledNumericValue getRotation()

getTint

public ParticleEmitter.GradientColorValue getTint()

getVelocity

public ParticleEmitter.ScaledNumericValue getVelocity()

getWind

public ParticleEmitter.ScaledNumericValue getWind()

getGravity

public ParticleEmitter.ScaledNumericValue getGravity()

getAngle

public ParticleEmitter.ScaledNumericValue getAngle()

getEmission

public ParticleEmitter.ScaledNumericValue getEmission()

getTransparency

public ParticleEmitter.ScaledNumericValue getTransparency()

getDuration

public ParticleEmitter.RangedNumericValue getDuration()

getDelay

public ParticleEmitter.RangedNumericValue getDelay()

getLifeOffset

public ParticleEmitter.ScaledNumericValue getLifeOffset()

getXOffsetValue

public ParticleEmitter.RangedNumericValue getXOffsetValue()

getYOffsetValue

public ParticleEmitter.RangedNumericValue getYOffsetValue()

getSpawnWidth

public ParticleEmitter.ScaledNumericValue getSpawnWidth()

getSpawnHeight

public ParticleEmitter.ScaledNumericValue getSpawnHeight()

getSpawnShape

public ParticleEmitter.SpawnShapeValue getSpawnShape()

isAttached
```
public boolean isAttached()
```

setAttached

public void setAttached(boolean attached)

isContinuous
```
public boolean isContinuous()
```

setContinuous

public void setContinuous(boolean continuous)

isAligned
```
public boolean isAligned()
```

setAligned

public void setAligned(boolean aligned)

isAdditive
```
public boolean isAdditive()
```

setAdditive

public void setAdditive(boolean additive)

cleansUpBlendFunction
```
public boolean cleansUpBlendFunction()
```
Returns:
Whether this ParticleEmitter automatically returns the Batch's blend function to the alpha-blending default (GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA) when done drawing.

setCleansUpBlendFunction
```
public void setCleansUpBlendFunction(boolean cleansUpBlendFunction)
```
Set whether to automatically return the Batch's blend function to the alpha-blending default (GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA) when done drawing. Is true by default. If set to false, the Batch's blend function is left as it was for drawing this ParticleEmitter, which prevents the Batch from being flushed repeatedly if consecutive ParticleEmitters with the same additive or pre-multiplied alpha state are drawn in a row.
IMPORTANT: If set to false and if the next object to use this Batch expects alpha blending, you are responsible for setting the Batch's blend function to (GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA) before that next object is drawn.

Parameters:
cleansUpBlendFunction -

isBehind
```
public boolean isBehind()
```

setBehind

public void setBehind(boolean behind)

isPremultipliedAlpha
```
public boolean isPremultipliedAlpha()
```

setPremultipliedAlpha

public void setPremultipliedAlpha(boolean premultipliedAlpha)

getMinParticleCount
```
public int getMinParticleCount()
```

setMinParticleCount

public void setMinParticleCount(int minParticleCount)

getMaxParticleCount
```
public int getMaxParticleCount()
```

isComplete
```
public boolean isComplete()
```

getPercentComplete
```
public float getPercentComplete()
```

getX
```
public float getX()
```

getY
```
public float getY()
```

getActiveCount
```
public int getActiveCount()
```

getImagePath
```
public String getImagePath()
```

setImagePath

public void setImagePath(String imagePath)

setFlip

public void setFlip(boolean flipX,
           boolean flipY)

flipY
```
public void flipY()
```

getBoundingBox
```
public BoundingBox getBoundingBox()
```
Returns the bounding box for all active particles. z axis will always be zero.

save

public void save(Writer output)
          throws IOException

Throws:: IOException

load

public void load(BufferedReader reader)
          throws IOException

Throws:: IOException

Class ParticleEmitter

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

duration

durationTimer

Constructor Detail

ParticleEmitter

ParticleEmitter

ParticleEmitter

Method Detail

setMaxParticleCount

addParticle

addParticles

update

draw

draw

start

reset

setPosition

setSprite

allowCompletion

getSprite

getName

setName

getLife

getScale

getRotation

getTint

getVelocity

getWind

getGravity

getAngle

getEmission

getTransparency

getDuration

getDelay

getLifeOffset

getXOffsetValue

getYOffsetValue

getSpawnWidth

getSpawnHeight

getSpawnShape

isAttached

setAttached

isContinuous

setContinuous

isAligned

setAligned

isAdditive

setAdditive

cleansUpBlendFunction

setCleansUpBlendFunction

isBehind

setBehind

isPremultipliedAlpha

setPremultipliedAlpha

getMinParticleCount

setMinParticleCount

getMaxParticleCount

isComplete

getPercentComplete

getX

getY

getActiveCount

getImagePath

setImagePath

setFlip

flipY

getBoundingBox

save

load