Famiglie native RFA e GSM
Questo flusso collega il file originale al motore che ne interpreta i dati. Il file caricato rimane immutato; conversioni e modifiche producono copie separate.
1. Scegliere dove eseguire il motore
Il browser può inviare i lavori al servizio di elaborazione configurato per il sito. Il desktop usa il proprio servizio Python. Revit e LP_XMLConverter devono risiedere sul computer di elaborazione: caricare il sito su un hosting PHP non installa questi programmi.
Per il servizio remoto configurare api/engineering.config.php con endpoint HTTPS e token del worker. L’account deve essere autenticato; il gateway associa ciascun lavoro al proprietario e ne limita accesso, frequenza e dimensioni. Non collocare token o percorsi eseguibili nel JavaScript pubblico.
2. Installare il collegamento Revit
Sono richiesti Windows, Revit 2025 e SDK .NET 8. Chiudere Revit. Aprire PowerShell nella cartella native/revit ed eseguire ./Install.ps1 -RevitDir "C:\Program Files\Autodesk\Revit 2025". Lo script compila l’add-in contro le DLL dell’installazione e lo registra per l’utente corrente. Riavviare Revit, consentire il caricamento dell’add-in e lasciarlo aperto.
Il servizio Python e Revit devono usare lo stesso account Windows e la stessa cartella di scambio. Il percorso predefinito è %USERPROFILE%/.nexsoon/native-families. Per un percorso diverso impostare NEXSOON_NATIVE_HOME nello stesso modo nei due processi prima dell’avvio. In configurazione remota il worker va eseguito sul computer con Revit; il sito inoltra i lavori tramite il gateway HTTPS.
3. Aprire e leggere una famiglia RFA
- Aprire il file RFA dal comando generale di importazione oppure aprire il pannello Lettori nativi e scegliere Famiglie RFA/GSM.
- Premere Verifica motori: Revit deve risultare collegato.
- Premere Carica e leggi famiglia. Il trasferimento avviene a blocchi; dimensione e SHA-256 vengono controllati prima dell’apertura.
- Attendere la lettura di Revit. La famiglia viene aperta come copia in una cartella del lavoro e chiusa senza salvare sull’originale.
- Scegliere il tipo nel menu. La tabella mostra i parametri di quel tipo, valori visualizzati e formule.
Per leggere solamente contenitore e metadati RFA senza inviare il file al servizio, usare Leggi metadati RFA sul dispositivo. Questa operazione non produce geometria e mantiene il limite locale di 128 MiB.
4. Modificare i parametri e generare la geometria
I campi governati da formule o riferimenti a elementi sono protetti. Per le grandezze dimensionali inserire il valore con unità riconosciute dal documento Revit. Premere Applica parametri e genera. Il motore rigenera il tipo e triangola le superfici visibili al livello di dettaglio Fine; non crea volumi sostitutivi se la famiglia non espone geometria.
Le modifiche successive allo stesso tipo conservano le variazioni già applicate nella sessione di conversione. Cambiando tipo si riparte dai valori originali del tipo scelto. Le famiglie annidate vengono percorse con le loro trasformazioni; le istanze specchiate mantengono il verso delle superfici.
Il risultato comprende GLB, dimensioni in centimetri, nome, categoria Revit, tipo, parametri, impronta del sorgente e colori/trasparenze dei materiali. Le texture di aspetto Revit non sono esportate da questo collegamento. La classe iniziale è IfcBuildingElementProxy e va adattata alla funzione del prodotto.
5. Portare l’oggetto nel catalogo e nel modello
- Scarica risultato produce un archivio catalogo riutilizzabile.
- Importa nel catalogo BIM apre la selezione dei prodotti e applica l’importazione transazionale già usata dai cataloghi portatili.
- Aprire Content Center, cercare il nome della famiglia e inserire l’oggetto nel progetto.
- Le trasformazioni dell’istanza si modificano nel BIM. Per cambiare la forma tramite parametri RFA tornare alla conversione Revit e generare la variante.
La mesh importata conserva i dati della famiglia, ma non diventa una famiglia parametrica eseguibile autonomamente nel browser. La valutazione delle formule e dei vincoli resta in Revit.
6. Configurare e usare GSM
Installare il componente Graphisoft LP_XMLConverter disponibile nell’installazione Archicad e impostare NEXSOON_GSM_CONVERTER al percorso assoluto dell’eseguibile sul computer del worker. Riavviare il worker. Su macOS indicare l’eseguibile interno al relativo pacchetto applicazione.
- Selezionare il GSM, verificare il motore e caricare il file.
- Il convertitore estrae l’XML e il pannello presenta i parametri scalari. Le matrici non vengono appiattite o riscritte.
- Modificare i valori: Length e Angle mantengono le unità native GDL; interi e booleani sono validati.
- Applicare i parametri per ricompilare una nuova copia GSM, poi scaricarla.
Gli script GDL vengono conservati nell’XML, senza esecuzione. Questo percorso non genera la geometria GSM e non la importa nel catalogo 3D. Per quella geometria serve un’esportazione IFC/GLB/OBJ da Archicad.
7. Interruzione, errori e cancellazione
Interrompi ferma il caricamento o marca il lavoro da annullare. Una chiamata del motore già in corso può terminare prima di rilasciare il documento. Elimina copia dal servizio rimuove sorgente caricato e risultati quando il motore li ha rilasciati. Non elimina gli oggetti già importati nel progetto.
Un heartbeat Revit scaduto segnala un motore non collegato. Le famiglie di versioni successive a Revit 2025 richiedono una versione Revit compatibile; non vengono riconvertite automaticamente a ritroso. Il pannello riporta gli errori nativi, senza presentare la conversione come completata.
Limiti operativi
256 MiB per file sorgente e risultato; blocchi di 512 KiB; fino a 2,5 milioni di triangoli per conversione RFA e 250 MiB di GLB. La geometria valutata, la classificazione e i diritti d’uso dipendono dal file originale. Il pacchetto distribuisce i sorgenti dell’add-in; l’eseguibile viene prodotto dallo script sull’installazione Revit disponibile.