Draft Slope: Difference between revisions

From FreeCAD Documentation
(Version=0.17 in the {{GuiCommand}} template)
(The command was removed from the Utilities menu in V0.20. See https://github.com/FreeCAD/FreeCAD/pull/4882.)
(32 intermediate revisions by 6 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
<translate>
<translate>

<!--T:9-->
{{Docnav
|[[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:2-->
The equivalent action is editing the object and moving the points manually to a new position.
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.


</translate>
==How to use== <!--T:4-->
[[Image:Draft_Slope_example.png|400px]]
# Select a [[Draft Line]] or [[Draft Wire]] object.
<translate>
# Press the {{Button|[[Image:Draft Slope.png|16px]] [[Draft Slope|Set Slope]]}} button, or go to the menu {{MenuCommand|Draft → Utilities → Set Slope}}.
<!--T:6-->
# Set the desired slope value, and press the {{Button|OK}} button.
{{Caption|On the left a horizontal Draft Line. On the right the same line with a slope value of 1 (angle is 45°)}}


<!--T:3-->
==Usage== <!--T:13-->
The slope value is the tangent of the elevation angle:
* 0 means the line is completely horizontal, that is, tan(0°) = 0.
* 1 means 45 degrees up, that is, tan(45°) = 1.
* 0.577 means 30 degrees up, that is, tan(30°) = 0.577.
* 1.732 means 60 degrees up, that is, tan(60°) = 1.732, etc.


<!--T:4-->
Negative values are also possible:
# Select one or more [[Draft_Line|Draft Lines]] and/or [[Draft_Wire|Draft Wires]].
* -1 means 45 degrees down, that is, tan(-45°) = -1, etc.
# There are several ways to invoke the command:
#* Press the {{Button|[[Image:Draft_Slope.svg|16px]] [[Draft_Slope|Draft Slope]]}} button.
#* Select the {{MenuCommand|Modification → [[Image:Draft_Slope.svg|16px]] Set slope}} option from the menu.
# 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.
# Press {{KEY|Enter}} or the {{button|OK}} button to finish the command.

==Scripting== <!--T:14-->

<!--T:15-->
See also: [https://freecad.github.io/SourceDoc/ Autogenerated API documentation] and [[FreeCAD Scripting Basics|FreeCAD Scripting Basics]].

<!--T:16-->
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
}}


{{Draft Tools navi}}
{{Userdocnavi}}
</translate>
</translate>
{{Draft Tools navi{{#translation:}}}}
{{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.