Spatial filtering enables you to remove areas of 3D object scene layers and building scene layers in your ArcGIS Map based on the polygon areas you specify. There are two different modes for removing areas of the scene layer: removing content inside of the specified polygon (referred to as disjoint
) or keeping the content inside of the specified polygons (referred to as contains
). For one spatial filter, you can specify multiple polygons by adding them to an ArcGISPolygon
.
The ArcGISSpatial
identifies 3D objects inside or outside of the provided polygons to remove them from the ArcGIS Map. Any 3D objects that are on the polygon geometry outlines will be removed in both filter types.
Once the 3D objects are removed by the spatial filter, data associated with the removed 3D objects are not accessible from Unreal Engine.
Illustration | Modification | Description |
---|---|---|
disjoint - removes selected area | Remove portions of the scene layer. Use a polygon and don't draw the parts inside that polygon. For example, to add another layer that shows a new development for that part of the city. | |
contains - displays only selected area | Define an area of interest. Use a polygon and draw only parts of the scene layer inside that polygon. For example, to show only a portion of a scene layer within the boundaries of a city. |
Polygons used to specify the area for spatial filtering; must have a spatial reference that matches the spatial reference of the layer. See When you need to know about spatial references topics to find the spatial reference of your layers.
Apply spatial filter to layers
You can set one spatial filter type per 3D object scene layer or building scene layer from the Layers content.
Apply spatial filter to a layer
- Click the Layers tab.
- Click the triangle icon on the left to expand the 3D object scene layer or the building scene layer registry and see the layer properties.
- On the Spatial Feature Filter raw, click the gear icon to display the tool overlay in the Viewport.
- In the tool overlay, click the icon.
- Click in the Viewport to draw a polygon.
- Click the icon.
- Select the polygon by clicking the polygon lines or anywhere inside the polygon. (The line color will change to blue.)
- Click the button Disjoint or Contains to select the filter you want to apply.
Edit a spatial filter
To edit a spatial filter, open the tool overlay for the layer that has the filter.
- Display polygons for the elevation surface or an integrated mesh scene layer by opening the tool overlay.
- Select a polygon by clicking the polygon lines or inside of the polygon while the icon is selected in the tool. (The line color will change to blue.)
- Deselect a polygon by clicking outside of the polygon in the Viewport.
- Use the gizmo to move a polygon while the polygon is selected.
- Click a point and drag to move the point position of the polygon.
- Add points to a polygon by clicking the middle point of a line.
- Copy a polygon by clicking the icon while it is selected.
- Paste a polygon by clicking the icon after opening the tool overlay for the elevation surface or an integrated mesh scene layer.
- Delete a polygon by clicking the icon while it is selected.
- Change the filter type by clicking another button while the polygon is selected.
- Uncheck the Spatial Feature Filter checkbox to disable the filter for the layer.
- To create a polygon, use Create ArcGIS Polygon Builder from Spatial Reference node and set the spatial reference with Create ArcGIS Spatial Reference according to your ArcGIS Map's spatial reference. Create a geometry with the To Geometry function of the ArcGIS Geometry Builder.
- Register all polygons to the ArcGIS Polygon Collection for the type of the filter you want to apply to layers with the Add node.
- To configure a filter, use the Create ArcGIS Spatial Feature Filter node, provide an ArcGIS Polygon Collection, and set the Spatial Relationship filter type,
Disjoint
orContains
. - To apply spatial filter, use the Set Feature Filter node for ArcGIS 3D Object Scene Layer or ArcGIS Building Scene Layer accordingly and provide the ArcGIS Spatial Feature Filter that you want to apply.
Example:
Create polygons with ArcGISPolygon
with a specific spatial reference for your ArcGIS Map and add them to ArcGISPolygon
. To prepare the polygons for the spatial filter, create geometry with the T
method.
Spatial filter requires polygons and the filter type to be specified. Define your spatial filter with ArcGISSpatial
and provide polygon geometries and the type, Disjoint
or Contains
from ArcGISSpatial
.
Once you have the filter defined, apply the filter to 3D object scene layers and/or Building scene layers.