Draft Trimex: Difference between revisions

From FreeCAD Documentation
No edit summary
mNo edit summary
 
(90 intermediate revisions by 10 users not shown)
Line 1: Line 1:
<languages/>
<translate>
<translate>
{{GuiCommand|Name=Draft_Trimex|Workbenches=[[Draft Module|Draft]], [[Arch Module|Arch]]|MenuLocation=Draft -> Trim/Extend|Shortcut=T R|SeeAlso=[[Part Extrude]]}}


<!--T:16-->
==Description==
{{Docnav
|[[Draft_Offset|Offset]]
|[[Draft_Stretch|Stretch]]
|[[Draft_Workbench|Draft]]
|IconL=Draft_Offset.svg
|IconR=Draft_Stretch.svg
|IconC=Workbench_Draft.svg
}}


<!--T:1-->
This tool trims/cuts and extends lines and polylines, and extrudes faces.
{{GuiCommand
|Name=Draft Trimex
|MenuLocation=Modification → Trimex
|Workbenches=[[Draft_Workbench|Draft]], [[Arch_Workbench|Arch]]
|Shortcut={{KEY|T}} {{KEY|R}}
|SeeAlso=[[Part_Extrude|Part Extrude]]
}}

==Description== <!--T:2-->

<!--T:3-->
The [[Image:Draft_Trimex.svg|24px]] '''Draft Trimex''' command [[#Trim_or_extend|trims or extends]] a selected object. Intersections with the edge of another object can be used to determine new endpoints. The command can also be used to [[#Extrude|extrude]] a face, in which case it creates a [[Part_Extrude|Part Extrude]] object.


</translate>
</translate>
[[Image:Draft trimex example.jpg|400px]]
[[Image:Draft trimex example.jpg|400px]]
<translate>
<translate>
<!--T:11-->
{{Caption|Top: a Draft Wire extended and then trimmed.<br>
Bottom: a face extruded into a solid body.}}


==Trim or extend== <!--T:20-->
==How to use==


===Usage=== <!--T:21-->
# Select a wire you wish to trim or extend, or select a face you wish to extrude
# Press the {{KEY|[[Image:Draft Trimex.png|16px]] [[Draft Trimex]]}} button, or press {{KEY|T}} then {{KEY|R}} keys
# Click a point in the 3D view


<!--T:5-->
==Options==
# Optionally select one object. The object must be a [[Draft_Line|Draft Line]], a [[Draft_Wire|Draft Wire]], a [[Draft_Arc|Draft Arc]] or a [[Draft_Circle|Draft Circle]] (which can only be trimmed). If the selected object is closed it must have its {{PropertyData|Make Face}} property set to {{FALSE}}.
# There are several ways to invoke the command:
#* Press the {{Button|[[Image:Draft_Trimex.svg|16px]] [[Draft_Trimex|Trimex]]}} button.
#* Select the {{MenuCommand|Modification → [[Image:Draft_Trimex.svg|16px]] Trimex}} option from the menu.
#* Use the keyboard shortcut: {{KEY|T}} then {{KEY|R}}.
# If you have not yet selected an object: select an object in the [[3D_view|3D view]].
# The {{MenuCommand|Trimex}} task panel opens. See [[#Options|Options]] for more information.
# Move the pointer in the [[3D_view|3D view]] so that the preview matches the desired result. If required use the modifier keys as explained in the [[#Options|Options]].
# Do one of the following:
#* Pick a point in the [[3D_view|3D view]].
#* Enter a {{MenuCommand|Distance}} or an {{MenuCommand|Angle}}. The distance is a delta distance. This option does not work if modifier keys are used.
#* Move the pointer over an edge belonging to another object, and click when this edge is highlighted, to trim or extend the selected object using an intersection with the highlighted edge as the new endpoint. When trimming, the projection of the point where the cutting edge is selected onto the object to be trimmed, determines the default result. Note that [[Draft_Snap|Draft Snaps]] can have an undesirable impact here. In some cases it can be useful to turn them off temporarily.


===Options=== <!--T:22-->
* trimming or extending is decided automatically from the position of your mouse
* if you move the mouse cursor over another object, the trim/extend operation will snap to that object or segment
* pressing {{KEY|SHIFT}} will [[Draft_Constrain|constrain]] you to the segment currently being trimmed or extended
* pressing {{KEY|ALT}} will invert the direction of the trimming
* When the selected object is a face, or a face is selected from an existing object, the trimex tool switches to extrude mode. In extrude mode, pressing {{KEY|SHIFT}} frees the extrusion from the face normal and allows to snap elsewhere.


<!--T:23-->
==Scripting==
The single character keyboard shortcuts available in the task panel can be changed. See [[Draft_Preferences|Draft Preferences]]. The shortcuts mentioned here are the default shortcuts.

<!--T:24-->
* Hold down {{KEY|Alt}} to invert the default result of the command.
* Hold down {{KEY|Shift}} to restrict the operation to the current segment of a [[Draft_Wire|Draft Wire]].
* Press {{KEY|S}} to switch [[Draft_Snap|Draft snapping]] on or off.

<!--T:25-->
Here is an example to explain the modifier keys. The left edge or the bottom edge of the U-shaped wire was extended. All [[Draft_Snap|Draft Snaps]] were turned off.


Not available. See the [[Part Extrude]] tool.
</translate>
</translate>
[[Image:Draft_Trimex_example2.png]]
<translate>


<!--T:7-->
<languages/>
# The arc was clicked near the bottom left corner of the wire. This is the default result.
# {{KEY|Alt}} was held down while the arc was clicked near the bottom left corner of the wire.
# {{KEY|Y}} was pressed, and while hovering over the left edge {{KEY|Shift}} was held down and then the arc was clicked. Pressing {{KEY|Y}} is only required for edges that are more or less parallel to the Y axis.

==Extrude== <!--T:26-->

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

<!--T:28-->
See also: [[Draft_Snap|Draft Snap]] and [[Draft_Constrain|Draft Constrain]].

<!--T:29-->
# It can be helpful to first change the [[Draft_SelectPlane|Draft working plane]] so that it is not coplanar with the face you want to extrude.
# Optionally select a single face or an object with a single face.
# There are several ways to invoke the command:
#* Press the {{Button|[[Image:Draft_Trimex.svg|16px]] [[Draft_Trimex|Draft Trimex]]}} button.
#* Select the {{MenuCommand|Modification → [[Image:Draft_Trimex.svg|16px]] Trimex}} option from the menu.
#* Use the keyboard shortcut: {{KEY|T}} then {{KEY|R}}.
# If you have not yet selected an object or a face: select an object with a single face in the [[3D_view|3D view]].
# The {{MenuCommand|Trimex}} task panel opens. See [[#Options_2|Options]] for more information.
# To define the extrusion direction and distance do one of the following:
#* Pick a point in the [[3D_view|3D view]] that does no lie on the same plane as the face.
#* Make sure the pointer is on the correct side of the face in the [[3D_view|3D view]] and enter a {{MenuCommand|Distance}}.

===Options=== <!--T:30-->

<!--T:31-->
The modifier key mentioned here can be changed. See [[Draft_Preferences|Draft Preferences]].

<!--T:32-->
* Hold {{KEY|Shift}} to extrude in a direction that is not parallel to the normal of the face.

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

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

<!--T:9-->
There is no Python method to trim objects. To extrude objects use the {{incode|extrude}} method of the Draft module.

</translate>
{{Code|code=
extrusion = extrude(obj, vector, solid=False)
}}
<translate>

<!--T:36-->
* {{incode|obj}} is the object to be extruded.
* {{incode|vector}} is the extrusion direction and distance.
* If {{incode|solid}} is {{incode|True}} a solid is created instead of a shell.
* {{incode|extrusion}} is returned with the created object.

<!--T:37-->
Example:

</translate>
{{Code|code=
import FreeCAD as App
import Draft

doc = App.newDocument()

rectangle = Draft.make_rectangle(1500, 500)
doc.recompute()

vector = App.Vector(0, 0, 300)
solid = Draft.extrude(rectangle, vector, solid=True)
doc.recompute()
}}
<translate>


<!--T:15-->
{{Docnav
|[[Draft_Offset|Offset]]
|[[Draft_Stretch|Stretch]]
|[[Draft_Workbench|Draft]]
|IconL=Draft_Offset.svg
|IconR=Draft_Stretch.svg
|IconC=Workbench_Draft.svg
}}

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

Latest revision as of 18:41, 6 January 2024

Draft Trimex

Menu location
Modification → Trimex
Workbenches
Draft, Arch
Default shortcut
T R
Introduced in version
-
See also
Part Extrude

Description

The Draft Trimex command trims or extends a selected object. Intersections with the edge of another object can be used to determine new endpoints. The command can also be used to extrude a face, in which case it creates a Part Extrude object.

Top: a Draft Wire extended and then trimmed.
Bottom: a face extruded into a solid body.

Trim or extend

Usage

  1. Optionally select one object. The object must be a Draft Line, a Draft Wire, a Draft Arc or a Draft Circle (which can only be trimmed). If the selected object is closed it must have its DataMake Face property set to false.
  2. There are several ways to invoke the command:
    • Press the Trimex button.
    • Select the Modification → Trimex option from the menu.
    • Use the keyboard shortcut: T then R.
  3. If you have not yet selected an object: select an object in the 3D view.
  4. The Trimex task panel opens. See Options for more information.
  5. Move the pointer in the 3D view so that the preview matches the desired result. If required use the modifier keys as explained in the Options.
  6. Do one of the following:
    • Pick a point in the 3D view.
    • Enter a Distance or an Angle. The distance is a delta distance. This option does not work if modifier keys are used.
    • Move the pointer over an edge belonging to another object, and click when this edge is highlighted, to trim or extend the selected object using an intersection with the highlighted edge as the new endpoint. When trimming, the projection of the point where the cutting edge is selected onto the object to be trimmed, determines the default result. Note that Draft Snaps can have an undesirable impact here. In some cases it can be useful to turn them off temporarily.

Options

The single character keyboard shortcuts available in the task panel can be changed. See Draft Preferences. The shortcuts mentioned here are the default shortcuts.

  • Hold down Alt to invert the default result of the command.
  • Hold down Shift to restrict the operation to the current segment of a Draft Wire.
  • Press S to switch Draft snapping on or off.

Here is an example to explain the modifier keys. The left edge or the bottom edge of the U-shaped wire was extended. All Draft Snaps were turned off.

  1. The arc was clicked near the bottom left corner of the wire. This is the default result.
  2. Alt was held down while the arc was clicked near the bottom left corner of the wire.
  3. Y was pressed, and while hovering over the left edge Shift was held down and then the arc was clicked. Pressing Y is only required for edges that are more or less parallel to the Y axis.

Extrude

Usage

See also: Draft Snap and Draft Constrain.

  1. It can be helpful to first change the Draft working plane so that it is not coplanar with the face you want to extrude.
  2. Optionally select a single face or an object with a single face.
  3. There are several ways to invoke the command:
    • Press the Draft Trimex button.
    • Select the Modification → Trimex option from the menu.
    • Use the keyboard shortcut: T then R.
  4. If you have not yet selected an object or a face: select an object with a single face in the 3D view.
  5. The Trimex task panel opens. See Options for more information.
  6. To define the extrusion direction and distance do one of the following:
    • Pick a point in the 3D view that does no lie on the same plane as the face.
    • Make sure the pointer is on the correct side of the face in the 3D view and enter a Distance.

Options

The modifier key mentioned here can be changed. See Draft Preferences.

  • Hold Shift to extrude in a direction that is not parallel to the normal of the face.

Scripting

See also: Autogenerated API documentation and FreeCAD Scripting Basics.

There is no Python method to trim objects. To extrude objects use the extrude method of the Draft module.

extrusion = extrude(obj, vector, solid=False)
  • obj is the object to be extruded.
  • vector is the extrusion direction and distance.
  • If solid is True a solid is created instead of a shell.
  • extrusion is returned with the created object.

Example:

import FreeCAD as App
import Draft

doc = App.newDocument()

rectangle = Draft.make_rectangle(1500, 500)
doc.recompute()

vector = App.Vector(0, 0, 300)
solid = Draft.extrude(rectangle, vector, solid=True)
doc.recompute()