SkeletonModification2DFABRIK

package
v0.0.0-...-d9f4d4e Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Feb 9, 2025 License: MIT Imports: 22 Imported by: 0

Documentation

Overview

Package SkeletonModification2DFABRIK provides methods for working with SkeletonModification2DFABRIK object instances.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type Advanced

type Advanced = class

Advanced exposes a 1:1 low-level instance of the class, undocumented, for those who know what they are doing.

type Any

type Any interface {
	gd.IsClass
	AsSkeletonModification2DFABRIK() Instance
}

type Instance

This [SkeletonModification2D] uses an algorithm called Forward And Backward Reaching Inverse Kinematics, or FABRIK, to rotate a bone chain so that it reaches a target. FABRIK works by knowing the positions and lengths of a series of bones, typically called a "bone chain". It first starts by running a forward pass, which places the final bone at the target's position. Then all other bones are moved towards the tip bone, so they stay at the defined bone length away. Then a backwards pass is performed, where the root/first bone in the FABRIK chain is placed back at the origin. Then all other bones are moved so they stay at the defined bone length away. This positions the bone chain so that it reaches the target when possible, but all of the bones stay the correct length away from each other. Because of how FABRIK works, it often gives more natural results than those seen in [SkeletonModification2DCCDIK]. FABRIK also supports angle constraints, which are fully taken into account when solving. [b]Note:[/b] The FABRIK modifier has [code]fabrik_joints[/code], which are the data objects that hold the data for each joint in the FABRIK chain. This is different from [Bone2D] nodes! FABRIK joints hold the data needed for each [Bone2D] in the bone chain used by FABRIK. To help control how the FABRIK joints move, a magnet vector can be passed, which can nudge the bones in a certain direction prior to solving, giving a level of control over the final result.

var Nil Instance

Nil is a nil/null instance of the class. Equivalent to the zero value.

func New

func New() Instance

func (Instance) AsObject

func (self Instance) AsObject() [1]gd.Object

func (Instance) AsRefCounted

func (self Instance) AsRefCounted() [1]gd.RefCounted

func (Instance) AsResource

func (self Instance) AsResource() Resource.Instance

func (Instance) AsSkeletonModification2D

func (self Instance) AsSkeletonModification2D() SkeletonModification2D.Instance

func (Instance) AsSkeletonModification2DFABRIK

func (self Instance) AsSkeletonModification2DFABRIK() Instance

func (Instance) FabrikDataChainLength

func (self Instance) FabrikDataChainLength() int

func (Instance) GetFabrikJointBone2dNode

func (self Instance) GetFabrikJointBone2dNode(joint_idx int) string

Returns the [Bone2D] node assigned to the FABRIK joint at [param joint_idx].

func (Instance) GetFabrikJointBoneIndex

func (self Instance) GetFabrikJointBoneIndex(joint_idx int) int

Returns the index of the [Bone2D] node assigned to the FABRIK joint at [param joint_idx].

func (Instance) GetFabrikJointMagnetPosition

func (self Instance) GetFabrikJointMagnetPosition(joint_idx int) Vector2.XY

Returns the magnet position vector for the joint at [param joint_idx].

func (Instance) GetFabrikJointUseTargetRotation

func (self Instance) GetFabrikJointUseTargetRotation(joint_idx int) bool

Returns whether the joint is using the target's rotation rather than allowing FABRIK to rotate the joint. This option only applies to the tip/final joint in the chain.

func (Instance) SetFabrikDataChainLength

func (self Instance) SetFabrikDataChainLength(value int)

func (Instance) SetFabrikJointBone2dNode

func (self Instance) SetFabrikJointBone2dNode(joint_idx int, bone2d_nodepath string)

Sets the [Bone2D] node assigned to the FABRIK joint at [param joint_idx].

func (Instance) SetFabrikJointBoneIndex

func (self Instance) SetFabrikJointBoneIndex(joint_idx int, bone_idx int)

Sets the bone index, [param bone_idx], of the FABRIK joint at [param joint_idx]. When possible, this will also update the [code]bone2d_node[/code] of the FABRIK joint based on data provided by the linked skeleton.

func (Instance) SetFabrikJointMagnetPosition

func (self Instance) SetFabrikJointMagnetPosition(joint_idx int, magnet_position Vector2.XY)

Sets the magnet position vector for the joint at [param joint_idx].

func (Instance) SetFabrikJointUseTargetRotation

func (self Instance) SetFabrikJointUseTargetRotation(joint_idx int, use_target_rotation bool)

Sets whether the joint at [param joint_idx] will use the target node's rotation rather than letting FABRIK rotate the node. [b]Note:[/b] This option only works for the tip/final joint in the chain. For all other nodes, this option will be ignored.

func (Instance) SetTargetNodepath

func (self Instance) SetTargetNodepath(value string)

func (Instance) TargetNodepath

func (self Instance) TargetNodepath() string

func (*Instance) UnsafePointer

func (self *Instance) UnsafePointer() unsafe.Pointer

func (Instance) Virtual

func (self Instance) Virtual(name string) reflect.Value

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL