src/FiltersPlugin/doc/FiltersPlugin.rst

   1 .. |plus.icon|  image:: images/add.png
   2 .. |minus.icon|  image:: images/reverce.png
   3 .. |delete.icon|  image:: images/delete.png
   4
   5
   6 .. _filtersPlugin:
   7
   8 Filters Plugin
   9 ==============
  10
  11 Filters plug-in provides a collection of filters used Filters property panel (for example see :ref:`groupPage` feature).
  12
  13
  14 **Selection filters**
  15
  16 Selection by filters panel looks like following:
  17
  18 .. image:: images/selection_by_filters.png
  19   :align: center
  20
  21 .. centered::
  22   Selection by filters property panel
  23
  24 In this panel:
  25
  26 - **Filters** a panel for added filters.
  27
  28 - **Add new filter** combo box. It contains accessible filters according to the selection mode. When user selects an item from this combo box a filter item appears in **Filters** panel like in the following example:
  29
  30 .. image:: images/selection_by_filters_added.png
  31   :align: center
  32
  33 .. centered::
  34   Filters **Horizontal faces** and **On plane** added to the property panel.
  35
  36 If filter is implemented as "Multiple", several instances of this filter may be added in one selection. Otherwise the added filter is removed from the "Add new filter..." list.
  37
  38 Each filter item can be deleted with help of |delete.icon| button. A filter can be reverced with help of toggle button |plus.icon|/|minus.icon|. Also a filter could have input fields in case
  39 if the filter has arguments.
  40
  41 - **Select** button traverces all objects of a current document and selects entities acceptable by currently defined set of filters. All selected entities will be shown in viewer 3d with
  42   blue semi-transparent color. Any modification in filters clears current selection.
  43
  44 - **Number of selected objects** shows number currently selected entities.
  45
  46 - **Show only** check box hides all non-selected objects.
  47
  48 **Accept** button in the **Selection filters** property panel reopens a property panel where the **selection filters** was called and transfers all selected entities to the corresponded list.
  49
  50
  51 Filters
  52 -------
  53
  54 **Belongs to**
  55
  56 By default, the result of Selection feature all selectable entities from all Shapes registered in the “Results” folder. This filter provides a way to explicit (restrict) the results in which looking for selectable entities.
  57
  58 - **Result type:** Any
  59 - **Argument:** Any result object, multiple OR selection accepted
  60 - **Algorithm:** Returns only shapes that belong to selected results.
  61
  62 **On a plane**
  63
  64 - **Result type:** Vertex, Edge, Face
  65 - **Argument:** Planar face or Construction plane, multiple OR selection accepted
  66 - **Algorithm:** Returns all vertices, edges or planar faces geometrically located on (co-planar) the given plane.
  67
  68 **On a Line**
  69
  70 - **Result type:** Vertex, Edge
  71 - **Argument:** Straight Edge or Construction axis, multiple OR selection accepted
  72 - **Algorithm:** Returns all vertices coincident or all edges collinear to the given line.
  73
  74 **On geometry**
  75
  76 - **Result type:** Any
  77 - **Argument:** Any Shape, multiple OR selection accepted
  78 - **Algorithm:** Returns the shapes which have the similar underlying geometry of the given Shape. Like all faces laying of the same geometrical surface or edges laying on the line.
  79
  80 **On plane side**
  81
  82 - **Result type:** Any
  83 - **Argument:** Planar face or Construction plane
  84 - **Algorithm:** By default, the side is in direction of normal of the given plane. For getting the other side, simply invert the filter by clicking on the Check button.
  85
  86 **Opposite to an edge**
  87
  88 This algorithm is based on the Propagate geompy function. It works on a model partitioned into quadrangular faces blocks for the purpose of hexahedral meshing.
  89
  90 - **Result type:** Edge
  91 - **Argument:** An edge belonging to a quadrangular face
  92 - **Algorithm:** Returns all Edges opposite to the given Edge on all quadrangular faces connected to this Edge. The algorithm is recursive: after an edge is found on one face, it adds edges opposite to this new one.
  93
  94 **On/In/Out a Solid**
  95
  96 This algorithm reproduces the GetShapesOnShape function of geompy.
  97
  98 - **Result type:** Vertex, Edge or Face
  99 - **Arguments:** Solid. Location according to the given Solid, as described below
 100 - **Algorithm:**
 101     - **In:** strictly inside the solid.
 102     - **Not In:** strictly outside the solid.
 103     - **On:** confused with the boundary of the solid
 104     - **Not On:** strictly inside or outside the solid
 105     - **In & On:** i.e. inside or confused with the boundary of the solid
 106     - **Not In & On:** outside or confused with the boundary of the solid.
 107
 108 **External Faces**
 109
 110 This algorithm finds all not-shared faces.
 111
 112 - **Result type:** Face
 113 - **Arguments:** None
 114 - **Algorithm:** Returns all faces which are not shared between higher level shapes of the connected compound of the connected compound of compsolid. For an example, if there is a compsolid of two boxes with one shared face between them, the filter returns all faces except the shared.
 115
 116 **Horizontal Faces**
 117
 118 This algorithm finds all the horizontal faces of the model.
 119
 120 - **Result type:** Face
 121 - **Arguments:** None
 122 - **Algorithm:** Returns only planar faces with normal of the plane perpendicular to OZ.
 123
 124 **Vertical Faces**
 125
 126 This algorithm finds all the vertical faces of the model.
 127
 128 - **Result type:** Face
 129 - **Arguments:** None
 130 - **Algorithm:** Returns only planar faces with normal of the plane parallel to OZ or cylindrical faces with axis parallel to OZ.
 131
 132 **Topologically connected Faces**
 133
 134 This algorithm finds all the faces topologically connected the argument selected by the user.
 135
 136 - **Result type:** Face
 137 - **Arguments:** A point, an edge or a face. A “propagation” flag (check-box).
 138 - **Algorithm:**
 139     - If a point of an edge is selected as an argument, the result is all faces that contain this argument.If a face is selected, the result is all faces that have shared edges or vertices with this selection.
 140     - If “propagation” flag is enabled (it is disabled by default), the algorithm becomes recursive: all connected faces are added to the results. So, for the solid shape there will be all faces except internal-volumes faces, not connected to any external faces.