Using Visualization Filters

A visualization filter is a group of layers you can apply to visualize (or not) only those objects located on the layers in the filter.


Before you begin: Layers and layer filters can only be applied to 3D Shapes and drawing representations. This means that in product edition context:
  • The Layer box displayed in the Graphic Properties toolbar is grayed out.
  • You cannot run Tools > Visualization Filters...
  1. Open a document with geometrical data.

    In this scenario, we use a product with two part bodies containing at least one pad each:

  2. Double-click a representation to switch to a part edition context.

  3. Select Tools > Visualization Filters....



    The default current filter All visible is applied automatically: it lets you see all the contents of the document. This filter cannot be deleted.

  4. In the Visualization Filters dialog box, click New.




    • Criterion: lists the operators you can use: =, !=, >, <, <= and >=; The default operator is "=".
    • the list to the right displays the named layers (you can type any layer number between 0 and 999).
    • And and Or provide you with the corresponding logical functions for combining layers:
      • And lets you add criteria (for instance, Layer>0 & Layer<10 means that objects displayed in layers 1 to 9 will be displayed).
      • Or lets you filter according to at least one of the criteria you define (for instance, Layer=0 + Layer=1 means that objects contained in layer 0, or in layer 1 will be displayed.
    • The Filter box specifies the final filter syntax.
    Tip: When pointing to a filter name, a tooltip indicates where the filter definition location is stored. The storage location cannot be modified and is set as explained below:
    • For parts, it is stored in the representation. If no definition is stored in the representation, the part objects use the definition stored in the CATSettings directory. The visualization filters cannot be administered because it is not relevant for the administrator (who would only be able to lock the instance of the currently edited representation).
    • For drawings, it is stored in the representation. The visualization filters cannot be administered (same explanation as above).

  5. In the Visualization Filter Editor dialog box, click in the Criterion box (where you see 0), delete 0 then type 1 so that the filter syntax now looks like this:

    Layer = 1

  6. Click OK.

    This creates a new filter Filter001 (with the default filter syntax) in the Visualization Filters dialog box.

  7. Select PadandCylinder in the tree, then select View > Toolbars > GraphicProperties.

  8. In the Graphic Properties toolbar, click the Layer list, then type 0.

    PadandCylinder is now assigned to the layer number 0.

  9. Select Pad.2 in the tree, click the arrow on the Layer list and check that the Layer list looks like this:



  10. Select Sketch.2 in the tree, click inside the Layer list, then type 1.

    Sketch.2 is assigned to Layer 1. The Layer list now looks like this:

  11. Select Filter001 in the Visualization Filters dialog box and click Apply.

    The objects under PadandCylinder are no longer displayed, and the filter remains active:

    Why are these objects no longer displayed?

    All the features below the root object in the tree are considered to be on layer 0 if applying the visualization filter makes the objects invisible. This remains the case even if you assign the objects to layers other than layer 0.

  12. This time, select the root object PadandCylinder in the tree, click the Layer list, then type 1 to assign it to layer 1.

    The filter is still active, but this time the object Sketch.2 becomes visible:

    Why is only the Sketch object displayed?

    This time applying the visualization filter has the effect of making objects visible, so the Sketch object becomes visible.

  13. To see all objects again, select the All visible filter then click Apply.

    Important: V4 objects have their own way of managing visualization filters (through a specific menu named Layer Filter) and the behavior depends on the visualization mode:
    • In Design mode, the .cgr format of the component is changed into the original editable component document (geometry is available). Therefore, the assembly contains the real V4 data and, as explained above, V4 elements are visualized according to their own filter. This is why some elements might not be filtered as expected.
    • In Visualization mode, documents appear in .cgr format. Only the external appearance of the component is visualized (geometry is not available). As .cgr elements are V5 data, visualization filters can be applied as for any other element and the result will be as expected.

    Regarding dittos, see About Layers and Layer Filters.