Draft Circle/zh-cn: Difference between revisions

From FreeCAD Documentation
(Created page with "通过下列函数就可以在macrosPython控制台中使用圆形工具:")
No edit summary
(17 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{Docnav|[[Draft_Wire|Wire]]|[[Draft_Arc|Arc]]|[[Draft_Module|Draft]]|IconL=Draft_Wire.svg |IconC=Workbench_Draft.svg|IconR=Draft_Arc.svg}}
{{Docnav|[[Draft_Fillet|Fillet]]|[[Draft_Arc|Arc]]|[[Draft_Module|Draft]]|IconL=Draft_Fillet.svg |IconC=Workbench_Draft.svg|IconR=Draft_Arc.svg}}


{{GuiCommand
{{GuiCommand
Line 6: Line 6:
|MenuLocation=Draft → Circle
|MenuLocation=Draft → Circle
|Workbenches=[[Draft Module|Draft]], [[Arch Module|Arch]]
|Workbenches=[[Draft Module|Draft]], [[Arch Module|Arch]]
|Shortcut=C I
|Shortcut={{KEY|C}} {{KEY|I}}
|SeeAlso=[[Draft Arc|Draft Arc]], [[Draft Ellipse]]
|SeeAlso=[[Draft Arc|Draft Arc]], [[Draft Ellipse|Draft Ellipse]]<br/>[[Macro_CirclePlus|Macro CirclePlus]]
|Version=0.7
|Version=0.7
}}
}}

==Description==


==描述==
==描述==
底图圆形工具通过用户输入的两个点(中心点与半径),或通过拾取切线,或上述若干组合来在当前的[[Draft SelectPlane|工作平面]]上创建一个圆形。它将根据[[Draft Tray]]中的[[Draft Linestyle]]来创建圆形。
底图圆形工具通过用户输入的两个点(中心点与半径),或通过拾取切线,或上述若干组合来在当前的[[Draft SelectPlane|工作平面]]上创建一个圆形。它将根据[[Draft Tray]]中的[[Draft Linestyle]]来创建圆形。


<div class="mw-translate-fuzzy">
此工具与[[Draft Arc]]工具的工作方式很相似,区别在于前者创建的是一个完整的圆周。要绘制椭圆形请使用[[Draft Ellipse]]工具。
此工具与[[Draft Arc]]工具的工作方式很相似,区别在于前者创建的是一个完整的圆周。要绘制椭圆形请使用[[Draft Ellipse]]工具。
</div>


[[Image:Draft_Circle_example.jpg|400px]]
[[Image:Draft_Circle_example.jpg|400px]]
{{Caption|两点定一圆}}
{{Caption|两点定一圆}}


==Usage==

<div class="mw-translate-fuzzy">
==如何使用==
==如何使用==
# 点击{{Button|[[Image:Draft Circle.png|16px]] [[Draft Circle|Draft Circle]]}}按钮,或先后按下{{KEY|C}}、{{KEY|I}}键。
# 点击{{Button|[[Image:Draft Circle.png|16px]] [[Draft Circle|Draft Circle]]}}按钮,或先后按下{{KEY|C}}、{{KEY|I}}键。
# 在3D视图中单击第一个点,或输入一个[[Draft_Coordinates|coordinate]]并按下{{Button|[[Image:Draft_AddPoint.svg|16px]] [[Draft_AddPoint|add point]]}}按钮。
# 在3D视图中单击第一个点,或输入一个[[Draft_Coordinates|coordinate]]并按下{{Button|[[Image:Draft_AddPoint.svg|16px]] [[Draft_AddPoint|add point]]}}按钮。
# 在3D视图中单击第二个点,或输入一个半径值。
# 在3D视图中单击第二个点,或输入一个半径值。
</div>


<div class="mw-translate-fuzzy">
通过双击树状视图(tree view)中的元素或点击{{Button|[[Image:Draft Edit.svg|16px]] [[Draft Edit]]}}按钮即可编辑对应圆形。届时,您就可将中心点与半径点移动到预定的新位置。
通过双击树状视图(tree view)中的元素或点击{{Button|[[Image:Draft Edit.svg|16px]] [[Draft Edit]]}}按钮即可编辑对应圆形。届时,您就可将中心点与半径点移动到预定的新位置。
</div>


创建圆形之后,通过将其第一角度(first angle)与最后角度(last angle)两个属性设置为不同值,便可以将它转换为一条弧。
创建圆形之后,通过将其第一角度(first angle)与最后角度(last angle)两个属性设置为不同值,便可以将它转换为一条弧。


==Options==
==选项==
* 此工具绘制圆形的主要用法就是拾取两点,即圆形的中心点及其圆周上一点。
* The primary use of the circle tool is by picking two points, the centre and a point on the circumference.
** By pressing {{KEY|Alt}}, you can select a tangent instead of picking a point. You can therefore construct several types of circles by selecting one, two or three tangents.
** 通过按下{{KEY|Alt}}键,您就可以选取一条切线而非拾取一个点。You can therefore construct several types of circles by selecting one, two or three tangents.
* To enter coordinates manually, simply enter the numbers, then press {{KEY|Enter}} between each X, Y and Z component. You can press the {{Button|[[Image:Draft_AddPoint.svg|16px]] [[Draft_AddPoint|add point]]}} button when you have entered the desired values to insert the point.
* 为了手动输入坐标,您可以在输入X、Y或Z坐标值后,通过按下{{KEY|Enter}}键切换至下一个坐标分量。您可以在输入点的坐标值后按{{Button|[[Image:Draft_AddPoint.svg|16px]] [[Draft_AddPoint|add point]]}}按钮来插入目标点。
* 按{{KEY|T}}键或单击continue多选框即可切换至''连续''模式。如果开启了连续模式,则圆形工具将在绘制完一个圆形后再次开启,并令您在不用按下圆形工具这一按钮的情况下,继续绘制下一个圆形。
* Press {{KEY|T}} or click the checkbox to toggle ''continue'' mode. If continue mode is on, the Circle tool will restart after you finish the circle, allowing you to draw another one without pressing the tool button again.
* Press {{KEY|L}} or click the checkbox to toggle ''filled'' mode. If filled mode is on, the circle will create a filled face ({{PropertyData|Make Face}} {{TRUE}}); if not, the circle will not make a face ({{PropertyData|Make Face}} {{FALSE}}).
* {{KEY|L}}键或单击filled复选框即可切换至''填充''模式。若开启填充模式,此工具创建的将是一个圆形的面({{PropertyData|Make Face}} {{TRUE}});否则创建的仅是一个圆形而非圆面({{PropertyData|Make Face}} {{FALSE}})
* 若希望将点强制绘至[[Draft_Snap|捕捉]]到的最近位置,请按住{{KEY|Ctrl}}键。
* Hold {{KEY|Ctrl}} while drawing to force [[Draft_Snap|snapping]] your point to the nearest snap location, independently of the distance.
* 若希望令绘制的第二个点位于第一个的水平或垂直方向,请按住{{KEY|Shift}}键。
* Hold {{KEY|Shift}} while drawing to [[Draft_Constrain|constrain]] your second point horizontally or vertically in relation to the first one.
* Press {{KEY|Esc}} or the {{Button|Close}} button to abort the current command.
* {{KEY|Esc}}键或{{Button|Close}}按钮来终止当前命令。


<div class="mw-translate-fuzzy">
==属性==
==属性==
圆形对象享有[[Draft Arc]]中的所有属性,但是有些属性仅对圆形而言才有意义。
圆形对象享有[[Draft Arc]]中的所有属性,但是有些属性仅对圆形而言才有意义。
</div>


<div class="mw-translate-fuzzy">
===Data===
===数据===
* {{PropertyData|First Angle}}: specifies the starting angle of the circle; normally 0&#176;.
* {{PropertyData|Last Angle}}: specifies the ending angle of the circle; normally 0&#176;.
* {{PropertyData|First Angle}}: 指定圆形的起始角度;此值通常为0&#176;.
* {{PropertyData|Radius}}: specifies the radius of the circle.
* {{PropertyData|Last Angle}}: 指定圆形的结束角度;此值通常为0&#176;。
* {{PropertyData|Radius}}: 指定圆形的半径。
* {{PropertyData|Make Face}}: specifies if the Circle makes a face or not. If it is {{TRUE}} a face is created, otherwise only the circumference is considered part of the object. This property only works if the shape is a full circumference.
* {{PropertyData|Make Face}}: 指定此工具绘制的是圆面还是圆形。如果值为{{TRUE}}则创建一个面,否则仅是创建一个圆周。只有绘制完整的圆形时,本属性才会生效。
:For it to be a full circle {{PropertyData|First Angle}} and {{PropertyData|Last Angle}} should have the same value; otherwise, a [[Draft Arc]] is displayed. The values 0&#176; and 360&#176; aren't considered the same, so if these two values are used, the circle will not form a face.
:对于完整的圆形而言,{{PropertyData|First Angle}} 与{{PropertyData|Last Angle}}应当有着相同的值;否则,显示的将是一个[[Draft Arc|弧线]]。0&#176;与 360&#176;并非相同的值,因此若采用这两个值,则绘制的圆无法构成一个面。
</div>


===View===
===视图===
* {{PropertyView|Pattern}}: specifies a [[Draft Pattern]] with which to fill the face of the circle. This property only works if {{PropertyData|Make Face}} is {{TRUE}}, and if {{PropertyView|Display Mode}} is "Flat Lines".
* {{PropertyView|Pattern}}: 指定[[Draft Pattern|底图图案]],用它来填充圆面。只有当{{PropertyData|Make Face}}{{TRUE}}{{PropertyView|Display Mode}}"Flat Lines"时本属性才能生效。
* {{PropertyView|Pattern Size}}: specifies the size of the [[Draft Pattern]].
* {{PropertyView|Pattern Size}}: 指定[[Draft Pattern|底图图案]]的大小。


<div class="mw-translate-fuzzy">
==脚本==
==脚本==
{{Emphasis|参见:}} [[Draft API]] 与 [[FreeCAD Scripting Basics]]。
{{Emphasis|参见:}} [[Draft API]] 与 [[FreeCAD Scripting Basics]]。
</div>


<div class="mw-translate-fuzzy">
通过下列函数就可以在[[macros]]与[[Python]]控制台中使用圆形工具:
通过下列函数就可以在[[macros]]与[[Python]]控制台中使用圆形工具:
</div>


{{Code|code=
{{Code|code=
Line 62: Line 80:
}}
}}


<div class="mw-translate-fuzzy">
* Creates a {{incode|Circle}} object with given {{incode|radius}} in millimeters.
** {{incode|radius}} can also be a {{incode|Part.Edge}}, whose {{incode|Curve}} attribute must be a {{incode|Part.Circle}}.
* 利用指定的以毫米为单位的{{incode|radius}}来创建一个{{incode|Circle}}对象。
** 可用{{incode|Part.Edge}}来代替{{incode|radius}},但是其{{incode|Curve}}属性必为{{incode|Part.Circle}}.
* If a {{incode|placement}} is given, it is used; otherwise the shape is created at the origin.
* 如果给出了{{incode|placement}}便采用此值为中心点;否则此圆形中心点位于原点。
* If {{incode|face}} is {{incode|True}}, the circle will make a face, that is, it will appear filled.
* 如果{{incode|face}}为{{incode|True}},则把圆形构造为一个面,即将它填充为实心圆片。
* If {{incode|startangle}} and {{incode|endangle}} are given in degrees, and have different values, they are used and the object appears as a [[Draft Arc]].
* 如果将{{incode|startangle}}与{{incode|endangle}}设置为不同的度数,便会启用此二参数,且目标对象表现为一个[[Draft Arc]]。
</div>


示例:
示例:
Line 84: Line 104:
}}
}}


{{Docnav|[[Draft_Wire|Wire]]|[[Draft_Arc|Arc]]|[[Draft_Module|Draft]]|IconL=Draft_Wire.svg |IconC=Workbench_Draft.svg|IconR=Draft_Arc.svg}}
{{Docnav|[[Draft_Fillet|Fillet]]|[[Draft_Arc|Arc]]|[[Draft_Module|Draft]]|IconL=Draft_Fillet.svg |IconC=Workbench_Draft.svg|IconR=Draft_Arc.svg}}

{{Draft Tools navi}}


{{Draft Tools navi{{#translation:}}}}
{{Userdocnavi}}
{{Userdocnavi{{#translation:}}}}
{{clear}}
{{clear}}

Revision as of 14:22, 19 October 2020

Draft Circle

Menu location
Draft → Circle
Workbenches
Draft, Arch
Default shortcut
C I
Introduced in version
0.7
See also
Draft Arc, Draft Ellipse
Macro CirclePlus

Description

描述

底图圆形工具通过用户输入的两个点(中心点与半径),或通过拾取切线,或上述若干组合来在当前的工作平面上创建一个圆形。它将根据Draft Tray中的Draft Linestyle来创建圆形。

此工具与Draft Arc工具的工作方式很相似,区别在于前者创建的是一个完整的圆周。要绘制椭圆形请使用Draft Ellipse工具。

两点定一圆

Usage

如何使用

  1. 点击 Draft Circle按钮,或先后按下CI键。
  2. 在3D视图中单击第一个点,或输入一个coordinate并按下 add point按钮。
  3. 在3D视图中单击第二个点,或输入一个半径值。

通过双击树状视图(tree view)中的元素或点击 Draft Edit按钮即可编辑对应圆形。届时,您就可将中心点与半径点移动到预定的新位置。

创建圆形之后,通过将其第一角度(first angle)与最后角度(last angle)两个属性设置为不同值,便可以将它转换为一条弧。

选项

  • 此工具绘制圆形的主要用法就是拾取两点,即圆形的中心点及其圆周上一点。
    • 通过按下Alt键,您就可以选取一条切线而非拾取一个点。You can therefore construct several types of circles by selecting one, two or three tangents.
  • 为了手动输入坐标,您可以在输入X、Y或Z坐标值后,通过按下Enter键切换至下一个坐标分量。您可以在输入点的坐标值后按 add point按钮来插入目标点。
  • T键或单击continue多选框即可切换至连续模式。如果开启了连续模式,则圆形工具将在绘制完一个圆形后再次开启,并令您在不用按下圆形工具这一按钮的情况下,继续绘制下一个圆形。
  • L键或单击filled复选框即可切换至填充模式。若开启填充模式,此工具创建的将是一个圆形的面(数据Make Face true);否则创建的仅是一个圆形而非圆面(数据Make Face false)。
  • 若希望将点强制绘至捕捉到的最近位置,请按住Ctrl键。
  • 若希望令绘制的第二个点位于第一个的水平或垂直方向,请按住Shift键。
  • Esc键或Close按钮来终止当前命令。

属性

圆形对象享有Draft Arc中的所有属性,但是有些属性仅对圆形而言才有意义。

数据

  • 数据First Angle: 指定圆形的起始角度;此值通常为0°.
  • 数据Last Angle: 指定圆形的结束角度;此值通常为0°。
  • 数据Radius: 指定圆形的半径。
  • 数据Make Face: 指定此工具绘制的是圆面还是圆形。如果值为true则创建一个面,否则仅是创建一个圆周。只有绘制完整的圆形时,本属性才会生效。
对于完整的圆形而言,数据First Angle数据Last Angle应当有着相同的值;否则,显示的将是一个弧线。0°与 360°并非相同的值,因此若采用这两个值,则绘制的圆无法构成一个面。

视图

  • 视图Pattern: 指定底图图案,用它来填充圆面。只有当数据Make Facetrue视图Display Mode为"Flat Lines"时本属性才能生效。
  • 视图Pattern Size: 指定底图图案的大小。

脚本

参见: Draft APIFreeCAD Scripting Basics

通过下列函数就可以在macrosPython控制台中使用圆形工具:

Circle = makeCircle(radius, placement=None, face=None, startangle=None, endangle=None, support=None)
Circle = makeCircle(Part.Edge, placement=None, face=None, startangle=None, endangle=None, support=None)
  • 利用指定的以毫米为单位的radius来创建一个Circle对象。
    • 可用Part.Edge来代替radius,但是其Curve属性必为Part.Circle.
  • 如果给出了placement便采用此值为中心点;否则此圆形中心点位于原点。
  • 如果faceTrue,则把圆形构造为一个面,即将它填充为实心圆片。
  • 如果将startangleendangle设置为不同的度数,便会启用此二参数,且目标对象表现为一个Draft Arc

示例:

import FreeCAD, Draft

Circle1 = Draft.makeCircle(200)

ZAxis = FreeCAD.Vector(0, 0, 1)
p2 = FreeCAD.Vector(1000, 1000, 0)
place2 = FreeCAD.Placement(p2, FreeCAD.Rotation(ZAxis, 0))
Circle2 = Draft.makeCircle(500, placement=place2)

p3 = FreeCAD.Vector(-1000, -1000, 0)
place3 = FreeCAD.Placement(p3, FreeCAD.Rotation(ZAxis, 0))
Circle3 = Draft.makeCircle(750, placement=place3)