Nodes/Avatar Graph/Object Set Show Transparent
ComfyUI Node

Object Set Show Transparent

Ghost a mesh in the viewport

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

Object Set Show Transparent toggles show_transparent, the Blender viewport flag that draws a mesh semi-transparent - the "X-Ray mode" look where you can see through a face layer to the jaw and eyes behind it. If you're trying to verify that the eye meshes actually sit inside the head, or that eyelids line up with the eyeball, this is the node that lets you look inside.

How it works

Auto-generated setter from bpy.types.Object's properties: setattr(object, "show_transparent", value) on the embedded bpy instance, returning the same BPY_OBJ. The value input is a BOOLEAN with default false. Set true and the object renders transparent in the viewport, letting you see what's behind it.

In the Avatar Graph context this is pure inspection tooling - the avatar's actual transparency comes from materials and alpha in the export, not from this flag. You enable it while you're building and checking the rig (are the eyeballs inside the head? does the tongue layer sit right?), then disable it before you judge the final look, since a transparent layer will mislead you about the finished appearance. It complements show_in_front: transparency lets you see through a part, in-front pushes a part above everything else - different tools for different debugging moods.

The inputs

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

Output: the same BPY_OBJ for chaining.

Install & gotchas

Ships inside the Avatar Graph pack:

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 → "Avatar Graph". Pack-level gotchas: bpy==3.6.0 requires Python 3.10 - no bpy wheel for 3.11+, so the pack fails to import on newer environments (conda python=3.10 per the README). First launch downloads a ~2.5 GB SAM model and mediapipe landmarker files.

Don't expect this flag to leak into the render or the exported avatar - it never does, and you don't want it to. The realistic confusion is leaving it on and wondering why the character looks washed out in the preview; it's just the viewport ghosting. Same setters' rules as ever: downstream of object creation (the bpy scene resets each queue run), and the pack's live editor preview needs ComfyUI started with --enable-cors-header, otherwise you still export via Save File on Avatar Main Output but lose the realtime view.

Categoryblender

Inputs (2)

NameTypeDefaultDescription
BPY_OBJoptBPY_OBJ
valueoptBOOLEANfalse

Outputs (1)

NameTypeDescription
BPY_OBJBPY_OBJ