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

  1. Aprire il progetto nel BIM e attendere il completamento della scena 3D e degli oggetti.
  2. Scegliere Editor o Viewer, verificare il motore e avviarlo.
  3. Premere Trasferisci scena BIM. Viene esportata la geometria visibile corrente, con materiali e identificativi.
  4. Attendere lo stato pronto. Il completamento richiede la conferma della stessa sessione del motore che ha caricato la scena.
  5. 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

ComandoAzione
Tasto destro + WASDOrientamento e spostamento libero
Q / EAbbassa / alza la camera durante la navigazione
Shift / rotellaAccelerazione / regolazione velocità
Clic / Ctrl+clicSelezione / selezione multipla
FInquadra gli elementi selezionati, oppure l’intera scena
IIsola la selezione / ripristina visibilità
EscDeseleziona e ripristina
HMostra 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.