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=145c48fecf18bd77e9910cb71d727cf311efee7c;hp=94ba013197c717ae8cb22bdf43164282b3b730ae;hb=54644afede59730525ebb89f87d5e09b620e329c;hpb=d64c9cac70573c5789a61c314f5ac5ffc3428f4a diff --git a/doc/salome/gui/SMESH/input/selection_filter_library.doc b/doc/salome/gui/SMESH/input/selection_filter_library.doc index 94ba01319..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,24 +19,30 @@ 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 +When we use filters during group creation or another operation (by clicking Set Filter button in the corresponding dialog), the -menu for setting filters looks as shown below. +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 for numerical criteria whether we search -for the elements that should be \b More, \b Less or \b Equal to this +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 checkbox limits +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 @@ -56,23 +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 of dimension +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: