DOVE

Barra dei menu → File → Open Scene… (⌘O).

TECNICO

Apre una finestra di dialogo per i formati bundle RadianceScene, .ply, .splat e .spz. Selezione singola, può mostrare sia file sia directory (per il formato bundle). Dopo la selezione riuscita, il percorso viene aggiunto alla lista dei recenti e la scena viene caricata in modo asincrono — quella precedente viene sostituita e la pipeline di training inizializzata con lo stato caricato. I file PLY/SPZ/Splat vengono letti tramite i rispettivi loader di formato; il bundle .radiancescene è una directory con manifest, snapshot della cloud e risultati SfM.

DOVE

Barra dei menu → File → Save Scene… (⌘S).

TECNICO

Apre una finestra di dialogo di salvataggio con il tipo di contenuto bundle RadianceScene e nome file precompilato scene.radiancescene. Scrive un pacchetto di directory con manifest.json, la nuvola gaussiana serializzata (snapshot PLY) e un dump del risultato SfM, in modo che dopo la riapertura funzioni anche il continue-training. La voce è disabilitata finché non esistono ancora gaussiane. Non salva nel percorso dei log di training, ma dove indica la finestra di salvataggio — tipicamente sotto ~/Documents/.

DOVE

Barra dei menu → File → Open Recent → (lista).

TECNICO

Sottomenu dinamico generato da una lista dei percorsi aperti più di recente (salvati nelle impostazioni). Ogni voce della lista viene denominata con il nome del file e caricata al clic. Se la lista è vuota, appare invece l'etichetta disabilitata "No Recent Scenes". Tipico di Apple, la lista mantiene le N scene aperte più di recente — il limite avviene durante la scrittura nelle impostazioni e non nel builder del menu stesso.

DOVE

Barra dei menu → File → Open Recent → Clear Recent.

TECNICO

Svuota la lista dei recenti nelle impostazioni. Effetto immediato, senza finestra di conferma. La voce appare nel sottomenu solo se ci sono in generale voci nella lista dei recenti (si trova sotto un divisore dopo i percorsi).

DOVE

Barra dei menu → File → Import COLMAP / Metashape Workspace… (⇧⌘I).

TECNICO

Apre un selettore di cartelle. Si aspetta una cartella con il layout del workspace COLMAP (ad es. sparse/0/cameras.{bin,txt} più images/). Dopo la selezione viene eseguita una pre-verifica del workspace — questa riconosce i tre layout (sparse/0/, sparse/, root) e se la ricostruzione è binaria (cameras.bin) o come testo ETH3D (cameras.txt). In caso di successo il workspace viene importato; altrimenti appare solo un avviso nel log dell'app. Vedi anche il Capitolo 9 "Backend SfM", Q6 per la logica completa della pipeline.

DOVE

Barra dei menu → File → New Project (⇧⌘N).

TECNICO

Verifica se ci sono lavori non salvati. In caso affermativo appare una finestra di conferma prima che qualcosa vada perso. Se non c'è nulla da salvare, il reset avviene direttamente — svuota le immagini importate, il risultato SfM, la nuvola gaussiana, lo stato del training e tutti gli indicatori UI dipendenti. Attenzione: una libreria di preset creata dall'utente rimane preservata, perché si trova nelle impostazioni dell'app e non nello stato del progetto.

DOVE

Barra dei menu → Mode → Simple Mode (⌘1).

TECNICO

Commuta lo stato dell'app sulla Modalità principiante. L'area principale dell'app mostra allora il flusso di lavoro guidato invece del layout esperto. Lo stato della modalità viene salvato nelle impostazioni (vedi S1 "Default Mode" nel Capitolo 3 Impostazioni).

DOVE

Barra dei menu → Mode → Expert Mode (⌘2).

TECNICO

Commuta lo stato dell'app sulla Modalità esperto. In questo modo appare il layout Inspector completo con tutte le sezioni (Presets, TrainingConfig, Enhancements, Metrics, LossChart, ProjectNavigator). Nella Modalità esperto sono accessibili tutti i parametri di training, picker COLMAP, toggle Mid-Compact e diagnostiche. Anche la live preview funziona solo in questa modalità.

DOVE

Barra dei menu → Training → Start Training (⇧⌘T).

TECNICO

Avvia la pipeline di training in modo asincrono. Prerequisito: esiste un risultato SfM e attualmente non è in esecuzione un'altra pipeline. Entrambe le condizioni bloccano la voce se non soddisfatte. All'avvio vengono letti i valori di configurazione attuali, viene creato un nuovo log JSONL sotto ~/Documents/RadianceKit/Logs/training_YYYY-MM-DD_HHmmss.jsonl, e a seconda della scelta della strategia viene eseguito il percorso classico o quello MCMC. Lo stato del training passa da "idle" a "training".

DOVE

Barra dei menu → Training → Pause Training.

TECNICO

Mette in pausa il training in corso. Viene sbloccato solo se lo stato del training è "training". La pausa ferma il loop di iterazione al prossimo punto di sync di sicurezza, mantiene l'intero stato GPU (buffer gaussiani, momenti dell'optimizer, posizione dello scheduler) e passa a "paused". Il resume avviene tramite nuova pressione (il titolo della voce è statico — l'app passa però tra pause/resume nella logica effettiva). I training messi in pausa non sopravvivono a un quit dell'app; in tal caso salva piuttosto la scena ed estendila in seguito tramite la voce Continue Training (M12–M14).

DOVE

Barra dei menu → Training → Cancel Training.

TECNICO

Interrompe il training in corso. Attivo se lo stato del training non è "idle". Imposta il flag di cancellazione nel motore di training, il che termina pulitamente il loop di iterazione al prossimo punto di sync, scrive la voce di summary finale nel log JSONL e ripristina lo stato a "idle". La nuvola finora addestrata rimane preservata (può essere salvata o esportata), ma viene contrassegnata come "cancelled".

DOVE

Barra dei menu → Training → Continue Training → +5,000 iterations.

TECNICO

Continua il training di 5 000 iterazioni. Attivo se un training concluso è continuabile e la versione completa è sbloccata. La continuabilità vale se esiste un training concluso e l'intero stato dell'optimizer è ancora in memoria. Al continue, i momenti Adam e lo scheduler LR vengono proseguiti, in modo che la continuazione si comporti come un'esecuzione continua di 25K/45K/60K invece di un nuovo avvio. Il log JSONL riceve una nuova voce di config con il setup incrementale. Disponibile solo nella versione completa.

DOVE

Barra dei menu → Training → Continue Training → +10,000 iterations.

TECNICO

Identico a M12, ma con 10 000 iterazioni aggiuntive. Stessi prerequisiti, stesso percorso dello scheduler LR. Consigliato se il training iniziale è stato fatto con un preset di livello intermedio e vuoi vedere un miglioramento significativo della qualità senza dover ricominciare l'esecuzione da zero.

DOVE

Barra dei menu → Training → Continue Training → +20,000 iterations.

TECNICO

Identico a M12 / M13, ma con 20 000 iterazioni aggiuntive. Il più grande salto Continue predefinito. Per i training MCMC è spesso ciò che fa la differenza tra "funziona" e "adatto al benchmark"; con Classic da 35–40K spesso non viene più aggiunto molto secondo l'esperienza.

DOVE

Barra dei menu → Viewport → Enter Edit Mode (o "Exit Edit Mode", a seconda dello stato). ⇧⌘E.

TECNICO

Il titolo della voce è dinamico e mostra "Exit Edit Mode" o "Enter Edit Mode" a seconda dello stato. Alla pressione, la modalità modifica viene commutata sul renderer del viewport. All'uscita dalla modalità modifica, viene inoltre resettata la selezione attuale. La modalità modifica attiva la selezione tramite clic sulle gaussiane, la selezione tramite box e l'eliminazione delle gaussiane contrassegnate (vedi l'area Editor della UI). Disabilitata finché non è collegato alcun renderer del viewport.

DOVE

Barra dei menu → Viewport → Toggle Auto-Rotation (⌘⌥T).

TECNICO

Commuta on o off la rotazione continua della fotocamera del viewport attorno a un asse verticale attraverso il centro della scena. L'asse e la velocità provengono dalla configurazione di controllo della fotocamera. L'auto-rotazione è un effetto puro del viewport e non influenza né il training né il recording — se usi in parallelo il registratore video turntable (M18), l'auto-rotazione fornisce però esattamente il percorso che il registratore cattura.

DOVE

Barra dei menu → Viewport → Toggle Camera Playback.

TECNICO

Commuta il playback del percorso della fotocamera. Se esiste un percorso registrato (ad es. da un recording precedente o perché è stato caricato un transforms.json), il percorso viene riprodotto — la fotocamera del viewport non si muove più dunque secondo input di mouse/trackpad, ma riproduce la traiettoria frame per frame. Nuova pressione mette in pausa il playback.

DOVE

Barra dei menu → Viewport → Record Turntable Video.

TECNICO

Commuta la registrazione del viewport. Alla prima pressione inizia una registrazione di frame in un percorso temporaneo; alla seconda pressione la registrazione viene terminata, codificata e scritta in un percorso MP4 (il percorso viene chiesto tramite una finestra di salvataggio). A differenza dell'Export → Media → Orbit Video (M31), che genera un percorso fisso a 360° con una durata impostabile, il registratore turntable cattura in tempo reale ciò che vedi nel viewport — puoi quindi registrare anche una corsa manuale della fotocamera.

DOVE

Barra dei menu → Viewport → Save Screenshot (⇧⌘S).

TECNICO

Cattura un singolo frame del viewport a piena risoluzione di rendering (quindi non il layout dei pixel della finestra, ma l'intero contenuto del render target) come file PNG. Il percorso viene chiesto tramite una finestra di salvataggio. Il colore di sfondo (M21–M23) viene impresso. Le impostazioni di upscaling MetalFX/MPS dagli Enhancements (vedi I27/I28) hanno effetto se attive — lo screenshot mostra quindi l'output sovracampionato.

DOVE

Barra dei menu → Viewport → Copy Camera Info.

TECNICO

Legge la posa attuale della fotocamera del viewport (posizione, punto Look-At, vettore Up) e i valori FOV dal controllo fotocamera e li scrive come testo multi-riga negli appunti. Il formato è leggibile dall'uomo (etichetta = valore per riga), non JSON. Pratico per riprodurre una specifica vista a scopo di debug o condividerla con il supporto.

DOVE

Barra dei menu → Viewport → Background → Dark Gray.

TECNICO

Imposta il colore di sfondo del viewport su un grigio scuro (RGB 0.1/0.1/0.1). Il renderer utilizza questo colore come sfondo davanti al quale le gaussiane vengono composte. Il colore predefinito all'avvio dell'app è controllato dall'opzione Settings S3 "Default Viewport Background".

DOVE

Barra dei menu → Viewport → Background → Black.

TECNICO

Imposta il colore di sfondo del viewport su nero puro (RGB 0/0/0). Aiuta se la scena ha molti floater chiari e vuoi identificarli, o per materiale di marketing con look-and-feel scuro.

DOVE

Barra dei menu → Viewport → Background → White.

TECNICO

Imposta il colore di sfondo del viewport su bianco puro (RGB 1/1/1). Utile se la scena ha prevalentemente contenuti scuri e vuoi vedere floater scuri (rumore di sfondo tipico outdoor).

DOVE

Barra dei menu → Viewport → Reset Camera.

TECNICO

Resetta la fotocamera del viewport, esce dalla vista fotocamera del training e ferma l'auto-rotazione. In questo modo la fotocamera torna alla posizione iniziale (tipica: davanti alla scena, guardando leggermente dall'alto), l'auto-rotazione è spenta, e se il renderer stava mostrando una delle pose SfM (la training camera), torna alla free-camera.

DOVE

Barra dei menu → Export → 3D Formats → PLY (⌘E).

TECNICO

Apre una finestra di salvataggio con nome file predefinito gaussians.ply. Al clic su OK, la nuvola gaussiana attuale viene scritta nel formato PLY ASCII/binario standardizzato — compatibile con SuperSplat, PolyCam, PlayCanvas e tutti i viewer 3DGS comuni. Coefficienti SH completi, precisione completa (Float32 per campo). Dimensione del file spesso diversi centinaia di MB con ≥ 500K gaussiane.

DOVE

Barra dei menu → Export → 3D Formats → Compressed PLY.

TECNICO

Scrive la nuvola gaussiana nel formato Compressed PLY con quantizzazione personalizzata dei campi posizione, scala, rotazione e SH. File 5–10× più piccoli del PLY non compresso (M25) con perdite visive minime. Compatibile con SuperSplat (che legge lo standard Compressed PLY) e PlayCanvas. Nome file predefinito gaussians_compressed.ply.

DOVE

Barra dei menu → Export → 3D Formats → SPZ.

TECNICO

Scrive la nuvola gaussiana nel formato SPZ — il formato splat compresso pubblicato da Niantic con quantizzazione aggressiva (~90 % più piccolo del PLY non compresso). Ottimizzato soprattutto per viewer web e app mobili. Compatibile con Niantic Splatt3R, gsplat.js e il viewer browser Niantic.

DOVE

Barra dei menu → Export → 3D Formats → glTF.

TECNICO

Scrive un file .glb (Binary-glTF) con l'estensione KHR_gaussian_splatting. Conforme allo standard, adatto a pipeline che usano motori glTF come Babylon.js o Three.js e che implementano l'estensione KHR_gaussian_splatting.

DOVE

Barra dei menu → Export → 3D Formats → .splat.

TECNICO

Scrive il formato .splat di Antimatter15 — fixed-size 32 byte per gaussiana (posizione come 3× Float32, scala come 3× Float32, rotazione come quaternione normalizzato 4× Uint8, RGB+opacità come 4× Uint8). Nessun coefficiente SH superiore al DC. Il file più piccolo con compatibilità diretta browser. Per gsplat.js e il viewer demo online di antimatter15.

DOVE

Barra dei menu → Export → 3D Formats → SOG.

TECNICO

Scrive la nuvola gaussiana nel formato SOG. SOG ("Self-Organizing Gaussian") è il formato PlayCanvas con layout texture atlas e compressione WebP dei dati quantizzati. Scala con un rapporto di dimensione 15–20× migliore del PLY. L'esportazione invoca internamente cwebp come strumento esterno — quindi potenzialmente limitato nella variante sandbox (App Store).

DOVE

Barra dei menu → Export → Media → Orbit Video.

TECNICO

Renderizza un orbit a 360° attorno al centro della scena e lo codifica come MP4 (H.264) o MOV (HEVC, a seconda del default di sistema). A differenza di M18 (recording dal vivo), il percorso qui è predefinito — la durata viene scelta nelle impostazioni o nello step di esportazione della Modalità principiante.

DOVE

Barra dei menu → Export → Media → Web Viewer.

TECNICO

Impacchetta un viewer HTML standalone (basato su gsplat.js) più i dati gaussiani codificati in base64 in un singolo file .html. Questo file viene eseguito offline in qualsiasi browser moderno — nessuna dipendenza da server, nessun URL esterno. La dimensione del file è circa fattore 1.3 più grande della variante SPZ (per l'overhead di base64).

DOVE

Barra dei menu → Export → Photogrammetry → Export SfM (transforms.json).

TECNICO

Percorso di esportazione proprio (non tramite la routine helper comune), perché non viene esportata una nuvola gaussiana ma il risultato SfM. Apre una finestra di salvataggio con transforms.json come predefinito e tipo di contenuto json. Al clic su OK viene scritto un transforms.json compatibile con nerfstudio con intrinseci della fotocamera, pose (come matrice 4×4 in convenzione NeRF) e percorsi dei frame. Il testo di aiuto nell'UI segnala che le immagini di training devono essere copiate come cartella sibling images/. Attivo solo se esiste un risultato SfM e la versione completa è sbloccata.

DOVE

Barra dei menu → Export → Photogrammetry → Export SfM (COLMAP Workspace).

TECNICO

Apre una finestra di salvataggio con nome predefinito colmap-workspace (senza estensione, perché è una cartella). Scrive un workspace COLMAP standard con sparse/0/cameras.bin, images.bin, points3D.bin. Permette di aprire una ricostruzione SfM calcolata o importata in RadianceKit in altri strumenti come Postshot, Nerfstudio o Meshroom, o di ricaricarla in caso di re-run A/B come input già calcolato in RadianceKit stesso (tramite M5) — risparmia tempo di calcolo. Attivo solo se esiste un risultato SfM e la versione completa è sbloccata.

DOVE

Barra dei menu → Help → User Guide (⌘?).

TECNICO

Apre la finestra User Guide. Mostra una navigazione con sidebar dei temi e area di dettaglio con scroll a dimensione predefinita 860×640. I contenuti sono inseriti staticamente (non parsati da Markdown).

DOVE

Barra dei menu → Help → Keyboard Shortcuts (⌘/).

TECNICO

Apre la finestra Keyboard Shortcuts — un semplice layout a scorrimento con tutte le scorciatoie dell'app, raggruppate per menu di primo livello. Dimensione predefinita 440×560. I contenuti sono allo stesso modo inseriti staticamente.

DOVE

Barra dei menu → Help → Open Training Logs… (⇧⌘L).

TECNICO

Calcola la cartella dei log come ~/Documents/RadianceKit/Logs, la crea se necessario e la apre nel Finder. Ogni esecuzione del training vi scrive un proprio file JSONL training_YYYY-MM-DD_HHmmss.jsonl.

DOVE

Barra dei menu → Help → Open Exports Folder…

TECNICO

Analogo a M37, ma con ~/Documents/RadianceKit/Exports. Viene creata alla prima esecuzione del test automatico o al primo clic; dopo vi finiscono i percorsi standard di tutte le esportazioni dei test automatici (ad es. autotest_<timestamp>.ply). Le esportazioni selezionate manualmente tramite la finestra di salvataggio NON finiscono necessariamente qui, ma dove l'utente le salva — quindi questa cartella è interessante soprattutto per i test automatici.

DOVE

Barra dei menu → Help → Manage Storage…

TECNICO

Apre il browser di archiviazione (vedi il Capitolo 4 Finestre ausiliarie, ID W7–W12). Elenca tutte le scene persistite, i log di training, le esportazioni e le cache nella cartella ~/Documents/RadianceKit/ con dimensione, permette Reveal-in-Finder e Move-to-Trash per voce.

DOVE

Barra dei menu → Help → Pareto Dashboard… (⇧⌘D).

TECNICO

Apre il Pareto Dashboard (vedi Capitolo 4, ID W13–W22). Il dashboard carica tutti i log JSONL di training da ~/Documents/RadianceKit/Logs/, li ordina per scena e preset e disegna uno scatter plot di Pareto (default: loss vs gaussiane, opzionale loss vs wallclock o PSNR vs iterazioni).

DOVE

Barra dei menu → Help → Holdout Analysis… (⇧⌘H).

TECNICO

Apre la finestra di analisi Holdout (vedi Capitolo 4, ID W23–W29). Carica un transforms.json, disegna le fotocamere come globo 3D e permette split train/test fold (angolare o lineare, 2–8 fold). L'output è un fold-assignment.json che il training può utilizzare nelle rispettive configurazioni di training come set di test.

DOVE

Barra dei menu → Help → BayesOpt Console… (⇧⌘B).

TECNICO

Apre la console BayesOpt (vedi Capitolo 4, ID W30–W39). Carica spazi di ricerca predefiniti (ad es. "MCMC scale-reg + opacity-reg + ssim"), esegue trial di ottimizzazione bayesiana in modo asincrono e mostra la curva di convergenza e il log dei trial in tempo reale.