Unreal Editor e visualizzatore autonomo
Il pannello Unreal consente le destinazioni locali l’Editor Unreal 5.5 già collegato e il progetto autonomo Nexsoon Viewer. Il viewer riceve geometrie, materiali PBR e identità BIM tramite la stessa coda di trasferimento.
1. Costruire il viewer Windows
Sono necessari Unreal Engine 5.5 e l’ambiente C++ Windows richiesto da Unreal, inclusi Visual Studio Build Tools e Windows SDK. Il motore Epic non è incorporato nell’archivio web.
Aprire PowerShell nella cartella native/unreal/NexsoonViewer:
./Build-Windows.ps1 -EngineRoot "C:\Program Files\Epic Games\UE_5.5" -Output "D:\NexsoonViewer"
Lo script verifica l’impronta della dipendenza glTFRuntime inclusa, la estrae, compila il modulo C++, genera una mappa vuota tramite Unreal e costruisce l’applicazione standalone. La cartella risultante deve essere conservata intera, con eseguibile, librerie e contenuti. Non basta copiare il solo EXE.
Se si ripete la preparazione, spostare la cartella Plugins/glTFRuntime già estratta prima di avviare lo script: la procedura evita di sovrascrivere modifiche locali della dipendenza.
Sono inclusi sorgenti, dipendenza fissata e procedura di build. Questo archivio non contiene un NexsoonViewer.exe già compilato.
Build Linux e macOS
È incluso Build-Unix.sh. Eseguirlo sul sistema di destinazione passando la cartella di Unreal 5.5 e la cartella di uscita. Sono richiesti toolchain e SDK indicati da Unreal per quel sistema. Il Viewer Mac è locale; Pixel Streaming R47 è abilitato per Windows e Linux.
2. Collegare il motore
Nel desktop, aprire il pannello Unreal, scegliere Nexsoon Viewer autonomo e premere Seleziona NexsoonViewer.exe. Nel worker impostare NEXSOON_UNREAL_RUNTIME al percorso assoluto dell’eseguibile e riavviare il servizio. Per l’Editor resta disponibile Seleziona Unreal installato.
Il viewer e il worker condividono NEXSOON_UNREAL_HOME, oppure la cartella predefinita ~/.nexsoon/unreal. Un worker ospitato sul server apre il viewer sul computer server: non trasferisce la finestra all’iPad o al browser remoto. Per trasmettere video e input al browser configurare il servizio Pixel Streaming R47.
3. Trasferire il modello
- Aprire il progetto nel BIM e attendere il completamento della scena 3D e degli oggetti.
- Scegliere Editor o Viewer, verificare il motore e avviarlo.
- Premere Trasferisci scena BIM. Viene esportata la geometria visibile corrente, con materiali e identificativi.
- Attendere lo stato pronto. Il completamento richiede la conferma della stessa sessione del motore che ha caricato la scena.
- Dopo modifiche geometriche nel BIM, trasferire nuovamente la scena.
Il viewer mantiene la scena precedente durante l’importazione. La sostituisce solo quando tutte le identità BIM del nuovo trasferimento risultano associate a componenti caricati. Un errore di importazione conserva la scena precedente.
4. Navigare e selezionare
| Comando | Azione |
|---|
| Tasto destro + WASD | Orientamento e spostamento libero |
| Q / E | Abbassa / alza la camera durante la navigazione |
| Shift / rotella | Accelerazione / regolazione velocità |
| Clic / Ctrl+clic | Selezione / selezione multipla |
| F | Inquadra gli elementi selezionati, oppure l’intera scena |
| I | Isola la selezione / ripristina visibilità |
| Esc | Deseleziona e ripristina |
| H | Mostra o nasconde la guida sovrapposta |
Il pannello del BIM invia selezione e camera al motore. Seleziona nel BIM gli elementi Unreal legge la selezione restituita dal viewer e la applica al documento corrente.
5. Rendering e caratteristiche del modello
Il progetto imposta DirectX 12, ombre virtuali e le impostazioni Lumen. Il caricamento runtime usa mesh e materiali di glTFRuntime: non equivale al trattamento Nanite e alle risorse precalcolate dell’Editor. La qualità dipende dalla GPU, dal materiale e dal modello sorgente; il passaggio a Unreal non aggiunge dettaglio a persone o veicoli semplificati.
Questa versione del viewer visualizza la scena trasferita e supporta navigazione, selezione, isolamento e camera. Non trasferisce l’editing geometrico al BIM e non implementa un player completo delle animazioni dei personaggi. La navigazione è libera, senza collisioni del pedone.
6. Risoluzione dei problemi
Se il motore non risulta configurato, controllare il percorso selezionato o la variabile d’ambiente. Se è avviato ma non collegato, controllare che worker e viewer usino la stessa cartella di scambio e che essa sia scrivibile. Se un lavoro resta in importazione, consultare i log nella cartella Unreal e le segnalazioni del pannello. Se la scena appartiene a una sessione precedente, trasferirla di nuovo: lo stato pronto di un processo terminato non viene riutilizzato.