Behavior element behavior adding particle emitter support.

Behavior adds a ParticleEmitter resource to the the behavior element.

If the ECBehaviorCollider behavior is present in the behavior element before this behavior is added the particle emitter is attached. The particle emitter is attached to the named bone if defined otherwise it is attached statically.

See also:

• Particle Emitters
• IGDE Particle Emitter Editor

This behavior can be added multiple times to an element. Each instance creates one particle emitter attached to the element collider which can be individually modified.

Element class properties have the prefix particleEmitter. or particleEmitter({id}). if id is not empty.

Set path to particle emitter resource to use.

• Full name: particleEmitter.path or particleEmitter({id}).path
• Type: string
• Default Value: empty string
• Expected File Pattern: *.depemit
• Example (*.deeclass)

  <string name='particleEmitter.path'>fire.depemit</string>

Set time scale for controllers advanced by time.

• Full name: particleEmitter.timeScale or particleEmitter({id}).timeScale
• Type: float
• Default Value: 1
• Example (*.deeclass)

  <float name='particleEmitter.timeScale'>0.5</float>

Set warm up time in seconds. If larger than 0 particle emitter starts with particles already simulated this many seconds.

• Full name: particleEmitter.warmUpTime or particleEmitter({id}).warmUpTime
• Type: float
• Default Value: 0
• Example (*.deeclass)

  <float name='particleEmitter.warmUpTime'>2</float>

Set particle emitter is casting particles.

• Full name: particleEmitter.casting or particleEmitter({id}).casting
• Type: boolean
• Default Value: true
• Example (*.deeclass)

  <boolean name='particleEmitter.casting'>false</boolean>

Set position to attach resource to collider.

• Full name: particleEmitter.position or particleEmitter({id}).position
• Type: 3-component float vector
• Default Value: (0,0,0)
• Example (*.deeclass)

  <vector name='particleEmitter.position' x='0' y='0' z='0.1'/>

Set orientation to attach resource to collider in degrees.

• Full name: particleEmitter.orientation or particleEmitter({id}).orientation
• Type: 3-component float vector
• Default Value: (0,0,0)
• Example (*.deeclass)

  <vector name='particleEmitter.orientation' x='30' y='0' z='0'/>

Set bone to attach resource to. If empty string attach to collider.

• Full name: particleEmitter.bone or particleEmitter({id}).bone
• Type: string
• Default Value: empty string
• Example (*.deeclass)

  <string name='particleEmitter.bone'>attach</string>

Set trigger casting. If no trigger is set the state of casting property is used.

• Full name: particleEmitter.trigger or particleEmitter({id}).trigger
• Type: string
• Default Value: state of casting
• Example (*.deeclass)

  <string name='particleEmitter.trigger'>@openHose & @waterInTank</string>

Set target casting. Fires target start casting and resets target if stop casting. Target can be used in triggers.

• Full name: particleEmitter.targetCasting or particleEmitter({id}).targetCasting
• Type: string
• Default Value: empty string
• Example (*.deeclass)

  <string name='particleEmitter.targetCasting'>hoseSpouting</string>

Set target last particle died. Pulses target if the last particle died. This happens a certain amount of time after targetCasting has been reset. Target can be used in triggers.

• Full name: particleEmitter.targetLastParticleDied or particleEmitter({id}).targetLastParticleDied
• Type: string
• Default Value: empty string
• Example (*.deeclass)

  <string name='particleEmitter.targetLastParticleDied'>hoseSpoutEnd</string>

This behavior provides these events:

Start casting particles.

Stop casting particles.

Last particle of a burst emission died.

Determine response for a custom particle collision.

Listener can update provided collisionInfo with the particle response to use. Multiple listeners can potentially update collisionInfo. The last update is used. If no listener updates the information the particle will be destroyed.

This behavior requires no other behaviors.

• ECBehaviorCollider: Attach to collider.

This behavior does support element class to be persistable (setPersistable). Saves selected color.

ECBehaviorParticleEmitter.

Since DragonScript Module Version 1.0

• Cast particles from an element.

This example defines an element which contains a particle emitter.

class MyElement extends BehaviorElementClass
  public var ECBehaviorComponent component
  public var ECBehaviorCollider collider
  public var ECBehaviorParticleEmitter particleEmitter
  func new()
    component = ECBehaviorComponent.new(this, null)
    collider = ECBehaviorCollider.new(this, component)
    particleEmitter = ECBehaviorParticleEmitter.new(this, collider)
    particleEmitter.getParticleEmitter().getParticleEmitter().setPath("/content/emitters/water.depemit")
  end
end

Using element class supporting adding behaviors the behavior can be added like this:

<?xml version='1.0' encoding='UTF-8'?>
<elementClass name='MyClass' class='GenericBehaviorElement'>
  <behavior type='ECBehaviorComponent'/>
  <behavior type='ECBehaviorCollider'/>
 
  <behavior type='ECBehaviorParticleEmitter'>
    <!-- optional: set collision filter. default value '5:0 1 2 6' which means
                   category BaseGameApp.CollisionFilterBit.particle
                   filter BaseGameApp.CollisionFilterBit.geometry,
                          BaseGameApp.CollisionFilterBit.dynamic,
                          BaseGameApp.CollisionFilterBit.actor,
                          BaseGameApp.CollisionFilterBit.forceField.
                   format is '', 'category' or 'category:filter' where category and filter
                   are a list of bits to set. -->
    <string name='collisionFilter'>5:0 1 2 6</string>
 
    <!-- optional: use BaseGameApp trigger table. game can add more supported values.
                   default value is 'default'. -->
    <string name='triggerTable'>default</string>
 
    <!-- optional: sync trigger with particle emitter matching identifier -->
    <string name='syncTrigger'>second</string>
 
    <!-- set element properties. omit property prefix if used inside behavior tag -->
    <string name='.path'>water.depemit</string>
  </behavior>
 
  <!-- for adding multiple behaviors use unique identifiers -->
  <behavior type='ECBehaviorParticleEmitter' id='second'/>
</elementClass>

• DEExamples Repository