Behavior adding cutscene support to actors.

Allows actor to perform cutscene actions controlled by conversation scripts.

Loads a custom animator and applies it to ECBehaviorConversationActor. Controller mappings assigned to ECBehaviorConversationActor do affect the loaded animator so cutscene animators can integrate into switched animators. In addition this behavior adds a controller named cutscene which is used to play back the cutscene.

Upon starting the animation captures the current animation state into state number 0. This allows cutscenes to blend over from the current state if required.

Supports adding break points to interrupt playing back a cutscene until the conversation script decides to continue. This allows for special configurations and requires the used animator to support playing back an idle animation (for example using idle controller) while the cutscene controller is frozen at the break point value.

Also supports loading a sound or synthesizer to play back while the cutscene is running.

When using this behavior make sure the BaseActorAction subclass used supports changing animator assigned to ECBehaviorActorAnimated while the action is in used. If this is not the case the BaseActorAction subclass can access AnimatorController of the previous animator causing problems.

See also:

• Animators and Animation
• IGDE Animator Editor
• Blender3D Export Scripts

This behavior can be used only once on an element.

Element class properties have the prefix cutscene..

Set name of playback controller.

• Full name: cutscene.controllerName
• Type: string
• Default Value: cutscene
• Example (*.deeclass)

  <string name='cutscene.controllerName'>playback</string>

This behavior has these events:

Cutscene started.

Cutscene stopped.

Cutscene hit break point and is now waiting.

Cutscene continues after waiting at a break point.

This behavior adds these conversation commands.

Control cutscene. The following syntax is supported:

cutscene start [path] {[breakPoint1] … [breakPointN]}

Start playing cutscene.

cutscene resume

Resume cutscene if paused (hence waiting at a break point).

cutscene stop

Stop cutscene if running.

cutscene synthesizer [path] [range] {[positionX] [positionY] [positionZ] {[bone]}}

Loads synthesizer and starts playing it back. Attaches the speaker to the actor.

This behavior adds these conversation conditions.

cutscene playing

Cutscene is playing.

cutscene paused

Cutscene is paused (hence waiting at a break point).

cutscene stopped

Cutscene is stopped.

• ECBehaviorCollider
• ECBehaviorConversationActor

This behavior does not support optional behaviors.

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

ECBehaviorActorCutscene.

Since DragonScript Module Version 1.0

• Allow actor to be used in cutscenes playing back a special cutscene animator.

This example defines an element which supports cutscenes.

class MyElement extends BehaviorElementClass
  public var ECBehaviorComponent component
  public var ECBehaviorCollider collider
  public var ECBehaviorConversationActor conversationActor
  public var ECBehaviorActorCutscene actorCutscene
  func new()
    component = ECBehaviorComponent.new(this, null)
    collider = ECBehaviorCollider.new(this, component)
    conversationActor = ECBehaviorConversationActor.new(this)
    actorCutscene = ECBehaviorActorCutscene.new(this, collider, conversationActor)
  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='ECBehaviorConversationActor'/>
 
  <behavior type='ECBehaviorActorCutscene'>
    <!-- set element properties. omit property prefix if used inside behavior tag -->
    <string name='.name'>value</string>
  </behavior>
</elementClass>

• DEExamples Repository