Source 2 Animation System VScript API/CModelVScriptCompile.CreateIKChain

Function Description

int CModelVScriptCompile::CreateSequence(string chainName, string end_bone, table parameters)

Creates an Inverse Kinematics chain, similar to the $ikchain QC command. The function only seems be available in run-time animation VScripts. Several IK solvers seem to be available, including Ken Perlin's two bone solver and the FABRIK solver.

Todo: Unknown how much of this works.

Parameters

Type	Name	Description
string	chainName	Name to refer to the chain by.
table	parameters	IK chain parameters (see below).

Returns

int - Index of the IK chain.

Sequence Parameters

The parameters are added as keys in the parameters table.

Todo: This list is likely wrong and incomplete.

Name	Type	Description
bones_point_along_positive_x	boolean	[Todo]
constraints	array	List of IK constraints. Syntax: { { < type = "$" >, ... }, ... }
ik_root_bone	string	Name of the first bone in the IK chain. Required.
ik_end_effector_bone	string	The end bone in the IK chain. Required.
ik_end_effector_target_bone	string	Todo: Maybe something related to procedural targets.
rules	array	List of IK rules. Syntax: { { < type = "$" >, ... }, ... }
solverInfo	array	Solver configuration. Possible syntax: { < type = [ "perlin" / "fabrik" / "maya_two_bone" ] > }
lockInfo	array	[Todo] Possible Syntax: { boneInfluenceDriver = "$", reverseFootLockBone = "$", lockBoneInfluenceDriver = "$", maxLockDistanceToTarget = #, hyperExtensionReleaseThreshold = #}

IK Rules

IK rules in the rules array.

Todo: This list is likely incomplete.

Name	Syntax	Description
ground	{ rule = "ground", trace_diameter = #, height = # }	Attempts to place the end bone on the ground.
touch	{ rule = "touch"}	Todo: Possibly unsupported currently
procedural_target	{ rule = "procedural_target", name = "$", bone= "$" }	Attempts to set the end bones position and orientation to values supplied by code. A VScript method for the CBaseAnimating class exists to control this.

IK Constraints

IK constraints in the constraints array.

Todo: This list is likely incomplete.

Name	Syntax	Description
hinge	{ type = "hinge", joint="$", min_angle = #, max_angle = # }	Todo: Adds a hinge of some kind with angle limits to the specified bone