Shader Output
Render dialog, still and sequence export, pipelines, Dome, linear EXR, image inputs and recovery
Last updated: 2026-11-20
Render on the Workshop dock opens the Render dialog. Compile, autosave and Import are on Shader Workshop. The preview controls are on Shader Controls.
Render dialog
The dialog opens on the Sequence tab. Still and Sequence switch between one image and a frame sequence. Without an operational Standard or Pro license the dock button is locked: "Render Sequence needs an operational Standard or Pro license". The dialog title Render Shader is announced to screen readers.
Projection is 360° Equirectangular, Azimuthal Dome or Angular Dome. Encoding is PNG, JPG or EXR. Supersampling can be Off (1×), 1.5×, 2× or Custom. The final image size does not change. The dialog preview is an sRGB picture of the setup. It is not scene-linear EXR data.
Output on the Workshop sets the saved panorama size, locked to 2:1, from 1K through 16K or a custom size. Import uses that size. A separate viewport resolution is remembered on this device and does not change the saved output.
Still
A still equirectangular PNG or JPG is opaque sRGB over the saved background. Guides and overlays are not included. Dome stills are square. Field of view, Pan, Tilt and Roll frame a Dome still. Reset to preview framing returns to the preview pose.
Export PNG, Export JPG or Export EXR writes the file you name. Afterwards you can Save another copy, Retry same file or Stop. Save to says "You choose the file name and folder when you export." Reset still choices and Reset Dome choices restore the dialog defaults.
Framing, supersampling and the estimate
Dome framing reads Framing · From preview, Custom or Unavailable. The fields are Field of view (10–360), Pan (−180–180), Tilt (−90–90) and Roll (−180–180). Reset to preview framing returns to the preview pose. If the pose is unknown, Confirm the dome pose offers Save Shader or Use 360° Equirectangular.
Supersampling is Off (1×), 1.5×, 2× or Custom ("Custom scale"). The final image size does not change. The help line is "One sample per pixel." or "N× the pixel work." A custom value must be a plain number such as 1.25, and a finite scale of at least 1. Browser pipelines add a JPEG quality slider from 50 to 100, or PNG · Browser-managed.
Render time shows Estimated render, "Approximate · from preview." The value is "≈ {duration}", Stale or Unavailable. How this is estimated says it comes from one preview of a frame, and that it excludes file encoding and writing, and process launch and transfer. Scenes whose cost changes over the timeline can differ. Refresh after the source, Start or FPS changes. Last preview processing breaks the time into Startup, Selected frame and Prior history replay.
The dialog preview has an Auto refresh checkbox. "Display preview in RGB8 sRGB. It is not scene-linear EXR data and does not show JPEG compression." Fit, Zoom out and Zoom in frame that picture.
Sequence
A sequence samples Start + n/FPS, strictly before End, with N = ceil((End − Start) × FPS) frames. A Shader sequence has no frame cap, so a long show such as 30 minutes at 30 fps (54,000 frames) is allowed. Real disk, memory, renderer and replay limits still apply and are shown before submission. Fractal keeps its own 10,000-frame cap. The setup image labels the Workshop sample. It does not preview the whole Start–End interval.
Preserve 360° appearance is a Dome switch, off unless you chose it before. The tooltip says "Render the full 360° image first, then map it to the dome. Uses more computation and increases render time to preserve shader colors and effects." Compress PNG is for PNG when the browser is not the encoder. "Smaller files; may take longer. Image quality is unchanged."
Advanced rendering shows Processing only for App - High precision: Automatic or CPU ("The compatibility option."). Status can read "Checking render settings…" or "Could not check render settings." with Retry. Size estimates shows Per frame (raw) and Total (raw).
Sequence report
When the render finishes, the report lists Status, Frames saved as N / M, Rendering time and Last frame. Settings shown are Projection, Resolution, Format, Preserve 360° appearance (Dome only), Supersampling, Range, Frame rate and Frames. The location row has Open in Explorer, plus Render files when they are stored elsewhere.
Once the render is accepted, the Workshop pauses editing. The dock shows the phase, the pipeline, a percent, verified frames and an ETA. Hold keeps the displayed frame. Follow latest advances. Watch in viewer opens verified frames in the main 360 viewer. Details returns to the dialog. Return to editing waits until rendering and cleanup settle. Stop asks the job to stop. Closing the dialog or leaving the Workshop keeps the accepted work running while the app is running.
Audio
A Shader with audio tracks renders them with the sequence. Every enabled audio signal is frozen into the job when the render is accepted. The dialog shows Ready, Preparing, Change pending, Failed or No curve, and a render never starts by itself when preparation finishes. The frames get companions: soundtrack-<track>.wav for each audio track and timing.json. MIDI, curve and label tracks have no soundtrack file. Signal offset (ms) and Monitor latency never shift the companions. See Audio Reactive Shaders.
Playable freeze and temporal passes
Starting Render Sequence on a Shader with controls freezes those controls from the last drawn preview frame and uses them for the whole render. The dialog says "Camera pose and toggles are frozen from the current preview. Live movement is paused; time animation continues. Continue keeps the original capture." If the capture no longer matches, wait for a current completed preview and render again. An input that needs interaction history is refused. Camera position and toggle controls can be frozen from a completed preview. Editing stays blocked until the render settles.
A history-dependent Shader has extra limits: no supersampling above 1×, a 2:1 source size, and a cap of 2048 wide and 240 frames for frame accumulation. Temporal passes are checked for memory and replay cost. If the pipeline cannot resume one, the message is "This pipeline cannot resume a history-dependent Shader. Your saved frames remain in the folder." The one-frame trail itself is under A spherical trail.
Pipelines
The pipeline list, fastest first:
| Pipeline | What it does |
|---|---|
| Viewer - App codec | Fastest. The app encodes the viewer's display pixels. Float data is not restored. |
| Viewer - Browser codec - Direct save | The browser encodes and the desktop saves. |
| Viewer - Browser codec via app | The browser encodes and the app service saves. |
| Viewer - High precision | The viewer sends float tiles and the app encodes. Sequence export is EXR only. |
| App - High precision | The app processes in float through the final conversion. It works with the viewer closed. |
Viewer - High precision can write only EXR sequences. Viewer - App codec can also write EXR sequences. A PNG or JPG sequence on the high-precision viewer pipeline is refused. Only a still EXR requires App - High precision or Viewer - High precision. An EXR sequence does not.
The closed picker shows Recommended or Unavailable. App - High precision is always available and works with the viewer closed. A pipeline can be unavailable because of Open Shader Workshop, Desktop app required, Not qualified on this system, PNG/JPG only, Pipeline unavailable or "Unavailable pipeline ({name})". Starting can also stop on Unsupported render pipeline, Choose a valid supersampling scale, Confirm the dome pose or "Browser JPEG quality must be 50–100."
A sequence uses the same projections as a still, and PNG, JPG or EXR. 2:1 sizes run from "1024 × 512" to "32768 × 16384". Output supersampling is Off (1×), 1.5×, 2× or Custom ("Custom scale (1× or higher)").
Dome
Navigator's Dome tab has Export Dome while a Shader is open in the Workshop. It opens this dialog on the Sequence tab and uses the current dome pose as the starting frame. It stays disabled until the Workshop has a current dome snapshot.
Dome output is square. Size is one Resolution field, "Diameter in pixels", plus Preset sizes: Custom, 1K (1024×1024), 2K (2048×2048), 4K (4096×4096) and 8K (8192×8192). Field of view is 10–360°. Outside the dome disk, PNG and JPG are opaque black. A Dome EXR leaves that area transparent. Guides are not included.
Linear EXR still
On the Still tab, choose 360° Equirectangular and EXR. The size stays 2:1 at any width. Export EXR writes one saved native frame: scene-linear float RGBA, OpenEXR ZIP. "Preserve 360° appearance is a Dome choice. This EXR stays a 2:1 panorama." At 4096 wide the caption notes that a trail still stops at 2048 × 1024.
The Shader must already be saved: "Linear EXR requires a saved 360° Shader." The pipeline must be App - High precision or Viewer - High precision. The file is created only when that path is absent. An existing target, an unsupported space, a missing codec or a budget refusal does not fall back to PNG.
Dome EXR is the same float RGBA writer on a square Dome projection. Export EXR is the button. Outside the disk is transparent.
This host profile adds no .hexshader capability. Linux software proof covers 2048 × 1024 and 4096 × 2048 under the 832 MiB helper guard. It does not qualify an installed GPU or a receiving application. See ribbon and exposure-over steps.
A spherical trail
hxPriorColor reads one prior full frame. Play steps one frame. Pause holds. Seek and Reset replay from the start. Sequence and linear EXR replay first, then use the existing writers. The trail stops at 2048 × 1024 and 240 frames. 4K is refused. Feedback sequence rendering supports 1× sampling. Higher supersampling is refused before rendering. The one-frame trail also refuses held image inputs it cannot bind.
That trail is passes mode accumulate. buffers is a separate ordered program of two to five passes, the last of them hxMain. feedback is a feedback buffer of its own. The three modes are on the format page. There is no graph editor.
Image inputs
The Image inputs card has Add image input. Each input's … menu has Replace…, Locate and Remove. The picker Add image to Input N has Renders and Sequences tabs, plus search. Only a finished, full image can be picked. Shape is 360 or Flat. Resolution is Full, 4K, 8K, 12K or 16K. The app stores its own copy, so a later change to the Render does not change the Shader. Confirm with Use as Input N…, or Make reduced copy when you chose a smaller resolution.
From frame and to must be a complete range. Use A–B suggests complete ranges. Original frame numbers are kept. Confirm with Use frames A–B as Input N.
Time is Hold frame (pick a Frame) or Follow Shader time. When following, At the end is Hold last or Loop. Range stays editable. Flat images use Clamp or Repeat. A 360 image wraps horizontally and clamps at the poles. Each image or frame must fit the preview's maximum texture size and the memory available.
Warp this image… appears when an input is attached and the code does not read it. It opens "Use Warp Source with ?", then Continue. You can create a new Shader named "Warp · " and leave the current one unchanged, or replace this Shader's code after a checkpoint named "Before Warp Source".
From an image… on New creates a Shader around a Render or a sequence range when nothing is open. When a Shader is open, it adds an image input instead.
Performance
The Output {size} pill is Shader output: 1K, 2K, 4K, 6K, 8K, 12K, 16K or Custom size, locked to 2:1. "Saved in the Shader. Import renders at this size." Separate viewport resolution ("Use a different resolution for the viewport.") reveals Viewport resolution. That choice is remembered on this device across Shaders and does not change the saved output.
Preview {choice} while playing is Auto, Full, 1/2, 1/4 or 1/8. While paused it is Full, 1/2, 1/4 or 1/8. It resets to Auto, 30 and Paused Full each time the Workshop opens. Status rows are Drawn, Drawing, Playback FPS and Viewport. The view is Sphere or Map.
Target FPS appears only when Playing is Auto. It accepts 1–120, with presets 15, 24, 30 and 60. "Auto adjusts resolution to aim for this frame rate. It does not change animation speed." A bad value says "Enter a whole number from 1 to 120."
Import quality is Supersampling for Import only: Off, 1.5×, 2× or Custom. The preview is unaffected. An invalid custom value blocks Import.
The Performance card summarizes "{fps} fps · GPU {ms} ms · compile {ms} ms", or "After first preview". Metrics are FPS, GPU time, Compile, Preview size and Final render. Final render stays "Not estimated yet". Before the first preview: "Measurements appear once the first preview renders." The Render dialog's own Render time estimate is the one that quotes a duration from the preview.
Capture Thumbnail (the camera button) saves the current preview frame as the Library cover. Toasts are "Thumbnail saved" and "Thumbnail could not be saved". It stays disabled with "Preview not ready" until a preview exists. A cover is also captured the first time a saved Shader with no cover previews successfully. Covers and manual overrides are on Shader Library.
Recovery
Before rendering, the dialog checks the folder. The states are Ready to resume, Render in progress, Render complete, Render settings differ, Folder unavailable and Replacement interrupted. Each difference shows as "{field}: saved X · current Y".
A matching unfinished job can Resume render. View progress and Open folder open the work you already have. A conflict asks you to Choose another folder. Stop checking leaves the check. Recover replacement finishes an interrupted replacement.
Use saved render settings appears when the folder's saved render can be reused. It renders from the saved Shader and settings: "Using saved render settings and Shader source. Your current Shader remains unchanged." Return to current settings switches back.
Start over… is shown when no render is live in the folder and either saved settings are in use or the Shader has no unsaved changes. The confirmation "Start over?" says "The owned frames and sequence metadata will move to .hextile-history. A new sequence will render from the beginning with the displayed settings. Other files stay in place." The buttons are Cancel and Start over. An older layout says "Start over is unavailable for this older sequence layout. Choose another folder to render from the beginning."
After a restart, interrupted work needs an explicit recovery. A lost reply means you check the existing sequence before a fresh request.
Folder layout for native jobs is also covered in Exporting Sequences.