paya.runtime.parts.Triad#

class Triad(groupNode)#

Inheritance

Part PartBase Trunk

classmethod createChain(points, upVector, tipMatrix=None, downAxis=<undefined>, upAxis=<undefined>, numTopTwists=0, numBtmTwists=0, parent=None, ikJitter=False, opposite=False)#

Creates a three-point skeletal chain.

Parameters

  • points (list [list [float] | Point | Vector]) – a world position for each joint; three points are required; excess points will be discarded

  • upVector – the main up vector hint for the chain; this will guide cross product calculations to resolve orientations for the main bend axis

  • tipMatrix (None, list [float], Matrix) – an optional rotation matrix override for the tip (end) joint; if provided, only orientation information will be used; defaults to None

  • numTopTwists (int) – the number of twist joints to insert on the top (bicep / thigh) bone; defaults to 0

  • numBtmTwists (int) – the number of twist joints to insert on the btm (forearm / shin) bone; defaults to 0

  • downAxis (str) – the ‘bone’ axis; defaults to paya.config.downAxis

  • upAxis (str) – the axis to map to the up vector; defaults to paya.config.upAxis

  • parent (None, str, Transform) – an optional destination parent for the chain; defaults to None

  • ikJitter (bool) – ignored if twist joints are involved; if this chain is in-line, auto-configures preferred angles to prevent lockout; defaults to False

  • opposite (bool) – flips the (resolved) down axis; defaults to False

Returns

The generated chain.

Return type

Chain