Part CompoundFilter

From FreeCAD Documentation


Part Compound‏‎Filter

Menu location
Part → Compound Filter
Workbenches
Part
Default shortcut
None
Introduced in version
-
See also
None

Description

The CompoundFilter can be used to extract the individual pieces of the result of e.g. a Part Slice operation, with which you have split an object.

It can extract children by their indexes, test children for collisions with stencil shape, and filter children based on their properties, such as length, area, volume.

If there is only one child in the result, the output is the child. If there is more than one child to output, the output is a new compound.

How to use

  1. Select the sliced object
  2. Apply Menu → Part → Compound → CompoundFilter
  3. Select the CompoundFilterObject in the tree
  4. In the properties tab set "Filter Type" to "specific items"
  5. Set items to the elements you want to extract
    1. For a single piece this is a number starting with 0, i.e. if you want to extract the first element enter 0 in this field, 1 for the next element ...
    2. If you want to extract more than one piece at a time separate the numbers with ";", e.g. a value of "0;2" will extract the first and the third element
    3. If you want to extract a range enter the number of the first element followed by ":" and the number of elements in the range. If you want to extract the third element (with the number 2) the fourth, fifth and sixth you enter "2:4".
  6. If you want to extract another piece select the sliced object again. It is now placed under the CompoundFilter in the tree
  7. Repeat the selection procedure from above. The slice and its subelements will be displayed under both CompoundFilters; they are, of course not repeated in the model. A very fast way to extract another piece is to copy the CompoundFilter. But watch out: You are asked if you want to copy the elements under the CompoundFilter too, which you must answer with no, you dont want to copy them, you only reference them.

Properties

  • DataBase: Object to be filtered.
  • DataFilter Type selectable options:
    • bypass
    • specific items; extract the items listed in the "items" property
    • collision-pass
    • window-volume; extract all pieces which have a volume between "Window From" and "Window To" where 100% is the biggest piece - and not the unsliced object
    • window-area; the same as window-volume where the sliced area determines the selection instead of the volume
    • window-length; the same as window-volume where the length of the pieces determines the selection instead of the volume
    • window-
  • DataInvert: If set to true the list as described above is excluded instead of included.
  • DataMax Val: The threshold for the window-properties if it is not 100%.
  • DataStencil:
  • DataWindow From: Upper threshold percentage for selecting pieces, 100% is relative to the biggest piece.
  • DataWindow To: Lower threshold percentage for selecting pieces, 100% is relative to the biggest piece.
  • Dataitems: List or range of elements to be selected if Filter Type is "specific items".

Usage

Notes