Drag[en]gine Wiki

User Tools

Site Tools

Trace:
dragengine:modules:dragonscript:behavior_actorik

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
dragengine:modules:dragonscript:behavior_actorik [2025/06/23 16:08] – [ECBehaviorActorIK] dragonlorddragengine:modules:dragonscript:behavior_actorik [2025/06/23 16:14] (current) – [Element Class Example] dragonlord
Line 18: Line 18:
 The behavior supports these controllers to input IK information to the animator. The behavior supports these controllers to input IK information to the animator.
  
-The **IK Position Controller** is used to set position of the target relative to the component assigned to the animator. The position is assigned as '//vector value//.+The **IK Position Controller** is used to set position of the target relative to the component assigned to the animator. The position is assigned as //vector value//.
  
 The **IK Rotation Controller** is used to set orientation of the target relative to the component assigned to the animator. The orientation is assigned as //vector value//. The **IK Rotation Controller** is used to set orientation of the target relative to the component assigned to the animator. The orientation is assigned as //vector value//.
  
-The **IK Height Controller** is used to set the height of the target above the ground. This is the same value as ''position.getY()'' but assigned as single //value//. This controller+The **IK Height Controller** is used to set the height of the target above the ground. This is the same value as ''IK Position Controller.y'' but assigned as single //value//. This controller
 allows to fine tune animators to different target heights above ground. To get the best results you usually have to use an animation for reaching at objects in upright and crouched position. Using this controller you can blend between such animations. allows to fine tune animators to different target heights above ground. To get the best results you usually have to use an animation for reaching at objects in upright and crouched position. Using this controller you can blend between such animations.
  
-The **IK Pan Controller** is used to set the left-right position of the target. This is the same value as ''position.getX()'' but assigned as single //value//.+The **IK Pan Controller** is used to set the left-right position of the target. This is the same value as ''IK Position Controller.x'' but assigned as single //value//.
  
-The **IK Distance Controller** is used to set the forward-backward position of the target. This is the same value as ''position.getZ()'' but assigned as single //value//.+The **IK Distance Controller** is used to set the forward-backward position of the target. This is the same value as ''IK Position Controller.z'' but assigned as single //value//.
  
-The **IK Azimuth Controller** is used to set the left-right rotation of the target. This is the same value as ''rotation.getY()'' but assigned as single //value//.+The **IK Azimuth Controller** is used to set the left-right rotation of the target. This is the same value as ''IK Rotation Controller.y'' but assigned as single //value//.
  
-The **IK Elevation Controller** is used to set the up-down rotation of the target. This is the same value as ''rotation.getX()'' but assigned as single //value//.+The **IK Elevation Controller** is used to set the up-down rotation of the target. This is the same value as ''IK Rotation Controller.x'' but assigned as single //value//.
  
 ====== Instance Counts ====== ====== Instance Counts ======
Line 39: Line 39:
 ====== Element Class Properties ====== ====== Element Class Properties ======
  
-Element class properties have the prefix **actorIK.** or **actorIK(id).** if id is not empty.+Element class properties have the prefix ''actorIK.'' or ''actorIK(id).'' if id is not empty.
  
 ===== controllerIKPosition ===== ===== controllerIKPosition =====
 Name of the controller to assign IK position to using //vector value//. If the controller is not found it is ignored. Name of the controller to assign IK position to using //vector value//. If the controller is not found it is ignored.
-  * Full name: "actorIK.controllerIKPosition" or "actorIK(id).controllerIKPosition"+  * Full name: ''actorIK.controllerIKPosition'' or ''actorIK(id).controllerIKPosition''
   * Type string   * Type string
   * Default Value ''ik.position''   * Default Value ''ik.position''
Line 49: Line 49:
  
 ===== controllerIKRotation ===== ===== controllerIKRotation =====
-Name of the controller to assign IK rotatio to using //vector value//. If the controller is not found it is ignored. +Name of the controller to assign IK rotation to using //vector value//. If the controller is not found it is ignored. 
-  * Full name: "actorIK.controllerIKRotation" or "actorIK(id).controllerIKRotation"+  * Full name: ''actorIK.controllerIKRotation'' or ''actorIK(id).controllerIKRotation''
   * Type string   * Type string
   * Default Value ''ik.rotation''   * Default Value ''ik.rotation''
Line 57: Line 57:
 ===== controllerIKHeight ===== ===== controllerIKHeight =====
 Name of the controller to assign IK height (Y axis position) to using //value//. If the controller is not found it is ignored. Name of the controller to assign IK height (Y axis position) to using //value//. If the controller is not found it is ignored.
-  * Full name: "actorIK.controllerIKHeight" or "actorIK(id).controllerIKHeight"+  * Full name: ''actorIK.controllerIKHeight'' or ''actorIK(id).controllerIKHeight''
   * Type string   * Type string
   * Default Value ''ik.height''   * Default Value ''ik.height''
Line 64: Line 64:
 ===== controllerIKPan ===== ===== controllerIKPan =====
 Name of the controller to assign IK pan (X axis position) to using //value//. If the controller is not found it is ignored. Name of the controller to assign IK pan (X axis position) to using //value//. If the controller is not found it is ignored.
-  * Full name: "actorIK.controllerIKPan" or "actorIK(id).controllerIKPan"+  * Full name: ''actorIK.controllerIKPan'' or ''actorIK(id).controllerIKPan''
   * Type string   * Type string
   * Default Value ''ik.pan''   * Default Value ''ik.pan''
Line 71: Line 71:
 ===== controllerIKDistance ===== ===== controllerIKDistance =====
 Name of the controller to assign IK distance (Z axis position) to using //value//. If the controller is not found it is ignored. Name of the controller to assign IK distance (Z axis position) to using //value//. If the controller is not found it is ignored.
-  * Full name: "actorIK.controllerIKDistance" or "actorIK(id).controllerIKDistance"+  * Full name: ''actorIK.controllerIKDistance'' or ''actorIK(id).controllerIKDistance''
   * Type string   * Type string
   * Default Value ''ik.distance''   * Default Value ''ik.distance''
Line 78: Line 78:
 ===== controllerIKAzimuth ===== ===== controllerIKAzimuth =====
 Name of the controller to assign IK azimuth (Y axis rotation) to using //value//. If the controller is not found it is ignored. Name of the controller to assign IK azimuth (Y axis rotation) to using //value//. If the controller is not found it is ignored.
-  * Full name: "actorIK.controllerIKAzimuth" or "actorIK(id).controllerIKAzimuth"+  * Full name: ''actorIK.controllerIKAzimuth'' or ''actorIK(id).controllerIKAzimuth''
   * Type string   * Type string
   * Default Value ''ik.azimuth''   * Default Value ''ik.azimuth''
Line 85: Line 85:
 ===== controllerIKElevation ===== ===== controllerIKElevation =====
 Name of the controller to assign IK elevation (X axis rotation) to using //value//. If the controller is not found it is ignored. Name of the controller to assign IK elevation (X axis rotation) to using //value//. If the controller is not found it is ignored.
-  * Full name: "actorIK.controllerIKElevation" or "actorIK(id).controllerIKElevation"+  * Full name: ''actorIK.controllerIKElevation'' or ''actorIK(id).controllerIKElevation''
   * Type string   * Type string
   * Default Value ''ik.elevation''   * Default Value ''ik.elevation''
Line 119: Line 119:
    public var ECBehaviorActorIK actorIK    public var ECBehaviorActorIK actorIK
        
-   public func new() super("ExampleObject")+   func new() super("ExampleObject")
      // the base actor class creates an actor animated behavior we can use      // the base actor class creates an actor animated behavior we can use
            
Line 134: Line 134:
    public var ECBehaviorActorIK.Instance actorIK    public var ECBehaviorActorIK.Instance actorIK
        
-   public func new()+   func new()
    end    end
        
Line 145: Line 145:
    // enable IK while this action is assigned to an actor then disable it again.    // enable IK while this action is assigned to an actor then disable it again.
    // using disable() instead of setEnabled(false) also clears the target    // using disable() instead of setEnabled(false) also clears the target
-   public func void activate()+   func void activate()
       super.activate()       super.activate()
       actorIK.setTarget(targetElementToTouch)       actorIK.setTarget(targetElementToTouch)
Line 151: Line 151:
    end    end
        
-   public func void deactivate()+   func void deactivate()
       actorIK.disable()       actorIK.disable()
       super.deactivate()       super.deactivate()
Line 166: Line 166:
    public var ECBehaviorActorIK actorIKRight    public var ECBehaviorActorIK actorIKRight
        
-   public func new() super("ExampleObject")+   func new() super("ExampleObject")
      // the base actor class creates an actor animated behavior we can use      // the base actor class creates an actor animated behavior we can use
            
Line 190: Line 190:
    public var ECBehaviorActorIK.Instance actorIKRight    public var ECBehaviorActorIK.Instance actorIKRight
        
-   public func new()+   func new()
    end    end
        
Line 205: Line 205:
    // from the point of view of the element. the target position is always    // from the point of view of the element. the target position is always
    // relative to the target element.    // relative to the target element.
-   public func void activate()+   func void activate()
       super.activate()       super.activate()
              
Line 217: Line 217:
    end    end
        
-   public func void deactivate()+   func void deactivate()
       actorIKLeft.disable()       actorIKLeft.disable()
       actorIKRight.disable()       actorIKRight.disable()
dragengine/modules/dragonscript/behavior_actorik.1750694889.txt.gz · Last modified: 2025/06/23 16:08 by dragonlord

Page Tools

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Noncommercial-Share Alike 4.0 International
CC Attribution-Noncommercial-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki