{{tag>motioncapture democap behavior}}
<WRAP youarehere>
[[:start|Start Page]] >> [[main|DEMoCap: Drag[en]gine Motion Capture]] >> [[democap:elementclasses|XML Element Classes]] >> ** ECBRemoteCamera **
</WRAP>

====== ECBRemoteCamera ======

Behavior adding support for [[dragengine:modules:dragonscript:behavior_camera|ECBehaviorCamera]] to be used remotely. Defines a name used to select the camera in remote view list models. Upon being added to game worlds adds itself to the global list of available remote views.

====== Instance Counts ======

This element behavior can be present multiple times in a BehaviorElement. In this case use a unique identifier to distinguish the individual behavior instances.

====== Element Class Properties ======

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

===== name =====

Name to display in UI for this remote camera. User can change this name in the behavior panel.

  * Full name: ''remoteCamera.name'' or ''remoteCamera({id}).name''
  * Type: string
  * Default Value: ''Camera''
  * Example (*.deeclass) <code xml><string name='remoteCamera.name'>Camera</string></code>

====== Events ======

This behavior has no events.

====== Conversation Commands ======

This behavior adds no conversation commands.

====== Conversation Conditions ======

This behavior adds no conversation conditions.

====== Behavior Tree Actions ======

This behavior adds no behavior tree actions.

====== Behavior Tree Conditions ======


====== Required Behaviors ======

  * [[dragengine:modules:dragonscript:behavior_camera|ECBehaviorCamera]]
  * [[behavior_ecbbehaviorguipanels|ECBBehaviorGuiPanels]]

====== Optional Behaviors ======

This behavior does not support optional behaviors.

====== API Documentation ======

Since DEMoCap Version ''1.3''

====== Use Cases ======

  * Add a remote camera the user can show in the main view or as HUD overlay

====== Element Class Example ======

<code>
class MyElement extends BehaviorElementClass
  public var ECBehaviorCollider collider
  public var ECBehaviorCamera camera
  public var ECBBehaviorGuiPanels guiPanels
  func new()
    collider = ECBehaviorCollider.new(this, null)
    camera = ECBehaviorCamera.new(this, collider)
    guiPanels = ECBBehaviorGuiPanels.new(this)
    remoteCamera = ECBRemoteCamera.new(this, guiPanels, camera)
  end
end
</code>

====== Behavior Factory ======

Using element class supporting adding behaviors the behavior can be added like this (again create an example which creates a valid element class):

<code xml>
<?xml version='1.0' encoding='UTF-8'?>
<elementClass name='MyClass' class='GenericBehaviorElement'>
  <behavior type='ECBehaviorCollider'/>
  <behavior type='ECBehaviorCamera'/>
  <behavior type='ECBBehaviorGuiPanels'/>
  
  <behavior type='ECBRemoteCamera'>
    <!-- optional: use camera with id instead of empty string -->
    <string name='camera'>second</string>
    
    <!-- set element properties. omit property prefix if used inside behavior tag -->
    <string name='.name'>Camera</string>
  </behavior>
  
  <!-- for adding multiple behaviors use unique identifiers -->
  <behavior type='ECBRemoteCamera' id='second'/>
</elementClass>
</code>

====== Live Examples ======