Changelog
Novità e correzioni di Replica, dalla versione più recente alle precedenti.
v1.4.1: 7 ottobre 2026
La 1.4.1 aggiunge la calibrazione AprilTag e migliora gli export VFX, il caricamento delle immagini e la gestione dei progetti.
Calibrazione AprilTag (Pro, Beta)
- Una barra dritta a due tag permette di impostare la scala in metri. Con la barra a L a tre tag puoi anche raddrizzare il modello, definire il piano di appoggio e scegliere origine e direzione +X.
- Find tags automatically trova i tag36h11 nelle immagini allineate. Puoi scegliere i centri nel viewer e assegnare A/B oppure Origin/X/Y. Se ci sono più barre, scegli quella da usare.
- Il JSON è facoltativo. Import JSON… (optional) legge ID e dimensioni nominali; puoi correggerle con le misure della stampa, che hanno la precedenza. Senza JSON, inserisci le misure a mano.
- Dopo aver applicato la scala, verifica un'altra distanza nota sul soggetto. La funzione è Beta e non certifica l'accuratezza metrica. La guida AprilTag Scale Bar descrive il procedimento.
Video e VFX
- L'export mantiene allineate mesh, camere fotografiche e camera animata. Applica una sola volta le trasformazioni correnti di Refine e dei gizmo e rifiuta scale non uniformi o non valide.
- Lo script
import_in_blender.pyimporta il bundle e imposta calibrazione, unità metriche, timeline e anteprima. Per il video prepara anche il compositor con i plate a piena risoluzione e la mesh come shadow catcher, conservando i contenuti estranei della scena. - I render di prova a risoluzione ridotta mantengono video e CG allineati. I bundle USD usano già Z come asse verticale, quindi in Blender non serve un'altra rotazione da Y-up a Z-up.
- Estrazione e tracking seguono i tempi effettivi dei frame decodificati, anche nei video con frame rate variabile. Lo smoothing conserva meglio le osservazioni affidabili. Trovi i passaggi in Import video e camera tracking e USD for VFX.
Due modalità per caricare le immagini
Il nuovo controllo Input Loading, disponibile in tutte le edizioni, offre due modalità:
- Save Memory carica le immagini una alla volta e limita l'uso della RAM, per evitare che il computer rallenti o si blocchi quando lavori con molte foto. È la modalità predefinita.
- Performance carica e mantiene le immagini in RAM per dare priorità alla velocità di caricamento. Replica mostra una stima della memoria richiesta e un avviso se il progetto ne richiede molta.
Replica salva la scelta nei progetti e nei preset. I progetti e i preset precedenti usano Save Memory. La guida Configurazione della sessione spiega quando usare le due modalità.
Scala degli export
- Gli export GLB, OBJ, FBX, STL, AR e PLY mantengono la trasformazione mostrata nel viewer. Le scale Refine precedenti non vengono moltiplicate di nuovo. Gli export convertiti di Replica Link usano la stessa correzione per la rotazione.
Salvataggio e apertura dei progetti
- Ogni salvataggio riuscito aggiorna subito File → Open Recent. Un nuovo nome aggiunge una voce; la sovrascrittura porta il file in cima senza duplicarlo. Un salvataggio fallito lascia la lista invariata.
- Replica scrive i progetti in modo atomico, per evitare di lasciare un file precedente sovrascritto solo in parte.
- Dopo l'installazione puoi aprire i file
.replicadal Finder. Se Replica mostra ancora la schermata iniziale o della licenza, attende che la finestra principale sia pronta. Progetti salvati e lista dei recenti precedenti restano compatibili. Vedi Iniziare.
v1.4.0: 15 settembre 2026
Nuove funzionalità
- Import video intelligente: Un progetto può ora partire direttamente da un file MOV o MP4. Replica analizza molti fotogrammi candidati, scarta quelli mossi o esposti male e seleziona immagini visivamente diverse e ben distribuite nel tempo. Durata, risoluzione, frame rate, scarti e avanzamento restano visibili durante l'import.
- Camera tracking da video: Replica ricostruisce il percorso della camera lungo la timeline usando le pose risolte da Object Capture come ancore. Il track viene salvato nel progetto in
camera_track.json, può essere riaperto senza ricalcolo ed è condiviso dalla pipeline di revisione e dall'export VFX. - Recupero dei gap nel tracking: I tratti senza soluzione possono essere recuperati usando evidenza bidirezionale fra ancore, punti distribuiti nell'immagine e raffinamento locale robusto. Le escursioni incoerenti vengono rifiutate senza alterare le pose di riferimento.
- Revisione camera nel viewer: Doppio click su una foto o su un frame per visualizzare il plate rettificato con opacità regolabile da 0 a 100%. Timeline, seek, preroll, follow e modalità manuale distinguono chiaramente i gap non risolti.
- USD for VFX con camera animata: Il bundle VFX include ora la camera animata, la sequenza completa di frame video rettificati a piena risoluzione e il track esterno, oltre agli asset USD già disponibili.
- Preview video per Blender: Ogni export VFX genera
plate_preview.movin ProRes 422 Proxy, con lato lungo massimo di 1920 px e timing identico ai frame full resolution. Lo scriptfix_in_blender.pyconfigura automaticamente camera, overlay e timeline e individua il bundle anche in progetti Blender non ancora salvati o salvati altrove. - Export della point cloud colorata: La point cloud può essere esportata in PLY binario little-endian con posizione e colore RGB, anche prima che sia pronta la mesh texturizzata. L'export applica la stessa catena di scala, rotazione, traslazione e Refine usata per la mesh.
Miglioramenti
- Preparazione progressiva degli input: Il nuovo
PhotogrammetrySampleStreamconsegna le fotografie alla sessione una alla volta, senza costruire in anticipo l'intero array di campioni. La sessione parte fuori dal thread principale, la cancellazione interrompe anche il flusso e gli input non validi vengono saltati senza bloccare il dataset. - Tracking più stabile: Lo smoothing elimina picchi isolati, ricostruisce brevi tratti mancanti e riduce il jitter conservando esattamente timestamp e pose delle ancore. Lo stesso filtro deterministico viene applicato al calcolo e al caricamento del track.
- Proiezione corretta con intrinseche complete: Overlay ed export usano ora l'intera matrice intrinseca, inclusi
cxecy, senza assumere che il principal point coincida con il centro dell'immagine. - Playback video alleggerito: La texture di playback è limitata a 1920 px sul lato lungo, mentre le intrinseche originali restano disponibili per geometria, overlay ed export.
- Undistortion accelerata con Metal: Calibrazione, pipeline e buffer GPU vengono creati una volta e riutilizzati durante l'export. Se Metal non è disponibile o fallisce su un frame, Replica passa automaticamente al percorso CPU e registra nel manifest il backend effettivo.
- Controlli 3D e processing: Nuovi gizmo per rotazione, scala e traslazione, editor delle dimensioni, toolbar unificata, Pan dedicato e inspector del processing con stato, ETA e memoria stimata.
Prestazioni verificate
- 99,5% di input simultanei in meno nella preparazione: Nel caso di riferimento da 188 immagini, il buffer controllato da Replica passa da 188 campioni residenti a circa uno. È una misura della preparazione degli input, non della RAM totale e non del tempo di ricostruzione.
- 93,75% di memoria per frame in meno nel playback warm: Sul test di 60 frame BGRA, il buffer passa da 126,56 a 7,91 MiB per frame. Il tempo mediano passa da 12,9 a 5,5 ms per frame, una riduzione del 57,4%. Il test non rappresenta le prestazioni dell'intera scena.
- Circa 22% di tempo in meno nel tratto di export 8K misurato: Sullo stesso set di 20 frame 8K, l'export passa da 14,19 s con il percorso CPU a 11,10 s con Metal. La misura include JPEG rettificati, preview ProRes e manifest, ma non l'intera ricostruzione né l'intero video.
- Tracking e overlay verificati: In un replay di riferimento i picchi anomali scendono da 5 a 0 e l'RMS del percorso da 0,04653 a 0,00581 unità modello, con 581 pose di riferimento invariate. Sul controllo geometrico 8K, l'offset dell'overlay scende da 347,438 px a meno di 0,005 px.
Stabilità e correzioni
- Stato del tracking legato al progetto: Cancellazione, cambio progetto e ricalcolo non possono più applicare risultati tardivi al progetto sbagliato.
- Gestione esplicita dei gap: Gap temporali superiori a 0,15 s e interpolazioni non risolte oltre 0,75 s restano visibili; il playback si arresta invece di mascherarli.
- Export VFX atomico: La rigenerazione del bundle preserva file
.blende cartelle personali presenti nella radice e sostituisce in modo sicuro soltanto gli asset gestiti da Replica. - Controllo dello spazio disco: Lo spazio disponibile viene verificato prima della copia e durante la generazione dei frame con una stima dinamica e un margine di sicurezza. In caso di spazio insufficiente, il bundle precedente resta intatto.
- Pulizia automatica dei temporanei: Le cartelle temporanee di Object Capture vengono rimosse anche dopo cancellazioni o sessioni concorrenti, senza coinvolgere foto, progetti, export o checkpoint dell'utente.
- Correzioni di export e interfaccia: Migliorati il sistema di coordinate Y-up, l'allineamento fra viewport, point cloud e mesh, gli export FBX/USD/STL, il supporto TIFF per edizione, i permessi di scrittura dei frame, shortcut e layout del pannello di processing.
Nota sull'ottica
La rettifica video usa una calibrazione fissa derivata dai frame allineati. Per mantenere coerenti camera e plate, zoom, messa a fuoco e ottica devono restare stabili durante la ripresa.
v1.3.0: giugno 2026
Nuove funzionalità
- Export COLMAP: Esporta camere, pose e una point cloud sparse in formato COLMAP (
cameras.txt,images.txt,points3D.txt), insieme alle foto rettificate su un modelloPINHOLEpuro. Poiché le immagini sono già senza distorsione di lente, il pacchetto entra direttamente in 3D Gaussian Splatting, NeRF/Nerfstudio e altri strumenti di ricostruzione, senza alcuno step manuale di undistortion. Vedi Export COLMAP per i dettagli. - USD for VFX: Un nuovo bundle di export (
model.usda+mesh.usdz+ plate undistorted) pensato per camera projection e matchmove in Blender, Maya, Houdini e Nuke. Free e Lite esportano un'anteprima a 2 camere; Pro esporta ogni camera del progetto. Vedi USD for VFX per i dettagli. - Overlay fotografico sulle pose camera: Il viewer 3D ora può proiettare la foto originale, senza distorsione, sulla relativa posa camera come piano immagine, con opacità regolabile e navigazione click-to-fly per saltare direttamente a qualsiasi camera.
- Measure & Scale (Pro): Una nuova operazione Refine che permette di scalare e raddrizzare il modello 3D usando misure di distanza reali. Supporta più coppie di misura con scala ai minimi quadrati, un riferimento verticale opzionale per il raddrizzamento automatico, e l'appoggio del modello a Y = 0. Utile per acquisizioni in interni e qualsiasi dataset in cui il GPS non è disponibile. Vedi Operazioni Refine per il flusso completo.
- Progetti recenti: Replica ora tiene traccia dei progetti aperti di recente, così puoi riprendere il lavoro in un click senza dover navigare fra le cartelle.
Miglioramenti
- Configuration Presets visibili su Free e Lite: Il selettore dei preset nel pannello Session Configuration è ora visibile in tutte le edizioni di Replica, così gli utenti Free e Lite possono scegliere gli stessi punti di partenza consigliati dei Pro. La creazione e la cancellazione di preset personalizzati restano una funzionalità Pro.
- Rotazione del viewer 3D più stabile dopo lo zoom: Il viewer non accumula più una rotazione indesiderata quando fai zoom in avanti o indietro: la navigazione resta prevedibile anche durante lunghe ispezioni.
- Il Delete di un Refine resetta il modello: Cliccando Delete su una qualsiasi operazione Refine, l'operazione viene rimossa, il viewer 3D torna allo stato originale pre-refine e lo stato "applicato" di tutte le altre operazioni Refine viene annullato. Viewer ed export restano coerenti.
- Il click sulle pose camera funziona correttamente dopo Refine: In precedenza, cliccando una posa camera dopo aver applicato un Refine la vista si portava nella posizione sbagliata. Ora la vista atterra esattamente sul punto della camera cliccata, indipendentemente dal Refine applicato.
- Cancellazione del singolo marker in Measure & Scale: Ogni marker piazzato (Point A, Point B, Ground, Top) può essere rimosso singolarmente con una piccola x accanto, senza dover cancellare l'intera coppia di misura.
- Reset dell'operazione Refine attiva al cambio progetto: La freccia arancione del riferimento verticale e ogni piazzamento marker in sospeso non persistono più al cambio di progetto.
v1.2.0: 4 aprile 2026
Nuove funzionalità
- Replica Link (Beta): Elabora la fotogrammetria da remoto caricando un dataset su un server companion e seguendo l'avanzamento dall'app desktop. Questa versione aggiunge la gestione dei progetti sopra la beta iniziale: rinomina ed elimina progetti remoti, scarica le foto originali come ZIP, e scoperta automatica dei progetti esistenti all'avvio del server. La vista del modello 3D ora si aggiorna dinamicamente man mano che l'elaborazione remota procede. Vedi Replica Link e Replica Link API per i dettagli.
- Export STL su tutte le edizioni: STL è ora disponibile come formato di export nell'export manuale, nell'export da Workflow e in Replica Link, su Free, Lite e Pro.
v1.1.0: 27 febbraio 2026
Miglioramenti
- Viewer 3D più fluido: Le prestazioni del viewer 3D sono state ottimizzate per una navigazione più fluida.
- Zoom adattivo al modello: Lo zoom ora si adatta automaticamente alla grandezza del modello caricato.
- Cartella di default nell'export manuale: Nell'export manuale, la cartella di destinazione predefinita è ora la stessa cartella del dataset.
- Drag & drop per l'importazione: È ora possibile trascinare file e cartelle direttamente nella cartella del dataset, in aggiunta al bottone +.
- Selezione automatica della cartella importata: Quando viene importata una cartella, viene ora selezionata automaticamente nell'elenco.
Correzioni
- Conferma cancellazione dataset: È stata aggiunta una finestra di conferma prima di procedere con la cancellazione di un dataset, per evitare eliminazioni accidentali.
- Bottone cancellazione computazione: Risolto un problema con il bottone di cancellazione della computazione nella sidebar che non funzionava correttamente.
v1.0.0: 16 febbraio 2026
Prima versione