Part Circle/it: Difference between revisions

From FreeCAD Documentation
No edit summary
(Created page with "* Dove {{Incode|"myCircle"}} è il nome dell'oggetto. * La funzione restituisce l'oggetto appena creato.")
 
(25 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{GuiCommand/it|Name=Part_Circle|Name/it=Cerchio|MenuLocation=Parte → [[Part_CreatePrimitives/it|Crea primitive]] → Cerchio|Workbenches=[[Part Module/it|Parte]]|SeeAlso=}}


{{Docnav/it
<div class="mw-translate-fuzzy">
|[[Part_Spiral/it|Spirale]]
== Descrizione ==
|[[Part_Ellipse/it|Ellisse]]
Dal dialogo '''Crea Primitive''' dell'ambiente Parte è disponibile un cerchio geometrico primitivo .
|[[Part_Workbench/it|Part]]
</div>
|IconL=Part_Spiral.svg
|IconR=Part_Ellipse.svg
|IconC=Workbench_Part.svg
}}


{{GuiCommand/it
Questo comando crea un bordo curvo circolare. Con i valori di default, il bordo curvo circolare è chiuso e quindi è un cerchio. Se vengono modificate i valori predefiniti (0 e 360​​) delle proprietà Angolo 0 o Angolo 1, il bordo è una curva aperta, un arco.
|Name=Part_Circle
|Name/it=Part Cerchio
|MenuLocation=Parte → [[Part_Primitives/it|Crea primitive]] → Cerchio
|Workbenches=[[Part_Workbench/it|Part]], [[OpenSCAD_Workbench/it|OpenSCAD]]
|SeeAlso=[[Part_Primitives/it|Part Primitive]]
}}


<span id="Description"></span>
In alternativa, un cerchio Part può essere inizialmente definito da tre punti. Una volta creato esso contiene solo le proprietà standard dei cerchi Part e non è più riferito ai punti di creazione.
==Descrizione==


Un [[Image:Part_Circle.svg|24px]] '''Part Cerchio''' è una forma parametrica che può essere creata con il comando [[Image:Part_Primitives.svg|24px]] [[Part_Primitives/it|Part Primitive]] . Nel sistema di coordinate definito dalla sua proprietà {{PropertyData|Placement}}, il cerchio giace sul piano XY con il centro nell'origine.
==Usage==


Un Part Cerchio è infatti un arco circolare chiuso in senso antiorario, può essere trasformato in un arco modificando le sue proprietà {{PropertyData|Angle1}} e/o {{PropertyData|Angle2}}.
<div class="mw-translate-fuzzy">
Il dialogo '''Crea Primitive''' è accessibile tramite l'icona [[Part_CreatePrimitives/it|Crea Primitive]] [[Image:Part_CreatePrimitives.png|32px]] del menu Part o della barra degli Strumenti Part, dell'ambiente Part.
</div>


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

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

Vedere [[Part_Primitives/it#Utilizzo|Part Primitive]].

In alternativa è possibile creare un cerchio parziale selezionando tre punti:
# Nel pannello delle azioni del comando [[Image:Part_Primitives.svg|16px]] [[Part_Primitives/it|Part Primitive]] selezionare l'opzione {{MenuCommand|[[Image:Part_Circle.svg|16px]] Cerchio}} dal menu a tendina.
# Premere il pulsante {{Button|Da tre punti}}.
# Selezionare tre vertici nella [[3D_view/it|Vista 3D]]. Non è necessario tenere premuto il tasto {{KEY|Ctrl}}.
# Viene creato un cerchio.
# I vertici selezionati vengono utilizzati solo al momento della creazione per calcolare il {{PropertyData|Radius}} e il {{PropertyData|Placement}} del cerchio.

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

[[Image:Part_Circle_Scripting_Example.png|thumb|Part Cerchio dall'esempio di scripting]]

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

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


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

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

====Posizione====
<span id="Data"></span>
Espandere la voce Posizione per stabilire:
=== Dati ===
* punto di posizionamento nella vista 3D, di default il centro del cerchio viene posto nel punto 0,0,0

* direzione dell'asse del cerchio, x, y, z o definita dall'utente.
{{TitleProperty|Attachment}}
I parametri e il posizionamento sono modificabili tramite la scheda delle proprietà.

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

{{TitleProperty|Base}}

* {{PropertyData|Radius|Length}}: il raggio del cerchio o dell'arco circolare. Il valore predefinito è {{Value|2mm}}.
* {{PropertyData|Angle1|Angle}}: l'angolo iniziale dell'arco circolare. Intervallo valido: {{Value|0° &lt; valore &lt;&#61; 360°}}. Il valore predefinito è {{Value|0°}}.
* {{PropertyData|Angle2|Angle}}: l'angolo finale dell'arco circolare. Intervallo valido: {{Value|0° &lt; valore &lt;&#61; 360°}}. Il valore predefinito è {{Value|360°}}. Se {{PropertyData|Angle1}} e {{PropertyData|Angle2}} sono uguali, o se un angolo è {{Value|0°}} e l'altro {{Value|360°}}, viene creato un cerchio completo.

<span id="Scripting"></span>
== 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]].

È possibile creare una Part Cerchio con il metodo {{Incode|addObject()}} del documento:

{{Code|code=
circle = FreeCAD.ActiveDocument.addObject("Part::Circle", "myCircle")
}}

* Dove {{Incode|"myCircle"}} è il nome dell'oggetto.
* La funzione restituisce l'oggetto appena creato.

Esempio:

{{Code|code=
import FreeCAD as App

doc = App.activeDocument()

circle = doc.addObject("Part::Circle", "myCircle")
circle.Radius = 10
circle.Angle1 = 45
circle.Angle2 = 225
circle.Placement = App.Placement(App.Vector(1, 2, 3), App.Rotation(30, 45, 10))

doc.recompute()
}}



{{Docnav/it
* {{Parameter|Raggio}}: il raggio del bordo curvo (arco o cerchio)
|[[Part_Spiral/it|Spirale]]
* {{Parameter|Angolo 1}}: inizio del bordo curvo, (gradi in senso antiorario), il valore di default è 0
|[[Part_Ellipse/it|Ellisse]]
* {{Parameter|Angolo 2}}: fine del bordo curvo (gradi in senso antiorario), il valore di default è 360
|[[Part_Workbench/it|Part]]
|IconL=Part_Spiral.svg
|IconR=Part_Ellipse.svg
|IconC=Workbench_Part.svg
}}


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

Latest revision as of 22:41, 5 January 2024

Part Cerchio

Posizione nel menu
Parte → Crea primitive → Cerchio
Ambiente
Part, OpenSCAD
Avvio veloce
Nessuno
Introdotto nella versione
-
Vedere anche
Part Primitive

Descrizione

Un Part Cerchio è una forma parametrica che può essere creata con il comando Part Primitive . Nel sistema di coordinate definito dalla sua proprietà DatiPlacement, il cerchio giace sul piano XY con il centro nell'origine.

Un Part Cerchio è infatti un arco circolare chiuso in senso antiorario, può essere trasformato in un arco modificando le sue proprietà DatiAngle1 e/o DatiAngle2.

Utilizzo

Vedere Part Primitive.

In alternativa è possibile creare un cerchio parziale selezionando tre punti:

  1. Nel pannello delle azioni del comando Part Primitive selezionare l'opzione Cerchio dal menu a tendina.
  2. Premere il pulsante Da tre punti.
  3. Selezionare tre vertici nella Vista 3D. Non è necessario tenere premuto il tasto Ctrl.
  4. Viene creato un cerchio.
  5. I vertici selezionati vengono utilizzati solo al momento della creazione per calcolare il DatiRadius e il DatiPlacement del cerchio.

Esempio

Part Cerchio dall'esempio di scripting

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

Proprietà

Vedere anche: Editor delle proprietà.

Un oggetto Part Cerchio 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.

Base

  • DatiRadius (Length): il raggio del cerchio o dell'arco circolare. Il valore predefinito è 2mm.
  • DatiAngle1 (Angle): l'angolo iniziale dell'arco circolare. Intervallo valido: 0° < valore <= 360°. Il valore predefinito è .
  • DatiAngle2 (Angle): l'angolo finale dell'arco circolare. Intervallo valido: 0° < valore <= 360°. Il valore predefinito è 360°. Se DatiAngle1 e DatiAngle2 sono uguali, o se un angolo è e l'altro 360°, viene creato un cerchio completo.

Script

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

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

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

Esempio:

import FreeCAD as App

doc = App.activeDocument()

circle = doc.addObject("Part::Circle", "myCircle")
circle.Radius = 10
circle.Angle1 = 45
circle.Angle2 = 225
circle.Placement = App.Placement(App.Vector(1, 2, 3), App.Rotation(30, 45, 10))

doc.recompute()