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
- Select Format Converter as the pipeline.
- In Input, choose the source image and its actual projection. Check the 180° source-FOV limitation above for fisheye input.
- In Output, choose the target projection, dimensions and PNG/JPG encoding. Adjust quality for JPG and the visible orientation/FOV controls as needed.
- 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.
- 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.
- 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.
- 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.
- Choose Start Batch Conversion and monitor the filename/count.
- 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.