Render Capabilities
render_capabilitiesDiscover which photoreal renderers are usable now, including Blender and FreeCAD Render add-ons, and get install instructions for missing ones to avoid guesswork.
Instructions
Report which photoreal renderers are usable right now — Blender (the studio backend) and the FreeCAD Render add-on renderers — so you can pick one for render_photoreal, or tell the user exactly what to install, instead of discovering availability by trial and error.
Takes no arguments and renders nothing. Resolves Blender like a solver
(ANKUSDRIVE_BLENDER_PATH -> PATH -> per-OS install dirs, incl. the versioned
Blender Foundation\Blender X.Y and /opt|~/.local/opt/blender-*) and launches it
once (cached) to read its version and GPU; resolves each add-on renderer as
render_photoreal would, changing no settings.
Returns {default_renderer ('auto'), auto_selects (the renderer 'auto' would use
now, or None), recommended ('Blender'), platform, available (ready renderer names
for renderer=), renderers: {name: {available, backend ('blender' |
'render_addon'), path or install_hint, ...}} — Blender adds version, device, gpu,
oidn, supported, scenes, qualities, devices, finishes — materials (appearance card
names), appearance_fields (the PBR dict keys), addon_importable, addon_error (when
the add-on does not import), and suggestion {renderer, why, install} while
Blender is missing}. When the user wants better renders, relay the Blender
install_hint verbatim — never run installers yourself. setup_status reports the
same install under the studio_render family.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||