Part Torus/de: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
(Updating to match new version of source page)
Line 24: Line 24:
== Beschreibung ==
== Beschreibung ==


<div class="mw-translate-fuzzy">
Erzeugt einen einfachen parametrischen Torus mit Position, Winkel1, Winkel2, Winkel3, Radius1 und Radius2 als Parameter.
Erzeugt einen einfachen parametrischen Torus mit Position, Winkel1, Winkel2, Winkel3, Radius1 und Radius2 als Parameter.
</div>

A Part Torus can be turned into a segment of a torus by changing its {{PropertyData|Angle3}} property. By changing its {{PropertyData|Angle1}} and/or {{PropertyData|Angle2}} properties the swept profile can become a segment of a circle.


[[File:SimpleTorus.jpg|400px]]
[[Image:Part_Torus_Example.png|400px]]


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
Line 36: Line 40:
</div>
</div>


== Example ==


[[Image:Part_Torus_Scripting_Example.png|thumb|Part Torus from the scripting example]]
'''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 parameters (radius1, radius2) permit to parametrize the torus, see next section.


A Part Torus object created with the [[#Scripting|scripting example]] below is shown here.
== Werte wählen ==


== Notes ==
Die gewünschten geometrischen Größen (parametrische Werte) werden als "Eigenschaften" in der "Combo-Ansicht" eingestellt. Die Erst-Werte lassen sich in der Spalte "Werte" überschreiben.


* A Part Torus can also be created with the [[Image:Part_Primitives.svg|16px]] [[Part_Primitives|Part Primitives]] command. With that command you can specify the dimensions and placement at creation time.
[[File:TorusA.png]]


<div class="mw-translate-fuzzy">
Ein Torus-förmiger Raum wird von einer z.B. in der x-z-Ebene positionierten dünnen Scheibe durchfahren, wenn man diese auf einem Kreis um die z-Achse rotieren lässt.
Ein Torus als Volumenkörper liegt nur vor, wenn die Erst-Werte dieser beiden Winkel beibehalten werden. Durch Verändern wird der Torus entlang seines größten Durchmessers aufgeschnitten und je ein mehr oder weniger breiter Gurt weggeschnitten. Übrig bleibt lediglich eine masselose Rest-Hülle.
</div>


See also: [[Property_editor|Property editor]].
* {{Parameter|Radius1:}} Radius des Kreises, auf dem der Mittelpunkt der dünnen Scheibe rotiert bzw. mittlerer Radius des "Schwimmringes" (im abgebildeten Beispiel wurde der Erst-Wert 10 mm beibehalten).
* {{Parameter|Radius2:}} Radius der dünnen Scheibe bzw. Radius der Torus-Querschnitts-Fläche (im abgebildeten Beispiel wurde der Erst-Wert 2 mm beibehalten).
* {{Parameter|Angle3:}} Winkel eines Torus-Sektors (im abgebildeten Beispiel wurde der Erst-Wert 360° auf 270° verändert, 1/4-Sektor wurde entfernt). Die Winkelvermaßung beginnt bei der positiven x-Achse und erfolgt mathematisch positiv im Gegenuhrzeiger-Sinn.


A Part Torus object is derived from a [[Part_Feature|Part Feature]] object and inherits all its properties. It also has the following additional properties:
=== Die Winkel Angle2 und Angle3 ===


=== Data ===
Ein Torus als Volumenkörper liegt nur vor, wenn die Erst-Werte dieser beiden Winkel beibehalten werden. Durch Verändern wird der Torus entlang seines größten Durchmessers aufgeschnitten und je ein mehr oder weniger breiter Gurt weggeschnitten. Übrig bleibt lediglich eine masselose Rest-Hülle.


{{TitleProperty|Attachment}}
[[File:TorusB.png]]


The object has the same attachment properties as a [[Part_Part2DObject#Data|Part Part2DObject]].
Die Erst-Werte der beiden Winkel Angle2 und Angle3 ergeben in Summe 360°, was den vollständigen Umfang des Torus-Querschnitts-Kreises ausmacht.
In der obigen Abbildung ist das xyz-Koordinatensystem in die Mitte des Querschnitts-Kreises verschoben. Der Kreis liegt in der xz-Ebene.
Die Winkelvermaßungen beginnen bei der negativen x-Achse und zählen mathematisch positiv im Gegenuhrzeiger-Sinn (negative Werte bei Winkel 1, da im Uhrzeigersinn gezählt).


{{TitleProperty|Torus}}
* {{Parameter|Angle1:}} Winkel 1 kennzeichnet den Rest des halben Kreises, der sich unterhalb der xy-Ebene befindet. Sein Wert wurde vom Erst-Wert -180° auf -120° verkleinert. 1/6 Kreis wurde entfernt.


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
* {{Parameter|Radius1:}} Radius des Kreises, auf dem der Mittelpunkt der dünnen Scheibe rotiert bzw. mittlerer Radius des "Schwimmringes" (im abgebildeten Beispiel wurde der Erst-Wert 10 mm beibehalten).
[[File:TorusExampleAngle3.jpg]]
* {{Parameter|Radius2:}} Radius der dünnen Scheibe bzw. Radius der Torus-Querschnitts-Fläche (im abgebildeten Beispiel wurde der Erst-Wert 2 mm beibehalten).
{{clear}}
* {{Parameter|Angle3:}} Winkel eines Torus-Sektors (im abgebildeten Beispiel wurde der Erst-Wert 360° auf 270° verändert, 1/4-Sektor wurde entfernt). Die Winkelvermaßung beginnt bei der positiven x-Achse und erfolgt mathematisch positiv im Gegenuhrzeiger-Sinn.
Der Parameter Angle3 hat einen Wert von 90°.
</div>
</div>


== Scripting ==
== Scripting ==


See also: [https://freecad.github.io/SourceDoc/ Autogenerated API documentation], [[Part_scripting|Part scripting]] and [[FreeCAD_Scripting_Basics|FreeCAD Scripting Basics]].
A Part Torus can be created using the following function:

A Part Torus can be created with the {{Incode|addObject()}} method of the document:


{{Code|code=
{{Code|code=
Line 80: Line 84:
* Where {{Incode|"myTorus"}} is the name for the object.
* Where {{Incode|"myTorus"}} is the name for the object.
* The function returns the newly created object.
* The function returns the newly created object.

Example:

{{Code|code=
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()
}}




Line 93: Line 115:
</div>
</div>


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

Revision as of 09:58, 3 March 2022

Part Torus

Menüeintrag
Part → Torus
Arbeitsbereich
Part
Standardtastenkürzel
Keiner
Eingeführt in Version
-
Siehe auch
[[Part_CreatePrimitives/de Part CreatePrimitives]]

Beschreibung

Erzeugt einen einfachen parametrischen Torus mit Position, Winkel1, Winkel2, Winkel3, Radius1 und Radius2 als Parameter.

A Part Torus can be turned into a segment of a torus by changing its DatenAngle3 property. By changing its DatenAngle1 and/or DatenAngle2 properties the swept profile can become a segment of a circle.

Anwendung

Im Arbeitsbereich Körper (workbench Part) auf das Symbol klicken. Zunächst entsteht ein vollständiger Torus mit mittlerem Ring-Radius 10 mm und Querschnitt-Radius 2mm.

Example

Part Torus from the scripting example

A Part Torus object created with the scripting example below is shown here.

Notes

  • A Part Torus can also be created with the Part Primitives command. With that command you can specify the dimensions and placement at creation time.

Ein Torus als Volumenkörper liegt nur vor, wenn die Erst-Werte dieser beiden Winkel beibehalten werden. Durch Verändern wird der Torus entlang seines größten Durchmessers aufgeschnitten und je ein mehr oder weniger breiter Gurt weggeschnitten. Übrig bleibt lediglich eine masselose Rest-Hülle.

See also: Property editor.

A Part Torus object is derived from a Part Feature object and inherits all its properties. It also has the following additional properties:

Data

Attachment

The object has the same attachment properties as a Part Part2DObject.

Torus

  • Radius1: Radius des Kreises, auf dem der Mittelpunkt der dünnen Scheibe rotiert bzw. mittlerer Radius des "Schwimmringes" (im abgebildeten Beispiel wurde der Erst-Wert 10 mm beibehalten).
  • Radius2: Radius der dünnen Scheibe bzw. Radius der Torus-Querschnitts-Fläche (im abgebildeten Beispiel wurde der Erst-Wert 2 mm beibehalten).
  • Angle3: Winkel eines Torus-Sektors (im abgebildeten Beispiel wurde der Erst-Wert 360° auf 270° verändert, 1/4-Sektor wurde entfernt). Die Winkelvermaßung beginnt bei der positiven x-Achse und erfolgt mathematisch positiv im Gegenuhrzeiger-Sinn.

Scripting

See also: Autogenerated API documentation, Part scripting and FreeCAD Scripting Basics.

A Part Torus can be created with the addObject() method of the document:

torus = FreeCAD.ActiveDocument.addObject("Part::Torus", "myTorus")
  • Where "myTorus" is the name for the object.
  • The function returns the newly created object.

Example:

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()