Behavior element behavior adding camera support.

Behavior adds a Camera resource to the the behavior element. Creates a camera attached to the element collider which can be individually modified.

This behavior can be added multiple times to an element. Use the behavior identifier to tell them apart.

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

Set position to attach resource to collider.

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

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

Set orientation to attach resource to collider in degrees.

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

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

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

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

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

Set vertical field of view in degrees for the entire view.

• Full name: customColor.fov or customColor({id}).fov
• Type: float
• Default Value: 39.6
• Restriction: At least 0 and at most 180
• Example (*.deeclass)

  <float name='customColor.fov'>60</value>

Set aspect ratio of the horizontal field of view to the vertical field of view.

• Full name: customColor.fovRatio or customColor({id}).fovRatio
• Type: float
• Default Value: 1
• Restriction: At least 0.1
• Example (*.deeclass)

  <float name='customColor.fovRatio'>1.5</value>

Set distance to the image plane.

• Full name: customColor.imageDistance or customColor({id}).imageDistance
• Type: float
• Default Value: 0.01
• Restriction: At least 0.001
• Example (*.deeclass)

  <float name='customColor.imageDistance'>0.1</value>

Set viewing distance up to which world geometry is rendered.

• Full name: customColor.viewDistance or customColor({id}).viewDistance
• Type: float
• Default Value: 200
• Restriction: At least 0.01
• Example (*.deeclass)

  <float name='customColor.viewDistance'>500</value>

Set enable high definition range rendering (HDRR) if supported.

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

  <float name='customColor.enableHDRR'>false</value>

Set exposure.

• Full name: customColor.exposure or customColor({id}).exposure
• Type: float
• Default Value: 1
• Restriction: 0
• Example (*.deeclass)

  <float name='customColor.exposure'>1.5</value>

Set lowest intensity the eye can adapt to.

• Full name: customColor.lowestIntensity or customColor({id}).lowestIntensity
• Type: float
• Default Value: 1
• Restriction: 0
• Example (*.deeclass)

  <float name='customColor.lowestIntensity'>10</value>

Set highest intensity the eye can adapt to.

• Full name: customColor.highestIntensity or customColor({id}).highestIntensity
• Type: float
• Default Value: 20
• Restriction: 0
• Example (*.deeclass)

  <float name='customColor.highestIntensity'>25</value>

Set adaption time of the eye in seconds.

• Full name: customColor.adaptionTime or customColor({id}).adaptionTime
• Type: float
• Default Value: 0.1
• Restriction: 0
• Example (*.deeclass)

  <float name='customColor.adaptionTime'>25</value>

Set enable global illumination (GI) if supported.

• Full name: customColor.enableGI or customColor({id}).enableGI
• Type: boolean
• Default Value: Engine.getDefaultEnableGI()
• Example (*.deeclass)

  <float name='customColor.enableGI'>false</value>

Set path to camera parameters file (*.decamera) to use. If not empty path the settings override the manual settings.

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

  <string name='customColor.pathParameters'>default.decamera</string>

This behavior has no events.

This behavior requires no other behaviors.

This behavior supports these optional behaviors:

• ECBehaviorCollider: Attach camera to collider.

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

ECBehaviorCamera.

Since DragonScript Module Version 1.0

• Attach camera to element which can be rendered to nearby elements (for example weapon scope).

This example defines an element which contain a camera.

class MyElement extends BehaviorElementClass
  public var ECBehaviorCollider collider
  public var ECBehaviorCamera camera
  public func new()
    collider = ECBehaviorCollider.new(this)
    camera = ECBehaviorCamera.new(this, collider)
    camera.getAttach().getPosition().setVector(Vector.new(0, 0, 0.1))
    camera.getViewDistance().setValue(300)
    camera.getPathParameters().setValue("/content/cameras/scope.decamera")
  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='ECBehaviorCamera'>
    <!-- optional: set layer mask (default empty). list of bits to set. -->
    <string name='layerMask'>0 1 4</string>
 
    <!-- set element properties. omit property prefix if used inside behavior tag -->
    <float name='.viewDistance'>300</float>
  </behavior>
 
  <!-- for adding multiple behaviors use unique identifiers -->
  <behavior type='ECBehaviorCamera' id='second'>
    ...
  </behavior>
</elementClass>

• DEExamples Repository