Spatial Filters
You can use the spatial filter options to perform advanced search and selection of objects based upon user defined areas and/or locations. You can select one or many, from the following options. Descriptions of each option are detailed in the table below:
|
Filter |
Condition |
Description |
|---|---|---|
|
Not in the Region |
Used to match objects that are not matching the spatial condition specified. This option effectively adds 'Not' to a filter. |
|
|
Type |
Used to specify the type of spatial query. |
|
|
Selected Objects |
Used to specify objects that can match each by their bounding box, or combine to form a single bounding box. Selecting this option makes available the further filtering options 'Regions' 'Grow Region' and 'Crossing'. |
|
|
Regions |
Specifies the number of regions, and is used to set the way in which the regions are matched. This is used in conjunction with the following conditions: |
|
|
Combined |
Used to test all of the bounding boxes of matched objects by merging them together into the minimum box that totally encloses all the boxes. That merged box is tested against the objects during statement evaluation. |
|
|
Separate |
Used to individually test one or more bounding boxes of matched objects. If any test succeeds, the whole test is positive. |
|
|
Grow Region |
Used to specify a size for a bounding box in the scene. You can select an exact size, or choose to grow the box to a specified size. This is used in conjunction with the following conditions: |
|
|
No |
Uses the box as defined. |
|
|
Scene Units |
Used to grow the box by a specified number of units. |
|
|
Percentage |
Used to grow the box to a specified percentage of the diagonal size. |
|
|
Crossing |
Used to set the match to occur for objects that touch or cross through the specified box, or parts that are wholly contained in the box. The available options are either Yes (check for crossing), or No (ignore crossing). |
|
|
Bounding Box |
Used to specify the x, y, and z, min and max values for a box in the scene, or you can "Get from selected object(s)" if any objects are selected in the scene. You can modify the six values to change the dimensions of the box for your query. Selecting this option also makes available the further filtering options 'Grow Region' and 'Crossing' (described above). |
|
|
Get box from selected objects |
Gets the selected objects if any objects are selected in the scene. The six values are automatically updated for your query. This is used in conjunction with following conditions: |
|
|
X Min Max |
Used to specify the x min and max values for a box in the scene. |
|
|
Y Min Max |
Used to specify the y min and max values for a box in the scene. |
|
|
Z Min Max |
Used to specify the z min and max values for a box in the scene. |
|
|
Contour |
Used to match the triangles of selected objects against other objects in the scene, effectively asking whether two objects touch. A tolerance can be added to specify that two objects must be within a specified number of scene units of one another. Selecting this option also makes the further filtering option 'Grow Region' (described above) available. |