Nodes/Avatar Graph/Object Set Show Instancer For Render
ComfyUI Node

Object Set Show Instancer For Render

Keep or drop instancers in the final render

By avatechai·Created 3 years ago·Updated 2 years ago· 264
Object Set Show Instancer For Render
  • BPY_OBJ
  • BPY_OBJ
valuetrue

An instancer is an object that spawns other objects - think particle emitters, dupliframes, or instances of a mesh. Object Set Show Instancer For Render toggles show_instancer_for_render, the Blender flag that decides whether the instancer itself appears in the final render or only its instances do. Default is true, so the instancer renders along with what it spawns.

How it works

One of the auto-generated setters from bpy.types.Object's property list: it runs setattr(object, "show_instancer_for_render", value) in the embedded bpy instance and returns the same BPY_OBJ. The value input is a BOOLEAN with default true.

For most Avatar Graph work this node is a non-event - the pack's mesh layers aren't usually instancers. Where it matters is when your scene uses instancing, e.g. particle hair, dupliverts, or a collection instance. Set show_instancer_for_render to false and the emitter/instancer object vanishes from the render while the spawned instances stay - handy when the instancer is just invisible scaffolding you don't want in the output. Its viewport counterpart is show_instancer_for_viewport (separate node), so you can show the instancer on screen while hiding it from the render, or vice versa.

The inputs

  • BPY_OBJ - the instancer object (particle emitter, dupliface mesh, collection instance).
  • value - boolean, default true.

Output: the same BPY_OBJ for chaining.

Install & gotchas

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

Honest take: unless your graph actually builds instancers, you'll never touch this flag, and the default true is almost always right. The subtle trap is confusing it with the viewport version - if an instancer shows in the editor but you expected it hidden, you're looking at the wrong node; this one only controls the render. Same as every setter: wire it downstream of creation (scene resets each queue run), and the live editor preview needs --enable-cors-header.

Categoryblender

Inputs (2)

NameTypeDefaultDescription
BPY_OBJoptBPY_OBJ
valueoptBOOLEANtrue

Outputs (1)

NameTypeDescription
BPY_OBJBPY_OBJ