Eve library

Neural Shader Artist Tuning Guide

Guide

Revision 1

On this page

Maya neural shaders replace expensive material graph regions with trained material-evaluation networks. Use this guide when a material has completed the PBR training pipeline and needs artist review before it ships as a neural shader path.

Overview#

The artist tuning interface is a review workspace, not a modeling tool. It connects the training corpus, neural-vs-traditional profiling, debug overlays, platform abstraction, and fallback path into one guarded signoff flow.

Keep the workspace focused on decisions artists can make:

  • Select a material slot and review the exposed output features.
  • Choose a performance, balanced, quality, or cinematic preset.
  • Compare neural output against the traditional shader path.
  • Inspect Delta E, normal error, confidence, and feature attribution overlays.
  • Confirm platform parity and fallback availability before approval.

When to use neural shaders#

Use neural shaders for complex material graphs where the trained network is faster than the authored shader and preserves visible material intent:

  • Layered PBR stone, moss, paint, mud, fabric, or procedural trim materials.
  • Materials with repeated node patterns that train well from parameter sweeps.
  • Platform targets with cooperative vectors, cooperative matrices, Metal ML, or an accepted scalar fallback.
  • Materials whose traditional path remains available for unsupported hardware.

Avoid artist signoff when the training corpus is sparse, when debug parity is missing, or when the neural shader only wins on one target while regressing others. Fix those gates before tuning visual thresholds.

Artist controls#

Tune these controls in order:

Control Typical range What it changes
Preset Performance to cinematic Starting guardrails for quality and cost.
Max Delta E 0.6-1.5 Allowed color difference from the traditional shader.
Max normal error 0.015-0.04 Allowed geometric response drift.
Max shader cost 0.03-0.09 ms Per-material inference budget.
Debug parity required On for shipping Blocks signoff unless debug samples match.
Fallback parity required On for broad platforms Requires a traditional shader route.
Delta heatmap On during review Highlights visible divergence.
Feature attribution On when tuning Shows which feature dominates an error.

Use the performance preset for gameplay-heavy materials that are rarely viewed close up. Use the quality or cinematic presets for hero surfaces, close-up props, and captured marketing scenes.

Training data#

The tuning interface should show the generated training corpus before exposing approval controls. Require:

  1. PBR library materials with gold-standard traditional render captures.
  2. Coverage across base color, normal, roughness, metallic, ambient occlusion, and emissive features when those features are authored.
  3. Holdout Delta E, roughness error, and normal error below preset guardrails.
  4. Derivative features for normal-heavy or procedural materials.
  5. Procedural coverage when the material graph uses noise, sweeps, triplanar blending, curvature, or animated parameters.

If coverage is low, add material captures or parameter sweeps. Do not loosen artist thresholds to compensate for missing training data.

Debug views#

Review these overlays before approving a neural shader:

  • Neural base color beside traditional base color.
  • Delta E heatmap with an agreed clamp.
  • Normal error overlay for tangent-space drift.
  • Scalar parameter error for roughness and metallic.
  • Feature attribution to isolate the dominant output mismatch.
  • Confidence mask for low-confidence regions.
  • Activation probes for saturated or dead hidden units.

Bright heatmap bands on silhouettes, wetness transitions, emissive edges, and procedural noise boundaries usually indicate missing captures or feature drift. Retune the corpus or fallback region before increasing preset tolerance.

Platform targets#

The interface should summarize every shipping target:

  • DX12 cooperative vector target and shader model support.
  • Vulkan cooperative matrix target and SPIR-V extension support.
  • Metal ML or scalar shader fallback on Apple targets.
  • Shared weight memory and per-target inference cost.
  • Traditional fallback availability for unsupported hardware.

Do not approve a material if the selected preset passes on the development GPU but fails a required platform target. Ship the traditional fallback for that platform or reduce the network/preset until parity is restored.

Shipping signoff#

Approve a neural shader only when all signoff gates pass:

  1. Training data pipeline is ready and coverage meets the selected preset.
  2. Profiling recommends the neural shader over the traditional path.
  3. Debug visualization reports parity-validated samples and healthy activations.
  4. Required platform targets are native or have accepted fallback paths.
  5. Traditional shader fallback parity is available when required.
  6. This guide's required sections are available from the tuning workspace.
  7. Material feature controls cover every output feature used by the material.

If a gate fails, keep the material in guardrailed tuning mode. Do not mark the asset as artist-approved until the interface reports no blocking issues.