Sketcher CreateBSpline: Difference between revisions

From FreeCAD Documentation
(correction of typos)
No edit summary
(12 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
<translate>
<translate>

<!--T:10-->
<!--T:10-->
{{Docnav
{{Docnav
|[[Sketcher_CompCreateBSpline|Create a B-Spline]]
|[[Sketcher_CompCreateBSpline|Create a B-spline]]
|[[Sketcher_CreatePeriodicBSpline|Create periodic B-Spline]]
|[[Sketcher_CreatePeriodicBSpline|Periodic B-spline]]
|[[Sketcher_Workbench|Sketcher]]
|[[Sketcher_Workbench|Sketcher]]
|IconL=Sketcher_CompCreateBSpline.png
|IconL=Sketcher_CompCreateBSpline.png
Line 14: Line 15:
{{GuiCommand
{{GuiCommand
|Name=Sketcher CreateBSpline
|Name=Sketcher CreateBSpline
|MenuLocation= Sketch → Sketcher geometries → Create B-Spline
|MenuLocation=Sketch → Sketcher geometries → Create B-spline
|Workbenches= [[Sketcher_Workbench|Sketcher]]
|Workbenches=[[Sketcher_Workbench|Sketcher]]
|Shortcut={{KEY|G}} {{KEY|B}} {{KEY|B}}
|Version=0.17
|Version=0.17
|SeeAlso=[[Sketcher_CreatePeriodicBSpline|Sketcher periodic B-Spline]]
|SeeAlso=[[Sketcher_CreatePeriodicBSpline|Sketcher periodic B-spline]]
}}
}}


Line 23: Line 25:


<!--T:3-->
<!--T:3-->
This tool creates B-Spline curve from its control points. (See [[B-Splines|this page]] for more info about B-Splines.)
This tool creates a B-spline curve from its control points. (See [[B-Splines|this page]] for more info about B-splines.)


</translate>
</translate>
Line 29: Line 31:
<translate>
<translate>
<!--T:4-->
<!--T:4-->
{{Caption|A B-Spline curve (in white) defined by 4 control points. Pictured are the control polygon in green (the straight lines connecting the control points) and the weight circles in dark yellow. The green digit "3" in the center refers to the [[Sketcher_BSplineIncreaseDegree#Description|degree]] of the B-spline and the digits "(4)" at the ends of the B-spline refer to their [[Sketcher_BSplineDecreaseKnotMultiplicity#Description|knot multiplicity]]. The red digit "3" denotes the control point weight which is defined as radius constraint to the control point circle.}}
{{Caption|A B-spline curve (in white) defined by 4 control points. Pictured are the control polygon in green (the straight lines connecting the control points) and the weight circles in dark yellow. The green digit "3" in the center refers to the [[Sketcher_BSplineIncreaseDegree#Description|degree]] of the B-spline and the digits "(4)" at the ends of the B-spline refer to their [[Sketcher_BSplineDecreaseKnotMultiplicity#Description|knot multiplicity]]. The red digit "3" denotes the control point weight which is defined as radius constraint to the control point circle.}}


==Usage== <!--T:5-->
==Usage== <!--T:5-->


<!--T:6-->
<!--T:6-->
# Press the {{Button|[[File:Sketcher_CreateBSpline.svg|16px]] [[Sketcher_CreateBSpline|Create B-Spline]]}} button.
# Press the {{Button|[[File:Sketcher_CreateBSpline.svg|16px]] [[Sketcher_CreateBSpline|Create B-spline]]}} button.
# Create a series of points by clicking in the 3D view. While the command is active, the created points are connected with straight lines, and a construction circle is created centred on each point.
# Create a series of points by clicking in the [[3D_view|3D view]]. While the command is active, the created points are connected with straight lines, and a construction circle is created centered on each point.
# Optionally press {{KEY|D}} before terminating the input to define the degree of the B-spline. {{Version|0.20}}
# Optionally press {{KEY|Backspace}} before terminating the input to delete the last created control point. {{Version|0.20}}
# Right-click to terminate the input and generate the curve.
# Right-click to terminate the input and generate the curve.
# Depending on preferences, the tool may remain active to trace a new curve. Right-click again to exit the command.
# Depending on preferences, the tool may remain active to trace a new curve. Right-click again to exit the command.
* It is possible to define the weight of the control points by changing the radii of the weight circles. The equality constraints on the circles need to be deleted first. The radius constraint is arbitrary, the weight of the control points will be defined by the relative radii of the circles. It works similar to gravity: the bigger a circle is in relation to the others, the more the curve will be attracted to the control point.
* It is possible to define the weight of the control points by changing the radii of the weight circles. The equality constraints on the circles need to be deleted first. The radius constraint is arbitrary, the weight of the control points will be defined by the relative radii of the circles. It works similar to gravity: the bigger a circle is in relation to the others, the more the curve will be attracted to the control point.
* The visibility of the control polygon, the curvature comb, the degree and the knot multiplicity can be toggled on/off from the [[Sketcher_Workbench#Sketcher_B-spline_tools|B-spline tools]] toolbar.
* The visibility of the control polygon, the curvature comb, the degree and the knot multiplicity can be toggled on/off from the [[Sketcher_Workbench#Sketcher_B-spline_tools|B-spline tools]] toolbar.
* Check out the other tools in the [[Sketcher_Workbench#Sketcher_B-Spline_tools|B-Spline tools]] toolbar for more B-Spline editing tools.
* Check out the other tools in the [[Sketcher_Workbench#Sketcher_B-spline_tools|B-spline tools]] toolbar for more B-spline editing tools.


==Limitations== <!--T:7-->
==Limitations== <!--T:7-->
Line 46: Line 50:
<!--T:8-->
<!--T:8-->
* Many types of constraints are not supported at this time. Only the B-spline's control point and end points can be constrained.
* Many types of constraints are not supported at this time. Only the B-spline's control point and end points can be constrained.
* [[Sketcher_Trimming|Trimming]] and [[Sketcher_Extend|extend]] tools are not supported.
* [[Sketcher_Trimming|Trim]] and [[Sketcher_Extend|extend]] tools are not supported.
* The shape of a B-spline curve can only be edited by dragging one of the control points. The knots lying on the curve cannot be selected.
* The shape of a B-spline curve can only be edited by dragging one of the control points. The knots lying on the curve cannot be selected.





<!--T:11-->
<!--T:11-->
{{Docnav
{{Docnav
|[[Sketcher_CompCreateBSpline|Create a B-Spline]]
|[[Sketcher_CompCreateBSpline|Create a B-spline]]
|[[Sketcher_CreatePeriodicBSpline|Create periodic B-Spline]]
|[[Sketcher_CreatePeriodicBSpline|Periodic B-spline]]
|[[Sketcher_Workbench|Sketcher]]
|[[Sketcher_Workbench|Sketcher]]
|IconL=Sketcher_CompCreateBSpline.png
|IconL=Sketcher_CompCreateBSpline.png
Line 62: Line 65:


</translate>
</translate>
{{Sketcher Tools navi{{#translation:}}}}
{{Sketcher_Tools_navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{clear}}

Revision as of 09:38, 14 April 2022

Sketcher CreateBSpline

Menu location
Sketch → Sketcher geometries → Create B-spline
Workbenches
Sketcher
Default shortcut
G B B
Introduced in version
0.17
See also
Sketcher periodic B-spline

Description

This tool creates a B-spline curve from its control points. (See this page for more info about B-splines.)

A B-spline curve (in white) defined by 4 control points. Pictured are the control polygon in green (the straight lines connecting the control points) and the weight circles in dark yellow. The green digit "3" in the center refers to the degree of the B-spline and the digits "(4)" at the ends of the B-spline refer to their knot multiplicity. The red digit "3" denotes the control point weight which is defined as radius constraint to the control point circle.

Usage

  1. Press the Create B-spline button.
  2. Create a series of points by clicking in the 3D view. While the command is active, the created points are connected with straight lines, and a construction circle is created centered on each point.
  3. Optionally press D before terminating the input to define the degree of the B-spline. introduced in version 0.20
  4. Optionally press Backspace before terminating the input to delete the last created control point. introduced in version 0.20
  5. Right-click to terminate the input and generate the curve.
  6. Depending on preferences, the tool may remain active to trace a new curve. Right-click again to exit the command.
  • It is possible to define the weight of the control points by changing the radii of the weight circles. The equality constraints on the circles need to be deleted first. The radius constraint is arbitrary, the weight of the control points will be defined by the relative radii of the circles. It works similar to gravity: the bigger a circle is in relation to the others, the more the curve will be attracted to the control point.
  • The visibility of the control polygon, the curvature comb, the degree and the knot multiplicity can be toggled on/off from the B-spline tools toolbar.
  • Check out the other tools in the B-spline tools toolbar for more B-spline editing tools.

Limitations

  • Many types of constraints are not supported at this time. Only the B-spline's control point and end points can be constrained.
  • Trim and extend tools are not supported.
  • The shape of a B-spline curve can only be edited by dragging one of the control points. The knots lying on the curve cannot be selected.