WHERE

Menu bar → File → Open Scene… (⌘O).

TECHNICAL

Opens a file dialog for the formats RadianceScene bundle, .ply, .splat and .spz. Single selection, can show both files and directories (for the bundle format). After a successful selection the path is added to the Recent list and the scene is loaded asynchronously — the previous one is replaced and the training pipeline is initialized with the loaded state. PLY/SPZ/Splat files are read via their respective format loaders; the .radiancescene bundle is a directory with manifest, cloud snapshot, and SfM results.

WHERE

Menu bar → File → Save Scene… (⌘S).

TECHNICAL

Opens a file save dialog with the content type RadianceScene bundle and a prefilled filename scene.radiancescene. Writes a directory package with manifest.json, the serialized Gaussian cloud (PLY snapshot) and a dump of the SfM result, so that continue training also works after reopening. The entry is disabled as long as no Gaussians exist yet. Does not save to the training-logs path but to wherever the save dialog points — typically under ~/Documents/.

WHERE

Menu bar → File → Open Recent → (list).

TECHNICAL

Dynamic submenu generated from a list of recently opened paths (stored in the settings). Each list entry is labeled with the filename and loaded on click. If the list is empty, the disabled label "No Recent Scenes" appears instead. Apple-style, the list holds the N most recently opened scenes — the limit is enforced when writing to the settings, not in the menu builder itself.

WHERE

Menu bar → File → Open Recent → Clear Recent.

TECHNICAL

Clears the Recent list in the settings. Takes effect immediately, without a confirmation dialog. The entry only appears in the submenu when there are actually entries in the Recent list (it sits below a divider after the paths).

WHERE

Menu bar → File → Import COLMAP / Metashape Workspace… (⇧⌘I).

TECHNICAL

Opens a folder picker. Expects a folder with the COLMAP workspace layout (e.g., sparse/0/cameras.{bin,txt} plus images/). After selection, a workspace pre-check is run — it detects the three layouts (sparse/0/, sparse/, root) and whether the reconstruction is binary (cameras.bin) or in ETH3D text form (cameras.txt). On success the workspace is imported; otherwise only a warning appears in the app log. See also Chapter 9 "SfM Backends", Q6 for the full pipeline logic.

WHERE

Menu bar → File → New Project (⇧⌘N).

TECHNICAL

Checks whether unsaved work is present. If so, a confirmation dialog appears before anything gets lost. If there's nothing to save, the reset runs immediately — it clears imported images, the SfM result, the Gaussian cloud, training state and all dependent UI indicators. Note: A user-created preset library is preserved because it lives in the app settings and not in the project state.

WHERE

Menu bar → Mode → Simple Mode (⌘1).

TECHNICAL

Switches the app state to Simple Mode. The main area of the app then shows the guided workflow instead of the Expert layout. The mode state is stored in the settings (see S1 "Default Mode" in Chapter 3 Settings).

WHERE

Menu bar → Mode → Expert Mode (⌘2).

TECHNICAL

Switches the app state to Expert Mode. This brings up the full Inspector layout with all sections (Presets, TrainingConfig, Enhancements, Metrics, LossChart, ProjectNavigator). In Expert Mode all training parameters, COLMAP picker, mid-compact toggles, and diagnostics are accessible. The live preview also only works in this mode.

WHERE

Menu bar → Training → Start Training (⇧⌘T).

TECHNICAL

Starts the training pipeline asynchronously. Prerequisite: an SfM result exists and no other pipeline is currently running. Both conditions block the entry if not met. On start, the current configuration values are read, a new JSONL log under ~/Documents/RadianceKit/Logs/training_YYYY-MM-DD_HHmmss.jsonl is created, and depending on the strategy choice the classic or the MCMC path is taken. The training state switches from "idle" to "training".

WHERE

Menu bar → Training → Pause Training.

TECHNICAL

Pauses the running training. Only enabled when the training state is "training". Pausing stops the iteration loop at the next safe sync point, keeps the full GPU state (Gaussian buffers, optimizer moments, scheduler position) and switches to "paused". Resume happens by pressing it again (the entry title is static — but the app toggles between Pause/Resume in the actual logic). Paused trainings do not survive an app quit; in that case save the scene instead and extend it later via a Continue Training entry (M12–M14).

WHERE

Menu bar → Training → Cancel Training.

TECHNICAL

Cancels the running training. Active when the training state is not "idle". Sets the cancel flag in the training engine, which cleanly ends the iteration loop at the next sync point, writes the final summary entry into the JSONL log, and resets the state to "idle". The cloud trained so far is preserved (can be saved or exported) but marked as "cancelled".

WHERE

Menu bar → Training → Continue Training → +5,000 iterations.

TECHNICAL

Continues training by 5,000 iterations. Active when a completed training run is resumable and the full version is unlocked. Resumability holds when a completed training run exists and the full optimizer state is still in memory. On continue, the Adam moments and the LR scheduler are carried forward, so the continuation behaves like a continuous 25K/45K/60K run rather than a restart. The JSONL log gets a new config entry with the incremental setup. Only available in the full version.

WHERE

Menu bar → Training → Continue Training → +10,000 iterations.

TECHNICAL

Identical to M12, but with 10,000 additional iterations. Same prerequisites, same LR scheduler path. Recommended when the initial training was run with a mid-tier preset and you want to see a significant quality improvement without restarting the run from scratch.

WHERE

Menu bar → Training → Continue Training → +20,000 iterations.

TECHNICAL

Identical to M12 / M13, but with 20,000 additional iterations. The largest preset continue jump. For MCMC training this is often what makes the difference between "okay" and "benchmark-grade"; for Classic, beyond 35–40K experience shows little is added.

WHERE

Menu bar → Viewport → Enter Edit Mode (or "Exit Edit Mode", depending on state). ⇧⌘E.

TECHNICAL

The entry title is dynamic and shows "Exit Edit Mode" or "Enter Edit Mode" depending on the state. On press, Edit Mode is toggled on the viewport renderer. On leaving Edit Mode, the current selection is also reset. Edit Mode activates click selection on Gaussians, box selection, and the deletion of marked Gaussians (see the editor area of the UI). Disabled as long as no viewport renderer is attached.

WHERE

Menu bar → Viewport → Toggle Auto-Rotation (⌘⌥T).

TECHNICAL

Toggles the continuous rotation of the viewport camera around a vertical axis through the scene center on or off. Axis and speed come from the camera control configuration. Auto-rotation is a pure viewport effect and influences neither training nor recording — if you use the turntable video recorder in parallel (M18), auto-rotation delivers exactly the path the recorder captures.

WHERE

Menu bar → Viewport → Toggle Camera Playback.

TECHNICAL

Toggles camera-path playback. If a recorded camera path exists (e.g., from a previous recording or because a transforms.json was loaded), the path plays back — the viewport camera no longer moves in response to mouse/trackpad input but reproduces the trajectory frame by frame. Pressing again pauses playback.

WHERE

Menu bar → Viewport → Record Turntable Video.

TECHNICAL

Toggles viewport recording. On first press, a frame recording starts to a temporary path; on second press, the recording is finished, encoded, and written to an MP4 path (the path is requested via a save dialog). Unlike Export → Media → Orbit Video (M31), which produces a fixed 360° path at a configurable duration, the turntable recorder captures live what you see in the viewport — so you can also record a manual camera move.

WHERE

Menu bar → Viewport → Save Screenshot (⇧⌘S).

TECHNICAL

Captures a single viewport frame at full render resolution (so not the window pixel layout but the full render-target contents) as a PNG file. The path is requested via a save dialog. The background color (M21–M23) is baked in. MetalFX/MPS upscaling settings from the Enhancements (see I27/I28) take effect if active — the screenshot then shows the upscaled output.

WHERE

Menu bar → Viewport → Copy Camera Info.

TECHNICAL

Reads the current viewport camera pose (position, look-at point, up vector) and the FOV values from the camera control and writes them as multi-line text to the clipboard. The format is human-readable (label = value per line), not JSON. Handy for reproducing a specific view for debugging purposes or sharing with support.

WHERE

Menu bar → Viewport → Background → Dark Gray.

TECHNICAL

Sets the viewport background color to a dark gray (RGB 0.1/0.1/0.1). The renderer uses this color as the background against which the Gaussians are composited. The default color at app start is controlled by the settings option S3 "Default Viewport Background".

WHERE

Menu bar → Viewport → Background → Black.

TECHNICAL

Sets the viewport background color to pure black (RGB 0/0/0). Helps when the scene has many bright floaters and you want to identify them, or for marketing material with a dark look-and-feel.

WHERE

Menu bar → Viewport → Background → White.

TECHNICAL

Sets the viewport background color to pure white (RGB 1/1/1). Useful when the scene has predominantly dark content and you want to see dark floaters (typical outdoor background noise).

WHERE

Menu bar → Viewport → Reset Camera.

TECHNICAL

Resets the viewport camera, leaves the training-camera view and stops auto-rotation. That puts the camera back at the initial position (typically: in front of the scene, looking slightly from above), auto-rotation is off, and if the renderer was showing the training camera (one of the SfM poses), it goes back to the free camera.

WHERE

Menu bar → Export → 3D Formats → PLY (⌘E).

TECHNICAL

Opens a save dialog with default filename gaussians.ply. On OK the current Gaussian cloud is written into the standardized ASCII/binary PLY format — compatible with SuperSplat, PolyCam, PlayCanvas and all common 3DGS viewers. Full SH coefficients, full precision (Float32 per field). File size often several hundred MB at ≥ 500K Gaussians.

WHERE

Menu bar → Export → 3D Formats → Compressed PLY.

TECHNICAL

Writes the Gaussian cloud in the compressed-PLY format with custom quantization of the position, scale, rotation, and SH fields. 5–10× smaller files than the uncompressed PLY (M25) with minimal visual loss. Compatible with SuperSplat (which reads the compressed-PLY standard) and PlayCanvas. Default filename gaussians_compressed.ply.

WHERE

Menu bar → Export → 3D Formats → SPZ.

TECHNICAL

Writes the Gaussian cloud in the SPZ format — the compressed splat format published by Niantic with aggressive quantization (~90 % smaller than uncompressed PLY). Mainly optimized for web viewers and mobile apps. Compatible with Niantic Splatt3R, gsplat.js, and the Niantic browser viewer.

WHERE

Menu bar → Export → 3D Formats → glTF.

TECHNICAL

Writes a .glb file (binary glTF) with the KHR_gaussian_splatting extension. Standard-conformant, suitable for pipelines that use glTF engines like Babylon.js or Three.js and implement the KHR_gaussian_splatting extension.

WHERE

Menu bar → Export → 3D Formats → .splat.

TECHNICAL

Writes the Antimatter15 .splat format — fixed-size 32 bytes per Gaussian (position as 3× Float32, scale as 3× Float32, rotation as 4× Uint8 normalized quaternion, RGB+opacity as 4× Uint8). No SH coefficients higher than DC. Smallest file with direct browser compatibility. For gsplat.js and antimatter15's online demo viewer.

WHERE

Menu bar → Export → 3D Formats → SOG.

TECHNICAL

Writes the Gaussian cloud in the SOG format. SOG ("Self-Organizing Gaussian") is the PlayCanvas format with texture-atlas layout and WebP compression of the quantized data. Scales with 15–20× better size ratio than PLY. The export calls cwebp as an external tool internally — so in the sandbox variant (App Store) potentially restricted.

WHERE

Menu bar → Export → Media → Orbit Video.

TECHNICAL

Renders a 360° orbit around the scene center and encodes it as MP4 (H.264) or MOV (HEVC, depending on system default). Unlike M18 (live recording), the path here is fixed — duration is chosen in the settings or in the Simple Mode export step.

WHERE

Menu bar → Export → Media → Web Viewer.

TECHNICAL

Packages a standalone HTML viewer (gsplat.js-based) plus the Gaussian data Base64-encoded into a single .html file. This file runs offline in any modern browser — no server dependencies, no external URLs. File size is about a factor of 1.3 larger than the SPZ variant (because of Base64 overhead).

WHERE

Menu bar → Export → Photogrammetry → Export SfM (transforms.json).

TECHNICAL

Dedicated export path (not via the common helper routine), because no Gaussian cloud but the SfM result is being exported. Opens a save dialog with transforms.json as the default and content type json. On OK a nerfstudio-compatible transforms.json with camera intrinsics, poses (as a 4×4 matrix in NeRF convention) and frame paths is written. Help text in the UI points out that the training images must be copied alongside as a sibling folder images/. Active only if an SfM result exists and the full version is unlocked.

WHERE

Menu bar → Export → Photogrammetry → Export SfM (COLMAP Workspace).

TECHNICAL

Opens a save dialog with default name colmap-workspace (without extension, because it's a folder). Writes a standard COLMAP workspace with sparse/0/cameras.bin, images.bin, points3D.bin. Lets you open an SfM reconstruction computed or imported in RadianceKit in other tools like Postshot, Nerfstudio, or Meshroom, or for an A/B re-run reload it as already-computed input in RadianceKit itself (via M5) — saves compute time. Active only if an SfM result exists and the full version is unlocked.

WHERE

Menu bar → Help → User Guide (⌘?).

TECHNICAL

Opens the User Guide window. It shows navigation with a topic sidebar and a scrollable detail area at default size 860×640. The contents are statically stored (not parsed from Markdown).

WHERE

Menu bar → Help → Keyboard Shortcuts (⌘/).

TECHNICAL

Opens the Keyboard Shortcuts window — a simple scroll layout with all app shortcuts, grouped by top-level menu. Default size 440×560. Contents are likewise statically stored.

WHERE

Menu bar → Help → Open Training Logs… (⇧⌘L).

TECHNICAL

Computes the log folder as ~/Documents/RadianceKit/Logs, creates it if necessary, and opens it in Finder. Each training run writes its own JSONL file training_YYYY-MM-DD_HHmmss.jsonl there.

WHERE

Menu bar → Help → Open Exports Folder…

TECHNICAL

Analogous to M37 but with ~/Documents/RadianceKit/Exports. Created on the first auto-test run or on the first click; after that the default paths of all auto-test exports (e.g., autotest_<timestamp>.ply) land there. Exports selected manually via the save dialog do NOT necessarily go here but wherever the user saves them — so this folder is mainly of interest for auto tests.

WHERE

Menu bar → Help → Manage Storage…

TECHNICAL

Opens the storage browser (see Chapter 4 Auxiliary Windows, IDs W7–W12). Lists all persisted scenes, training logs, exports, and caches in the ~/Documents/RadianceKit/ folder with size, allows reveal in Finder and move to trash per entry.

WHERE

Menu bar → Help → Pareto Dashboard… (⇧⌘D).

TECHNICAL

Opens the Pareto Dashboard (see Chapter 4, IDs W13–W22). The dashboard loads all JSONL training logs from ~/Documents/RadianceKit/Logs/, organizes them by scene and preset, and draws a Pareto scatter plot (default: loss vs Gaussians, optionally loss vs wallclock or PSNR vs iterations).

WHERE

Menu bar → Help → Holdout Analysis… (⇧⌘H).

TECHNICAL

Opens the Holdout Analysis window (see Chapter 4, IDs W23–W29). Loads a transforms.json, draws the cameras as a 3D globe, and allows train/test fold splits (angular or linear, 2–8 folds). Output is a fold-assignment.json that training can use as the test set in the respective training configs.

WHERE

Menu bar → Help → BayesOpt Console… (⇧⌘B).

TECHNICAL

Opens the BayesOpt Console (see Chapter 4, IDs W30–W39). Loads predefined search spaces (e.g., "MCMC scale-reg + opacity-reg + ssim"), runs Bayesian-optimization trials asynchronously, and shows the convergence curve and trial log live.