AprilTag Scale Bar (Beta)
Una barra AprilTag permette di dare al modello una scala in metri. Con una barra a L puoi anche raddrizzarlo e scegliere il piano di appoggio. La funzione è disponibile in Refine Pro dalla v1.4.1. Puoi trovare i tag automaticamente e usare la barra anche senza JSON.
Preparare la barra
Usa una barra dritta con due tag della famiglia tag36h11, oppure una barra a L con tre tag. Ogni tag deve avere un ID diverso. Il generatore di barre Replica, quando disponibile sul sito, fornisce i file di stampa e un JSON con le dimensioni. Puoi usare anche una barra compatibile e inserire i dati a mano.
Riprendi la barra ferma e rigida in almeno tre immagini nitide, già allineate dalla ricostruzione. I tag devono essere visibili insieme e la camera deve spostarsi tra gli scatti: girarla da una posizione fissa non basta per ottenere parallasse. Assegna ID unici anche alle altre barre o ai marker presenti nella scena.
Per raddrizzare il modello con una barra a L, appoggia la faccia stampata sul piano che vuoi usare come terreno. Se sposti o togli la barra durante un video, escludi quel tratto dal rilevamento.
Trovare i tag
Aggiungi AprilTag Scale Bar (Beta) in Refine. Con Aligned image range scegli le immagini in cui la barra è rimasta ferma. Replica le ordina per nome file; lascia Last a 0 per arrivare fino all'ultima immagine.
Puoi procedere in due modi:
| Comando | Come usarlo |
|---|---|
| Find tags automatically | Cerca i tag nelle immagini allineate. Scegli il tipo di barra e inserisci una distanza nota fra i centri, in millimetri. |
| Import JSON… (optional) | Carica il JSON del generatore: v1 per la barra dritta, v2 per la L. Replica legge ID, ruoli e dimensioni nominali. Puoi usare queste dimensioni senza inserirle di nuovo. |
Per indicare tu gli ID, compilali nei campi e clicca Detect selected IDs. In ogni caso serve una misura nota: il disegno di un tag contiene il suo ID, ma non dice quanto è grande.
Scegliere i tag nel viewer
Replica mostra i centri rilevati in 3D, con etichette ID e bracci colorati. Clicca su un marker o sul suo pulsante ID e assegnagli il ruolo con Use as A/B per la barra dritta, oppure Use as Origin/X/Y per la L.
Per la L, Replica riconosce il vertice dell'angolo retto come Origin e propone come X l'estremità con ID più basso. Controlla l'orientamento e scambia X e Y se serve: gli ID non stabiliscono la direzione degli assi. Se nella scena ci sono più barre, scegli i due o tre tag della barra che vuoi usare.
Inserire le misure
Misura dal centro di un tag al centro dell'altro. La lunghezza esterna della barra e il lato del quadrato nero sono misure diverse. Se i centri distano 100 mm, inserisci 100, anche se la barra è più lunga.
Senza JSON devi inserire almeno una distanza. Per la L, parti da Origin-X; puoi aggiungere la misura dell'altro braccio o della diagonale per controllare il calcolo.
Se hai importato il JSON, apri Correct printed dimensions (optional) per correggere le dimensioni della stampa. Le misure inserite hanno la precedenza su quelle nominali. Per la L, basta inserire una misura reale perché Replica usi solo le misure reali che hai fornito: in questo modo una stampa ridimensionata non viene confrontata anche con distanze nominali rimaste invariate.
Controlla le dimensioni stampate prima di usare i valori del JSON, soprattutto se hai cambiato la scala nello slicer. Replica non applica una seconda correzione di scala dai metadati di compensazione della stampa.
Applicare la scala
Controlla quante viste sono risultate coerenti, l'errore di riproiezione, la parallasse e la scala calcolata. Clicca Apply metric scale… per la barra dritta oppure Apply metric scale + level… per la L. La finestra di conferma riepiloga ID, dimensioni e trasformazione da applicare.
La barra dritta porta il modello dalla scala della ricostruzione ai metri. La L rende anche orizzontale la faccia stampata, orienta il braccio X lungo +X e porta il tag Origin all'origine del mondo. Per questo la barra deve trovarsi sul piano che vuoi usare come terreno.
Replica sostituisce la scala corrente. Mantiene i dati delle operazioni Refine precedenti, ma ne annulla lo stato applicato per evitare di sommare le trasformazioni. Salva la definizione della barra e il risultato con il progetto; i marker che vedi nel viewer restano fuori dall'export.
Dopo aver applicato la scala, verifica un'altra distanza misurata sul soggetto. La diagnostica aiuta a valutare il rilevamento, ma la funzione è ancora Beta e non certifica l'accuratezza metrica. Controlla anche le unità nel software in cui apri l'export: un file STL, per esempio, non le specifica.
Risoluzione dei problemi
Replica non trova i tag o trova poche viste
Controlla la famiglia dei tag e che nelle immagini siano abbastanza grandi, nitidi e liberi da riflessi o ostacoli. Servono almeno tre viste allineate in cui i tag della barra compaiano insieme, riprese da posizioni diverse.
Nella scena ci sono più barre o ID ripetuti
Scegli i tag della barra nel viewer. Se due tag visibili hanno lo stesso ID, il rilevamento è ambiguo: usa ID unici e ripeti la cattura.
La scala risulta sbagliata
Controlla le distanze fra i centri e inseriscile in millimetri. Verifica anche se hai ridimensionato la stampa. Replica mostra un avviso per uno scarto superiore al 10% dalla distanza generata; spesso l'errore nasce dall'aver misurato la lunghezza esterna della barra.
La barra a L non si raddrizza
Controlla i ruoli dei tag e che la stampa sia in squadra. Replica rifiuta bracci con uno scarto oltre 5° dall'angolo retto; più distanze misurate devono rispettare la tolleranza del calcolo, pari al 2% o a 2 mm.
Il risultato precedente non è più valido
Ripeti il rilevamento se cambi le immagini, il loro intervallo o la calibrazione. Finché il pannello resta aperto, puoi cambiare la scelta dei tag e le misure riutilizzando i rilevamenti già in memoria.
Guide collegate
- Operazioni Refine: allineamento GPS e misure manuali con Measure & Scale.
- Import video e camera tracking: ripresa della calibrazione e controllo del percorso della camera.
- USD for VFX: export del modello in scala insieme alle camere.