Part Torus/it: Difference between revisions

From FreeCAD Documentation
No edit summary
No edit summary
 
(41 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{Docnav/it|[[Part_Sphere/it|Sfera]]|[[Part_CreatePrimitives/it|Crea primitive]]|[[Part_Module/it|Part]]|IconL=Part_Sphere.svg|IconC=Workbench_Part.svg|IconR=Part_CreatePrimitives.svg}}


{{Docnav
{{GuiCommand/it|Name=Part Torus|Name/it=Toro|MenuLocation=Parte → Primitive → Toro|Workbenches=[[Part Module/it|Parte]]|SeeAlso= [[Part_CreatePrimitives/it|Crea primitive]]}}
|[[Part_Cone/it|Cono]]
|[[Part_Tube/it|Tubo]]
|[[Part_Workbench/it|Part]]
|IconL=Part_Cone.svg
|IconR=Part_Tube.svg
|IconC=Workbench_Part.svg
}}


{{GuiCommand/it
|Name=Part Torus
|Name/it=Part Toro
|MenuLocation=Parte → Primitive → Toro
|Workbenches=[[Part_Workbench/it|Part]]
|SeeAlso=[[Part_Primitives/it|Part Primitive]]
}}

<span id="Description"></span>
== Descrizione ==
== Descrizione ==
Crea un semplice toro parametrico, con i parametri position, angle1, angle2, angle3, radius1 e radius2.


Il comando [[Image:Part_Torus.svg|24px]] '''Part Toro''' crea un solido toroide parametrico, a forma di ciambella. È il risultato dello spostamento di un profilo circolare attorno a un percorso circolare. Nel sistema di coordinate definito dalla sua proprietà {{PropertyData|Placement}}, il percorso circolare del toro giace sul piano XY con il centro nell'origine.
[[File:SimpleTorus.jpg|400px]]


Una Part Toro può essere trasformata in un segmento di un toro modificando la sua proprietà {{PropertyData|Angle3}}. Modificando le sue proprietà {{PropertyData|Angle1}} e/o {{PropertyData|Angle2}} il profilo di creazione può diventare un segmento di un cerchio.
<div class="mw-translate-fuzzy">

[[Image:Part_Torus_Example.png|400px]]

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


# Esistono diversi modi per richiamare il comando:
<div class="mw-translate-fuzzy">
#* Premere il pulsante {{Button|[[Image:Part_Torus.svg|16px]] [[Part_Torus/it|Toro]]}}.
Nell'ambiente [[Part_Workbench/it|Parte]] cliccare sull'icona [[Image:Part Torus.png|32px]]. Il toro viene creato nell'origine, nel punto 0,0,0.
#* Selezionare l'opzione {{MenuCommand|Parte → Primitive → [[Image:Part_Torus.svg|16px]] Toro}} dal menu.
I parametri Angolo e i parametri Raggio permettono di parametrizzare il toro. Come descritto nel paragrafo successivo, i parametri Angolo consentono di creare una porzione di toro invece di un toro completo, di default sono impostati a 360°, e i parametri Raggio1 e Raggio2 definiscono rispettivamente la dimensione del foro e il diametro dell'anello del 'tubo'.
# Viene creato il toro.
</div>
# Facoltativamente, modificare le dimensioni e il {{PropertyData|Placement}} del toro effettuando una delle seguenti operazioni:
#* Fare doppio clic sull'oggetto nella [[Tree_view/it|Vista ad albero]]:
#*# Si apre il pannello delle attività {{MenuCommand|Primitive geometriche}}.
#*# Modificare una o più proprietà.
#*# L'oggetto viene aggiornato dinamicamente nella [[3D_view/it|vista 3D]].
#*# Premere il pulsante {{Button|OK}}.
#* Modificare le proprietà nell'[[Property_editor|Editor delle proprietà]].
#* Modificare il {{PropertyData|Placement}} con il comando [[Image:Std_TransformManip.svg|16px]] [[Std_TransformManip/it|Trasforma]].

<span id="Example"></span>
== Esempio ==

[[Image:Part_Torus_Scripting_Example.png|thumb|Part Toro dall'esempio di scripting]]

Qui viene mostrato un oggetto Part Toro creato con l'[[#Script|esempio di scripting]] riportato di seguito.

<span id="Notes"></span>
== Note ==

* È possibile creare un Part Toro anche con il comando [[Image:Part_Primitives.svg|16px]] [[Part_Primitives/it|Part Primitive]]. Con questo comando si può specificare le dimensioni e il posizionamento al momento della creazione.

<span id="Properties"></span>
== Proprietà ==

Vedere anche: [[Property_editor/it|Editor delle proprietà]].

Un oggetto Part Toro deriva da un oggetto [[Part_Feature/it|Funzione Part]] e ne eredita tutte le proprietà. Ha inoltre le seguenti proprietà aggiuntive:

<span id="Data"></span>
=== Dati ===

{{TitleProperty|Attachment}}

L'oggetto ha le stesse proprietà di collegamento di un [[Part_Part2DObject/it#Dati|Part Part2DObject]].


{{TitleProperty|Torus}}
'''Result:''' The torus will be positioned at origin (point 0,0,0) on creation.<br />
The angle parameters (angle1, angle2, angle3), as well as the radius parameter (radius1 , radius2) parameters permit to parametrize the torus, see next section.


* {{PropertyData|Radius1|Length}}: il raggio del percorso circolare del toro. Il valore predefinito è {{Value|10mm}}.
== Opzioni ==
* {{PropertyData|Radius2|Length}}: il raggio del profilo circolare del toro. Il valore predefinito è {{Value|2mm}}.
* {{PropertyData|Angle1|Angle}}: l'angolo iniziale del profilo circolare. Intervallo valido: {{Value|-180° &lt;&#61; valore &lt;&#61; 180°}}. Il valore predefinito è {{Value|-180°}}.
* {{PropertyData|Angle2|Angle}}: l'angolo finale del profilo circolare. Intervallo valido: {{Value|-180° &lt;&#61; valore &lt;&#61; 180°}}. Il valore predefinito è {{Value|180°}}. Se l'angolo totale del profilo circolare è inferiore a {{Value|360°}} il profilo avrà una forma a torta.
* {{PropertyData|Angle3|Angle}}: l'angolo del percorso circolare del toro. Intervallo valido: {{Value|0° &lt; valore &lt;&#61; 360°}}. Il valore predefinito è {{Value|360°}}. Se è inferiore a {{Value|360°}} il solido risultante sarà un segmento di un toro.


<span id="Scripting"></span>
[[File:TorusExampleOverviewParameters.jpg]]
== Script ==


Vedere anche: [https://freecad.github.io/SourceDoc/ Autogenerated API documentation], [[Part_scripting/it|Script di Part]] e [[FreeCAD_Scripting_Basics/it|Script di base per FreeCAD]].
'''Parametri'''


È possibile creare una Part Toro con il metodo {{Incode|addObject()}} del documento:
Un toro può essere assimilato ad un disco che compie un'orbita circolare attorno un'asse immaginario. Quindi il toro parametrico è definito dai seguenti parametri:


{{Code|code=
* {{Parameter|Raggio1:}} Raggio del cerchio attorno al quale circola il disco. Distanza tra l'asse di rotazione, centro del toro, e il centro del disco.
torus = FreeCAD.ActiveDocument.addObject("Part::Torus", "myTorus")
* {{Parameter|Raggio2:}} Raggio del disco che definisce la forma del toro
}}
* {{Parameter|Angolo1:}} 1° Angolo di taglio per definire il disco del toro
* {{Parameter|Angolo2:}} 2° Angolo di taglio per definire il disco del toro
* {{Parameter|Angolo3:}} 3° Angolo per definire la circonferenza del toro. Ampiezza della rotazione


* Dove {{Incode|"myTorus"}} è il nome dell'oggetto.
nonché la serie standard di parametri di posizionamento. Le immagini sottostanti danno una rappresentazione grafica dei parametri citati:
* La funzione restituisce l'oggetto appena creato.


Esempio:
[[File:TorusExampleRadius1.jpg]]
Il parametro Raggio1 ha il valore di 20 mm.


{{Code|code=
[[File:TorusExampleRadius2.jpg]]
import FreeCAD as App
Il parametro Raggio2 ha il valore di 2 mm.


doc = App.activeDocument()
[[File:TorusExampleAngle1.jpg]]
Il parametro Angolo1 ha il valore di -90°. Notare che, lo strumento "di misura dell'angolo" non in grado di visualizzare l'angolo negativo. Considerare il valore visualizzato nell'immagine come "-90°".


torus = doc.addObject("Part::Torus", "myTorus")
[[File:TorusExampleAngle2.jpg]]
torus.Radius1 = 20
Il parametro Angolo2 ha il valore di 90°.
torus.Radius2 = 10
torus.Angle1 = -90
torus.Angle2 = 45
torus.Angle3 = 270
torus.Placement = App.Placement(App.Vector(1, 2, 3), App.Rotation(30, 45, 10))


doc.recompute()
<div class="mw-translate-fuzzy">
}}
[[File:TorusExampleAngle3.jpg]]
{{clear}}
Il parametro Angolo3 ha il valore di 90°.
</div>




{{Docnav
<div class="mw-translate-fuzzy">
|[[Part_Cone/it|Cono]]
{{Docnav/it|[[Part_Sphere/it|Sfera]]|[[Part_CreatePrimitives/it|Crea primitive]]|[[Part_Module/it|Part]]|IconL=Part_Sphere.png|IconC=Workbench_Part.svg|IconR=Part_CreatePrimitives.png}}
|[[Part_Tube/it|Tubo]]
</div>
|[[Part_Workbench/it|Part]]
|IconL=Part_Cone.svg
|IconR=Part_Tube.svg
|IconC=Workbench_Part.svg
}}


{{Part Tools navi{{#translation:}}}}
{{Part_Tools_navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}

Latest revision as of 22:10, 2 January 2024

Part Toro

Posizione nel menu
Parte → Primitive → Toro
Ambiente
Part
Avvio veloce
Nessuno
Introdotto nella versione
-
Vedere anche
Part Primitive

Descrizione

Il comando Part Toro crea un solido toroide parametrico, a forma di ciambella. È il risultato dello spostamento di un profilo circolare attorno a un percorso circolare. Nel sistema di coordinate definito dalla sua proprietà DatiPlacement, il percorso circolare del toro giace sul piano XY con il centro nell'origine.

Una Part Toro può essere trasformata in un segmento di un toro modificando la sua proprietà DatiAngle3. Modificando le sue proprietà DatiAngle1 e/o DatiAngle2 il profilo di creazione può diventare un segmento di un cerchio.

Utilizzo

  1. Esistono diversi modi per richiamare il comando:
    • Premere il pulsante Toro.
    • Selezionare l'opzione Parte → Primitive → Toro dal menu.
  2. Viene creato il toro.
  3. Facoltativamente, modificare le dimensioni e il DatiPlacement del toro effettuando una delle seguenti operazioni:
    • Fare doppio clic sull'oggetto nella Vista ad albero:
      1. Si apre il pannello delle attività Primitive geometriche.
      2. Modificare una o più proprietà.
      3. L'oggetto viene aggiornato dinamicamente nella vista 3D.
      4. Premere il pulsante OK.
    • Modificare le proprietà nell'Editor delle proprietà.
    • Modificare il DatiPlacement con il comando Trasforma.

Esempio

Part Toro dall'esempio di scripting

Qui viene mostrato un oggetto Part Toro creato con l'esempio di scripting riportato di seguito.

Note

  • È possibile creare un Part Toro anche con il comando Part Primitive. Con questo comando si può specificare le dimensioni e il posizionamento al momento della creazione.

Proprietà

Vedere anche: Editor delle proprietà.

Un oggetto Part Toro deriva da un oggetto Funzione Part e ne eredita tutte le proprietà. Ha inoltre le seguenti proprietà aggiuntive:

Dati

Attachment

L'oggetto ha le stesse proprietà di collegamento di un Part Part2DObject.

Torus

  • DatiRadius1 (Length): il raggio del percorso circolare del toro. Il valore predefinito è 10mm.
  • DatiRadius2 (Length): il raggio del profilo circolare del toro. Il valore predefinito è 2mm.
  • DatiAngle1 (Angle): l'angolo iniziale del profilo circolare. Intervallo valido: -180° <= valore <= 180°. Il valore predefinito è -180°.
  • DatiAngle2 (Angle): l'angolo finale del profilo circolare. Intervallo valido: -180° <= valore <= 180°. Il valore predefinito è 180°. Se l'angolo totale del profilo circolare è inferiore a 360° il profilo avrà una forma a torta.
  • DatiAngle3 (Angle): l'angolo del percorso circolare del toro. Intervallo valido: 0° < valore <= 360°. Il valore predefinito è 360°. Se è inferiore a 360° il solido risultante sarà un segmento di un toro.

Script

Vedere anche: Autogenerated API documentation, Script di Part e Script di base per FreeCAD.

È possibile creare una Part Toro con il metodo addObject() del documento:

torus = FreeCAD.ActiveDocument.addObject("Part::Torus", "myTorus")
  • Dove "myTorus" è il nome dell'oggetto.
  • La funzione restituisce l'oggetto appena creato.

Esempio:

import FreeCAD as App

doc = App.activeDocument()

torus = doc.addObject("Part::Torus", "myTorus")
torus.Radius1 = 20
torus.Radius2 = 10
torus.Angle1 = -90
torus.Angle2 = 45
torus.Angle3 = 270
torus.Placement = App.Placement(App.Vector(1, 2, 3), App.Rotation(30, 45, 10))

doc.recompute()