Part TopoShape/it: Difference between revisions

From FreeCAD Documentation
(Created page with "{{Part Tools navi/it}} {{Userdocnavi/it}}")
No edit summary
 
(27 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{TOCright}}


<span id="Introduction"></span>
== Introduzione ==
== Introduzione ==


Una [[Part_TopoShape|Part TopoShape]], o formalmente una {{incode|Part::TopoShape}}, è una classe che definisce una "forma topologica" parametrica nel software. Gli oggetti del documento che mostrano qualcosa nella [[3D view/it|vista 3D]] normalmente hanno una TopoShape.
Una [[Part_TopoShape/it|Part TopoShape]], o formalmente una {{incode|Part::TopoShape}}, è una classe che definisce una "forma topologica" parametrica nel software. Gli oggetti del documento che mostrano qualcosa nella [[3D_view/it|Vista 3D]] normalmente hanno una TopoShape.


The topological shapes, as well as their methods, are defined by the OpenCASCADE Technology kernel (OCCT). FreeCAD uses these shapes, and builds [[App_DocumentObject|App DocumentObjects]] around them.
Le forme topologiche, così come i loro metodi, sono definiti dal kernel [[OpenCASCADE/it|OpenCASCADE Technology]] (OCCT). FreeCAD usa queste forme e crea dei [[App_DocumentObject/it|App DocumentObjects]] attorno ad esse.

Un altro tipo di classe è quella [[Mesh/it|meshes]]; questa classe non è molto parametrica perché non può essere ridefinita facilmente se non specificando singoli vertici e superfici triangolari.

[[File:Shape_and_mesh.svg]]

{{Caption|A sinistra: [[Part_TopoShape/it|Part TopoShape]] parametrico definito dalle proprietà. A destra: [[Mesh/it|mesh]] non parametrico, definito da vertici e superfici triangolari.}}


[[File:FreeCAD_core_objects.svg|800px]]
[[File:FreeCAD_core_objects.svg|800px]]
Line 11: Line 19:
{{Caption|Diagramma semplificato delle relazioni tra gli oggetti principali del programma. La classe {{incode|Part::TopoShape}} è incorporata nell'oggetto {{incode|Part::Feature}} e da lì viene propagata a tutti gli oggetti che ne derivano.}}
{{Caption|Diagramma semplificato delle relazioni tra gli oggetti principali del programma. La classe {{incode|Part::TopoShape}} è incorporata nell'oggetto {{incode|Part::Feature}} e da lì viene propagata a tutti gli oggetti che ne derivano.}}


<span id="Usage"></span>
== Utilizzo ==
== Utilizzo ==


TopoShape è un attributo assegnato ad alcuni [[App_DocumentObject/it|App DocumentObjects]]. In particolare, l'oggetto base che gestisce questi tipi di forme è la [[Part_Feature/it|Part Feature]] (classe {{incode|Part::Feature}}).
TopoShape è un oggetto assegnato ad alcuni [[App_DocumentObject/it|App DocumentObjects]].

In particolare, l'oggetto base che gestisce questi tipi di forme è la [[Part_Feature/it|Part Feature]] (classe {{incode|Part::Feature}}). Tutti gli oggetti derivati da questa classe avranno accesso a una Part TopoShape.

Alcuni degli oggetti più importanti con Part TopoShape sono i seguenti:
* Qualsiasi solido primitivo creato con [[Part_Workbench/it|Part]].
* Qualsiasi [[PartDesign_Body/it|Corpo di PartDesign]] e [[PartDesign_Feature/it|PartDesign Feature]] creati con [[PartDesign_Workbench/it|PartDesign]].
* Qualsiasi oggetto derivato da [[Part_Part2DObject/it|Part Part2DObject]], come la maggior parte degli oggetti creati con [[Draft_Workbench/it|Draft]].
* Qualsiasi [[Sketch/it|schizzo]], cioè, [[Sketcher_SketchObject/it|Sketcher SketchObject]], creato con [[Sketcher_Workbench/it|Sketcher]].
* Qualsiasi oggetto creato importando uno STEP, BREP e file simili in formato solido.

<span id="Scripting"></span>
==Script==

{{Emphasis|Vedere anche:}} [[FreeCAD Scripting Basics/it|Script di base per FreeCAD]], e [[scripted objects/it|script di oggetti]].

Tutti gli oggetti derivati da {{incode|Part::Feature}} avranno un [[Part TopoShape/it|Part TopoShape]], che è normalmente accessibile dal suo attributo {{incode|Shape}}.
{{Code|code=
import FreeCAD as App

doc = App.newDocument()
obj = App.ActiveDocument.addObject("Part::Box", "Box")
print(obj.Shape)
}}

Un TopoShape ha molti attributi (variabili) e metodi che contengono informazioni su di esso e che consentono di eseguire operazioni con esso. Queste variabili e metodi possono essere testati nella [[Python_console/it|console Python]].
{{Code|code=
print(obj.Shape.Area)
print(obj.Shape.BoundBox)
print(obj.Shape.CenterOfMass)
print(obj.Shape.ShapeType)

obj.Shape.check()
obj.Shape.copy()
obj.Shape.exportStep("my_file.step")
obj.Shape.exportStl("my_file.stl")
}}

Per un elenco completo di attributi e metodi, consultare la [[Source_documentation/it|documentazione sorgente]] e lo strumento {{Button|[[File:Std PythonHelp.svg|16px]] [[Std_PythonHelp/it|Documentazione dei moduli Python]]}}.

Si può ottenere un rapido riepilogo di tutti i metodi utilizzando la funzione integrata {{incode|help()}} di Python.
{{Code|code=
help(obj.Shape)
}}



{{Part Tools navi/it}}
{{Part Tools navi{{#translation:}}}}
{{Document objects navi{{#translation:}}}}
{{Userdocnavi/it}}
{{Userdocnavi{{#translation:}}}}

Latest revision as of 23:19, 29 December 2023

Introduzione

Una Part TopoShape, o formalmente una Part::TopoShape, è una classe che definisce una "forma topologica" parametrica nel software. Gli oggetti del documento che mostrano qualcosa nella Vista 3D normalmente hanno una TopoShape.

Le forme topologiche, così come i loro metodi, sono definiti dal kernel OpenCASCADE Technology (OCCT). FreeCAD usa queste forme e crea dei App DocumentObjects attorno ad esse.

Un altro tipo di classe è quella meshes; questa classe non è molto parametrica perché non può essere ridefinita facilmente se non specificando singoli vertici e superfici triangolari.

A sinistra: Part TopoShape parametrico definito dalle proprietà. A destra: mesh non parametrico, definito da vertici e superfici triangolari.

Diagramma semplificato delle relazioni tra gli oggetti principali del programma. La classe Part::TopoShape è incorporata nell'oggetto Part::Feature e da lì viene propagata a tutti gli oggetti che ne derivano.

Utilizzo

TopoShape è un oggetto assegnato ad alcuni App DocumentObjects.

In particolare, l'oggetto base che gestisce questi tipi di forme è la Part Feature (classe Part::Feature). Tutti gli oggetti derivati da questa classe avranno accesso a una Part TopoShape.

Alcuni degli oggetti più importanti con Part TopoShape sono i seguenti:

Script

Vedere anche: Script di base per FreeCAD, e script di oggetti.

Tutti gli oggetti derivati da Part::Feature avranno un Part TopoShape, che è normalmente accessibile dal suo attributo Shape.

import FreeCAD as App

doc = App.newDocument()
obj = App.ActiveDocument.addObject("Part::Box", "Box")
print(obj.Shape)

Un TopoShape ha molti attributi (variabili) e metodi che contengono informazioni su di esso e che consentono di eseguire operazioni con esso. Queste variabili e metodi possono essere testati nella console Python.

print(obj.Shape.Area)
print(obj.Shape.BoundBox)
print(obj.Shape.CenterOfMass)
print(obj.Shape.ShapeType)

obj.Shape.check()
obj.Shape.copy()
obj.Shape.exportStep("my_file.step")
obj.Shape.exportStl("my_file.stl")

Per un elenco completo di attributi e metodi, consultare la documentazione sorgente e lo strumento Documentazione dei moduli Python.

Si può ottenere un rapido riepilogo di tutti i metodi utilizzando la funzione integrata help() di Python.

help(obj.Shape)