Format Converter

Convert panorama projections or process a folder without an AI model

Last updated: 2026-10-27

Overview

Format Converter changes image projection without diffusion. It needs no AI-model download, but ordinary conversion uses GPU resources. Speed and memory use depend on image size and projection; it is not an instant, zero-VRAM task. Select it from the Diffusion tab's pipeline selector, then configure Input and Output. It is not a separate Create source.

Supported Formats

Projection Input Output Check
Equirectangular Yes Yes Full sphere, normally 2:1.
Fulldome Yes Yes Equidistant square domemaster; current UI assumes 180° source FOV, while target FOV is configurable.
Fulldome Angular Yes Yes Equisolid-angle fisheye; not interchangeable with equidistant.
Cubemap Cross Yes Yes Horizontal 4:3 cross. Six separate faces are an image Export layout, not this input format.
Rectilinear No Yes Flat perspective, horizontal FOV 1–170°.
Stereographic No Yes Wide fisheye/little-planet view, horizontal FOV 1–330°.

Set the input projection to match the file; a wrong source projection gives wrong geometry rather than detecting the right one. The current single-image and folder UI does not expose a source-FOV control: affected fisheye inputs are interpreted with a 180° source FOV. It does not auto-detect another capture FOV. Use compatible sources; prepare a correctly reprojected input before using this UI for a non-180° fisheye. Output FOV is a separate, configurable choice for the new view. Dome output is square (FOV 10–360°); cubemap cross is 4:3. Use the format's size presets and inspect orientation.

Single Image

  1. Select Format Converter as the pipeline.
  2. In Input, choose the source image and its actual projection. Check the 180° source-FOV limitation above for fisheye input.
  3. In Output, choose the target projection, dimensions and PNG/JPG encoding. Adjust quality for JPG and the visible orientation/FOV controls as needed.
  4. Inspect the conversion preview. For example, an equirectangular panorama to Cubemap (Cross Layout) needs a 4:3 output; equirectangular to Fulldome needs a square output and the venue's desired FOV.
  5. Choose the output location/naming, start processing and inspect the completed image. Keep the original for another conversion.

PNG/JPG delivery is 8-bit display-image output, not native HDR-range preservation. Folder conversion can retain available alpha in PNG; JPG drops alpha. Inspect the result rather than assuming the source transparency survives every other pipeline/export path. PNG/JPG selection in this UI does not expose all codecs accepted by specialist integrations. For native Shader HDR/alpha use its separate Shader export task. For ordinary render export encodings, see Exporting Images.

Batch Conversion

The Batch Convert card appears in Format Converter's Output panel. It processes a folder using the current conversion settings; it is separate from an AI sequence or the optional Batch Workflow feature.

  1. Configure source/target projections, output dimensions, orientation, output FOV and encoding first. Source FOV remains 180° for affected inputs; it is not copied from a separate input-FOV control. Test one representative image.
  2. Choose Select Input Folder... and Select Output Folder.... Use different folders, with a fresh output folder for each run; output cannot resolve to the input folder. An active licence is required to start folder conversion.
  3. Choose Start Batch Conversion and monitor the filename/count.
  4. Inspect Completed, Failed and the per-file errors. A finished batch can still contain failed files; verify the actual destination before delivery.

Only the selected folder is scanned, not its subfolders. Supported source extensions are PNG, JPG/JPEG, TIFF/TIF, BMP and WebP, sorted by name. Filenames already ending in a projection suffix such as _cubemap, _angular, _fulldome, _rectilinear or _stereographic are skipped, even when that suffix is part of an original filename. Stage a renamed copy in another input folder if such a source must be converted. Output names use the source stem and target projection suffix; they do not use every still-render naming token. Existing files at those names can be overwritten, including two source files with the same stem. Preserve previous outputs and avoid duplicate stems in the input set.

Stop requests cancellation between files or while waiting for admission; a current conversion may finish before it settles. Completed files remain. Closing the panel or losing its progress connection is not proof the job stopped. Folder jobs are not a durable restart queue. After a crash, inspect and preserve completed outputs, prepare a separate folder of remaining sources and choose a fresh destination before starting another job. Reusing the original folders can replace already completed files; the still-render Auto-rename/Skip setting does not protect this folder-conversion writer.

Rectilinear Extraction

For a single saved panorama, Reframe provides a posed rectilinear or stereographic Shot with its own save/export options. That Quick Shot path runs on the CPU; it does not mean every Format Converter projection has a CPU fallback. The main image Export dialog offers Rectilinear as a Reframe handoff and has no stereographic option.

Troubleshooting

For a refused conversion, check input projection, source availability, target shape/FOV, destination and available memory. Lower output size if memory is insufficient; selecting a large preset is not a resource reservation. For busy, interrupted or uncertain work, follow Rendering and Recovery.

Esc
Searching...
No results found.
Type to search the documentation
↑↓ Navigate ↵ Select Esc Close

We use cookies for analytics to understand how visitors use our site. Privacy Policy