Draft Slope: Difference between revisions

From FreeCAD Documentation
No edit summary
(Button text.)
 
(21 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
<translate>
<translate>

<!--T:9-->
<!--T:9-->
{{Docnav
{{Docnav
|[[Draft_Draft2Sketch|Draft2Sketch]]
|[[Draft_Layer|Layer]]
|[[Draft_FlipDimension|FlipDimension]]
|[[Draft_AutoGroup|AutoGroup]]
|[[Draft_Module|Draft]]
|[[Draft_Workbench|Draft]]
|IconL=Draft_Layer.svg
|IconL=Draft_Draft2Sketch.svg
|IconR=Draft_AutoGroup.svg
|IconR=Draft_FlipDimension.svg
|IconC=Workbench_Draft.svg
|IconC=Workbench_Draft.svg
}}
}}
Line 14: Line 15:
{{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]]
|Version=0.17
|Version=0.17
|SeeAlso=[[Draft_Line|Draft Line]], [[Draft_Wire|Draft Wire]]
}}
}}


Line 23: Line 23:


<!--T:2-->
<!--T:2-->
For a selected [[Draft_Line|Draft Line]] or [[Draft_Wire|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.
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.

<!--T:5-->
The equivalent action is editing the object and moving the points manually to a new position.


</translate>
</translate>
Line 32: 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°)}}


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


<!--T:4-->
<!--T:4-->
# Select a [[Draft_Line|Draft Line]] or [[Draft_Wire|Draft Wire]] object.
# Select one or more [[Draft_Line|Draft Lines]] and/or [[Draft_Wire|Draft Wires]].
# There are several ways to invoke the command:
# 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.
#* Press the {{Button|[[Image:Draft_Slope.svg|16px]] [[Draft_Slope|Set 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:3-->
<!--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.
The slope value is the [https://en.wikipedia.org/wiki/Trigonometric_functions#tan tangent] of the elevation angle:
* 0 means the line is completely horizontal, because tan(0°) = 0.
* 1 means 45 degrees up, because tan(45°) = 1.
* 0.577 means 30 degrees up, because tan(30°) = 0.577.
* 1.732 means 60 degrees up, because tan(60°) = 1.732, etc.


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


<!--T:8-->
<!--T:8-->
{{Docnav
{{Docnav
|[[Draft_Draft2Sketch|Draft2Sketch]]
|[[Draft_Layer|Layer]]
|[[Draft_FlipDimension|FlipDimension]]
|[[Draft_AutoGroup|AutoGroup]]
|[[Draft_Module|Draft]]
|[[Draft_Workbench|Draft]]
|IconL=Draft_Layer.svg
|IconL=Draft_Draft2Sketch.svg
|IconR=Draft_AutoGroup.svg
|IconR=Draft_FlipDimension.svg
|IconC=Workbench_Draft.svg
|IconC=Workbench_Draft.svg
}}
}}
Line 65: Line 63:
{{Draft Tools navi{{#translation:}}}}
{{Draft Tools navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{clear}}

Latest revision as of 17:12, 3 December 2023

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 Set 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.