OpenSCAD Workbench/it: Difference between revisions

From FreeCAD Documentation
(Created page with "In openSUSE questo viene fatto da:")
No edit summary
 
(16 intermediate revisions by 2 users not shown)
Line 12: Line 12:
== Introduzione ==
== Introduzione ==


L'ambiente [[Image:Workbench_OpenSCAD.svg|24px]] OpenSCAD serve per offrire interoperabilità con il software open source [http://www.openscad.org/ 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/it|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.
L'[[OpenSCAD_Workbench/it|Ambiente OpenSCAD]] [[Image:Workbench_OpenSCAD.svg|24px]] serve per offrire interoperabilità con il software open source [http://www.openscad.org/ 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/it|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 [[OpenSCAD_CSG/it|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.
Contiene un importatore [[OpenSCAD_CSG/it|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.
Line 72: Line 72:
* [[Image:Std_DlgParameter.svg|32px]] [[OpenSCAD_Preferences/it|Preferenze]]: Preferenze disponibili in OpenSCAD.
* [[Image:Std_DlgParameter.svg|32px]] [[OpenSCAD_Preferences/it|Preferenze]]: Preferenze disponibili in OpenSCAD.


== Limitations ==

<div class="mw-translate-fuzzy">
== Limitazioni ==
== Limitazioni ==


OpenSCAD crea una geometria solida costruttiva, importa i file mesh e estrude la geometria 2D da file [[DXF/it|DXF]]. FreeCAD consente anche di creare CSG con primitive. Il kernel di geometria di FreeCAD (OCCT) funziona utilizzando la rappresentazione dei limiti.
OpenSCAD crea una geometria solida costruttiva, importa i file mesh e estrude la geometria 2D da file [[DXF/it|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 è.
Pertanto la conversione da CSG a BREP dovrebbe, in teoria, essere possibile, mentre la conversione da BREP a CSG, in generale, non lo è.
</div>


<div class="mw-translate-fuzzy">
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.
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.
</div>


== Importing text ==
== Importare testo ==


L'importazione di codice OpenSCAD con testi richiede che i font utilizzati siano installati correttamente sul sistema. Puoi verificarlo aprendo OpenSCAD come strumento autonomo e controllando l'elenco in {{MenuCommand|Aiuto → Font List}}. L'elenco ti darà anche i nomi dei caratteri corretti. Se un font non viene visualizzato nell'elenco dopo l'installazione, potrebbe essere necessario copiare manualmente il file del font nella directory di sistema appropriata.
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 {{MenuCommand|Help → Font List}}. 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.
L'importazione di testi è relativamente lenta. Dietro le quinte FreeCAD utilizza un file DXF creato da OpenSCAD. Più contorni ci sono, più lenta sarà l'importazione.


It can be a good idea to first import a simple test case (replace {{Incode|NameOfFont}} with the correct font name):
Può essere una buona idea importare prima un semplice test case (sostituire {{Incode|NameOfFont}} con il nome del carattere corretto):


<pre>
<pre>
Line 100: Line 93:
</pre>
</pre>


The {{Incode|<nowiki>script="Latn"</nowiki>}} parameter can be left out here, but is required if the text string does not contain any letters, but only punctuation and/or numbers.
Il parametro {{Incode|<nowiki>script="Latn"</nowiki>}} può essere omesso qui, ma è obbligatorio se la stringa di testo non contiene lettere, ma solo punteggiatura e/o numeri.


Please note that {{Incode|<nowiki>use <FONT>;</nowiki>}} statements in your source files are ignored when importing in FreeCAD. Under OpenSCAD the effect of a {{Incode|use}} 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).
Tieni presente che le istruzioni {{Incode|<nowiki>use <FONT>;</nowiki>}} nei file sorgente vengono ignorate durante l'importazione in FreeCAD. Sotto OpenSCAD l'effetto di un'istruzione {{Incode|use}} è che il file di font fornito viene temporaneamente aggiunto all'elenco dei font conosciuti (sebbene anche l'istruzione non funzioni quando uno script viene modificato in modo interattivo).

== Hints ==


== Suggerimenti ==
== Suggerimenti ==
Line 116: Line 107:
== Tutorials ==
== Tutorials ==


== Tutorial ==
* [[Import_OpenSCAD_code/it|Importare codice OpenSCAD]]
* [[Import_OpenSCAD_code/it|Importare codice OpenSCAD]]


== Links ==
== Links ==


* Il repository ufficiale del codice sorgente del progetto OpenSCAD è ospitato su [https://github.com/openscad/openscad GitHub]
<div class="mw-translate-fuzzy">
* Aprire un ticket etichettato "OpenSCAD" su [https://github.com/FreeCAD/FreeCAD/labels/WB%20OpenSCAD FreeCAD Github Issue tracker]. Ci sono anche ticket sull'ormai archiviato [https://freecadweb.org/tracker/search.php?tag_string=OpenSCAD mantis bugtracker].
== Link ==
* OpenSCAD source code repository on [https://github.com/openscad/openscad GitHub]
* Modelli etichettati con "OpenSCAD" su [http://www.thingiverse.com/tag:openscad Thingiverse]
* [https://freecadweb.org/tracker/search.php?tag_string=OpenSCAD Open tickets tagged "Openscad" on the FreeCAD bugtracker]
* [http://www.thingiverse.com/tag:openscad Elementi etichettati "OpenSCAD" in Thingiverse]
</div>




{{Docnav/it
<div class="mw-translate-fuzzy">
{{Docnav/it|[[Mesh_Workbench/it|Ambiente Mesh]]|[[Part_Workbench/it|Ambiente Part]]|IconL=Workbench_Mesh.svg|IconR=Workbench_Part.svg}}
|[[Mesh_Workbench/it|Ambiente Mesh]]
|[[Part_Workbench/it|Ambiente Part]]
</div>
|IconL=Workbench_Mesh.svg
|IconR=Workbench_Part.svg
}}


{{OpenSCAD Tools navi{{#translation:}}}}
{{OpenSCAD Tools navi{{#translation:}}}}

Latest revision as of 20:38, 12 August 2022

L'icona dell'ambiente OpenSCAD

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 questo viene fatto da:

sudo zypper install python3-ply

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

sudo apt install python3-ply

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

pip3 install --user ply

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

Preferenze

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.

Importare testo

L'importazione di codice OpenSCAD con testi richiede che i font utilizzati siano installati correttamente sul sistema. Puoi verificarlo aprendo OpenSCAD come strumento autonomo e controllando l'elenco in Aiuto → Font List. L'elenco ti darà anche i nomi dei caratteri corretti. Se un font non viene visualizzato nell'elenco dopo l'installazione, potrebbe essere necessario copiare manualmente il file del font nella directory di sistema appropriata.

L'importazione di testi è relativamente lenta. Dietro le quinte FreeCAD utilizza un file DXF creato da OpenSCAD. Più contorni ci sono, più lenta sarà l'importazione.

Può essere una buona idea importare prima un semplice test case (sostituire NameOfFont con il nome del carattere corretto):

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

Il parametro script="Latn" può essere omesso qui, ma è obbligatorio se la stringa di testo non contiene lettere, ma solo punteggiatura e/o numeri.

Tieni presente che le istruzioni use <FONT>; nei file sorgente vengono ignorate durante l'importazione in FreeCAD. Sotto OpenSCAD l'effetto di un'istruzione use è che il file di font fornito viene temporaneamente aggiunto all'elenco dei font conosciuti (sebbene anche lì l'istruzione non funzioni quando uno script viene modificato in modo interattivo).

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: Modifica → Preferenze → Part Design → Impostazione del modello.

Tutorials

Links