X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;f=doc%2Fsalome%2Fgui%2FSMESH%2Finput%2Fselection_filter_library.doc;h=145c48fecf18bd77e9910cb71d727cf311efee7c;hb=a1a6d5ddc111fa237d1164fda37ff823a3fac764;hp=583d7e773faec0316ce135defa4bd7dc56fad507;hpb=22353257e1ba059feb8872697f43e508c86a8415;p=modules%2Fsmesh.git diff --git a/doc/salome/gui/SMESH/input/selection_filter_library.doc b/doc/salome/gui/SMESH/input/selection_filter_library.doc index 583d7e773..145c48fec 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 +the filters that can be later reused for operations on meshes. You can +access it from the Main Menu via Tools / Selection filter library. +It is also possible to save/load a filter by invoking the filter library +from \ref filtering_elements "Filter dialog" launched from any mesh operation. \image html selectionfilterlibrary.png @@ -17,37 +19,39 @@ the current study. You can \b Add or \b Delete filters. filter. By default it is prefixed with the corresponding entity type. \anchor filtering_elements +

Filter Dialog

-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). +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. -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 +\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,21 +64,32 @@ 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 entities of dimension +more than zero, i.e. to \b Edges, \b Faces and \b Volumes: -The following criteria are applicable to all Entity types -except for Volumes: +The following criteria are applicable to Entities of \b all types +except for \a Volumes: