Nodes/Avatar Graph/Object Anim Transforms To Deltas
ComfyUI Node

Object Anim Transforms To Deltas

Folding animated transforms into deltas

By avatechai·Created 3 years ago·Updated 2 years ago· 264
Object Anim Transforms To Deltas
  • BPY_OBJ
  • BPY_OBJ

Another single-purpose Blender operator wrapper from Avatar Graph, avatech.ai's pack for building rigged, interactive avatars out of a flat character image inside ComfyUI. This one exists for a specific, slightly niche problem: you've got an object with animated (keyframed) location, rotation, or scale, and you need to layer more transform on top of it without touching or breaking that existing animation.

What it actually does

Blender objects carry two separate transform channels: the regular location/rotation/scale (the ones animation keyframes usually drive) and a parallel delta_location/delta_rotation/delta_scale set that stacks on top and isn't touched by most animation systems. "Anim Transforms to Deltas" takes whatever the object's animated transform is currently evaluating to and bakes that visual result into the delta channels instead - same look, different channel. Why bother? Because it frees up the regular transform channels for something else (another rig, a manual pose adjustment, a parent constraint) to drive, without fighting the existing keyframes or needing to re-key anything. In an avatar rig built up procedurally, node by node, that's the kind of plumbing move you need occasionally and would otherwise have to do by hand in Blender's UI.

Inputs and outputs

There's nothing to configure - a single optional BPY_OBJ in, the same BPY_OBJ out, transformed. BPY_OBJ is this pack's custom edge type for passing a live Blender object reference between nodes, the same pattern nearly every blender-category node in this pack uses. Whatever object you feed in needs to already have animated transforms on it for this node to have anything to do - if the object's transform is static, running this is a no-op.

Installing it

Install through ComfyUI Manager (search avatar-graph-comfyui) or manually:

cd ComfyUI/custom_nodes
git clone https://github.com/avatechai/avatar-graph-comfyui
cd avatar-graph-comfyui && python -m pip install -r requirements.txt

The real prerequisite is Python, not the pack itself: this whole thing runs on bpy, Blender's own engine packaged as a pip-installable module, and bpy is picky - it needs Python 3.10.x specifically, nothing newer. That means it usually wants its own environment rather than living in whatever Python your main ComfyUI setup already runs. The README ships a dedicated Python 3.10 build of ComfyUI for Windows users for exactly this reason, and recommends a fresh conda create --name comfyui python=3.10 on Mac/Linux. After install, restart with --enable-cors-header if you plan to use the pack's live preview panel that talks to editor.avatech.ai - otherwise the graph still runs, you just export a .glb/.gltf to view elsewhere.

Troubleshooting

Because this node does nothing visible unless the incoming object already has keyframed animation, "it doesn't seem to do anything" is usually a signal your upstream object has no animation on it yet - not a broken node. Beyond that, general Avatar Graph troubleshooting applies: this pack had its moment in October 2023 and has been mostly quiet since, so there's no deep community thread to search for this specific node. If your install fails outright, it's almost always the Python version - confirm you're actually running 3.10.x in whatever environment ComfyUI launched from before assuming the node itself is broken.

Categoryblender

Inputs (1)

NameTypeDefaultDescription
BPY_OBJoptBPY_OBJ

Outputs (1)

NameTypeDescription
BPY_OBJBPY_OBJ