Draft SubelementHighlight: Difference between revisions

From FreeCAD Documentation
m (Added template)
(Button text.)
 
(38 intermediate revisions by 6 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{UnfinishedDocu}}
<translate>
<translate>


<!--T:1-->
<!--T:1-->
{{Docnav
{{Docnav
|[[Draft Edit|Edit]]
|[[Draft_Edit|Edit]]
|[[Draft_Join|Join]]
|[[Draft_WireToBSpline|Wire to BSpline]]
|[[Draft_Module|Draft]]
|[[Draft_Workbench|Draft]]
|IconL=Draft Edit.svg
|IconL=Draft_Edit.svg
|IconR=Draft_Join.svg
|IconC=Workbench_Draft.svg
|IconC=Workbench_Draft.svg
|IconR=Draft_WireToBSpline.svg
}}
}}


Line 16: Line 15:
{{GuiCommand
{{GuiCommand
|Name=Draft SubelementHighlight
|Name=Draft SubelementHighlight
|MenuLocation=Draft → Subelement highlight
|MenuLocation=Modification → Subelement highlight
|Workbenches=[[Draft_Workbench|Draft]], [[Arch_Workbench|Arch]]
|Shortcut=D E
|Shortcut={{KEY|H}} {{KEY|S}}
|Workbenches=[[Draft Module|Draft]], [[Arch Module|Arch]]
|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 {{Button|[[Image:Draft SubelementHighlight.svg|24px]] [[Draft SubelementHighlight|Draft SubelementHighlight]]}} tool allows you to edit graphically certain properties of the selected object, such as the vertices of a [[Draft Wire|Draft Wire]], the length and width of a [[Draft Rectangle|Draft Rectangle]], or the radius of a [[Draft Circle|Draft Circle]].
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]].

<!--T:5-->
Unlike the standard [[Draft Edit|Draft Edit]], it allows you to edit multiple multiple nodes of multiple objects at the same time.


</translate>
</translate>
[[Image:Draft_Edit_Improved_Example.png|400px]]
[[Image:Draft_SubelementHighlight_example.png]]
<translate>
<translate>

<!--T:6-->
<!--T:6-->
{{Caption|Editing a wire}}
{{Caption|An Arch Wall whose base, a Draft Wire, has been highlighted}}


==How to use== <!--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:
# Press the {{Button|[[Image:Draft_SubelementHighlight.svg|24px]] [[Draft SubelementHighlight|SubelementHighlight]]}} button.
#* Press the {{Button|[[Image:Draft_SubelementHighlight.svg|16px]] [[Draft_SubelementHighlight|Subelement highlight]]}} button.
# Click on all the points that you wish to move.
#* Select the {{MenuCommand|Modification → [[Image:Draft_SubelementHighlight.svg|16px]] Subelement highlight}} option from the menu.
# 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.
#* Use the keyboard shortcut: {{KEY|H}} then {{KEY|S}}.
# Press {{KEY|Esc}} or the {{Button|Close}} button to complete the current command.
# If you have not yet selected an object: select an object in the [[3D_view|3D view]].
# 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}}.
# It is advisable to now deselect the existing selection, for example by clicking a random point in the [[3D_view|3D view]].
# 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]].
# Toggle subelement mode in the task panel of that command by checking the {{MenuCommand|Modify subelements}} checkbox.
# Modify the selected sublements and complete the Draft modify command.
# Press {{KEY|Esc}} to revert the temporary visual changes of the objects.


<!--T:9-->
==Notes== <!--T:17-->
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.


==Options== <!--T:10-->
<!--T:18-->
* 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.



==Scripting== <!--T:11-->
{{Emphasis|See also:}} [[Draft API|Draft API]] and [[FreeCAD Scripting Basics|FreeCAD Scripting Basics]].

<!--T:12-->
There is no programming interface available for the Edit tool. Each object is modified by changing its attributes directly.


<!--T:13-->
<!--T:13-->
{{Docnav
{{Docnav
|[[Draft Edit|Edit]]
|[[Draft_Edit|Edit]]
|[[Draft_Join|Join]]
|[[Draft_WireToBSpline|Wire to BSpline]]
|[[Draft_Module|Draft]]
|[[Draft_Workbench|Draft]]
|IconL=Draft Edit.svg
|IconL=Draft_Edit.svg
|IconR=Draft_Join.svg
|IconC=Workbench_Draft.svg
|IconC=Workbench_Draft.svg
|IconR=Draft_WireToBSpline.svg
}}
}}


<!--T:14-->
{{Draft Tools navi}}

<!--T:15-->
{{Userdocnavi}}
</translate>
</translate>
{{Draft Tools navi{{#translation:}}}}
{{clear}}
{{Userdocnavi{{#translation:}}}}

Latest revision as of 17:10, 3 December 2023

Draft SubelementHighlight

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

  1. Optionally select one or more Draft Lines or Draft Wires, or objects whose DataBase objects are Draft Lines or Draft Wires.
  2. 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.
  3. If you have not yet selected an object: select an object in the 3D view.
  4. 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.
  5. It is advisable to now deselect the existing selection, for example by clicking a random point in the 3D view.
  6. Select one or more subelements, edges or points, of the objects that have been marked in red.
  7. Invoke Draft Move, Draft Rotate or Draft Scale.
  8. Toggle subelement mode in the task panel of that command by checking the Modify subelements checkbox.
  9. Modify the selected sublements and complete the Draft modify command.
  10. 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.