Object Set Show Empty Image Perspective

Object Set Show Empty Image Perspective toggles show_empty_image_perspective - the Blender flag for whether an empty's image is visible in perspective viewport mode. Default true, so like its orthographic sibling it's mostly a turn-it-off node: you'd flip it false when the reference image on an empty keeps cluttering your 3D view while you orbit the avatar.

How it works

Standard auto-generated setter: setattr(object, "show_empty_image_perspective", value) on the embedded bpy instance, then the same BPY_OBJ comes back out for chaining. The value input is a BOOLEAN with default true.

It's one of the three empty-image visibility flags in the pack, alongside show_empty_image_orthographic and show_empty_image_only_axis_aligned. The split is per view type: this one governs perspective, its sibling governs orthographic, and the third adds the axis-alignment requirement on top. For a drawing reference the common setup is the reverse of the default - ortho on, perspective off - so you see the image in the flat views you draw in and it doesn't float in your face while you orbit. If you prefer the image visible while rotating around the model, leave this at true.

The inputs

• BPY_OBJ - an empty carrying an image, usually from Object_ empty_add.
• value - boolean, default true.

Output: the same BPY_OBJ.

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 requirement: bpy==3.6.0 needs Python 3.10 - no wheel for 3.11+, so newer runtimes can't import the pack at all. Conda with python=3.10 is the README's path. First launch auto-downloads a ~2.5 GB SAM model and mediapipe landmarker files.

Don't overthink this one: it's a viewport nicety for image-carrying empties, and if you're not using them it's irrelevant. The flags that actually run an avatar graph are the naming, parenting, and transform setters. Standard traps: viewport-only (nothing in the render/export), wire it downstream of creation since the bpy scene resets each queue run, and start ComfyUI with --enable-cors-header for the live editor preview - otherwise the graph still runs and you can export via Avatar Main Output.