OpenSCAD Workbench/it

Introduzione
L'ambiente OpenSCAD serve per offrire interoperabilità con il software open source OpenSCAD. Questo programma non è distribuito come parte di FreeCAD, ma dovrebbe essere installato per poter sfruttare appieno questo ambiente. OpenSCAD non deve essere confuso con OpenCASCADE, che è il kernel geometrico che FreeCAD utilizza per costruire la geometria sullo schermo. Le librerie OpenCASCADE sono sempre necessarie per utilizzare FreeCAD, mentre l'eseguibile OpenSCAD è del tutto opzionale.

Contiene un importatore CSG che permette di aprire i file CSG di OpenSCAD, e un esportatore per produrre un albero basato su CSG. La geometria che non è basata su operazioni CSG viene esportata come mesh.

Questo ambiente contiene le funzioni per modificare l'albero delle caratteristiche CSG e riparare i modelli. Contiene anche strumenti per scopi generali che non richiedono l'installazione di OpenSCAD; essi possono essere utilizzati in combinazione con altri ambienti di lavoro. Ad esempio, l'ambiente Mesh utilizza internamente le funzioni di OpenSCAD per eseguire le operazioni con le mesh, poiché sono abbastanza robuste.



Dipendenze
In FreeCAD 0.19, il modulo Ply (Python-Lex-Yacc), utilizzato per importare i file CSG, è stato rimosso dal codice sorgente di FreeCAD, in quanto è una libreria di terze parti non sviluppata da FreeCAD. Di conseguenza, ora è necessario installare Ply prima di utilizzare l'ambiente OpenSCAD. Quando si utilizza una versione preconfezionata e stabile di FreeCAD, questa dipendenza dovrebbe essere installata automaticamente su tutte le piattaforme; in altri casi, ad esempio, quando si compila dal sorgente, potrebbe essere necessario installarlo da un repository online.

In openSUSE this is done by:

Nei sistemi basati su Debian/Ubuntu questo è fatto in questo modo.

L'installazione generale in tutte le piattaforme può essere eseguita dall'indice del pacchetto Python.

Linguaggio e formato dei file OpenSCAD
Il linguaggio OpenSCAD consente l'utilizzo di variabili e loop. Esso consente di specificare sotto-moduli per riutilizzare la geometria e il codice. Questo alto grado di flessibilità rende l'analisi sintattica molto complessa. Attualmente il modulo OpenSCAD in FreeCAD non in grado di gestire il linguaggio nativo di OpenSCAD. Invece, se OpenSCAD è installato, può essere utilizzato per convertire l'ingresso in un formato di output denominato 'CSG'. È un sottoinsieme del linguaggio OpenSCAD e può essere utilizzato come ingresso di OpenSCAD per una ulteriore elaborazione.

Durante la conversione si perde tutto il comportamento parametrico - tutti i nomi delle variabili vengono eliminati, i loop espansi e le espressioni matematiche valutate.

Strumenti

 * [[Image:OpenSCAD_ColorCodeShape.svg|32px]] Codice colore della forma: Cambia il colore della forma selezionata o di tutte le forme in base alla loro validità.
 * [[Image:OpenSCAD_ReplaceObject.svg|32px]] Sostituisci un oggetto: Sostituisce un oggetto nell'albero delle operazioni. Selezionare l'oggetto vecchio, il nuovo e il genitore.
 * [[Image:OpenSCAD_RemoveSubtree.svg|32px]] Elimina un ramo: Rimuove gli oggetti selezionati e tutti i suoi figli che non sono referenziati da altri oggetti.
 * [[Image:OpenSCAD_RefineShapeFeature.svg|32px]] Affina la forma: Crea una operazione di affinatura della forma.
 * [[Image:OpenSCAD_MirrorMeshFeature.svg|32px]] Specchia la mesh: Crea una funzione mesh speculare.
 * [[Image:OpenSCAD ScaleMesh.svg|32px]] Scala la mesh: Scala una funzione mesh.
 * Ridimensiona la mesh: Ridimensiona una funzione mesh.
 * [[Image:OpenSCAD_IncreaseToleranceFeature.svg|32px]] Incrementa la tolleranza: Aumenta la tolleranza di bordi/facce/vertici degli oggetti selezionati.
 * [[Image:OpenSCAD_Edgestofaces.png|32px]] Converti i bordi in facce: Converte i bordi (contorni) in facce. Utile per preparare la geometria DXF importata per essere estrusa.
 * [[Image:OpenSCAD_ExpandPlacements.png|32px]] Espandi le posizioni: Espande tutte le posizioni della struttura delle operazioni verso il basso.
 * [[Image:OpenSCAD_ExplodeGroup.png|32px]] Esplodi il gruppo: Separa le primitive delle parti fuse.
 * [[Image:OpenSCAD_AddOpenSCADElement.png|32px]] Aggiungi un elemento OpenSCAD: Aggiunge un elemento OpenSCAD inserendo il codice OpenSCAD nel pannello delle azioni.
 * [[Image:OpenSCAD_MeshBoolean.png|32px]] Booleana su mesh...: Crea un nuovo oggetto mesh da un'operazione booleana sulle forme.
 * [[Image:OpenSCAD_Hull.svg|32px]] Hull: Applica un inviluppo Hull di forme selezionate.
 * [[Image:OpenSCAD_Minkowski.svg|32px]] Minkowski: Applica una somma Minkowski di forme selezionate.

Preferenze

 * [[Image:Std_DlgParameter.svg|32px]] Preferenze: Preferenze disponibili in OpenSCAD.

Limitazioni
OpenSCAD crea una geometria solida costruttiva, importa i file mesh e estrude la geometria 2D da file DXF. FreeCAD consente anche di creare CSG con primitive. Il kernel di geometria di FreeCAD (OCCT) funziona utilizzando la rappresentazione dei limiti. Pertanto la conversione da CSG a BREP dovrebbe, in teoria, essere possibile, mentre la conversione da BREP a CSG, in generale, non lo è.

OpenSCAD lavora internamente su maglie. Alcune operazioni che sono utili con le maglie non sono significative su un modello BREP e attualmente non possono essere completamente supportate. Tra queste ci sono convex hull, minkowski sum, glide e subdiv. Attualmente si può eseguire il binario OpenSCAD al fine di eseguire le operazioni hull e minkwoski e importare il risultato. Ciò significa che la geometria coinvolta sarà triangolata. In OpenSCAD è spesso usata la scalatura non uniforme, che non crea alcun problema quando si utilizzano mesh. Nel nostro kernel geometrico le primitive geometriche (linee, sezioni circolari, ecc) vengono convertite in BSpline prima di eseguire queste deformazioni. Le bspline sono note per causare problemi nelle successive operazioni booleane. Al momento non è disponibile nessuna soluzione automatica. Non esitate a postare sul forum se si verificano tali problemi. Spesso tali problemi possono essere risolti rimodellamento piccole parti. Una deformazione di un cilindro può sostituita da una estrusione di una ellisse.

Importing text
Importing OpenSCAD code with texts requires that the fonts that are used are properly installed on your system. You can verify this by opening OpenSCAD as a standalone tool and checking the list in. The list will also give you the correct font names. If a font does not appear in the list after installing, you may have to manually copy the font file to the appropriate system directory.

Importing texts is relatively slow. Behind the scenes FreeCAD uses a DXF file created by OpenSCAD. The more contours there are the slower the import.

It can be a good idea to first import a simple test case (replace with the correct font name):

TESTFONT="NameOfFont"; linear_extrude(0.001) { text("A", size=5, font=TESTFONT, script="Latn"); };

The parameter can be left out here, but is required if the text string does not contain any letters, but only punctuation and/or numbers.

Please note that statements in your source files are ignored when importing in FreeCAD. Under OpenSCAD the effect of a statement is that the provided font file is temporarily added to the list of known fonts (although even there the statement does not work when a script is modified interactively).

Suggerimenti
Quando si importano DXF impostare la precisione del progetto a un valore adeguato, in modo che vengano individuati i bordi connessi.

Per impostare la precisione nell'ambiente Draft: Modifica → Preferenze → Draft → Importa/Esporta → Opzioni del formato DXF → Segmento Spline massimo

Se FreeCAD va in crash durante l'importazione CSG, si consiglia vivamente di attivare 'controllare automaticamente il modello dopo l'operazione booleana' in:.

Tutorial

 * Importare codice OpenSCAD

Link

 * OpenSCAD source code repository on GitHub
 * Open tickets tagged "Openscad" on the FreeCAD bugtracker
 * Elementi etichettati "OpenSCAD" in Thingiverse