Draft SubelementHighlight: Difference between revisions
(Updated Autogenerated API link) |
(Button text.) |
||
(16 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
{{Page_in_progress}} |
|||
<languages/> |
<languages/> |
||
<translate> |
<translate> |
||
Line 7: | Line 6: | ||
|[[Draft_Edit|Edit]] |
|[[Draft_Edit|Edit]] |
||
|[[Draft_Join|Join]] |
|[[Draft_Join|Join]] |
||
|[[ |
|[[Draft_Workbench|Draft]] |
||
|IconL= |
|IconL=Draft_Edit.svg |
||
|IconR=Draft_Join.svg |
|IconR=Draft_Join.svg |
||
|IconC=Workbench_Draft.svg |
|IconC=Workbench_Draft.svg |
||
Line 17: | Line 16: | ||
|Name=Draft SubelementHighlight |
|Name=Draft SubelementHighlight |
||
|MenuLocation=Modification → Subelement highlight |
|MenuLocation=Modification → Subelement highlight |
||
|Workbenches=[[ |
|Workbenches=[[Draft_Workbench|Draft]], [[Arch_Workbench|Arch]] |
||
|Shortcut={{KEY| |
|Shortcut={{KEY|H}} {{KEY|S}} |
||
|Version=0.19 |
|||
|SeeAlso=[[Draft_Edit|Draft Edit]] |
|||
|SeeAlso=[[Draft_Move|Draft Move]], [[Draft_Rotate|Draft Rotate]], [[Draft_Scale|Draft Scale]] |
|||
}} |
}} |
||
Line 25: | Line 25: | ||
<!--T:4--> |
<!--T:4--> |
||
The [[Image:Draft_SubelementHighlight.svg|24px]] '''Draft SubelementHighlight''' command temporarily highlights selected objects, or the base objects of selected objects. It is intended to be used in conjunction with the subelement mode of the [[Draft_Move|Draft Move]] command, the [[Draft_Rotate|Draft Rotate]] command or the [[Draft_Scale|Draft Scale]] command. Currently subelement mode only works properly for [[Draft_Line|Draft Lines]] and [[Draft_Wire|Draft Wires]]. |
|||
The {{Button|[[Image:Draft SubelementHighlight.svg|16px]] [[Draft_SubelementHighlight|SubelementHighlight]]}} tool allows you to graphically edit certain properties of the selected object such as: |
|||
* the vertices of a {{Button|[[Image:Draft_Wire.svg|16px]] [[Draft Wire|Draft Wire]]}} |
|||
* the length and width of a {{Button|[[Image:Draft_Rectangle.svg|16px]] [[Draft_Rectangle|Draft Rectangle]]}} |
|||
* the radius of a {{Button|[[Image:Draft_Circle.svg|16px]] [[Draft_Circle|Draft Circle]]}} |
|||
<!--T:5--> |
|||
Unlike the standard [[Draft_Edit|Draft Edit]], it allows you to edit multiple nodes of multiple objects at the same time. |
|||
</translate> |
</translate> |
||
[[Image: |
[[Image:Draft_SubelementHighlight_example.png]] |
||
<translate> |
<translate> |
||
<!--T:6--> |
<!--T:6--> |
||
{{Caption| |
{{Caption|An Arch Wall whose base, a Draft Wire, has been highlighted}} |
||
==Usage== <!--T:7--> |
==Usage== <!--T:7--> |
||
<!--T:8--> |
<!--T:8--> |
||
# Optionally select one or more [[Draft_Line|Draft Lines]] or [[Draft_Wire|Draft Wires]], or objects whose {{PropertyData|Base}} objects are [[Draft_Line|Draft Lines]] or [[Draft_Wire|Draft Wires]]. |
|||
# Select an object. |
|||
# There are several ways to invoke the command: |
# There are several ways to invoke the command: |
||
#* Press the {{Button|[[Image:Draft_SubelementHighlight.svg|16px]] [[Draft_SubelementHighlight| |
#* Press the {{Button|[[Image:Draft_SubelementHighlight.svg|16px]] [[Draft_SubelementHighlight|Subelement highlight]]}} button. |
||
⚫ | |||
#* Use the {{KEY| |
#* Use the keyboard shortcut: {{KEY|H}} then {{KEY|S}}. |
||
⚫ | |||
# If you have not yet selected an object: select an object in the [[3D_view|3D view]]. |
|||
# Click on all the points that you wish to move. |
|||
# The selected objects are made visible (if required), their {{PropertyView|Line Color}} and {{PropertyView|Point Color}} are changed to red, and their {{PropertyView|Point Size}} is changed to {{Value|10}}. |
|||
# Click another point on the 3D view, or type a [[Draft_Coordinates|coordinate]] and press the {{Button|[[Image:Draft_AddPoint.svg|24px]] [[Draft_AddPoint|add point]]}} button. |
|||
# It is advisable to now deselect the existing selection, for example by clicking a random point in the [[3D_view|3D view]]. |
|||
# Press {{KEY|Esc}} or the {{Button|Close}} button to complete the current command. |
|||
# Select one or more subelements, edges or points, of the objects that have been marked in red. |
|||
# Invoke [[Draft_Move|Draft Move]], [[Draft_Rotate|Draft Rotate]] or [[Draft_Scale|Draft Scale]]. |
|||
<!--T:9--> |
|||
# Toggle subelement mode in the task panel of that command by checking the {{MenuCommand|Modify subelements}} checkbox. |
|||
The tool mostly works on Draft objects: [[Draft_Wire|Draft Wires]], [[Draft_Line|Draft Lines]], [[Draft_Rectangle|Draft Rectangles]], [[Draft_Circle|Draft Circles]], [[Draft Arc|Draft Arcs]], [[Draft_Polygon|Draft Polygons]], and [[Draft_BSpline|Draft BSplines]]. Other object types must first be converted to these objects. |
|||
# Modify the selected sublements and complete the Draft modify command. |
|||
# Press {{KEY|Esc}} to revert the temporary visual changes of the objects. |
|||
==Options== <!--T:10--> |
|||
==Scripting== <!--T:16--> |
|||
<!--T: |
==Notes== <!--T:17--> |
||
See also: [https://freecad.github.io/SourceDoc/ Autogenerated API documentation] and [[FreeCAD Scripting Basics|FreeCAD Scripting Basics]]. |
|||
<!--T: |
<!--T:18--> |
||
* If objects have been highlighted with this command the temporary visual changes should be reverted before saving and reopening the file. |
|||
There is no Python method to Draft Edit objects. To emulate the results of the Draft SubelementHighlight command geometric properties of objects have to be modified. |
|||
* Highlighted objects should not be copied if subelement mode is off. The temporary visual changes cannot be reverted for copies created in this manner. |
|||
Line 70: | Line 61: | ||
|[[Draft_Edit|Edit]] |
|[[Draft_Edit|Edit]] |
||
|[[Draft_Join|Join]] |
|[[Draft_Join|Join]] |
||
|[[ |
|[[Draft_Workbench|Draft]] |
||
|IconL= |
|IconL=Draft_Edit.svg |
||
|IconR=Draft_Join.svg |
|IconR=Draft_Join.svg |
||
|IconC=Workbench_Draft.svg |
|IconC=Workbench_Draft.svg |
Latest revision as of 17:10, 3 December 2023
|
Menu location |
---|
Modification → Subelement highlight |
Workbenches |
Draft, Arch |
Default shortcut |
H S |
Introduced in version |
0.19 |
See also |
Draft Move, Draft Rotate, Draft Scale |
Description
The Draft SubelementHighlight command temporarily highlights selected objects, or the base objects of selected objects. It is intended to be used in conjunction with the subelement mode of the Draft Move command, the Draft Rotate command or the Draft Scale command. Currently subelement mode only works properly for Draft Lines and Draft Wires.
An Arch Wall whose base, a Draft Wire, has been highlighted
Usage
- Optionally select one or more Draft Lines or Draft Wires, or objects whose DataBase objects are Draft Lines or Draft Wires.
- There are several ways to invoke the command:
- Press the
Subelement highlight button.
- Select the Modification →
Subelement highlight option from the menu.
- Use the keyboard shortcut: H then S.
- Press the
- If you have not yet selected an object: select an object in the 3D view.
- The selected objects are made visible (if required), their ViewLine Color and ViewPoint Color are changed to red, and their ViewPoint Size is changed to
10
. - It is advisable to now deselect the existing selection, for example by clicking a random point in the 3D view.
- Select one or more subelements, edges or points, of the objects that have been marked in red.
- Invoke Draft Move, Draft Rotate or Draft Scale.
- Toggle subelement mode in the task panel of that command by checking the Modify subelements checkbox.
- Modify the selected sublements and complete the Draft modify command.
- Press Esc to revert the temporary visual changes of the objects.
Notes
- If objects have been highlighted with this command the temporary visual changes should be reverted before saving and reopening the file.
- Highlighted objects should not be copied if subelement mode is off. The temporary visual changes cannot be reverted for copies created in this manner.
- Drafting: Line, Polyline, Fillet, Arc, Arc by 3 points, Circle, Ellipse, Rectangle, Polygon, B-spline, Cubic Bézier curve, Bézier curve, Point, Facebinder, ShapeString, Hatch
- Annotation: Text, Dimension, Label, Annotation styles, Annotation scale
- Modification: Move, Rotate, Scale, Mirror, Offset, Trimex, Stretch, Clone, Array, Polar array, Circular array, Path array, Path link array, Point array, Point link array, Edit, Subelement highlight, Join, Split, Upgrade, Downgrade, Wire to B-spline, Draft to sketch, Set slope, Flip dimension, Shape 2D view
- Draft Tray: Select plane, Set style, Toggle construction mode, AutoGroup
- Snapping: Snap lock, Snap endpoint, Snap midpoint, Snap center, Snap angle, Snap intersection, Snap perpendicular, Snap extension, Snap parallel, Snap special, Snap near, Snap ortho, Snap grid, Snap working plane, Snap dimensions, Toggle grid
- Miscellaneous: Apply current style, Layer, Manage layers, Add a new named group, Move to group, Select group, Add to construction group, Toggle normal/wireframe display, Create working plane proxy, Heal, Show snap toolbar
- Additional: Constraining, Pattern, Preferences, Import Export Preferences, DXF/DWG, SVG, OCA, DAT
- Context menu:
- Layer container: Merge layer duplicates, Add new layer
- Layer: Activate this layer, Select layer contents
- Text: Open hyperlinks
- Wire: Flatten
- Working plane proxy: Write camera position, Write objects state
![](/images/thumb/9/94/User_hub.png/24px-User_hub.png)
- Getting started
- Installation: Download, Windows, Linux, Mac, Additional components, Docker, AppImage, Ubuntu Snap
- Basics: About FreeCAD, Interface, Mouse navigation, Selection methods, Object name, Preferences, Workbenches, Document structure, Properties, Help FreeCAD, Donate
- Help: Tutorials, Video tutorials
- Workbenches: Std Base, Assembly, BIM, CAM, Draft, FEM, Inspection, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Surface, TechDraw, Test Framework
- Hubs: User hub, Power users hub, Developer hub