Part Cone/zh-cn: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
(Updating to match new version of source page)
 
(2 intermediate revisions by the same user not shown)
Line 1: Line 1:
<languages/>
<languages/>

{{Docnav
{{Docnav
|[[Part_Sphere|Sphere]]
|[[Part_Sphere|Sphere]]
Line 23: Line 24:
</div>
</div>


The default Part Cone is truncated. It can be turned into a full, untruncated, cone by changing its {{PropertyData|Radius1}} or {{PropertyData|Radius2}} property to zero. It can be turned into a segment of a cone by changing its {{PropertyData|Angle}} property.
[[File:Otherwisedefault270degree_Part_Cone.png|300px]]

<div class="mw-translate-fuzzy">
[[Image:Part_Cone_Example.png|400px]]
下图展示了"Angle"为270度且其他参数为默认值的效果。
</div>


== Usage ==
== Usage ==
Line 35: Line 35:
</div>
</div>


== Example ==
<div class="mw-translate-fuzzy">

默认值是根据定义的两个半径radius1、radius2、高度以及角度参数来创建一个截断的参数化圆锥。默认的圆锥被创建在原点(point 0,0,0)处。角度参数确定了所创建的部分圆锥(默认设置值为360°), 而radius1与radius2则分别对应于截断圆柱体底部与顶部的半径。
[[Image:Part_Cone_Scripting_Example.png|thumb|Part Cone from the scripting example]]
</div>

A Part Cone object created with the [[#Scripting|scripting example]] below is shown here.

== Notes ==


* A Part Cone 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.
The cone properties can later be edited, either in the [[Property_editor|Property editor]] or by double-clicking the cone in the [[Tree_view|Tree view]].


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
Line 54: Line 58:
</div>
</div>


See also: [[Property_editor|Property editor]].
* {{PropertyData|Radius 1}}: Radius of the arc or circle defining the lower face

* {{PropertyData|Radius 2}}: Radius of the arc or circle defining the upper face
A Part Cone object is derived from a [[Part_Feature|Part Feature]] object and inherits all its properties. It also has the following additional properties:
* {{PropertyData|Height}}: Height of the Part Cone

* {{PropertyData|Angle}}: Number of degrees of the arc or circles defining the upper and lower faces of the truncated cone. The default 360° creates circular faces, a lower value will create a portion of a cone as defined by upper and lower faces each with edges defined by an arc of the number of degrees and two radii.
=== Data ===

{{TitleProperty|Attachment}}

The object has the same attachment properties as a [[Part_Part2DObject#Data|Part Part2DObject]].

{{TitleProperty|Cone}}

* {{PropertyData|Radius1|Length}}: The radius of the bottom face of the cone. Can be {{Value|0mm}} if {{PropertyData|Radius2}} is larger than {{Value|0mm}}. The default is {{Value|2mm}}.
* {{PropertyData|Radius2|Length}}: The radius of the top face of the cone. Can be {{Value|0mm}} if {{PropertyData|Radius1}} is larger than {{Value|0mm}}. The default is {{Value|4mm}}.
* {{PropertyData|Height|Length}}: The height of the cone. The default is {{Value|10mm}}.
* {{PropertyData|Angle|Angle}}: The angle of the circular arc that defines the top and bottom face of the cone. Valid range: {{Value|0° &lt; value &lt;&#61; 360°}}. The default is {{Value|360°}}. If it is smaller than {{Value|360°}} the resulting solid will be a segment of a cone.

== Scripting ==

See also: [https://freecad.github.io/SourceDoc/ Autogenerated API documentation], [[Part_scripting|Part scripting]] and [[FreeCAD_Scripting_Basics|FreeCAD Scripting Basics]].

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

{{Code|code=
cone = FreeCAD.ActiveDocument.addObject("Part::Cone", "myCone")
}}

* Where {{Incode|"myCone"}} is the name for the object.
* The function returns the newly created object.

Example:

{{Code|code=
import FreeCAD as App

doc = App.activeDocument()

cone = doc.addObject("Part::Cone", "myCone")
cone.Radius1 = 5
cone.Radius2 = 10
cone.Height = 50
cone.Angle = 270
cone.Placement = App.Placement(App.Vector(1, 2, 3), App.Rotation(30, 60, 15))

doc.recompute()
}}




Line 69: Line 115:
}}
}}


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

Latest revision as of 08:56, 4 March 2022

Part Cone

Menu location
Part → Primitives → Cone
Workbenches
Part
Default shortcut
None
Introduced in version
-
See also
Part Primitives

Description

描述

在零件工作台中,可以通过零件工具栏、Part菜单(中的primitives子菜单)或Create Primitives(创建图元)对话框来创建参数化的截断零件圆锥图元。

The default Part Cone is truncated. It can be turned into a full, untruncated, cone by changing its 数据Radius1 or 数据Radius2 property to zero. It can be turned into a segment of a cone by changing its 数据Angle property.

Usage

如何使用

点击位于零件工作台中的图标

Example

Part Cone from the scripting example

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

Notes

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

选项

Cone

  • Radius 1 - 定义底面弧或圆的半径
  • Radius 2 - 定义顶面弧或圆的半径
  • Height - 零件圆锥体的高度
  • Angle - 定义截断圆锥体顶面与底面上弧或圆的角度值。默认值360创建的顶底皆为圆面,较小值将创建出不完整的部分圆锥,具体形状取决于实际角度与两个半径所定义的弧,乃至顶面与底面。

See also: Property editor.

A Part Cone 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.

Cone

  • 数据Radius1 (Length): The radius of the bottom face of the cone. Can be 0mm if 数据Radius2 is larger than 0mm. The default is 2mm.
  • 数据Radius2 (Length): The radius of the top face of the cone. Can be 0mm if 数据Radius1 is larger than 0mm. The default is 4mm.
  • 数据Height (Length): The height of the cone. The default is 10mm.
  • 数据Angle (Angle): The angle of the circular arc that defines the top and bottom face of the cone. Valid range: 0° < value <= 360°. The default is 360°. If it is smaller than 360° the resulting solid will be a segment of a cone.

Scripting

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

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

cone = FreeCAD.ActiveDocument.addObject("Part::Cone", "myCone")
  • Where "myCone" is the name for the object.
  • The function returns the newly created object.

Example:

import FreeCAD as App

doc = App.activeDocument()

cone = doc.addObject("Part::Cone", "myCone")
cone.Radius1 = 5
cone.Radius2 = 10
cone.Height = 50
cone.Angle = 270
cone.Placement = App.Placement(App.Vector(1, 2, 3), App.Rotation(30, 60, 15))

doc.recompute()