SkeletonModification2DCCDIK

继承: SkeletonModification2D < Resource < RefCounted < Object

使用 CCDIK 操纵一系列骨骼到达某个 2D 目标的修改器。

描述

这种 SkeletonModification2D 使用的是名为循环坐标下降逆向运动学(Cyclic Coordinate Descent Inverse Kinematics)的算法,即 CCDIK,能够对 Skeleton2D 中的一条骨骼链进行操作,从而抵达指定的目标。

CCDIK 的工作原理是让一组骨骼围绕单一轴旋转,这组骨骼通常称作“骨骼链”。每根骨骼的尖端都会转向目标(默认),这样整条骨骼链就能够正确旋转,从而抵达目标。因为这些骨骼都只围绕单一轴进行旋转,CCDIK 看起来能够比其他 IK 解算器更加机械。

注意:CCDIK 修改器具有关节属性 ccdik_joints,里面是存放 CCDIK 链中各个关节数据的数据对象。关节和骨骼是两码事!CCDIK 关节存放的是 CCDIK 所使用的骨骼链中每根骨骼所需的数据。

CCDIK 还完全支持角度约束,能够对求解过程进行更多控制。

属性

int

ccdik_data_chain_length

0

NodePath

target_nodepath

NodePath(“”)

NodePath

tip_nodepath

NodePath(“”)

方法

NodePath

get_ccdik_joint_bone2d_node ( int joint_idx ) const

int

get_ccdik_joint_bone_index ( int joint_idx ) const

bool

get_ccdik_joint_constraint_angle_invert ( int joint_idx ) const

float

get_ccdik_joint_constraint_angle_max ( int joint_idx ) const

float

get_ccdik_joint_constraint_angle_min ( int joint_idx ) const

bool

get_ccdik_joint_enable_constraint ( int joint_idx ) const

bool

get_ccdik_joint_rotate_from_joint ( int joint_idx ) const

void

set_ccdik_joint_bone2d_node ( int joint_idx, NodePath bone2d_nodepath )

void

set_ccdik_joint_bone_index ( int joint_idx, int bone_idx )

void

set_ccdik_joint_constraint_angle_invert ( int joint_idx, bool invert )

void

set_ccdik_joint_constraint_angle_max ( int joint_idx, float angle_max )

void

set_ccdik_joint_constraint_angle_min ( int joint_idx, float angle_min )

void

set_ccdik_joint_enable_constraint ( int joint_idx, bool enable_constraint )

void

set_ccdik_joint_rotate_from_joint ( int joint_idx, bool rotate_from_joint )


属性说明

int ccdik_data_chain_length = 0

  • void set_ccdik_data_chain_length ( int value )

  • int get_ccdik_data_chain_length ( )

CCDIK 修改中 CCDIK 关节的数量。


NodePath target_nodepath = NodePath("")

作为 CCDIK 修改目标的节点的 NodePath。该节点是 CCDIK 链会尝试将该骨骼链旋转到的节点。


NodePath tip_nodepath = NodePath("")

该 CCDIK 链的结束位置。通常,这应该是一个 Bone2D 节点的一个子节点,被附加到 CCDIK 链中的最终 Bone2D 上。


方法说明

NodePath get_ccdik_joint_bone2d_node ( int joint_idx ) const

返回分配给位于 joint_idx 的 CCDIK 关节的 Bone2D 节点。


int get_ccdik_joint_bone_index ( int joint_idx ) const

返回分配给位于 joint_idx 的 CCDIK 关节的 Bone2D 节点的索引。


bool get_ccdik_joint_constraint_angle_invert ( int joint_idx ) const

返回索引为 joint_idx 的 CCDIK 关节是否使用反向关节约束。详见 set_ccdik_joint_constraint_angle_invert


float get_ccdik_joint_constraint_angle_max ( int joint_idx ) const

返回索引为 joint_idx 的关节的最大角约束。


float get_ccdik_joint_constraint_angle_min ( int joint_idx ) const

返回索引为 joint_idx 的关节的最小角约束。


bool get_ccdik_joint_enable_constraint ( int joint_idx ) const

返回索引为 joint_idx 的 CCDIK 关节是否启用角度约束。


bool get_ccdik_joint_rotate_from_joint ( int joint_idx ) const

返回位于 joint_idx 的关节是从该关节旋转,true,还是从尖端旋转,false。默认是从尖端旋转。


void set_ccdik_joint_bone2d_node ( int joint_idx, NodePath bone2d_nodepath )

设置分配给位于 joint_idx 的 CCDIK 关节的 Bone2D 节点。


void set_ccdik_joint_bone_index ( int joint_idx, int bone_idx )

设置位于 joint_idx 的 CCDIK 关节的骨骼索引 joint_idx。可能时,还会根据所链接的骨架提供的信息来更新 CCDIK 关节的 bone2d_node


void set_ccdik_joint_constraint_angle_invert ( int joint_idx, bool invert )

设置索引为 joint_idx 的 CCDIK 关节是否使用反向关节约束。

反向关节约束只会将该 CCDIK 关节的角度约束在输入的最大最小角度范围之外。因此,它被称为反向关节约束,因为它将关节约束在输入值的外部。


void set_ccdik_joint_constraint_angle_max ( int joint_idx, float angle_max )

设置索引为 joint_idx 的关节的最大角约束。


void set_ccdik_joint_constraint_angle_min ( int joint_idx, float angle_min )

设置索引为 joint_idx 的关节的最小角约束。


void set_ccdik_joint_enable_constraint ( int joint_idx, bool enable_constraint )

决定是否启用 joint_idx 处 CCDIK 关节上的角度约束。为 true 时将启用约束,在求解时纳入考虑范围。


void set_ccdik_joint_rotate_from_joint ( int joint_idx, bool rotate_from_joint )

设置位于 joint_idx 的关节是设为从关节旋转,true,还是从尖端旋转,false

Previous Next


© 版权所有 2014-present Juan Linietsky, Ariel Manzur and the Godot community (CC BY 3.0). Revision b1c660f7.

Built with Sphinx using a theme provided by Read the Docs.