Creating Custom Quad Filters

The Quad cursor filter allows to customize the set of buttons that the Quad displays for a certain type of entity.

Creating custom filters for custom tools

The Quad displays certain buttons depending on the type of entity that is hovered with the mouse cursor.

The condition which specifies whether a certain Quad Button will appear in the quad is specified for each Quad Button individually in the Entity Filter property.

To access the Entity Filter property, follow the next steps:

  • Open the Customize dialog box, Quad tab.
  • Click the tool node in the left side of the dialog box.
  • In the Quad Button frame, click the Entity Filter label.
  • At the far-right side of the same row, click the button with three dots, marked with (1) in the image below. This will open the Edit Quad Button Filter dialog box. See details below.
Note: It is not possible to modify the Entity Filter of a built-in Quad Button. For built-in buttons the Entity Filter field is disabled.

Adding a new filter for a Quad button

To add a new filter to a Quad button, follow these steps:

  • Open the Customize dialog box, Quad tab.
  • Click the tool node in the left side of the dialog box.
  • Open the Edit Quad Button Filter dialog box.
  • Click Add Entity Type(s) button.
  • Select whether the filter will affect one entity or many entities.
  • Select the entity type or subentity type that will be associated to the filter. You can select multiple items.
  • Click OK.
  • Or click the Add Filter button to enter a custom filter or to select a filter from the available general filters (NO_SELECTION, OBJECT_ANY, OBJECTS_ANY).
    Note: Custom filter allows the user to manually type the DXF name of an entity that they want to be filtered, as well as a subentity specifier (face/edge/vertex). The full filter name consists of a general filter name, either "OBJECT_" or "OBJECTS_", followed by the DXF name (LINE, CIRCLE, etc) of the entity, e.g. OBJECT_CIRCLE, OBJECTS_SURFACE_EDGE.
  • Click OK.

The selected items will appear in the list of the Edit Quad Button Filter dialog box.

Other operations that can be performed here:

  1. To delete an item, click it and press Remove.
  2. To add one or more items, press Add Entity Type(s) and select some more items from the list of entity types.
  3. After the entity list in the Edit Quad Button Filter dialog box is ready, press OK. The filter will appear in the Entity filter field in the Customize dialog box, Quad tab.
  4. To edit the filter, press the button with three dots at the right end of the Entity filter row and repeat the steps described above.