Object Set Show Empty Image Orthographic

Object Set Show Empty Image Orthographic toggles show_empty_image_orthographic, the Blender flag that controls whether an empty's image texture is visible when the viewport is in orthographic mode. It's a viewport-display control with a default of true, so in practice this node is mostly about turning the image off - or keeping it visible deliberately while you work in a flat, top-down view.

How it works

Another auto-generated setter from bpy.types.Object's properties: setattr(object, "show_empty_image_orthographic", value) against the embedded bpy instance, returning the same BPY_OBJ. The value input is a BOOLEAN with default true. Set it false and the empty's image vanishes in ortho view while staying visible in perspective.

It works together with show_empty_image_perspective (its own node, Object Set Show Empty Image Perspective) and show_empty_image_only_axis_aligned. The trio forms the visibility logic for image-carrying empties: per-view-type gate × axis-alignment gate. This node handles just the orthographic half of the per-view-type gate. If you're modeling against a character image on an empty, you'll usually leave orthographic on and perspective off - that way your reference only shows in the flat views you actually draw in. That's the classic reference-image setup, and the default true here is what makes the reference visible in ortho from the start.

The inputs

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

Output: same BPY_OBJ for chaining.

Install & gotchas

Ships with the Avatar Graph pack - install 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 → "Avatar Graph". The pack pins bpy==3.6.0, which demands Python 3.10 in your ComfyUI env - no bpy wheel exists for 3.11+, so the pack won't load otherwise. Conda python=3.10 per the README. First launch downloads a ~2.5 GB SAM model and mediapipe landmarker files.

Reality check: these empty-image view flags are the long tail of the pack's setters. If you never use image empties as references, this node is pure noise - leave it alone. When you do use one, the useful pattern is ortho on / perspective off for a drawing reference. And the usual rules hold: viewport-only, downstream of creation (scene resets each run), and --enable-cors-header for the live editor preview.