{{tag>dragonscript behavior}}
<WRAP youarehere>
[[:start|Start Page]] >> [[main|DragonScript Scripting Language]] >> [[dragengine:modules:dragonscript:abstractions|Abstraction Layers: How you want to build your Game]] >> [[dragengine:modules:dragonscript:behavior_elements|Behavior Elements]] >> **ECBehaviorNStateGeometry**
</WRAP>

  * [[behaviors_use_cases|Behaviors Explained: By Use-Case]]
  * [[behaviors_a_to_z|Behaviors Explained: From A to Z]]

====== ECBehaviorNStateGeometry ======

Behavior element behavior adding geometry network state support.

If [[behavior_networkstate|ECBehaviorNetworkState]] is present and activate adds network values to synchronize the owner element position and orientation.

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

This behavior can be used only once on an element.

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

Element class properties have the prefix ''nstateGeometry.'' .

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

This behavior has no events.

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

  * [[behavior_networkstate|ECBehaviorNetworkState]]

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

This behavior does not support optional behaviors.

====== Persistency ======

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

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

#@LinkApiDocDEDS2_HTML~classDragengine_1_1Scenery_1_1ECBehaviorNStateGeometry.html,ECBehaviorNStateGeometry~@#.

Since DragonScript Module Version ''1.0''

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

  * Add support to synchronize geometry state of element using [[behavior_networkstate|ECBehaviorNetworkState]].

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

This example defines an element which synchronizes geometry state of element using network state.

<code>
class MyElement extends BehaviorElementClass
  public var ECBehaviorNetworkState networkState
  public var ECBehaviorNStateGeometry nstateGeometry
  func new()
    networkState = ECBehaviorComponent.new(this, 1, 1)
    nstateGeometry = ECBehaviorNStateGeometry.new(this, networkState)
  end
end
</code>

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

Using element class supporting adding behaviors the behavior can be added like this:
<code xml>
<?xml version='1.0' encoding='UTF-8'?>
<elementClass name='MyClass' class='GenericBehaviorElement'>
  <behavior type='ECBehaviorNetworkState'>
    <integer name='requestLinkCode'>1</integer>
    <integer name='messageCode'>1</integer>
  </behavior>
  
  <behavior type='ECBehaviorNStateGeometry'>
    <!-- optional: position precision. default is 0.001 -->
    <float name='precisionPosition'>0.01</float>
    
    <!-- optional: orientation precision. default is 0.001 -->
    <float name='precisionOrientation'>0.01</float>
    
    <!-- set element properties. omit property prefix if used inside behavior tag -->
    <string name='.name'>value</string>
  </behavior>
</elementClass>
</code>

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

  * [[https://github.com/LordOfDragons/deexamples|DEExamples Repository]]