Sketcher Workbench/ja: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
(Updating to match new version of source page)
 
(19 intermediate revisions by the same user not shown)
Line 7: Line 7:
|IconR=Workbench_Spreadsheet.svg
|IconR=Workbench_Spreadsheet.svg
}}
}}

{{VeryImportantMessage|This page has been marked for translation. But it is still a work in progress!!!}}


[[Image:Workbench_Sketcher.svg|thumb|128px|Sketcher workbench icon]]
[[Image:Workbench_Sketcher.svg|thumb|128px|Sketcher workbench icon]]
Line 20: Line 22:
スケッチャーは[[Part Module/jp|ブーリアン演算]]と並んで3次元形状デザイン作成の中核を成す機能なのです。
スケッチャーは[[Part Module/jp|ブーリアン演算]]と並んで3次元形状デザイン作成の中核を成す機能なのです。
</div>
</div>

Together with boolean operations defined in the [[Image:Workbench_Part.svg|16px]] [[Part Workbench|Part Workbench]], the Sketcher Workbench, or "The Sketcher" for short, forms the basis of the [[constructive solid geometry|constructive solid geometry]] (CSG) method of building solids. Together with [[Image:Workbench_PartDesign.svg|16px]] [[PartDesign_Workbench|PartDesign Workbench]] operations, it also forms the basis of the [[feature editing|feature editing]] methodology of creating solids. But many other workbenches use sketches as well.


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
スケッチャーワークベンチの特徴はなんといっても拘束です・・これによって2次元形状を厳密な幾何定義に従って拘束することが可能です。また拘束用ソルバーによって2次元形状の拘束範囲を計算したり、スケッチの自由度を対話的に検査したりすることが可能です。
スケッチャーワークベンチの特徴はなんといっても拘束です・・これによって2次元形状を厳密な幾何定義に従って拘束することが可能です。また拘束用ソルバーによって2次元形状の拘束範囲を計算したり、スケッチの自由度を対話的に検査したりすることが可能です。
</div>
</div>

[[File:FC_ConstrainedSketch.png|450px]]
{{Caption|A fully constrained sketch}}

== Basics of constraint sketching ==


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
==スケッチ拘束基本 ==
=== スケッチャーに向かないも===
スケッチャーは2次元図面を作成するためのものではありません。ソリッド形状を作成するとスケッチは自動的に非表示になります。寸法はスケッチ編集モード時のみ表示されます。
スケッチャーがどのように動作するか説明するには"従来"の製図方法と比較するとわかりやすいでしょう。
</div>
</div>


[[File:FC_ConstrainedSketch.png|450px]]
==== Traditional Drafting ====
{{Caption|A fully constrained sketch}}


== Constraints ==
<div class="mw-translate-fuzzy">
==== 従来の製図 ====
"従来"のCAD製図方法は過去の[http://en.wikipedia.org/wiki/Drawing_board 製図板]を用いた方法を受け継いでいます。[http://en.wikipedia.org/wiki/Multiview_orthographic_projection (2次元)正射影図]を手書きすることで製図(いわゆる青写真)を作成します。物体は意図したサイズ、寸法に合わせて正確に描画されます。もし点(0, 0)から伸びる100mmの水平線を描きたければまずラインツールを選択し、画面をクリックするか座標(0, 0)と入力して始点を設定した後、終点をクリックするか座標を(100,0)を入力します。あるいは位置を気にせずに線を描き、後から位置を調整します。形状を描き終わったらそれらに寸法を追加します。
</div>

==== Constraint Sketching ====

<div class="mw-translate-fuzzy">
==== 拘束スケッチ ====
'''スケッチャー'''の方法は全く異なります。物体を厳密に描く必要はありません。なぜなら物体は後で拘束をかけることによって定義されるからです。物体はおおまかに描けばよく、拘束をかける前であれば変更も可能です。実際の所、物体は"流動的"で動かしたり、伸ばしたり、回転させたり、拡大縮小させたりといったことが可能です。これによってデザイン作業がとても柔軟なものになります。
</div>

==== What are constraints? ====


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
Line 60: Line 48:
<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
複数のオブジェクトがある場合は相互に拘束が可能です。二本のラインがあった場合、点一致拘束を使用することでそれぞれの端点をつなぎ合わせることができます。また二本のラインの間の角度を設定したり、二本のラインが垂直になるよう設定することも可能です。ラインに対しては円弧や円の接線となるように拘束することもできます。
複数のオブジェクトがある場合は相互に拘束が可能です。二本のラインがあった場合、点一致拘束を使用することでそれぞれの端点をつなぎ合わせることができます。また二本のラインの間の角度を設定したり、二本のラインが垂直になるよう設定することも可能です。ラインに対しては円弧や円の接線となるように拘束することもできます。
</div>
</div>


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


=== Driving vs. reference constraints ===
==== What the Sketcher is not good for ====


=== Edit constraints ===
<div class="mw-translate-fuzzy">
=== スケッチャーに向かないもの ===
スケッチャーは2次元図面を作成するためのものではありません。ソリッド形状を作成するとスケッチは自動的に非表示になります。寸法はスケッチ編集モード時のみ表示されます。
</div>


When a [[Sketcher_ToggleDrivingConstraint|driving constraint]] is created, and if the {{MenuCommand|Ask for value after creating a dimensional constraint}} [[Sketcher_Preferences#Display|preference]] is selected (default), a dialog opens to edit its value.
<div class="mw-translate-fuzzy">
もし印刷用の2次元表示を作成するだけで3次元モデルが必要ないのであれば[[Draft_Workbench/ja|製図ワークベンチ]]をチェックしてください(製図ワークベンチでも2次元形状が作れることを記憶に留めておいてください。今のところスケッチャーでは使用できない機能、例えばB-スプラインなどを使うこともできます)。
</div>


[[Image:Sketcher_Edit_Constraint.png|Sketcher_Edit_Constraint.png]]
== Sketching Workflow ==


You can enter a numerical value or an [[Expressions|expression]], and it is possible to name the constraint to facilitate its use in other expressions. You can also check the {{MenuCommand|Reference}} checkbox to switch the constrain to reference mode.
<div class="mw-translate-fuzzy">
== Sketching Workflow ==
スケッチは常に2次元(2D)です。 ソリッドを作成するには、囲まれた1つの領域の2Dスケッチを作成し、次にPaddedまたはRevolvedで3次元を追加して、2Dスケッチから3Dソリッドを作成します。
</div>


To edit the value of an existing dimensional constraint do one of the following:
<div class="mw-translate-fuzzy">
* Double-click the constraint value in the [[3D_view|3D view]].
スケッチが互いに交差する線分、Pointが線分上に直接ない場所、または隣接する線分の端点間にギャップがある場所では、PadまたはRevolveはソリッドを作成しません。 この規則の例外は、それがConstruction(blue)Geometryには適用されないことです。
* Double-click the constraint in the [[Sketcher_Dialog|Sketcher Dialog]].
</div>
* Right-click the constraint in the Sketcher Dialog and select the {{MenuCommand|Change value}} option from the context menu.


=== Reposition constraints ===
<div class="mw-translate-fuzzy">
囲まれた領域の内側に、重ならない小さな領域を含めることができます。 3Dソリッドを作成すると、これらは無効になります。
</div>


Constraints can be repositioned in the 3D view by dragging. Hold down the left mouse button over the constraint value and move the mouse.
Once a Sketch is fully constrained, the Sketch features will turn green; Construction Geometry will remain blue. It is usually "finished" at this point and suitable for use in creating a 3D solid. However, once the Sketch dialog is closed it may be worthwhile going to [[Image:Workbench_Part.svg|24px]] [[Part_Workbench|Part Workbench]] and running {{Button|[[File:Part_CheckGeometry.svg|16px]] [[Part_CheckGeometry|Check geometry]]}} to ensure there are no features in the Sketch which may cause later problems.

== Profile sketches ==

To create a sketch that can be used as a profile for generating solids certain rules must be followed:
* The sketch must contain only closed contours. Gaps between endpoints, however small, are not allowed.
* Contours can be nested, to create voids, but should not self-intersect or intersect other contours.
* Contours cannot share edges with other contours. Duplicate edges should be avoided.
* T-connections, that is more than two edges sharing a common point, or a point touching an edge, are not allowed.

These rules do not apply to construction geometry (default color blue), which is not shown outside edit mode, or if the sketch is used for a different purpose. Depending on the workbench and the tool that will use the profile sketch, additional restrictions may apply.

== Drawing aids ==

The Sketcher Workbench has several drawing aids and other features that can help when creating geometry and applying constraints.

=== Continue modes ===

There are two continue modes: '''Geometry creation "Continue Mode"''' and '''Constraint creation "Continue Mode"'''. If these are checked (default) in the [[Sketcher_Preferences#Display|preferences]], related tools will restart after finishing. To exit an continuous tool press {{KEY|Esc}} or the right mouse button. This must be repeated if a continuous geometry tool has already received input. You can also exit a continuous tool by starting another geometry or constraint creation tool. Note that pressing {{KEY|Esc}} if no tool is active will exit sketch edit mode. Uncheck the '''Esc can leave sketch edit mode''' [[Sketcher_Preferences#General|preference]] if you often inadvertently press {{KEY|Esc}} too many times.

=== Auto constraints ===

In sketches that have '''Auto constraints''' checked (default) several constraints are applied automatically when hovering the cursor properly (their symbols are displayed next to the cursor before applying). This is a per-sketch setting that can be changed in the [[Sketcher_Dialog#Constraints|Sketcher Dialog]] or by changing the {{PropertyView|Autoconstraints}} [[Property_editor|property]] of the sketch. The following constraints are applied automatically:
* [[Sketcher_ConstrainCoincident|Coincident]]
* [[Sketcher_ConstrainPointOnObject|Point on object]]
* [[Sketcher_ConstrainHorizontal|Horizontal]]
* [[Sketcher_ConstrainVertical|Vertical]]
* [[Sketcher_ConstrainTangent|Tangent]]
* {{Version|0.22}}: [[Sketcher_ConstrainSymmetric|Symmetric]] (line midpoint)

=== Snapping ===

{{Version|0.21}}

It is possible to [[Sketcher_Snap|snap]] to grid lines and grid intersection, to edges of geometry and midpoints of lines and arcs, and to certain angles. Please note that snapping does not produce constraints in and of itself. For example, only if Auto constraints is switched on will snapping to an edge produce a [[Sketcher_ConstrainPointOnObject|Point on object constraint]]. But just picking a point on the edge would then have the same result.

=== On-View-Parameters ===

{{Version|0.22}}

Depending on the selected option in the [[Sketcher_Preferences#General|preferences]] only the dimensional On-View-Parameters or both the dimensional and the positional On-View-Parameters can be enabled. Positional parameters allow the input of exact coordinates, for example the center of a circle, or the start point of a line. Dimensional parameters allow the input of exact dimensions, for example the radius of a circle, or the length and angle of a line. On-View-Parameters are not available for all tools.

[[Image:Sketcher_On_view_parameters_positional.png]]
{{Caption|Determining the center point of a circle with the positional parameters enabled}}

[[Image:Sketcher_On_view_parameters_dimensional.png]]
{{Caption|Determining the radius of a circle with the dimensional parameters enabled}}

If values are entered and confirmed by pressing {{KEY|Enter}} or {{KEY|Tab}}, related constraints are added automatically. If two parameters are displayed at the same time, for example the X and Y coordinate of a point, it is possible to enter one value and pick a point to define the other. Depending on the object additional constraints may be required to fully constrain it. Constraints resulting from On-View-Parameters take precedence over those that may result from [[Sketcher_Dialog#Constraints|Auto constraints]].

[[Image:Sketcher_ArcExample3.png|300px]]
{{Caption|Arc created by entering all On-View-Parameters with resulting automatically created constraints}}

=== Coordinate display ===

If the '''Show coordinates beside cursor while editing''' [[Sketcher_Preferences#Display|preference]] is checked (default), the parameters of the current geometry tool (coordinates, radius, or length and angle) are displayed next to the cursor. This is deactivated while On-View-Parameters are shown.

== Selection ==

No need for Ctrl, but...
Select in Sketcher Dialog...

=== Box selection ===

=== Connected geometry selection ===

== Copy, cut and paste ==

{{Version|0.22}}

The standard keyboard shortcuts can be used to copy, {{KEY|Ctrl}}+{{KEY|C}}, cut, {{KEY|Ctrl}}+{{KEY|X}}, and paste, {{KEY|Ctrl}}+{{KEY|V}}, the currently selected Sketcher geometry including related constraints. But these tools are also available from the {{MenuCommand|Sketch → Sketcher tools}} menu. They can be used within the same sketch but also between different sketches or separate instances of FreeCAD. Since the data is copied to the clipboard in the form of Python code, it can be used in other ways too (e.g. shared on the forum).


== Tools ==
== Tools ==
Line 100: Line 149:
スケッチャーワークベンチのツールはスケッチャーワークベンチをロードすると表示されるSketcherメニューに配置されています。
スケッチャーワークベンチのツールはスケッチャーワークベンチをロードすると表示されるSketcherメニューに配置されています。
</div>
</div>

{{Version|0.21}}: If a sketch is in edit mode the Structure toolbar is hidden as none of its tools can then be used.


=== General ===
=== General ===
Line 105: Line 156:
==== Sketcher toolbar ====
==== Sketcher toolbar ====


* [[Image:Sketcher_NewSketch.svg‎‎|32px]] [[Sketcher_NewSketch|Create sketch]]: Creates‎ a new sketch on a selected face or plane. If no face is selected while this tool is executed the user is prompted to select a plane from a pop-up window.
* [[Image:Sketcher_NewSketch.svg‎‎|32px]] [[Sketcher_NewSketch|Create sketch]]: Creates a new sketch and opens the [[Sketcher_Dialog|Sketcher Dialog]] to edit it.


* [[Image:Sketcher_EditSketch.svg|32px]] [[Sketcher_EditSketch|Edit sketch]]: Edit the selected Sketch. This will open the [[Sketcher_Dialog|Sketcher Dialog]].
* [[Image:Sketcher_EditSketch.svg|32px]] [[Sketcher_EditSketch|Edit sketch]]: Opens the Sketcher Dialog to edit an existing sketch.


* [[Image:Sketcher_MapSketch.svg|32px]] [[Sketcher_MapSketch|Map sketch to face]]: Maps a sketch to the previously selected face of a solid.
* [[Image:Sketcher_MapSketch.svg|32px]] [[Sketcher_MapSketch|Attach sketch]]: Attaches a sketch to selected geometry.


* [[File:Sketcher_ReorientSketch.svg|32px]] [[Sketcher_ReorientSketch|Reorient sketch]]: Allows you to attach the sketch to one of the main planes.
* [[File:Sketcher_ReorientSketch.svg|32px]] [[Sketcher_ReorientSketch|Reorient sketch]]: Places a sketch on one of the main planes with an optional offset. It can also be used to detach a sketch.


* [[File:Sketcher_ValidateSketch.svg|32px]] [[Sketcher_ValidateSketch|Validate sketch]]: Verify the tolerance of different points and adjust them.
* [[File:Sketcher_ValidateSketch.svg|32px]] [[Sketcher_ValidateSketch|Validate sketch]]: Can analyze and repair a sketch that is no longer editable or has invalid constraints, or add missing coincident constraints.


* [[Image:Sketcher_MergeSketches.svg|32px]] [[Sketcher_MergeSketches|Merge sketches]]: Merge two or more sketches.
* [[Image:Sketcher_MergeSketches.svg|32px]] [[Sketcher_MergeSketches|Merge sketches]]: Merges two or more sketches.


* [[Image:Sketcher_MirrorSketch.svg|32px]] [[Sketcher_MirrorSketch|Mirror sketch]]: Mirror a sketch along the x-axis, the y-axis or the origin.
* [[Image:Sketcher_MirrorSketch.svg|32px]] [[Sketcher_MirrorSketch|Mirror sketch]]: Mirrors sketches along their X axis, Y axis, or origin.


==== Sketcher Edit Mode toolbar ====
==== Sketcher Edit Mode toolbar ====


* [[Image:Sketcher_LeaveSketch.svg|32px]] [[Sketcher_LeaveSketch|Leave sketch]]: Leave the Sketch editing mode.
* [[Image:Sketcher_LeaveSketch.svg|32px]] [[Sketcher_LeaveSketch|Leave sketch]]: Finishes sketch edit mode and closes the [[Sketcher_Dialog|Sketcher Dialog]].

* [[Image:Sketcher_ViewSketch.svg|32px]] [[Sketcher_ViewSketch|View sketch]]: Sets the [[3D_view|3D view]] perpendicular to the sketch plane.

* [[Image:Sketcher_ViewSection.svg|32px]] [[Sketcher_ViewSection|View section]]: Toggles a temporary section plane that hides any objects and parts of objects in front of the sketch plane.


==== Sketcher edit tools toolbar ====
* [[Image:Sketcher_ViewSketch.svg|32px]] [[Sketcher_ViewSketch|View sketch]]: Sets the model view perpendicular to the sketch plane.


* [[Image:Sketcher_ViewSection.svg|32px]] [[Sketcher_ViewSection|View section]]: Creates a section plane that temporarily hides any matter in front of the sketch plane.
* [[Image:Sketcher_Grid.svg|32px]] [[Sketcher_Grid|Toggle grid]]: Toggles the grid in the sketch currently being edited. Settings can be changed in the related menu. {{Version|0.21}}


* [[Image:Sketcher_Grid.svg|32px]] [[Sketcher_Grid|Grid]]: {{Version|0.21}}
* [[Image:Sketcher_Snap.svg|32px]] [[Sketcher_Snap|Toggle snap]]: Toggles snapping in all sketches. Settings can be changed in the related menu. {{Version|0.21}}


* [[Image:Sketcher_Snap.svg|32px]] [[Sketcher_Snap|Snap]]: {{Version|0.21}}
* [[Image:Sketcher_RenderingOrder.svg|32px]] [[Sketcher_RenderingOrder|Configure rendering order]]: The rendering order of all sketches can be changed in the related menu. {{Version|0.21}}


==== Other ====
==== Other ====


* [[File:Sketcher_StopOperation.svg|32px]] [[Sketcher_StopOperation|Stop operation]]: When in edit mode, stop the current operation, whether that is drawing, setting constraints, etc.
* [[File:Sketcher_StopOperation.svg|32px]] [[Sketcher_StopOperation|Stop operation]]: Stops any currently running geometry or constraint creation tool.


===Sketcher geometries===
===Sketcher geometries===
Line 143: Line 198:
* [[Image:Sketcher_CreateLine.svg|32px]] [[Sketcher_CreateLine|Line]]: Draws a line segment between 2 points. Lines are infinite regarding certain constraints.
* [[Image:Sketcher_CreateLine.svg|32px]] [[Sketcher_CreateLine|Line]]: Draws a line segment between 2 points. Lines are infinite regarding certain constraints.


* <span id="Sketcher_CompCreateArc">[[Image:Sketcher_CreateArc.svg|x32px]][[Image:Toolbar_flyout_arrow_blue_background.svg|x32px]] Create arc:</span><!--Do not edit span id: the Sketcher_CompCreateArc pages redirect here-->
* [[Image:Sketcher_CompCreateArc.png|48px]] [[Sketcher_CompCreateArc|Create an arc]]: This is an icon menu in the Sketcher toolbar that holds the following commands:


:* [[Image:Sketcher_CreateArc.svg|32px]] [[Sketcher_CreateArc|Arc]]: Draws an arc segment from center, radius, start angle and end angle.
:* [[Image:Sketcher_CreateArc.svg|32px]] [[Sketcher_CreateArc|Arc]]: Draws an arc segment from center, radius, start angle and end angle.
Line 149: Line 204:
:* [[Image:Sketcher_Create3PointArc.svg|32px]] [[Sketcher_Create3PointArc|Arc by 3 points]]: Draws an arc segment from two endpoints and another point on the circumference.
:* [[Image:Sketcher_Create3PointArc.svg|32px]] [[Sketcher_Create3PointArc|Arc by 3 points]]: Draws an arc segment from two endpoints and another point on the circumference.


* <span id="Sketcher_CompCreateCircle">[[Image:Sketcher_CreateCircle.svg|x32px]][[Image:Toolbar_flyout_arrow_blue_background.svg|x32px]] Create circle:</span><!--Do not edit span id: the Sketcher_CompCreateCircle pages redirect here-->
* [[Image:Sketcher_CompCreateCircle.png|48px]] [[Sketcher_CompCreateCircle|Create a circle]]: This is an icon menu in the Sketcher toolbar that holds the following commands:


:* [[Image:Sketcher_CreateCircle.svg|32px]] [[Sketcher_CreateCircle|Circle]]: Draws a circle from center and radius.
:* [[Image:Sketcher_CreateCircle.svg|32px]] [[Sketcher_CreateCircle|Circle]]: Draws a circle from center and radius.
Line 155: Line 210:
:* [[Image:Sketcher_Create3PointCircle.svg|32px]] [[Sketcher_Create3PointCircle|Circle by 3 points]]: Draws a circle from three points on the circumference.
:* [[Image:Sketcher_Create3PointCircle.svg|32px]] [[Sketcher_Create3PointCircle|Circle by 3 points]]: Draws a circle from three points on the circumference.


* <span id="Sketcher_CompCreateConic">[[Image:Sketcher_Conics.svg|x32px]][[Image:Toolbar_flyout_arrow_blue_background.svg|x32px]] Create conic:</span><!--Do not edit span id: the Sketcher_CompCreateConic pages redirect here-->
* [[Image:Sketcher_CompCreateConic.png|48px]] [[Sketcher_CompCreateConic|Create a conic]]: The sketcher provides the following conical sections. Unlike B-splines they can be used with all sorts of constraints such as [[Sketcher ConstrainTangent|Tangent]], [[Sketcher ConstrainPointOnObject|Point On Object]], or [[Sketcher ConstrainPerpendicular|Perpendicular]].


:* [[Image:Sketcher_CreateEllipseByCenter.svg|32px]] [[Sketcher_CreateEllipseByCenter|Ellipse by center]]: Draws an ellipse by center point, major radius point and minor radius point.
:* [[Image:Sketcher_CreateEllipseByCenter.svg|32px]] [[Sketcher_CreateEllipseByCenter|Ellipse by center]]: Draws an ellipse by center point, major radius point and minor radius point.
Line 167: Line 222:
:* [[Image:Sketcher_CreateArcOfParabola.svg|32px]] [[Sketcher_CreateArcOfParabola|Arc of parabola]]: Draws an arc of parabola.
:* [[Image:Sketcher_CreateArcOfParabola.svg|32px]] [[Sketcher_CreateArcOfParabola|Arc of parabola]]: Draws an arc of parabola.


* <span id="Sketcher_CompCreateBSpline">[[Image:Sketcher_CreateBSpline.svg|x32px]][[Image:Toolbar_flyout_arrow_blue_background.svg|x32px]] B-spline:</span><!--Do not edit span id: the Sketcher_CompCreateBSpline pages redirect here-->
* [[Image:Sketcher_CompCreateBSpline.png|48px]] [[Sketcher_CompCreateBSpline|Create a B-spline]]: This is an icon menu in the Sketcher toolbar that holds the following commands:


:* [[File:Sketcher_CreateBSpline.svg|32px]] [[Sketcher_CreateBSpline|B-spline by control points]]: Draws a B-spline curve by its control points.
:* [[File:Sketcher_CreateBSpline.svg|32px]] [[Sketcher_CreateBSpline|B-spline by control points]]: Draws a B-spline curve by its control points.
Line 173: Line 228:
:* [[File:Sketcher_CreatePeriodicBSpline.svg|32px]] [[Sketcher_CreatePeriodicBSpline|Periodic B-spline by control points]]: Draws a periodic (closed) B-spline curve by its control points.
:* [[File:Sketcher_CreatePeriodicBSpline.svg|32px]] [[Sketcher_CreatePeriodicBSpline|Periodic B-spline by control points]]: Draws a periodic (closed) B-spline curve by its control points.


:* [[File:Sketcher_CreateBSplineByInterpolation.svg|32px]] [[Sketcher_CreateBSplineByInterpolation|B-spline by knots]]: {{Version|0.21}}
:* [[File:Sketcher_CreateBSplineByInterpolation.svg|32px]] [[Sketcher_CreateBSplineByInterpolation|B-spline by knots]]: Draws a B-spline curve by its knots. {{Version|0.21}}


:* [[File:Sketcher_CreatePeriodicBSplineByInterpolation.svg|32px]] [[Sketcher_CreatePeriodicBSplineByInterpolation|Periodic B-spline by knots]]: {{Version|0.21}}
:* [[File:Sketcher_CreatePeriodicBSplineByInterpolation.svg|32px]] [[Sketcher_CreatePeriodicBSplineByInterpolation|Periodic B-spline by knots]]: Draws a periodic (closed) B-spline curve by its knots. {{Version|0.21}}


* [[Image:Sketcher_CreatePolyline.svg|32px]] [[Sketcher_CreatePolyline|Polyline (multiple-point line)]]: Draws a line made of multiple line segments. Pressing the {{KEY|M}} key while drawing a Polyline toggles between the different polyline modes.
* [[Image:Sketcher_CreatePolyline.svg|32px]] [[Sketcher_CreatePolyline|Polyline (multiple-point line)]]: Draws a line made of multiple line segments. Pressing the {{KEY|M}} key while drawing a Polyline toggles between the different polyline modes.


* <span id="Sketcher_CompCreateRectangles">[[Image:Sketcher_CreateRectangle.svg|x32px]][[Image:Toolbar_flyout_arrow_blue_background.svg|x32px]] Create rectangle:</span><!--Do not edit span id: the Sketcher_CompCreateRectangles pages redirect here-->
* [[Image:Sketcher_CompCreateRectangles.png|48px]] [[Sketcher_CompCreateRectangles|Create a rectangle]]: This is an icon menu in the Sketcher toolbar that holds the following commands: {{Version|0.20}}


:* [[Image:Sketcher_CreateRectangle.svg|32px]] [[Sketcher_CreateRectangle|Rectangle]]: Draws a rectangle from 2 opposite points.
:* [[Image:Sketcher_CreateRectangle.svg|32px]] [[Sketcher_CreateRectangle|Rectangle]]: Draws a rectangle from 2 opposite points.
Line 187: Line 242:
:* [[Image:Sketcher_CreateOblong.svg|32px]] [[Sketcher_CreateOblong|Rounded rectangle]]: Draws a rounded rectangle from 2 opposite points. {{Version|0.20}}
:* [[Image:Sketcher_CreateOblong.svg|32px]] [[Sketcher_CreateOblong|Rounded rectangle]]: Draws a rounded rectangle from 2 opposite points. {{Version|0.20}}


* <span id="Sketcher_CompCreateRegularPolygon">[[Image:Sketcher_CreateHexagon.svg|x32px]][[Image:Toolbar_flyout_arrow_blue_background.svg|x32px]] Create regular polygon:</span><!--Do not edit span id: the Sketcher_CompCreateRegularPolygon pages redirect here-->
* [[Image:Sketcher_CompCreateRegularPolygon.png|48px]] [[Sketcher_CompCreateRegularPolygon|Create a regular polygon]]: This is an icon menu in the Sketcher toolbar that holds the following commands:


:* [[Image:Sketcher_CreateTriangle.svg|32px]] [[Sketcher_CreateTriangle|Triangle]]: Draws a regular triangle inscribed in a construction geometry circle.
:* [[Image:Sketcher_CreateTriangle.svg|32px]] [[Sketcher_CreateTriangle|Triangle]]: Draws a regular triangle inscribed in a construction geometry circle.
Line 203: Line 258:
:* [[Image:Sketcher_CreateRegularPolygon.svg|32px]] [[Sketcher_CreateRegularPolygon|Regular polygon]] : Draws a regular polygon by selecting the number of sides and picking two points: the center and one corner.
:* [[Image:Sketcher_CreateRegularPolygon.svg|32px]] [[Sketcher_CreateRegularPolygon|Regular polygon]] : Draws a regular polygon by selecting the number of sides and picking two points: the center and one corner.


* <span id="Sketcher_CompSlot">[[Image:Sketcher_CreateSlot.svg|x32px]][[Image:Toolbar_flyout_arrow_blue_background.svg|x32px]] Create slot:</span><!--Do not edit span id: the Sketcher_CompSlot pages redirect here-->
* [[Image:Sketcher_CreateSlot.svg|32px]] [[Sketcher_CreateSlot|Slot]]: Draws an oval by selecting the center of one semicircle and an endpoint of the other semicircle.


* [[Image:Sketcher_CompCreateFillets.png|48px]] [[Sketcher_CompCreateFillets|Create a fillet]]: This is an icon menu in the Sketcher toolbar that holds the following commands:
:* [[Image:Sketcher_CreateSlot.svg|32px]] [[Sketcher_CreateSlot|Slot]]: Draws an oval by selecting the center of one semicircle and an endpoint of the other semicircle.


:* [[Image:Sketcher_CreateFillet.svg|32px]] [[Sketcher_CreateFillet|Fillet]]: Creates a fillet between two non-parallel lines.
:* [[Image:Sketcher_CreateArcSlot.svg|32px]] [[Sketcher_CreateArcSlot|Arc slot]]: Draws an arc slot consisting of two semicircles connected by two parallel concentric arcs. {{Version|0.22}}


* <span id="Sketcher_CompCreateFillets">[[Image:Sketcher_CreateFillet.svg|x32px]][[Image:Toolbar_flyout_arrow_blue_background.svg|x32px]] Create fillet/chamfer:</span><!--Do not edit span id: the Sketcher_CompCreateFillets pages redirect here-->
:* [[Image:Sketcher_CreatePointFillet.svg|32px]] [[Sketcher_CreatePointFillet|Corner-preserving fillet]]: Creates a fillet between two non-parallel lines while preserving their (virtual) intersection.


* [[Image:Sketcher_Trimming.svg|32px]] [[Sketcher_Trimming|Trim]]: Trims a line, circle or arc with respect to the clicked point.
:* [[Image:Sketcher_CreateFillet.svg|32px]] [[Sketcher_CreateFillet|Fillet]]: Creates a fillet between two non-parallel edges.


:* [[Image:Sketcher_CreateChamfer.svg|32px]] [[Sketcher_CreateChamfer|Chamfer]]: Creates a chamfer between two non-parallel edges.
* [[File:Sketcher_Extend.svg|32px]] [[Sketcher_Extend|Extend]]: Extends a line or an arc to a boundary line, arc, ellipse, arc of ellipse or a point in space.


* <span id="Sketcher_CompCurveEdition">[[Image:Sketcher_Trimming.svg|x32px]][[Image:Toolbar_flyout_arrow_blue_background.svg|x32px]] Edit edge:</span><!--Do not edit span id: the Sketcher_CompCurveEdition pages redirect here-->
* [[Image:Sketcher_Split.svg|32px]] [[Sketcher_Split|Split]]: Splits an edge into two while keeping most of the constraints. {{Version|0.20}}

:* [[Image:Sketcher_Trimming.svg|32px]] [[Sketcher_Trimming|Trim]]: Trims a line, circle or arc with respect to the clicked point.

:* [[Image:Sketcher_Split.svg|32px]] [[Sketcher_Split|Split]]: Splits an edge into two while keeping most of the constraints. {{Version|0.20}}

:* [[File:Sketcher_Extend.svg|32px]] [[Sketcher_Extend|Extend]]: Extends a line or an arc to a boundary line, arc, ellipse, arc of ellipse or a point in space.


* [[Image:Sketcher_External.svg|32px]] [[Sketcher_External|External geometry]]: Creates an edge linked to external geometry.
* [[Image:Sketcher_External.svg|32px]] [[Sketcher_External|External geometry]]: Creates an edge linked to external geometry.
Line 227: Line 288:
Constraints are used to define lengths, set rules between sketch elements, and to lock the sketch along the vertical and horizontal axes. Some constraints require use of [[Sketcher_helper_constraint|Helper constraints]].
Constraints are used to define lengths, set rules between sketch elements, and to lock the sketch along the vertical and horizontal axes. Some constraints require use of [[Sketcher_helper_constraint|Helper constraints]].


* [[File:Sketcher_ConstrainCoincidentUnified.svg|32px]] [[Sketcher_ConstrainCoincidentUnified|Coincident (unified)]]: Can replace the [[Sketcher_ConstrainCoincident|Coincident]] and [[Sketcher_ConstrainPointOnObject|Point on object]] constraints. {{Version|0.22}}
==== Geometric constraints ====

These constraints are not associated with numeric data.


* [[File:Sketcher_ConstrainCoincident.svg|32px]] [[Sketcher_ConstrainCoincident|Coincident]]: Affixes a point onto (coincident with) one or more other points. It acts as a concentric constraint if two or more circles, arcs, ellipses or arcs of ellipses are selected.
* [[File:Sketcher_ConstrainCoincident.svg|32px]] [[Sketcher_ConstrainCoincident|Coincident]]: Affixes a point onto (coincident with) one or more other points. It acts as a concentric constraint if two or more circles, arcs, ellipses or arcs of ellipses are selected.
Line 235: Line 294:
* [[File:Sketcher_ConstrainPointOnObject.svg|32px]] [[Sketcher_ConstrainPointOnObject|Point on object]]: Affixes a point onto another object such as a line, arc, or axis.
* [[File:Sketcher_ConstrainPointOnObject.svg|32px]] [[Sketcher_ConstrainPointOnObject|Point on object]]: Affixes a point onto another object such as a line, arc, or axis.


* <span id="Sketcher_CompHorVer">[[Image:Sketcher_ConstrainHorVer.svg|x32px]][[Image:Toolbar_flyout_arrow_blue_background.svg|x32px]]Horizontal/Vertical constraints:</span><!--Do not edit span id: the Sketcher_CompHorVer pages redirect here-->
* [[File:Sketcher_ConstrainVertical.svg|32px]] [[Sketcher_ConstrainVertical|Vertical]]: Constrains the selected lines or polyline elements to a true vertical orientation. More than one object can be selected before applying this constraint.

:* [[File:Sketcher_ConstrainHorVer.svg|32px]] [[Sketcher_ConstrainHorVer|Horizontal/Vertical]]: Automatically applies [[Sketcher_ConstrainHorizontal|Horizontal]] or [[Sketcher_ConstrainVertical|Vertical]] constraint depending on the orientation of a line. {{Version|0.22}}

:* [[File:Sketcher_ConstrainHorizontal.svg|32px]] [[Sketcher_ConstrainHorizontal|Horizontal]]: Constrains the selected lines or polyline elements to a true horizontal orientation. More than one object can be selected before applying this constraint.


* [[File:Sketcher_ConstrainHorizontal.svg|32px]] [[Sketcher_ConstrainHorizontal|Horizontal]]: Constrains the selected lines or polyline elements to a true horizontal orientation. More than one object can be selected before applying this constraint.
:* [[File:Sketcher_ConstrainVertical.svg|32px]] [[Sketcher_ConstrainVertical|Vertical]]: Constrains the selected lines or polyline elements to a true vertical orientation. More than one object can be selected before applying this constraint.


* [[File:Sketcher_ConstrainParallel.svg|32px]] [[Sketcher_ConstrainParallel|Parallel]]: Constrains two or more lines parallel to one another.
* [[File:Sketcher_ConstrainParallel.svg|32px]] [[Sketcher_ConstrainParallel|Parallel]]: Constrains two or more lines parallel to one another.
Line 251: Line 314:
* [[Image:Sketcher_ConstrainBlock.svg|32px]] [[Sketcher_ConstrainBlock|Block]]: it blocks an edge from moving, that is, it prevents its vertices from changing their current positions. It should be particularly useful to fix the position of B-Splines. See the [https://forum.freecadweb.org/viewtopic.php?f=9&t=26572 Block Constraint forum topic].
* [[Image:Sketcher_ConstrainBlock.svg|32px]] [[Sketcher_ConstrainBlock|Block]]: it blocks an edge from moving, that is, it prevents its vertices from changing their current positions. It should be particularly useful to fix the position of B-Splines. See the [https://forum.freecadweb.org/viewtopic.php?f=9&t=26572 Block Constraint forum topic].


* <span id="Sketcher_CompDimensionTools">[[Image:Sketcher_Dimension.svg|x32px]][[Image:Toolbar_flyout_arrow_blue_background.svg|x32px]] Dimensional constraints:</span><!--Do not edit span id: the Sketcher_CompDimensionTools pages redirect here-->
==== Dimensional constraints ====


:* [[File:Sketcher_Dimension.svg|32px]] [[Sketcher_Dimension|Dimension]]: Provides context-sensitive dimensional constraint tool. {{Version|0.22}}
These are constraints associated with numeric data, for which you can use the [[Expressions|expressions]]. The data may be taken from a [[Spreadsheet_Workbench|spreadsheet]].


:* [[File:Sketcher_ConstrainDistanceX.svg|32px]] [[Sketcher_ConstrainDistanceX|Horizontal distance]]: Fixes the horizontal distance between two points or line endpoints. If only one item is selected, the distance is set to the origin.
* [[File:Sketcher_ConstrainLock.svg|32px]] [[Sketcher_ConstrainLock|Lock]]: Constrains the selected item by setting vertical and horizontal distances relative to the origin, thereby locking the location of that item. These constraint distances can be edited later.


* [[File:Sketcher_ConstrainDistanceX.svg|32px]] [[Sketcher_ConstrainDistanceX|Horizontal distance]]: Fixes the horizontal distance between two points or line endpoints. If only one item is selected, the distance is set to the origin.
:* [[File:Sketcher_ConstrainDistanceY.svg|32px]] [[Sketcher_ConstrainDistanceY|Vertical distance]]: Fixes the vertical distance between 2 points or line endpoints. If only one item is selected, the distance is set to the origin.


* [[File:Sketcher_ConstrainDistanceY.svg|32px]] [[Sketcher_ConstrainDistanceY|Vertical distance]]: Fixes the vertical distance between 2 points or line endpoints. If only one item is selected, the distance is set to the origin.
:* [[File:Sketcher_ConstrainDistance.svg|32px]] [[Sketcher_ConstrainDistance|Distance]]: Defines the length of a line, the perpendicular distance between a point and a line, the distance between two points, or, {{Version|0.21}}, the distance between the edges of two circles.


* [[File:Sketcher_ConstrainDistance.svg|32px]] [[Sketcher_ConstrainDistance|Distance]]: Defines the length of a line, the perpendicular distance between a point and a line, the distance between two points, or, {{Version|0.21}}, the distance between the edges of two circles.
:* <span id="Sketcher_CompConstrainRadDia">[[File:Sketcher_ConstrainRadiam.svg|32px]] [[Sketcher_ConstrainRadiam|Auto radius/diameter]]: Defines the radius of an arc, the diameter of a circle or the weight of a B-spline pole. {{Version|0.20}}</span><!--Do not edit span id: the Sketcher_CompConstrainRadDia pages redirect here-->


:* [[File:Sketcher_ConstrainRadius.svg|32px]] [[Sketcher_ConstrainRadius|Radius]]: Defines the radius of an arc or circle or the weight of a B-spline pole.
* [[Image:Sketcher_CompConstrainRadDia.png|48px]] [[Sketcher_CompConstrainRadDia|Arc or circle]]: This is an icon menu in the Sketcher constraints toolbar that holds the following commands:


:* [[File:Sketcher_ConstrainRadius.svg|32px]] [[Sketcher_ConstrainRadius|Radius]]: Defines the radius of a selected arc or circle by constraining the radius.
:* [[File:Sketcher_ConstrainDiameter.svg|32px]] [[Sketcher_ConstrainDiameter|Diameter]]: Defines the diameter of an arc or circle.


:* [[File:Sketcher_ConstrainDiameter.svg|32px]] [[Sketcher_ConstrainDiameter|Diameter]]: Defines the diameter of a selected arc or circle by constraining the diameter.
:* [[File:Sketcher_ConstrainAngle.svg|32px]] [[Sketcher_ConstrainAngle|Angle]]: Defines the internal angle between two selected lines.


:* [[File:Sketcher_ConstrainLock.svg|32px]] [[Sketcher_ConstrainLock|Lock]]: Constrains the selected item by setting vertical and horizontal distances relative to the origin, thereby locking the location of that item. These constraint distances can be edited later.
:* [[File:Sketcher_ConstrainRadiam.svg|32px]] [[Sketcher_ConstrainRadiam|Radiam]]: Automatically defines radius/diameter of a selected arc or circle (weight for a B-spline pole, diameter for a complete circle, radius for an arc). {{Version|0.20}}

* [[File:Sketcher_ConstrainAngle.svg|32px]] [[Sketcher_ConstrainAngle|Angle]]: Defines the internal angle between two selected lines.


==== Special constraints ====
==== Special constraints ====


* [[File:Sketcher_ConstrainSnellsLaw.svg|32px]] [[Sketcher_ConstrainSnellsLaw|Snell's law]]: Constrains two lines to obey a refraction law to simulate the light going through an interface.
* [[File:Sketcher_ConstrainSnellsLaw.svg|32px]] [[Sketcher_ConstrainSnellsLaw|Refraction (Snell's law)]]: Constrains two lines to obey a refraction law to simulate the light going through an interface.


==== Constraint tools ====
==== Constraint tools ====
Line 287: Line 348:
===Sketcher tools===
===Sketcher tools===


* [[File:Sketcher_SelectElementsWithDoFs.svg|32px]] [[Sketcher_SelectElementsWithDoFs|Select unconstrained DoF]]: Highlights in green the geometry with degrees of freedom (DOFs), i.e. not fully constrained.
* [[File:Sketcher_SelectElementsWithDoFs.svg|32px]] [[Sketcher_SelectElementsWithDoFs|Select unconstrained DoF]]: Highlights in green the geometry with degrees of freedom (DoFs), i.e. not fully constrained.

* [[File:Sketcher_CloseShape.svg|32px]] [[Sketcher_CloseShape|Close shape]]: Creates a closed shape by applying coincident constraints to endpoints. This tool is obsolete, it will not be available in future releases ({{VersionPlus|1.0}}).

* [[File:Sketcher_ConnectLines.svg|32px]] [[Sketcher_ConnectLines|Connect edges]]: Connect sketcher elements by applying coincident constraints to endpoints. This tool is obsolete, it will not be available in future releases ({{VersionPlus|1.0}}).


* [[File:Sketcher_SelectConstraints.svg|32px]] [[Sketcher_SelectConstraints|Select associated constraints]]: Selects the constraints of a sketcher element.
* [[File:Sketcher_SelectConstraints.svg|32px]] [[Sketcher_SelectConstraints|Select associated constraints]]: Selects the constraints of a Sketcher element.


* [[File:Sketcher_SelectElementsAssociatedWithConstraints.svg|32px]] [[Sketcher_SelectElementsAssociatedWithConstraints|Select associated geometry]]: Select sketcher elements associated with constraints.
* [[File:Sketcher_SelectElementsAssociatedWithConstraints.svg|32px]] [[Sketcher_SelectElementsAssociatedWithConstraints|Select associated geometry]]: Select Sketcher elements associated with constraints.


* [[File:Sketcher_SelectRedundantConstraints.svg|32px]] [[Sketcher_SelectRedundantConstraints|Select redundant constraints]]: Selects redundant constraints of a sketch.
* [[File:Sketcher_SelectRedundantConstraints.svg|32px]] [[Sketcher_SelectRedundantConstraints|Select redundant constraints]]: Selects redundant constraints of a sketch.
Line 304: Line 361:


* [[File:Sketcher_SelectOrigin.svg|32px]] [[Sketcher_SelectOrigin|Select origin]]: Selects the origin of a sketch.
* [[File:Sketcher_SelectOrigin.svg|32px]] [[Sketcher_SelectOrigin|Select origin]]: Selects the origin of a sketch.

* [[File:Sketcher_SelectVerticalAxis.svg|32px]] [[Sketcher_SelectVerticalAxis|Select vertical axis]]: Selects the vertical axis of a sketch.


* [[File:Sketcher_SelectHorizontalAxis.svg|32px]] [[Sketcher_SelectHorizontalAxis|Select horizontal axis]]: Selects the horizontal axis of a sketch.
* [[File:Sketcher_SelectHorizontalAxis.svg|32px]] [[Sketcher_SelectHorizontalAxis|Select horizontal axis]]: Selects the horizontal axis of a sketch.


* [[File:Sketcher_Symmetry.svg|32px]] [[Sketcher_Symmetry|Symmetry]]: Copies a sketcher element symmetrical to a chosen line.
* [[File:Sketcher_SelectVerticalAxis.svg|32px]] [[Sketcher_SelectVerticalAxis|Select vertical axis]]: Selects the vertical axis of a sketch.


* [[File:Sketcher_Clone.svg|32px]] [[Sketcher_Clone|Clone]]: Clones a sketcher element.
* [[File:Sketcher_Offset.svg|32px]] [[Sketcher_Offset|Offset geometry]]: Adds an equidistant outline around selected edges. {{Version|0.22}}


* [[File:Sketcher_Rotate.svg|32px]] [[Sketcher_Rotate|Polar transform]]: Rotates and optionally copies (to create polar patterns) selected geometries. {{Version|0.22}}
* [[File:Sketcher_Copy.svg|32px]] [[Sketcher_Copy|Copy]]: Copies a sketcher element.


* [[File:Sketcher_Move.svg|32px]] [[Sketcher_Move|Move]]: Moves the selected geometry taking as reference the last selected point.
* [[File:Sketcher_Scale.svg|32px]] [[Sketcher_Scale|Scale transform]]: Scales and optionally copies selected geometries. {{Version|0.22}}


* [[File:Sketcher_RectangularArray.svg|32px]] [[Sketcher_RectangularArray|Rectangular array]]: Creates an array of selected sketcher elements.
* [[File:Sketcher_Symmetry.svg|32px]] [[Sketcher_Symmetry|Symmetry]]: Copies a Sketcher element symmetrically to a chosen line.

* [[File:Sketcher_Translate.svg|32px]] [[Sketcher_Translate|Array transform]]: Translates and optionally copies (to create linear patterns) selected geometries. {{Version|0.22}}


* [[File:Sketcher_RemoveAxesAlignment.svg|32px]] [[Sketcher_RemoveAxesAlignment|Remove axes alignment]]: Remove axes alignment while trying to preserve the constraint relationship of the selection. {{Version|0.20}}
* [[File:Sketcher_RemoveAxesAlignment.svg|32px]] [[Sketcher_RemoveAxesAlignment|Remove axes alignment]]: Remove axes alignment while trying to preserve the constraint relationship of the selection. {{Version|0.20}}
Line 324: Line 381:


* [[File:Sketcher_DeleteAllConstraints.svg|32px]] [[Sketcher_DeleteAllConstraints|Delete all constraints]]: Deletes all constraints from the sketch.
* [[File:Sketcher_DeleteAllConstraints.svg|32px]] [[Sketcher_DeleteAllConstraints|Delete all constraints]]: Deletes all constraints from the sketch.

* <span id="Sketcher_CopyClipboard">[[File:Edit-copy.svg|32px]] Copy in Sketcher: See [[#Copy,_cut_and_paste|Copy, cut and paste]].</span><!--Do not edit span id: the Sketcher_CopyClipboard pages redirect here-->

* <span id="Sketcher_Cut">[[File:Edit-cut.svg|32px]] Cut in Sketcher: See [[#Copy,_cut_and_paste|Copy, cut and paste]].</span><!--Do not edit span id: the Sketcher_Cut pages redirect here-->

* <span id="Sketcher_Paste">[[File:Edit-paste.svg|32px]] Paste in Sketcher: See [[#Copy,_cut_and_paste|Copy, cut and paste]].</span><!--Do not edit span id: the Sketcher_Paste pages redirect here-->


===Sketcher B-spline tools===
===Sketcher B-spline tools===


* [[File:Sketcher_BSplineConvertToNURBS.svg|32px]] [[Sketcher_BSplineConvertToNURBS|Convert geometry to B-spline]]: Converts compatible geometry, edges and curves, into a B-spline.
* [[File:Sketcher_BSplineDegree.svg|32px]] [[Sketcher_BSplineDegree|Show/hide B-spline degree]]


* [[File:Sketcher_BSplinePolygon.svg|32px]] [[Sketcher_BSplinePolygon|Show/hide B-spline control polygon]]
* [[File:Sketcher_BSplineIncreaseDegree.svg|32px]] [[Sketcher_BSplineIncreaseDegree|Increase B-spline degree]]: Increases the degree (order) of a B-spline.


* [[File:Sketcher_BSplineComb.svg|32px]] [[Sketcher_BSplineComb|Show/hide B-spline curvature comb]]
* [[File:Sketcher_BSplineDecreaseDegree.svg|32px]] [[Sketcher_BSplineDecreaseDegree|Decrease B-spline degree]]: Decreases the degree (order) of a B-spline.


* [[File:Sketcher_BSplineKnotMultiplicity.svg|32px]] [[Sketcher_BSplineKnotMultiplicity|Show/hide B-spline knot multiplicity]]
* [[File:Sketcher_BSplineIncreaseKnotMultiplicity.svg|32px]] [[Sketcher_BSplineIncreaseKnotMultiplicity|Increase knot multiplicity]]: Increases the multiplicity of a B-spline knot.


* [[File:Sketcher_BSplineDecreaseKnotMultiplicity.svg|32px]] [[Sketcher_BSplineDecreaseKnotMultiplicity|Decrease knot multiplicity]]: Decreases the multiplicity of a B-spline knot.
* [[File:Sketcher_BSplinePoleWeight.svg|32px]] [[Sketcher_BSplinePoleWeight|Show/hide B-spline control point weight]]


* [[File:Sketcher_BSplineApproximate.svg|32px]] [[Sketcher_BSplineApproximate|Convert geometry to B-spline]]
* [[File:Sketcher_BSplineInsertKnot.svg|32px]] [[Sketcher_BSplineInsertKnot|Insert knot]]: Inserts a knot into an existing B-spline. {{Version|0.20}}


* [[File:Sketcher_JoinCurves.svg|32px]] [[Sketcher_JoinCurves|Join curves]]: Joins two curves at selected end points. {{Version|0.21}}
* [[File:Sketcher_BSplineIncreaseDegree.svg|32px]] [[Sketcher_BSplineIncreaseDegree|Increase B-spline degree]]


===Sketcher visual===
* [[File:Sketcher_BSplineDecreaseDegree.svg|32px]] [[Sketcher_BSplineDecreaseDegree|Decrease B-spline degree]]


* [[File:Sketcher_SwitchVirtualSpace.svg|32px]] [[Sketcher_SwitchVirtualSpace|Switch virtual space]]: Allows you to hide all constraints of a sketch and make them visible again.
* [[File:Sketcher_BSplineIncreaseKnotMultiplicity.svg|32px]] [[Sketcher_BSplineIncreaseKnotMultiplicity|Increase knot multiplicity]]


* [[File:Sketcher_BSplineDegree.svg|32px]] [[Sketcher_BSplineDegree|Show/hide B-spline degree]]: Shows or hides the display of the degree of a B-spline.
* [[File:Sketcher_BSplineDecreaseKnotMultiplicity.svg|32px]] [[Sketcher_BSplineDecreaseKnotMultiplicity|Decrease knot multiplicity]]


* [[File:Sketcher_BSplinePolygon.svg|32px]] [[Sketcher_BSplinePolygon|Show/hide B-spline control polygon]]: Shows or hides the display of the defining polygon of a B-spline.
* [[File:Sketcher_BSplineInsertKnot.svg|32px]] [[Sketcher_BSplineInsertKnot|Insert knot]], {{Version|0.20}}


* [[File:Sketcher_BSplineComb.svg|32px]] [[Sketcher_BSplineComb|Show/hide B-spline curvature comb]]: Shows or hides the display of the curvature comb of a B-spline.
* [[File:Sketcher_JoinCurves.svg|32px]] [[Sketcher_JoinCurves|Join curves]], {{Version|0.21}}


* [[File:Sketcher_BSplineKnotMultiplicity.svg|32px]] [[Sketcher_BSplineKnotMultiplicity|Show/hide B-spline knot multiplicity]]: Shows or hides the display of the knot multiplicity of a B-spline.
===Sketcher virtual space===


* [[File:Sketcher_SwitchVirtualSpace.svg|32px]] [[Sketcher_SwitchVirtualSpace|Switch virtual space]]: Allows you to hide all constraints of a sketch and make them visible again.
* [[File:Sketcher_BSplinePoleWeight.svg|32px]] [[Sketcher_BSplinePoleWeight|Show/hide B-spline control point weight]]: Shows or hides the display of the weights for the control points of a B-spline.

* [[File:Sketcher_ArcOverlay.svg|32px]] [[Sketcher_ArcOverlay|Show/hide circular helper for arcs]]: Shows or hides the circular helpers (circle outlines) for arcs. {{Version|0.22}}

===Obsolete tools===

* [[File:Sketcher_Clone.svg|32px]] [[Sketcher_Clone|Clone]]: Clones a Sketcher element. Not available in {{VersionPlus|0.22}}.

* [[File:Sketcher_CloseShape.svg|32px]] [[Sketcher_CloseShape|Close shape]]: Creates a closed shape by applying coincident constraints to endpoints. Not available in {{VersionPlus|0.21}}.

* [[File:Sketcher_CreatePointFillet.svg|32px]] [[Sketcher_CreatePointFillet|Corner-preserving fillet]]: Creates a fillet between two non-parallel lines while preserving their corner point. Not available in {{VersionPlus|0.22}}.

* [[File:Sketcher_ConnectLines.svg|32px]] [[Sketcher_ConnectLines|Connect edges]]: Connect Sketcher elements by applying coincident constraints to endpoints. Not available in {{VersionPlus|0.21}}.

* [[File:Sketcher_Copy.svg|32px]] [[Sketcher_Copy|Copy]]: Copies a Sketcher element. Not available in {{VersionPlus|0.22}}.

* [[File:Sketcher_Move.svg|32px]] [[Sketcher_Move|Move]]: Moves the selected geometry taking as reference the last selected point. Not available in {{VersionPlus|0.22}}.

* [[File:Sketcher_RectangularArray.svg|32px]] [[Sketcher_RectangularArray|Rectangular array]]: Creates an array of selected Sketcher elements. Not available in {{VersionPlus|0.22}}.


== Preferences ==
== Preferences ==


* [[Image:Preferences-general.svg|32px]] [[Sketcher_Preferences|Preferences]]: Preferences for the '''Sketcher''' workbench.
* [[Image:Workbench_Sketcher.svg|32px]] [[Sketcher_Preferences|Preferences]]: Preferences for the Sketcher Workbench.


== Best Practices ==
== Best practices ==


Every CAD user develops his own way of working over time, but there are some useful general principles to follow.
Every CAD user develops their own way of working over time, but there are some useful general principles to follow.


* A series of simple sketches is easier to manage than a single complex one. For example, a first sketch can be created for the base 3D feature (either a pad or a revolve), while a second one can contain holes or cutouts (pockets). Some details can be left out, to be realized later on as 3D features. You can choose to avoid fillets in your sketch if there are too many, and add them as a 3D feature.
* A series of simple sketches is easier to manage than a single complex one. For example, a first sketch can be created for the base 3D feature (either a pad or a revolve), while a second one can contain holes or cutouts (pockets). Some details can be left out, to be realized later on as 3D features. You can choose to avoid fillets in your sketch if there are too many, and add them as a 3D feature.
* Always create a closed profile, or your sketch won't produce a solid, but rather a set of open faces. If you don't want some of the objects to be included in the solid creation, turn them to construction elements with the Construction Mode tool.
* Always create a closed profile, or your sketch won't produce a solid, but rather a set of open faces. If you don't want some of the objects to be included in the solid creation, turn them to construction elements with the Construction Mode tool.
* Use the auto constraints feature to limit the number of constraints you'll have to add manually.
* Use the Auto constraints feature to limit the number of constraints you'll have to add manually.
* As a general rule, apply geometric constraints first, then dimensional constraints, and lock your sketch last. But remember: rules are made to be broken. If you're having trouble manipulating your sketch, it may be useful to constrain a few objects first before completing your profile.
* As a general rule, apply geometric constraints first, then dimensional constraints, and lock your sketch last. But remember: rules are made to be broken. If you're having trouble manipulating your sketch, it may be useful to constrain a few objects first before completing your profile.
* If possible, center your sketch to the origin (0,0) with the lock constraint. If your sketch is not symmetric, locate one of its points to the origin, or choose nice round numbers for the lock distances.
* If possible, center your sketch to the origin (0,0) with the Lock constraint. If your sketch is not symmetric, locate one of its points to the origin, or choose nice round numbers for the lock distances.
* If you have the possibility to choose between the Length constraint and the Horizontal or Vertical Distance constraints, prefer the latter. Horizontal and Vertical Distance constraints are computationally cheaper.
* If you have the possibility to choose between the Length constraint and the Horizontal or Vertical distance constraints, prefer the latter. Horizontal and Vertical distance constraints are computationally cheaper.
* In general, the best constraints to use are: Horizontal and Vertical Constraints; Horizontal and Vertical Length Constraints; Point-to-Point Tangency. If possible, limit the use of these: the general Length Constraint; Edge-to-Edge Tangency; Fix Point Onto a Line Constraint; Symmetry Constraint.
* In general, the best constraints to use are: Horizontal and Vertical constraints; Horizontal and Vertical length constraints; point-to-point Tangency. If possible, limit the use of these: the general Length constraint; edge-to-edge Tangency; Point on object constraint; Symmetric constraint.
* If in doubt about the validity of a sketch once it is complete (features turn green), close the Sketcher dialog, switch to the [[Image:Workbench_Part.svg|24px]] [[Part_Workbench|Part Workbench]] and run {{Button|[[File:Part_CheckGeometry.svg|16px]] [[Part_CheckGeometry|Check geometry]]}}.
* If in doubt about the validity of a sketch once it is complete (features turn green), close the Sketcher dialog and use [[File:Sketcher_ValidateSketch.svg|24px]] [[Sketcher_ValidateSketch|Validate sketch]].


<span id="Tutorials"></span>
<span id="Tutorials"></span>
Line 377: Line 458:
</div>
</div>


* [https://forum.freecadweb.org/viewtopic.php?f=36&t=30104 Sketcher tutorial] by chrisb. This is a 70-page long PDF document that serves as a detailed manual for the sketcher. It explains the basics of Sketcher usage, and goes into a lot of detail about the creation of geometrical shapes, and each of the constraints.
* [https://forum.freecadweb.org/viewtopic.php?f=36&t=30104 Sketcher Lecture] by chrisb. This is a more than 80 page PDF document that serves as a detailed manual for the Sketcher. It explains the basics of Sketcher usage, and goes into a lot of detail about the creation of geometrical shapes, and each of the constraints.
* [[Basic_Sketcher_Tutorial|Basic Sketcher Tutorial]] for beginners
* [[Basic_Sketcher_Tutorial|Basic Sketcher Tutorial]] for beginners
* [[Sketcher_Micro_Tutorial_-_Constraint_Practices|Sketcher Micro Tutorial - Constraint Practices]]
* [[Sketcher_Micro_Tutorial_-_Constraint_Practices|Sketcher Micro Tutorial - Constraint Practices]]

Latest revision as of 09:26, 14 April 2024

This page has been marked for translation. But it is still a work in progress!!!
Sketcher workbench icon

はじめに

スケッチャーワークベンチパートデザインワークベンチやその他のワークベンチで使用するための2次元形状を作成するために使われます。 ほとんどのCADモデルでは2次元形状が開始点となることが普通です・・まず簡単な2次元スケッチを'押し出して'3次元形状を作り、その形状の表面に穴を開けるための2次元スケッチを追加したり、スケッチで'突起'(押し出し形状)を定義したりします。 スケッチャーはブーリアン演算と並んで3次元形状デザイン作成の中核を成す機能なのです。

Together with boolean operations defined in the Part Workbench, the Sketcher Workbench, or "The Sketcher" for short, forms the basis of the constructive solid geometry (CSG) method of building solids. Together with PartDesign Workbench operations, it also forms the basis of the feature editing methodology of creating solids. But many other workbenches use sketches as well.

スケッチャーワークベンチの特徴はなんといっても拘束です・・これによって2次元形状を厳密な幾何定義に従って拘束することが可能です。また拘束用ソルバーによって2次元形状の拘束範囲を計算したり、スケッチの自由度を対話的に検査したりすることが可能です。

スケッチャーに向かないもの

スケッチャーは2次元図面を作成するためのものではありません。ソリッド形状を作成するとスケッチは自動的に非表示になります。寸法はスケッチ編集モード時のみ表示されます。

A fully constrained sketch

Constraints

拘束とは何なのか?

拘束は物体の自由度を制限するために使用されます。例えばラインは拘束がない場合は4つの自由度を持ちます。つまり水平方向、垂直方向への移動と拡大縮小と回転が可能です。

水平拘束、垂直拘束、あるいは(他のラインか座標軸の一つに対する)角度拘束を適用すると回転が制限され自由度は3つに減ります。片方の短点を原点に対してロックすることでさらに2つの自由度が減ります。最後にサイズ拘束を適用すれば最後の自由度が無くなります。こうしてラインは完全拘束状態になります。

複数のオブジェクトがある場合は相互に拘束が可能です。二本のラインがあった場合、点一致拘束を使用することでそれぞれの端点をつなぎ合わせることができます。また二本のラインの間の角度を設定したり、二本のラインが垂直になるよう設定することも可能です。ラインに対しては円弧や円の接線となるように拘束することもできます。

拘束には二種類あります。幾何拘束と寸法拘束です。これらについては下の'ツール'セクションで詳しく説明します。

Driving vs. reference constraints

Edit constraints

When a driving constraint is created, and if the Ask for value after creating a dimensional constraint preference is selected (default), a dialog opens to edit its value.

Sketcher_Edit_Constraint.png

You can enter a numerical value or an expression, and it is possible to name the constraint to facilitate its use in other expressions. You can also check the Reference checkbox to switch the constrain to reference mode.

To edit the value of an existing dimensional constraint do one of the following:

  • Double-click the constraint value in the 3D view.
  • Double-click the constraint in the Sketcher Dialog.
  • Right-click the constraint in the Sketcher Dialog and select the Change value option from the context menu.

Reposition constraints

Constraints can be repositioned in the 3D view by dragging. Hold down the left mouse button over the constraint value and move the mouse.

Profile sketches

To create a sketch that can be used as a profile for generating solids certain rules must be followed:

  • The sketch must contain only closed contours. Gaps between endpoints, however small, are not allowed.
  • Contours can be nested, to create voids, but should not self-intersect or intersect other contours.
  • Contours cannot share edges with other contours. Duplicate edges should be avoided.
  • T-connections, that is more than two edges sharing a common point, or a point touching an edge, are not allowed.

These rules do not apply to construction geometry (default color blue), which is not shown outside edit mode, or if the sketch is used for a different purpose. Depending on the workbench and the tool that will use the profile sketch, additional restrictions may apply.

Drawing aids

The Sketcher Workbench has several drawing aids and other features that can help when creating geometry and applying constraints.

Continue modes

There are two continue modes: Geometry creation "Continue Mode" and Constraint creation "Continue Mode". If these are checked (default) in the preferences, related tools will restart after finishing. To exit an continuous tool press Esc or the right mouse button. This must be repeated if a continuous geometry tool has already received input. You can also exit a continuous tool by starting another geometry or constraint creation tool. Note that pressing Esc if no tool is active will exit sketch edit mode. Uncheck the Esc can leave sketch edit mode preference if you often inadvertently press Esc too many times.

Auto constraints

In sketches that have Auto constraints checked (default) several constraints are applied automatically when hovering the cursor properly (their symbols are displayed next to the cursor before applying). This is a per-sketch setting that can be changed in the Sketcher Dialog or by changing the ビューAutoconstraints property of the sketch. The following constraints are applied automatically:

Snapping

introduced in version 0.21

It is possible to snap to grid lines and grid intersection, to edges of geometry and midpoints of lines and arcs, and to certain angles. Please note that snapping does not produce constraints in and of itself. For example, only if Auto constraints is switched on will snapping to an edge produce a Point on object constraint. But just picking a point on the edge would then have the same result.

On-View-Parameters

introduced in version 0.22

Depending on the selected option in the preferences only the dimensional On-View-Parameters or both the dimensional and the positional On-View-Parameters can be enabled. Positional parameters allow the input of exact coordinates, for example the center of a circle, or the start point of a line. Dimensional parameters allow the input of exact dimensions, for example the radius of a circle, or the length and angle of a line. On-View-Parameters are not available for all tools.

Determining the center point of a circle with the positional parameters enabled

Determining the radius of a circle with the dimensional parameters enabled

If values are entered and confirmed by pressing Enter or Tab, related constraints are added automatically. If two parameters are displayed at the same time, for example the X and Y coordinate of a point, it is possible to enter one value and pick a point to define the other. Depending on the object additional constraints may be required to fully constrain it. Constraints resulting from On-View-Parameters take precedence over those that may result from Auto constraints.

Arc created by entering all On-View-Parameters with resulting automatically created constraints

Coordinate display

If the Show coordinates beside cursor while editing preference is checked (default), the parameters of the current geometry tool (coordinates, radius, or length and angle) are displayed next to the cursor. This is deactivated while On-View-Parameters are shown.

Selection

No need for Ctrl, but... Select in Sketcher Dialog...

Box selection

Connected geometry selection

Copy, cut and paste

introduced in version 0.22

The standard keyboard shortcuts can be used to copy, Ctrl+C, cut, Ctrl+X, and paste, Ctrl+V, the currently selected Sketcher geometry including related constraints. But these tools are also available from the Sketch → Sketcher tools menu. They can be used within the same sketch but also between different sketches or separate instances of FreeCAD. Since the data is copied to the clipboard in the form of Python code, it can be used in other ways too (e.g. shared on the forum).

Tools

ツール

スケッチャーワークベンチのツールはスケッチャーワークベンチをロードすると表示されるSketcherメニューに配置されています。

introduced in version 0.21: If a sketch is in edit mode the Structure toolbar is hidden as none of its tools can then be used.

General

Sketcher toolbar

  • Edit sketch: Opens the Sketcher Dialog to edit an existing sketch.
  • Reorient sketch: Places a sketch on one of the main planes with an optional offset. It can also be used to detach a sketch.
  • Validate sketch: Can analyze and repair a sketch that is no longer editable or has invalid constraints, or add missing coincident constraints.
  • Mirror sketch: Mirrors sketches along their X axis, Y axis, or origin.

Sketcher Edit Mode toolbar

  • View section: Toggles a temporary section plane that hides any objects and parts of objects in front of the sketch plane.

Sketcher edit tools toolbar

Other

  • Stop operation: Stops any currently running geometry or constraint creation tool.

Sketcher geometries

These are tools for creating objects.

  • Line: Draws a line segment between 2 points. Lines are infinite regarding certain constraints.
  • Create arc:
  • Arc: Draws an arc segment from center, radius, start angle and end angle.
  • Arc by 3 points: Draws an arc segment from two endpoints and another point on the circumference.
  • Create circle:
  • Circle: Draws a circle from center and radius.
  • Create conic:
  • Ellipse by center: Draws an ellipse by center point, major radius point and minor radius point.
  • Arc of ellipse: Draws an arc of ellipse by center point, major radius point, starting point and ending point.
  • B-spline:
  • Polyline (multiple-point line): Draws a line made of multiple line segments. Pressing the M key while drawing a Polyline toggles between the different polyline modes.
  • Create rectangle:
  • Rectangle: Draws a rectangle from 2 opposite points.
  • Create regular polygon:
  • Triangle: Draws a regular triangle inscribed in a construction geometry circle.
  • Square: Draws a regular square inscribed in a construction geometry circle.
  • Pentagon: Draws a regular pentagon inscribed in a construction geometry circle.
  • Hexagon: Draws a regular hexagon inscribed in a construction geometry circle.
  • Heptagon: Draws a regular heptagon inscribed in a construction geometry circle.
  • Octagon: Draws a regular octagon inscribed in a construction geometry circle.
  • Regular polygon : Draws a regular polygon by selecting the number of sides and picking two points: the center and one corner.
  • Create slot:
  • Slot: Draws an oval by selecting the center of one semicircle and an endpoint of the other semicircle.
  • Create fillet/chamfer:
  • Fillet: Creates a fillet between two non-parallel edges.
  • Chamfer: Creates a chamfer between two non-parallel edges.
  • Edit edge:
  • Trim: Trims a line, circle or arc with respect to the clicked point.
  • Extend: Extends a line or an arc to a boundary line, arc, ellipse, arc of ellipse or a point in space.
  • Toggle construction geometry: Toggles sketch geometry from/to construction mode. Construction geometry is shown in blue and is discarded outside of Sketch editing mode.

Sketcher constraints

Constraints are used to define lengths, set rules between sketch elements, and to lock the sketch along the vertical and horizontal axes. Some constraints require use of Helper constraints.

  • Coincident: Affixes a point onto (coincident with) one or more other points. It acts as a concentric constraint if two or more circles, arcs, ellipses or arcs of ellipses are selected.
  • Point on object: Affixes a point onto another object such as a line, arc, or axis.
  • Horizontal/Vertical constraints:
  • Horizontal: Constrains the selected lines or polyline elements to a true horizontal orientation. More than one object can be selected before applying this constraint.
  • Vertical: Constrains the selected lines or polyline elements to a true vertical orientation. More than one object can be selected before applying this constraint.
  • Parallel: Constrains two or more lines parallel to one another.
  • Perpendicular: Constrains two lines perpendicular to one another, or constrains a line perpendicular to an arc endpoint.
  • Tangent: Creates a tangent constraint between two selected entities, or a co-linear constraint between two line segments. A line segment does not have to lie directly on an arc or circle to be constrained tangent to that arc or circle.
  • Equal: Constrains two selected entities equal to one another. If used on circles or arcs their radii will be set equal.
  • Symmetric: Constrains two points symmetrically about a line, or constrains the first two selected points symmetrically about a third selected point.
  • Block: it blocks an edge from moving, that is, it prevents its vertices from changing their current positions. It should be particularly useful to fix the position of B-Splines. See the Block Constraint forum topic.
  • Dimensional constraints:
  • Horizontal distance: Fixes the horizontal distance between two points or line endpoints. If only one item is selected, the distance is set to the origin.
  • Vertical distance: Fixes the vertical distance between 2 points or line endpoints. If only one item is selected, the distance is set to the origin.
  • Distance: Defines the length of a line, the perpendicular distance between a point and a line, the distance between two points, or, introduced in version 0.21, the distance between the edges of two circles.
  • Radius: Defines the radius of an arc or circle or the weight of a B-spline pole.
  • Diameter: Defines the diameter of an arc or circle.
  • Angle: Defines the internal angle between two selected lines.
  • Lock: Constrains the selected item by setting vertical and horizontal distances relative to the origin, thereby locking the location of that item. These constraint distances can be edited later.

Special constraints

  • Refraction (Snell's law): Constrains two lines to obey a refraction law to simulate the light going through an interface.

Constraint tools

The following tools can be used the change the effect of constraints:

Sketcher tools

  • Show/hide internal geometry: Recreates missing/deletes unneeded internal geometry of a selected ellipse, arc of ellipse/hyperbola/parabola or B-spline.
  • Symmetry: Copies a Sketcher element symmetrically to a chosen line.

Sketcher B-spline tools

Sketcher visual

Obsolete tools

  • Clone: Clones a Sketcher element. Not available in version 0.22 and above.
  • Close shape: Creates a closed shape by applying coincident constraints to endpoints. Not available in version 0.21 and above.
  • Corner-preserving fillet: Creates a fillet between two non-parallel lines while preserving their corner point. Not available in version 0.22 and above.
  • Connect edges: Connect Sketcher elements by applying coincident constraints to endpoints. Not available in version 0.21 and above.
  • Copy: Copies a Sketcher element. Not available in version 0.22 and above.
  • Move: Moves the selected geometry taking as reference the last selected point. Not available in version 0.22 and above.
  • Rectangular array: Creates an array of selected Sketcher elements. Not available in version 0.22 and above.

Preferences

Best practices

Every CAD user develops their own way of working over time, but there are some useful general principles to follow.

  • A series of simple sketches is easier to manage than a single complex one. For example, a first sketch can be created for the base 3D feature (either a pad or a revolve), while a second one can contain holes or cutouts (pockets). Some details can be left out, to be realized later on as 3D features. You can choose to avoid fillets in your sketch if there are too many, and add them as a 3D feature.
  • Always create a closed profile, or your sketch won't produce a solid, but rather a set of open faces. If you don't want some of the objects to be included in the solid creation, turn them to construction elements with the Construction Mode tool.
  • Use the Auto constraints feature to limit the number of constraints you'll have to add manually.
  • As a general rule, apply geometric constraints first, then dimensional constraints, and lock your sketch last. But remember: rules are made to be broken. If you're having trouble manipulating your sketch, it may be useful to constrain a few objects first before completing your profile.
  • If possible, center your sketch to the origin (0,0) with the Lock constraint. If your sketch is not symmetric, locate one of its points to the origin, or choose nice round numbers for the lock distances.
  • If you have the possibility to choose between the Length constraint and the Horizontal or Vertical distance constraints, prefer the latter. Horizontal and Vertical distance constraints are computationally cheaper.
  • In general, the best constraints to use are: Horizontal and Vertical constraints; Horizontal and Vertical length constraints; point-to-point Tangency. If possible, limit the use of these: the general Length constraint; edge-to-edge Tangency; Point on object constraint; Symmetric constraint.
  • If in doubt about the validity of a sketch once it is complete (features turn green), close the Sketcher dialog and use Validate sketch.

チュートリアル

Scripting

The Sketcher scripting page contains examples on how to create constraints from Python scripts.

Examples

For some ideas of what can be achieved with Sketcher tools, have a look at: Sketcher examples.