> For the complete documentation index, see [llms.txt](https://help.pesipiuma.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.pesipiuma.app/utilizzare-pesipiuma/utilizzare-gli-importatori/dxf.md). # DXF e RUL L'importatore DXF è il flusso principale di Pesipiuma v3 per creare un progetto direttamente dalla geometria CAD. Legge i pezzi del modello da un file **.dxf**, rileva le sezioni da impiumare, crea la struttura di taglie e pezzi nell'editor e genera il report partendo dalla geometria processata. Se il modello è sviluppato, è possibile caricare anche un file **.rul**. Il file RUL è opzionale: quando non viene caricato, Pesipiuma processa il DXF senza sviluppo taglie. {% hint style="info" %} Gli importatori attivi nel workspace sono quelli previsti dal piano sottoscritto. Se è necessario aggiungere il metodo di importazione **DXF**, contattare l'assistenza; per piani Business o Enterprise, contattare l'amministratore di sistema. {% endhint %} {% hint style="warning" %} **Orientamento dei pezzi DXF** Prima di esportare o importare il DXF, verificare il drittofilo (grainline) di ogni pezzo da impiumare. Pesipiuma usa il drittofilo per orientare le preview SVG e il report PDF: i pezzi vengono disposti con il drittofilo verticale. Se si ha la necessità di ottenere un posizionamento diverso nel report, orientare di conseguenza il drittofilo nel CAD prima di esportare il DXF. {% endhint %} ## File richiesti Per importare un progetto DXF servono: * Un file **.dxf** contenente la geometria del modello. * Facoltativamente, un file **.rul** contenente le regole di sviluppo delle taglie del modello. {% hint style="warning" %} Ogni progetto può usare un solo metodo di importazione. Dopo che un progetto è stato importato con DXF, non può essere convertito in un'importazione Excel. Creare un nuovo progetto se occorre usare un metodo di importazione diverso. {% endhint %} ## Avviare un progetto DXF 1. Creare o aprire un progetto dalla Dashboard. 2. Se il progetto è vuoto, scegliere **Start with DXF**. 3. Se il progetto usa già DXF, cliccare **Import DXF** o **Replace DXF** nella toolbar dell'editor. 4. Nella finestra **Import DXF File**, trascinare i file nell'area di caricamento oppure cliccarla per selezionarli. 5. Aggiungere il file **.dxf** richiesto e, se disponibile, il file **.rul** opzionale. 6. Cliccare **Upload files**. Al termine del caricamento, Pesipiuma apre la **DXF Preview** prima di sostituire i dati dell'editor. ## Controllare la DXF Preview La DXF Preview permette di controllare la geometria rilevata prima di salvarla nel progetto. Nella parte superiore della preview è possibile regolare: * **DXF processor**: usare **Auto** come impostazione predefinita, oppure scegliere un profilo specifico quando la sorgente CAD lo richiede. * **Area threshold**: l'area minima, in cm², usata per ignorare sezioni rilevate molto piccole. * **Default coeff.**: il coefficiente assegnato ai pezzi importati prima di eventuali modifiche manuali. * **Text Annotations**: mantenere questa opzione attiva per importare le annotazioni testuali DXF supportate; disattivarla quando i testi importati non sono utili nel report. * **Avoid overlap**: attivarlo quando i numeri sezione sono molto vicini e devono essere separati leggermente nella preview e nel report. La preview mostra una scheda per ogni pezzo rilevato. Ogni scheda contiene il disegno del pezzo e la lista delle sezioni rilevate. Ogni scheda pezzo permette anche di rifinire quel singolo pezzo: * **Area threshold** del pezzo: modifica la soglia solo per quel pezzo. Può valere per tutte le taglie oppure solo per la taglia selezionata. * **Qty** e **Coeff**: impostano quantità e coefficiente iniziale del pezzo prima della conferma. * **Avoid overlap**: applica la gestione delle etichette ravvicinate solo a quel pezzo. {% hint style="info" %} Se il progetto ha più taglie, usare le tab delle taglie per ispezionarle. La taglia base resta la taglia principale per includere o escludere sezioni e per impostare quantità e coefficienti. Sulle altre taglie è possibile controllare lo sviluppo, regolare la soglia area per pezzo e correggere eventuali unioni specifiche. {% endhint %} ## Selezionare e unire le sezioni Nella preview della taglia base è possibile rifinire le sezioni rilevate prima di confermare l'importazione: * Cliccare una sezione per includerla o escluderla. * Tenere premuto **Shift** e cliccare le sezioni per unirle in un gruppo. * Tenere premuto **Alt** + **Shift** e cliccare per iniziare un nuovo gruppo di unione. Le sezioni escluse sono mostrate con uno stile rosso. I gruppi uniti sono mostrati con colori coordinati nel disegno e nella lista delle sezioni. Attivare il checkbox **Stitching** su un gruppo unito quando le sezioni devono contare come un'unica area ma mantenere visibile la separazione condivisa come linea tratteggiata di impuntura in preview e nei report. Quando un gruppo unito nasce dalla taglia base, Pesipiuma prova ad applicarlo anche alle taglie sviluppate. Se una taglia sviluppata richiede una correzione diversa, usare **Shift** su quella taglia per creare o modificare un'unione valida solo per quella taglia. {% hint style="warning" %} Se una taglia diversa dalla base mostra un avviso sul numero di sezioni, controllarla con attenzione prima di confermare. Il pulsante accanto alle tab delle taglie aiuta a trovare questi casi: check verde significa nessun avviso, icona arancione significa che ci sono pezzi da rivedere. Cliccandolo puoi mostrare temporaneamente solo i pezzi con avviso. {% endhint %} ## Confermare l'importazione Quando la preview è corretta, tornare alla taglia base e cliccare **Confirm**. Pesipiuma salva nel progetto i dati importati: * Le taglie vengono create dal risultato del processamento DXF/RUL. * I pezzi vengono creati dai pezzi rilevati nel cartamodello. * Le sezioni vengono create dalle aree da impiumare rilevate. * Le preview SVG dei pezzi vengono generate automaticamente. * Il progetto viene contrassegnato come progetto DXF. Dopo la conferma è possibile modificare nomi dei pezzi, quantità, coefficienti, coefficienti di sezione, note di sezione e altri dati direttamente nell'editor. ## Target weight Dopo aver importato un progetto DXF, è possibile attivare **Target Weight** dalla toolbar delle taglie. Quando Target Weight è attivo: * Inserire il peso obiettivo in grammi per la taglia base. * Pesipiuma usa quel valore per calcolare i pesi del report rispetto alla taglia base. * I coefficienti vengono mostrati come percentuali perché rappresentano la scala usata per raggiungere il peso obiettivo. Disattivare lo switch per disabilitare il calcolo con Target Weight per il progetto. ## Ricalcolare i pezzi Usare **Recalculate pieces** quando è necessario rileggere i file DXF/RUL caricati e ricostruire la geometria del progetto. Prima di avviare il ricalcolo, Pesipiuma chiede conferma. I file originali vengono processati di nuovo, mentre area threshold, soglie per singolo pezzo o taglia, sezioni ignorate, sezioni unite, opzioni di stitching, coefficienti, note, quantità, impostazioni **Avoid overlap**, annotazioni e posizioni manuali delle etichette vengono riapplicati quando possibile. {% hint style="warning" %} Il ricalcolo sostituisce taglie, pezzi e sezioni salvati con la nuova geometria processata. Controllare attentamente la preview prima di confermare. {% endhint %} ## Aprire il report Cliccare **Open Report** per generare un nuovo report PDF dagli ultimi dati salvati nell'editor. Per i progetti DXF, il report viene generato dalla geometria processata, dai dati salvati di pezzi e sezioni, dall'impostazione Target Weight corrente e dalle ultime modifiche pronte per il report. Le etichette sezione vengono calcolate dalla geometria del pezzo. Pesipiuma cerca di tenerle centrate e allineate; quando **Avoid overlap** è attivo, può spostare leggermente solo le etichette troppo vicine. Le posizioni impostate manualmente nell'editor vengono usate anche nel PDF. ## Scaricare o eliminare i file sorgente Quando è stato caricato un file DXF, il menu azioni accanto a **Replace DXF** permette di: * **Download DXF+RUL**: scaricare un archivio ZIP con il file DXF salvato e il file RUL, se è stato caricato. * **Reset project data**: cancellare dati editor, preview, report e artefatti generati, mantenendo solo i file DXF/RUL caricati per riprocessare il progetto da zero. * **Delete DXF** o **Delete DXF+RUL**: rimuovere i file sorgente caricati dal progetto. {% hint style="info" %} Eliminare i file DXF/RUL caricati non elimina i dati dell'editor già salvati. Tuttavia, l'apertura del report e il ricalcolo della geometria restano disabilitati finché non viene importato un nuovo file DXF. {% endhint %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.pesipiuma.app/utilizzare-pesipiuma/utilizzare-gli-importatori/dxf.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.