Skeleton & Bones

DazSkeleton

class dazpy.DazSkeleton(client, identifier)

Bases: DazNode

Proxy for a DzSkeleton (a rigged figure such as Genesis 9).

Extends DazNode with bone-access helpers.

bones()

Return all bones in this skeleton.

find_bone(name)

Find a bone by its internal name.

Parameters:

name (str) – The getName() string of the bone. Naming conventions differ by figure generation: Genesis 9 uses snake_case (e.g. "r_forearm"); Genesis 3/8 uses "rForearmBend"/"lForearmBend"; Genesis 1/2 uses "rForeArm"/"lForeArm". Use bones() to list every bone name for the loaded figure.

Returns:

A DazBone proxy.

Raises:

NodeNotFoundError – If no bone with that name exists.

Return type:

DazBone

find_bone_by_label(label)

Find a bone by its user-visible label.

Parameters:

label (str) – The getLabel() string of the bone.

Returns:

A DazBone proxy.

Raises:

NodeNotFoundError – If no bone with that label exists.

Return type:

DazBone

num_bones()

Return the total number of bones in this skeleton.

bone_rotations()

Return Euler rotations for every bone in one HTTP call.

Equivalent to calling local_euler on every bone returned by bones(), but rounds-trips only once.

Returns:

{bone_name: (x, y, z)} in degrees for every bone.

Return type:

dict[str, tuple[float, float, float]]

set_bone_rotations(data)

Set Euler rotations for any subset of bones in one HTTP call.

Only the bones named in data are modified; all others are unchanged. Equivalent to calling set_local_rotation() per bone, but rounds-trips only once.

Parameters:

data (dict[str, tuple | list]) – {bone_name: (x, y, z)} or {bone_name: [x, y, z]}, angles in degrees. Bones not in this dict are left as-is.

morph_values(nonzero_only=False)

Return the current value of every DzMorph modifier in one HTTP call.

Parameters:

nonzero_only (bool) – When True, exclude morphs whose value is effectively zero (abs(v) <= 0.0001). Useful for sparse logging.

Returns:

{morph_name: float} for all (or non-zero) morphs.

Return type:

dict[str, float]

set_morph_values(data)

Set the value of any subset of morphs in one HTTP call.

Only morphs named in data are modified; all others are unchanged.

Parameters:

data (dict[str, float]) – {morph_name: float} mapping. Morphs not in this dict are left at their current value.

bake_bone_rotations(start=None, end=None, bone_names=None)

Bake bone rotation keyframes for every frame in the range.

Scrubs the timeline server-side. For each frame, the current evaluated X/Y/Z rotation of every bone (including IK, constraints, and driven keys) is stamped as an explicit keyframe via insertKey. After baking, the animation plays back without requiring any of the original drivers.

The original frame is restored before the call returns.

Parameters:

• start (int | None) – First frame to bake. None → play-range start.

• end (int | None) – Last frame to bake. None → play-range end.

• bone_names (list[str] | None) – Subset of bone names to bake. None → all bones.

Returns:

{"frames_baked": int, "bones_baked": int}

Raises:

NodeNotFoundError – If the skeleton is not found.

Return type:

dict

bake_morphs(start=None, end=None, morph_names=None)

Bake morph channel keyframes for every frame in the range.

For each frame, the current value of every DzMorph modifier is stamped as an explicit keyframe via insertKey.

The original frame is restored before the call returns.

Parameters:

• start (int | None) – First frame to bake. None → play-range start.

• end (int | None) – Last frame to bake. None → play-range end.

• morph_names (list[str] | None) – Subset of morph names to bake. None → all morphs.

Returns:

{"frames_baked": int, "morphs_baked": int}

Return type:

dict

bake(start=None, end=None, bone_names=None, include_morphs=False, morph_names=None)

Bake bone rotations and optionally morphs in a single HTTP call.

Combines bake_bone_rotations() and bake_morphs() into one server-side loop so the timeline is only scrubbed once.

Parameters:

• start (int | None) – First frame to bake. None → play-range start.

• end (int | None) – Last frame to bake. None → play-range end.

• bone_names (list[str] | None) – Bones to bake. None → all bones.

• include_morphs (bool) – Also bake DzMorph channels.

• morph_names (list[str] | None) – Morphs to bake (only used when include_morphs is True). None → all morphs.

Returns:

{"frames_baked": int, "bones_baked": int, "morphs_baked": int}

Return type:

dict

follow_target()

Return the IK follow-target skeleton, or None if not set.

DazBone

class dazpy.DazBone(client, identifier)

Bases: DazNode

Proxy for a DzBone (a single joint within a DazSkeleton).

Extends DazNode with bone-specific rotation helpers.

property local_euler: tuple[float, float, float] | None

Local-space rotation as an (x, y, z) tuple of Euler angles in degrees.

Reads the same rotation controls written by set_local_rotation(), so the two are exact inverses.

Returns:

(x, y, z) in degrees, or None if the bone cannot be found.

property local_rotation: dict | None

Local-space rotation as {"x", "y", "z", "w"} quaternion (read-only).

set_local_rotation(x, y, z)

Set the bone’s local rotation using Euler angles in degrees.

Parameters:

• x (float) – Rotation around the local X axis.

• y (float) – Rotation around the local Y axis.

• z (float) – Rotation around the local Z axis.

property local_position: dict | None

Local-space position as {"x", "y", "z"} (read-only).

property rotation_order: str | None

Rotation order string (e.g. "XYZ"), or None.

get_skeleton()

Return the parent DazSkeleton, or None.