Mesh Scripting/it: Difference between revisions
Renatorivo (talk | contribs) (Created page with "==== Analisi e Test ====") |
No edit summary |
||
(44 intermediate revisions by 3 users not shown) | |||
Line 1: | Line 1: | ||
<languages/> |
|||
==== Introduzione ==== |
|||
{{TOCright}} |
|||
==Introduzione== |
|||
Per accedere al modulo {{incode| Mesh}} devi prima importarlo: |
|||
{{Code|code= |
|||
Prima di tutto si deve importare il modulo Mesh: |
|||
<syntaxhighlight> |
|||
import Mesh |
import Mesh |
||
}} |
|||
</syntaxhighlight> |
|||
Dopo questa operazione si ha accesso al modulo Mesh e alla classe Mesh che offrono le funzioni del Kernel C++ Mesh di FreeCAD. |
|||
== |
==Creazione== |
||
Per creare un oggetto mesh vuoto basta usare il costruttore standard: |
Per creare un oggetto mesh vuoto basta usare il costruttore standard: |
||
{{Code|code= |
|||
<syntaxhighlight> |
|||
mesh = Mesh.Mesh() |
mesh = Mesh.Mesh() |
||
}} |
|||
</syntaxhighlight> |
|||
Inoltre è possibile creare un oggetto da un file |
Inoltre è possibile creare un oggetto da un file: |
||
{{Code|code= |
|||
<syntaxhighlight> |
|||
mesh = Mesh.Mesh( |
mesh = Mesh.Mesh("D:/temp/Something.stl") |
||
}} |
|||
</syntaxhighlight> |
|||
Un elenco di tipi di file compatibili è disponibile [[Feature_list/it#IO|in questa pagina]] al paragrafo 'Mesh'. |
|||
Oppure crearlo tramite un gruppo di triangoli descritti dai loro vertici: |
Oppure crearlo tramite un gruppo di triangoli descritti dai loro vertici: |
||
{{Code|code= |
|||
<syntaxhighlight> |
|||
triangles = [ |
|||
# triangle 1 |
# triangle 1 |
||
[-0.5000,-0.5000,0.0000],[0.5000,0.5000,0.0000],[-0.5000,0.5000,0.0000], |
[-0.5000, -0.5000, 0.0000], [0.5000, 0.5000, 0.0000], [-0.5000, 0.5000, 0.0000], |
||
#triangle 2 |
#triangle 2 |
||
[-0.5000,-0.5000,0.0000],[0.5000,-0.5000,0.0000],[0.5000,0.5000,0.0000], |
[-0.5000, -0.5000, 0.0000], [0.5000, -0.5000, 0.0000], [0.5000, 0.5000, 0.0000], |
||
] |
] |
||
meshObject = Mesh.Mesh(triangles) |
|||
Mesh.show( |
Mesh.show(meshObject) |
||
}} |
|||
</syntaxhighlight> |
|||
Il Kernel Mesh si occupa di creare una corretta struttura topologica dei dati individuando i punti e i bordi coincidenti. |
Il Kernel Mesh si occupa di creare una corretta struttura topologica dei dati individuando i punti e i bordi coincidenti. |
||
{{Top}} |
|||
==Modellazione== |
|||
Per creare geometrie regolari è possibile utilizzare uno dei metodi {{incode|create*()}}. Un toroide, ad esempio, può essere creato come segue: |
|||
Più avanti si vedrà come è possibile verificare ed esaminare i dati mesh. |
|||
{{Code|code= |
|||
==== Modellazione ==== |
|||
m = Mesh.createTorus(8.0, 2.0, 50) |
|||
Mesh.show(m) |
|||
}} |
|||
I primi due parametri definiscono i raggi del toro e il terzo parametro è un fattore di sub-campionamento che stabilisce quanti triangoli vengono creati. Maggiore è questo valore e più il corpo è liscio, più questo valore è piccolo e più il corpo è grossolano (sfaccettato). |
|||
Per creare delle geometrie regolari è possibile utilizzare lo script Python BuildRegularGeoms.py. |
|||
Il modulo {{incode|Mesh}} fornisce anche tre metodi Booleani: {{incode|union()}}, {{incode|intersection()}} e {{incode|difference()}}: |
|||
<syntaxhighlight> |
|||
import BuildRegularGeoms |
|||
</syntaxhighlight> |
|||
{{Code|code= |
|||
Questo script fornisce i metodi per definire semplici corpi di rotazione, tipo le sfere, gli ellissoidi, i cilindri, i coni e i toroidi. Inoltre ha anche un metodo per creare un semplice cubo. |
|||
Ad esempio, per creare un toroide si può fare nel modo seguente: |
|||
<syntaxhighlight> |
|||
t = BuildRegularGeoms.Toroid(8.0, 2.0, 50) # list with several thousands triangles |
|||
m = Mesh.Mesh(t) |
|||
</syntaxhighlight> |
|||
I primi due parametri definiscono i raggi del toroide e il terzo parametro è un fattore di sub-campionamento che stabilisce quanti triangoli vengono creati. Maggiore è questo valore e più il corpo è liscio, più questo valore è piccolo e più il corpo è grossolano (sfaccettato). |
|||
La classe Mesh fornisce una serie di funzioni booleane che possono essere utilizzate per operazioni di modellazione. Essa fornisce l'unione, l'intersezione e la differenza tra due oggetti mesh. |
|||
<syntaxhighlight> |
|||
m1, m2 # are the input mesh objects |
m1, m2 # are the input mesh objects |
||
m3 = Mesh.Mesh(m1) # create a copy of m1 |
m3 = Mesh.Mesh(m1) # create a copy of m1 |
||
Line 71: | Line 63: | ||
m6 = Mesh.Mesh(m2) |
m6 = Mesh.Mesh(m2) |
||
m6.difference(m1) # the difference of m2 and m1, usually the result is different to m5 |
m6.difference(m1) # the difference of m2 and m1, usually the result is different to m5 |
||
}} |
|||
</syntaxhighlight> |
|||
Ecco |
Ecco un esempio che crea un tubo usando il metodo {{incode|difference()}}: |
||
{{Code|code= |
|||
<syntaxhighlight> |
|||
import |
import FreeCAD, Mesh |
||
cylA = Mesh.createCylinder(2.0, 10.0, True, 1.0, 36) |
|||
cylB = Mesh.createCylinder(1.0, 12.0, True, 1.0, 36) |
|||
cylB.Placement.Base = (FreeCAD.Vector(-1, 0, 0)) # move cylB to avoid co-planar faces |
|||
diff = sphere |
|||
pipe = cylA |
|||
diff = diff.difference(cylinder) |
|||
pipe = pipe.difference(cylB) |
|||
d = FreeCAD.newDocument() |
|||
pipe.flipNormals() # somehow required |
|||
d.addObject("Mesh::Feature","Diff_Sphere_Cylinder").Mesh=diff |
|||
doc = FreeCAD.ActiveDocument |
|||
d.recompute() |
|||
obj = d.addObject("Mesh::Feature", "Pipe") |
|||
</syntaxhighlight> |
|||
obj.Mesh = pipe |
|||
doc.recompute() |
|||
}} |
|||
{{Top}} |
|||
==Note== |
|||
Una nutrita (anche se difficile da usare) libreria di script riferiti a Mesh sono gli script dell'unita di test del Modulo Mesh. In questa unit test sono letteralmente chiamati tutti i metodi e sono ottimizzate tutte le proprietà e gli attributi. Quindi, se siete abbastanza coraggiosi, date un'occhiata al [http://free-cad.svn.sourceforge.net/viewvc/free-cad/trunk/src/Mod/Mesh/App/MeshTestsApp.py?view=markup modulo unit test]. |
|||
==== Analisi e Test ==== |
|||
=== Write your own Algorithms === |
|||
=== Exporting === |
|||
You can even write the mesh to a python module: |
|||
<syntaxhighlight> |
|||
m.write("D:/Develop/Projekte/FreeCAD/FreeCAD_0.7/Mod/Mesh/SavedMesh.py") |
|||
import SavedMesh |
|||
m2 = Mesh.Mesh(SavedMesh.faces) |
|||
</syntaxhighlight> |
|||
=== Gui related stuff === |
|||
=== Odds and Ends === |
|||
An extensive (though hard to use) source of Mesh related scripting are the unit test scripts of the Mesh-Module. |
|||
In this unit tests literally all methods are called and all properties/attributes are tweaked. |
|||
So if you are bold enough, take a look at the [http://free-cad.svn.sourceforge.net/viewvc/free-cad/trunk/src/Mod/Mesh/App/MeshTestsApp.py?view=markup Unit Test module]. |
|||
{{docnav|FreeCAD Scripting Basics|Topological data scripting}} |
|||
[[Category:Poweruser Documentation]] |
|||
[[Category:Python Code]] |
|||
Vedere anche: [[Mesh_API/it|Mesh API]]. |
|||
{{Top}} |
|||
{{Powerdocnavi{{#translation:}}}} |
|||
[[Category:Developer Documentation{{#translation:}}]] |
|||
[[Category:Python Code{{#translation:}}]] |
|||
{{Mesh Tools navi{{#translation:}}}} |
|||
{{clear}} |
{{clear}} |
||
<languages/> |
Latest revision as of 19:48, 17 September 2022
Introduzione
Per accedere al modulo Mesh
devi prima importarlo:
import Mesh
Creazione
Per creare un oggetto mesh vuoto basta usare il costruttore standard:
mesh = Mesh.Mesh()
Inoltre è possibile creare un oggetto da un file:
mesh = Mesh.Mesh("D:/temp/Something.stl")
Oppure crearlo tramite un gruppo di triangoli descritti dai loro vertici:
triangles = [
# triangle 1
[-0.5000, -0.5000, 0.0000], [0.5000, 0.5000, 0.0000], [-0.5000, 0.5000, 0.0000],
#triangle 2
[-0.5000, -0.5000, 0.0000], [0.5000, -0.5000, 0.0000], [0.5000, 0.5000, 0.0000],
]
meshObject = Mesh.Mesh(triangles)
Mesh.show(meshObject)
Il Kernel Mesh si occupa di creare una corretta struttura topologica dei dati individuando i punti e i bordi coincidenti.
Modellazione
Per creare geometrie regolari è possibile utilizzare uno dei metodi create*()
. Un toroide, ad esempio, può essere creato come segue:
m = Mesh.createTorus(8.0, 2.0, 50)
Mesh.show(m)
I primi due parametri definiscono i raggi del toro e il terzo parametro è un fattore di sub-campionamento che stabilisce quanti triangoli vengono creati. Maggiore è questo valore e più il corpo è liscio, più questo valore è piccolo e più il corpo è grossolano (sfaccettato).
Il modulo Mesh
fornisce anche tre metodi Booleani: union()
, intersection()
e difference()
:
m1, m2 # are the input mesh objects
m3 = Mesh.Mesh(m1) # create a copy of m1
m3.unite(m2) # union of m1 and m2, the result is stored in m3
m4 = Mesh.Mesh(m1)
m4.intersect(m2) # intersection of m1 and m2
m5 = Mesh.Mesh(m1)
m5.difference(m2) # the difference of m1 and m2
m6 = Mesh.Mesh(m2)
m6.difference(m1) # the difference of m2 and m1, usually the result is different to m5
Ecco un esempio che crea un tubo usando il metodo difference()
:
import FreeCAD, Mesh
cylA = Mesh.createCylinder(2.0, 10.0, True, 1.0, 36)
cylB = Mesh.createCylinder(1.0, 12.0, True, 1.0, 36)
cylB.Placement.Base = (FreeCAD.Vector(-1, 0, 0)) # move cylB to avoid co-planar faces
pipe = cylA
pipe = pipe.difference(cylB)
pipe.flipNormals() # somehow required
doc = FreeCAD.ActiveDocument
obj = d.addObject("Mesh::Feature", "Pipe")
obj.Mesh = pipe
doc.recompute()
Note
Una nutrita (anche se difficile da usare) libreria di script riferiti a Mesh sono gli script dell'unita di test del Modulo Mesh. In questa unit test sono letteralmente chiamati tutti i metodi e sono ottimizzate tutte le proprietà e gli attributi. Quindi, se siete abbastanza coraggiosi, date un'occhiata al modulo unit test.
Vedere anche: Mesh API.
- FreeCAD scripting: Python, Introduction to Python, Python scripting tutorial, FreeCAD Scripting Basics
- Modules: Builtin modules, Units, Quantity
- Workbenches: Workbench creation, Gui Commands, Commands, Installing more workbenches
- Meshes and Parts: Mesh Scripting, Topological data scripting, Mesh to Part, PythonOCC
- Parametric objects: Scripted objects, Viewproviders (Custom icon in tree view)
- Scenegraph: Coin (Inventor) scenegraph, Pivy
- Graphical interface: Interface creation, Interface creation completely in Python (1, 2, 3, 4, 5), PySide, PySide examples beginner, intermediate, advanced
- Macros: Macros, How to install macros
- Embedding: Embedding FreeCAD, Embedding FreeCADGui
- Other: Expressions, Code snippets, Line drawing function, FreeCAD vector math library (deprecated)
- Hubs: User hub, Power users hub, Developer hub
- Miscellaneous: Import mesh, Export mesh, Create mesh from shape, Regular solid, Unwrap Mesh, Unwrap Face
- Modifying: Harmonize normals, Flip normals, Fill holes, Close hole, Add triangle, Remove components, Remove components by hand, Smooth, Refinement, Decimation, Scale
- Boolean: Union, Intersection, Difference
- Cutting: Cut mesh, Trim mesh, Trim mesh with a plane, Create section from mesh and plane, Cross-sections
- Components and segments: Merge, Split by components, Create mesh segments, Create mesh segments from best-fit surfaces