Nodes/Avatar Graph/Object Set Show Bounds
ComfyUI Node

Object Set Show Bounds

Draw a bounding box around your avatar's parts

By avatechai·Created 3 years ago·Updated 2 years ago· 264
Object Set Show Bounds
  • BPY_OBJ
  • BPY_OBJ
valuefalse

Object Set Show Bounds toggles show_bounds, the Blender viewport flag that draws a wireframe box around an object's extents. If you've ever wondered whether two mesh layers of an avatar are colliding, or whether a part has drifted out of place, a bounding box makes the object's actual footprint obvious at a glance - it's the cheap, low-poly version of "show me the outline" for a whole part instead of its edges.

How it works

Auto-generated from bpy.types.Object's properties, this setter runs setattr(object, "show_bounds", value) against the embedded bpy instance and returns the same BPY_OBJ. The value input is a BOOLEAN with default false. Flip it true and the object gets a box around its bounds in the viewport.

The companion detail: the style of that box is controlled by the separate display_bounds_type property (BOX, SPHERE, CYLINDER, CONE, CAPSULE), which has its own setter node in the pack. So Show Bounds turns the thing on, and the display-type setter decides whether the bounds are a box or a sphere. If your bounds look like a weird shape and you wanted a plain box, that's the display_bounds_type property, not this flag.

As with the other viewport flags in this family, this is inspection tooling: it affects the editor/preview only, not the render or the exported avatar. Enable it while you're checking a rig, disable it before you ship so the preview stays clean.

The inputs

  • BPY_OBJ - the mesh layer from Create Mesh Layer or a Mesh_ primitive.
  • value - boolean, default false.

Output: the same BPY_OBJ, so it slots into a setter chain.

Install & gotchas

It's one node in the Avatar Graph pack - install that once:

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

Or ComfyUI Manager → search "Avatar Graph". The pack pins bpy==3.6.0, which needs Python 3.10 - on 3.11+ bpy has no wheel and the whole pack fails to import. Conda with python=3.10 is the README's approach. First launch auto-downloads a ~2.5 GB SAM model and mediapipe landmarker files.

Standard traps: viewport-only, so don't expect bounds in the render; set it after the object's creation node (the bpy scene resets each queue run); and the pack's live preview needs ComfyUI started with --enable-cors-header. Skip the flag and the graph still runs and exports via Avatar Main Output - you just lose the realtime editor. And if ComfyUI Desktop's UI breaks after installing the pack (an oversized embedded editor overlay has been reported), run the browser build; the nodes themselves are fine.

Categoryblender

Inputs (2)

NameTypeDefaultDescription
BPY_OBJoptBPY_OBJ
valueoptBOOLEANfalse

Outputs (1)

NameTypeDescription
BPY_OBJBPY_OBJ