Mesh RemoveComponents: Difference between revisions

From FreeCAD Documentation
(Removed faulty PNG images.)
(Revising. Added 'in progress' for now.)
Line 1: Line 1:
<languages/>
<languages/>

{{Page in progress}}

<translate>
<translate>


<!--T:8-->
{{Docnav
{{Docnav
|[[Mesh AddTriangle|Add triangle]]
|[[Mesh_AddFacet|Mesh AddFacet]]
|[[Mesh RemoveCompByHand|Remove components by hand...]]
|[[Mesh_RemoveCompByHand|Mesh RemoveCompByHand]]
|[[Mesh_Workbench|Mesh]]
|[[Mesh_Workbench|Mesh]]
|IconL=
|IconL=
Line 12: Line 14:
}}
}}


<!--T:1-->
{{GuiCommand
{{GuiCommand
|Name=Mesh_RemoveComponents
|Name=Mesh RemoveComponents‏‎
|MenuLocation=Meshes → Remove components
|MenuLocation=Meshes → Remove components...
|Workbenches=[[Mesh Workbench|Mesh]]
|Workbenches=[[Mesh_Workbench|Mesh]]
|SeeAlso=[[Mesh_RemoveCompByHand|Mesh RemoveCompByHand]]
|Shortcut=
|SeeAlso=
}}
}}


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

The '''Mesh RemoveComponents''' command removes faces from mesh objects.

</translate>
[[Image:Meshes_RemoveComponents.jpg]]
<translate>
{{Caption|The Remove components task panel}}

==Usage==

# The command will consider all visible mesh objects. Especially if you plan to use the {{Button|Invert}} button it can be advisable to change the {{PropertyView|Visibility}} property to {{FALSE}} for mesh objects that should not be modified.
# The command uses the color red to mark selected faces. To see this properly:
#* The {{PropertyView|Display Mode}} of the mesh objects should show faces. If necessary use the [[Std_DrawStyle|Std DrawStyle]] command to override this property.
#* The {{PropertyView|Shape Color}} of the mesh objects should not be red.
#* No mesh object should not be selected (and therefore highlighted).
# Select the {{MenuCommand|Meshes → Remove components...}} option from the menu.
# The {{MenuCommand|Remove components}} task panel opens.
# Use one or more of the {{MenuCommand|Select}} options to select faces:
#* Press the {{Button|Region}} button and while holding down the left mouse button draw a region, a closed spline, in the [[3D_view|3D view]]. All faces that match the {{MenuCommand|Region options}} and completely fall inside the region will be selected.
#* Press the {{Button|All}} button to select all faces.
#* Press the {{Button|Components}} button to select all components with fewer than the specified number of faces. Here a component refers to a group of faces that are connected. Usually a mesh object will contain a single component. But, for example after using the [[Mesh_Merge|Mesh Merge]] command, a mesh object can contain multiple components.
#* Press the {{Button|Pick triangle}} button to select a single face. If the {{MenuCommand|Select whole component}} option is checked, seelcting a face will result in selecting the entire component the face belongs to.


==Options==

* Press {{KEY|Esc}} or the {{Button|Cancel}} button to abort the command.

==Notes==


* Todo.
<!--T:2-->
Remove components of meshes.


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


* Todo.
<!--T:3-->
[[Image: Meshes_RemoveComponents.jpg]]


==Properties==
<!--T:4-->
Select/Deselect:
*Region: click left mouse button, keep pressed an move mouse to draw a spline defining a selection region.
*All: will select/deselect all components in the active document
*Components: will select all components with less than the entered number of faces
*Pick Triangle: lets you select a single triangle face
If "Select whole component" is marked, using any of the four selection choices will select the whole component.


* Todo.
<!--T:5-->
Region options
*Respect only visible triangles
*Respect only triangles with normals facing the screen


==Scripting==
==Limitations== <!--T:6-->
<br />


* Todo.
==Notes== <!--T:7-->
<br />


<!--T:9-->
{{Docnav
{{Docnav
|[[Mesh AddTriangle|Add triangle]]
|[[Mesh_AddFacet|Mesh AddFacet]]
|[[Mesh RemoveCompByHand|Remove components by hand...]]
|[[Mesh_RemoveCompByHand|Mesh RemoveCompByHand]]
|[[Mesh_Workbench|Mesh]]
|[[Mesh_Workbench|Mesh]]
|IconL=
|IconL=
Line 63: Line 78:
{{Mesh Tools navi{{#translation:}}}}
{{Mesh Tools navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{clear}}

Revision as of 15:58, 19 July 2020

This documentation is a work in progress. Please don't mark it as translatable since it will change in the next hours and days.


Mesh_RemoveComponents

Menu location
Meshes → Remove components...
Workbenches
Mesh
Default shortcut
None
Introduced in version
-
See also
Mesh RemoveCompByHand

Description

The Mesh RemoveComponents command removes faces from mesh objects.

The Remove components task panel

Usage

  1. The command will consider all visible mesh objects. Especially if you plan to use the Invert button it can be advisable to change the ViewVisibility property to false for mesh objects that should not be modified.
  2. The command uses the color red to mark selected faces. To see this properly:
    • The ViewDisplay Mode of the mesh objects should show faces. If necessary use the Std DrawStyle command to override this property.
    • The ViewShape Color of the mesh objects should not be red.
    • No mesh object should not be selected (and therefore highlighted).
  3. Select the Meshes → Remove components... option from the menu.
  4. The Remove components task panel opens.
  5. Use one or more of the Select options to select faces:
    • Press the Region button and while holding down the left mouse button draw a region, a closed spline, in the 3D view. All faces that match the Region options and completely fall inside the region will be selected.
    • Press the All button to select all faces.
    • Press the Components button to select all components with fewer than the specified number of faces. Here a component refers to a group of faces that are connected. Usually a mesh object will contain a single component. But, for example after using the Mesh Merge command, a mesh object can contain multiple components.
    • Press the Pick triangle button to select a single face. If the Select whole component option is checked, seelcting a face will result in selecting the entire component the face belongs to.


Options

  • Press Esc or the Cancel button to abort the command.

Notes

  • Todo.

Preferences

  • Todo.

Properties

  • Todo.

Scripting

  • Todo.