X-Git-Url: http://git.salome-platform.org/gitweb/?p=modules%2Fsmesh.git;a=blobdiff_plain;f=doc%2Fsalome%2Fgui%2FSMESH%2Finput%2Fselection_filter_library.doc;h=c73c1e42e67995a5f856fe3d7b6aa508de2b1e28;hp=a0e85ab81bbf06265b9cac5991ed7976836421ed;hb=8301b1e71a0a9833c5bcf7951b426949f647ae9f;hpb=bbca2cb797c37bb7695d3f35490bcd328fbddd4e diff --git a/doc/salome/gui/SMESH/input/selection_filter_library.doc b/doc/salome/gui/SMESH/input/selection_filter_library.doc index a0e85ab81..c73c1e42e 100644 --- a/doc/salome/gui/SMESH/input/selection_filter_library.doc +++ b/doc/salome/gui/SMESH/input/selection_filter_library.doc @@ -2,9 +2,11 @@ \page selection_filter_library_page Selection filter library -\n Selection filter library is a powerful tool enabling to create -filters to be used on meshes. You can access to it from the Main Menu -via Tools / Selection filter library. +\n Selection filter library allows creating and storing in files +filters that can be later loaded and used for operations on meshes. You can +access to it from the Main Menu via Tools / Selection filter library. +It is also possible to save any filter by invoking the filter library +from \a Filter dialog launched from any mesh operation. \image html selectionfilterlibrary.png @@ -16,38 +18,39 @@ the current study. You can \b Add or \b Delete filters. \n In Filter name box you can specify the name for your filter. By default it is prefixed with the corresponding entity type. -When we use filters during a group creation or another operation (by -clicking Set Filters button in the corresponding dialog), the -menu for setting filters looks a bit differently (see the image below). - \anchor filtering_elements -Each filter can be applicable to \b Nodes, \b Edges, \b Faces or \b -Volumes. You can combine many criteria in one filter, but they all -must be of the same Entity type. -\n The \b Add button creates a new criterion at the end of the list of +When we use filters during group creation or another operation (by +clicking Set Filter button in the corresponding dialog), the +dialog for setting filters looks as shown below. + +\image html a-filteronfaces.png + +The \b Add button creates a new criterion at the end of the list of criteria. The \b Insert button creates a new criterion before the selected criterion. The \b Remove button deletes the selected -criterion. The \b Clear button deletes all criteria. +criterion. The \b Clear button deletes all criteria.\n +If there is a choice of Entity type in the dialog, only +criteria of currently selected type are used to create or change a +filter, and criteria of hidden types (if were specified) are ignored. \n Each Entity type has its specific list of criteria, however all -filters have common syntax. For each criterion you should specify the -Threshold Value and whether we search for the elements that should be -\b More, \b Less or \b Equal to this \b Value. You can also reverse the -sense of a criterion using \b Unary operator Not and you should -specify logical relations between criteria using \b Binary operators -Or and And. -\n Some criteria should have the additional parameter of \b Tolerance. -
-Switching on Insert filter in viewer checkbox limits +filters have common syntax. The Threshold Value should be specified +for most criteria. For numerical criteria it is necessary to indicate if +the found elements should be \b More, \b Less or \b Equal to this +\b Value. You can also reverse the sense of a criterion using \b Unary +operator \a Not and you should specify logical relations between +criteria using \b Binary operators \a Or and \a And. +\n Some criteria have the additional parameter of \b Tolerance.
+Switching on Insert filter in viewer check-box limits selection of elements in the Viewer to the current filter.
In the \b Source field you choose if the filter will be applied to the whole \b Mesh, the Initial Selection or the Current -Group. If \b Mesh is chosen, the elements satisfying the filter +Dialog. If \b Mesh is chosen, the elements satisfying the filter will be selected in the 3D Viewer. If Initial Selection is chosen, the filter will be applied to the selected elements and the elements rejected by the filter will be deselected. If Current -Group is chosen, the filter will be applied to the list of +Dialog is chosen, the filter will be applied to the list of elements in the current dialog and the elements rejected by the filter will be removed from the list.
@@ -60,15 +63,12 @@ in the Library. is no selected mesh in the Object Browser and the filter can not be created. You have to select the mesh and the button will be enabled. -\image html a-filteronfaces.png - Some criteria are applicable to all Entity types: -Some criteria are applicable to all Entity types, except for -Nodes +Some criteria are applicable to all Entity types of dimension +more than zero, i.e. to \b Edges, \b Faces and \b Volumes: @@ -132,7 +138,7 @@ See also \ref tui_double_nodes_control "Double Nodes quality control". The following criteria allow selecting mesh Edges: