Draft Slope: Difference between revisions

From FreeCAD Documentation
m (Icon)
(The command was removed from the Utilities menu in V0.20. See https://github.com/FreeCAD/FreeCAD/pull/4882.)
(26 intermediate revisions by 5 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
<translate>
<translate>

<!--T:9-->
<!--T:9-->
{{Docnav
{{docnav|[[Draft_VisGroup|VisGroup]]|[[Draft AutoGroup|AutoGroup]]|[[Draft_Module|Draft]]|IconL=Draft_VisGroup.svg|IconC=Workbench_Draft.svg|IconR=Draft_AutoGroup.svg}}
|[[Draft_Draft2Sketch|Draft2Sketch]]
|[[Draft_FlipDimension|FlipDimension]]
|[[Draft_Workbench|Draft]]
|IconL=Draft_Draft2Sketch.svg
|IconR=Draft_FlipDimension.svg
|IconC=Workbench_Draft.svg
}}


<!--T:1-->
<!--T:1-->
{{GuiCommand
{{GuiCommand
|Name=Draft Slope
|Name=Draft Slope
|MenuLocation=Draft → Utilities → Set Slope
|MenuLocation=Modification → Set slope
|Workbenches=[[Draft Module|Draft]], [[Arch Module|Arch]]
|Workbenches=[[Draft_Workbench|Draft]], [[Arch_Workbench|Arch]]
|SeeAlso=[[Draft Line]], [[Draft Wire]]
|Version=0.17
|Version=0.17
}}
}}


==Description== <!--T:2-->
==Description== <!--T:12-->
For a selected [[Draft Line]] or [[Draft Wire]] drawn on the XY plane, the Draft Slope tool increases the Z coordinate of all vertices after the first one, so that the line or wire has the defined slope.


<!--T:5-->
<!--T:2-->
The [[Image:Draft_Slope.svg|24px]] '''Draft Slope''' command slopes selected [[Draft_Line|Draft Lines]] or [[Draft_Wire|Draft Wires]] by increasing, or decreasing, the Z coordinate of all points after the first one. It can also be used to flatten [[Draft_Wire|Draft Wires]]. Note that the slope is relative to the XY plane defined by the {{PropertyData|Placement}} of the objects.
The equivalent action is editing the object and moving the points manually to a new position.


</translate>
</translate>
Line 23: Line 29:
<translate>
<translate>
<!--T:6-->
<!--T:6-->
{{Caption|Horizontal line; line with slope changed to 45°}}
{{Caption|On the left a horizontal Draft Line. On the right the same line with a slope value of 1 (angle is 45°)}}


==How to use== <!--T:4-->
==Usage== <!--T:13-->
# Select a [[Draft Line]] or [[Draft Wire]] object.
# Go to the menu {{MenuCommand|Draft → Utilities → [[Image:Draft Slope.png|16px]] [[Draft Slope|Set Slope]]}}.
# Set the desired slope value, and press the {{Button|OK}} button.


<!--T:3-->
<!--T:4-->
# Select one or more [[Draft_Line|Draft Lines]] and/or [[Draft_Wire|Draft Wires]].
The slope value is the [https://en.wikipedia.org/wiki/Trigonometric_functions#tan tangent] of the elevation angle:
# There are several ways to invoke the command:
* 0 means the line is completely horizontal, because tan(0°) = 0.
#* Press the {{Button|[[Image:Draft_Slope.svg|16px]] [[Draft_Slope|Draft Slope]]}} button.
* 1 means 45 degrees up, because tan(45°) = 1.
#* Select the {{MenuCommand|Modification → [[Image:Draft_Slope.svg|16px]] Set slope}} option from the menu.
* 0.577 means 30 degrees up, because tan(30°) = 0.577.
# Enter a {{MenuCommand|Slope}} value. {{Value|0}} means each segment is horizontal, {{Value|0.5}} means the delta height for each segment is {{Value|0.5}} times its length, etc. The value can also be negative.
* 1.732 means 60 degrees up, because tan(60°) = 1.732, etc.
# Press {{KEY|Enter}} or the {{button|OK}} button to finish the command.


<!--T:7-->
==Scripting== <!--T:14-->
Negative values are also possible:
* -1 means 45 degrees down, because tan(-45°) = -1, etc.


<!--T:8-->
<!--T:15-->
See also: [https://freecad.github.io/SourceDoc/ Autogenerated API documentation] and [[FreeCAD Scripting Basics|FreeCAD Scripting Basics]].
{{docnav|[[Draft_VisGroup|VisGroup]]|[[Draft AutoGroup|AutoGroup]]|[[Draft_Module|Draft]]|IconL=Draft_VisGroup.svg|IconC=Workbench_Draft.svg|IconR=Draft_AutoGroup.svg}}


<!--T:16-->
{{Draft Tools navi}}
There is no Python method to slope objects. To emulate the results of the Draft Slope command the {{incode|Points}} property of wire objects has to be modified.


<!--T:8-->
{{Docnav
|[[Draft_Draft2Sketch|Draft2Sketch]]
|[[Draft_FlipDimension|FlipDimension]]
|[[Draft_Workbench|Draft]]
|IconL=Draft_Draft2Sketch.svg
|IconR=Draft_FlipDimension.svg
|IconC=Workbench_Draft.svg
}}


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

Revision as of 12:58, 2 September 2021

Draft Slope

Menu location
Modification → Set slope
Workbenches
Draft, Arch
Default shortcut
None
Introduced in version
0.17
See also
None

Description

The Draft Slope command slopes selected Draft Lines or Draft Wires by increasing, or decreasing, the Z coordinate of all points after the first one. It can also be used to flatten Draft Wires. Note that the slope is relative to the XY plane defined by the DataPlacement of the objects.

On the left a horizontal Draft Line. On the right the same line with a slope value of 1 (angle is 45°)

Usage

  1. Select one or more Draft Lines and/or Draft Wires.
  2. There are several ways to invoke the command:
    • Press the Draft Slope button.
    • Select the Modification → Set slope option from the menu.
  3. Enter a Slope value. 0 means each segment is horizontal, 0.5 means the delta height for each segment is 0.5 times its length, etc. The value can also be negative.
  4. Press Enter or the OK button to finish the command.

Scripting

See also: Autogenerated API documentation and FreeCAD Scripting Basics.

There is no Python method to slope objects. To emulate the results of the Draft Slope command the Points property of wire objects has to be modified.