# ExclusionRectangle Objects<no value>
{{% tagged "internal" %}}

// CALLOUT HERE

This object is not available when the Scenery Editor is in [World Hub Mode](../../the-scenery-editor/#worldhub).

{{% /tagged %}}

An **ExclusionRectangle** object is an object element used to define a rectangular area which has the sole purpose of *excluding* things from being rendered in a scene.

{{< callout context="caution" title="IMPORTANT!" icon="outline/alert-triangle" >}}

This object will <strong>not</strong> exclude anything from the current package being edited. It is <strong>only</strong> valid for removing things from a previously loaded package, and is dependent on the package load order. So, packages loaded after the package with the exclusion rectangle will be rendered as normal, and packages loaded before the package with the exclusion rectangle will have elements excluded.

{{< /callout >}}

{{< callout context="note" title="NOTE" icon="outline/bulb" >}}

Exclusion rectangles will only apply to SimObjects placed via the Scenery Editor. They will not apply to BGL traffic or SimObjects spawned using SimConnect.

{{< /callout >}}

When you select this object type the [Objects](../../menus/the-view-menu/#objects) window will not show any different object elements as currently there is only one type of exclusion rectangle and what it does is defined through its [Properties](../../using-the-scenery-editor/#properties):

{{< image-center
    src="images/2_DevMode/scenery_editor/Objects/exclude_rect/excluderect_obj_1_list.png"
    alt="The ExclusionRectangle Object In The Objects Window" >}}

When you select an exclusion rectangle object and click {{< button "Add" />}}, the rectangle will be added to the scene and you can edit its size (length / width) through the Properties window or using the [Gizmo](../../menus/the-view-menu/#gizmo) in its center. The gizmo can also be used to change the scale of the rectangle on either or both axis. You'll notice that there are various points shown on the rectangle area in the world. Each of these points can also be clicked on, which will move the gizmo to that point and enable you to edit the following properties:

{{< image-center
    src="images/2_DevMode/scenery_editor/Objects/exclude_rect/excluderect_obj_3_handles.png"
    alt="The Different Direct Edit Properties For An Exlcusion Rectangle Object" >}}

Once you are happy with the placement of the exclusion rectangle, you can then go on to edit its **Properties**. Note that if you wish to remove the exclusion rectangle, you can select it and press {{< input "Delete" />}} on the keyboard.

{{< callout context="caution" title="IMPORTANT!" icon="outline/alert-triangle" >}}

To improve the speed at which exclusions are processed by the simulation, Exclude Rectangles <strong>cannot be rotated</strong> and will always be aligned along the lines of latitude and longitude for faster collision testing.

{{< /callout >}}


### Properties

At its most basic the exclusion rectangle object element can be used to exclude *everything* possible, however it can be customised from this window to exclude many different things while leaving others untouched. Initially only **excludeAirports** and **excludeAllObjects** will be visible, with excludeAllObjects being *checked*. To view the other individual include/exclude options you will need *uncheck* the **ExcludeAllObjects** option, which will change the [Properties](../../menus/the-view-menu/#properties) window to look like the following:

{{< image-center
    src="images/2_DevMode/scenery_editor/Objects/exclude_rect/excluderect_obj_2_props.png"
    alt="The Properties Window For An Exlusion Rectangle Object" >}}

-   ##### excludeAirports

    Checking this will exclude [Airport Objects](../airport-objects/) that it has been placed over. This requires that the exclusion rectangle covers the *center* point of the airport, and it will prevent all airport objects from spawning, including towers, runways, aprons, etc... Note that this will not change any ground textures, and so - if the airport being excluded exists in the real world - there may still be airport areas visible in the {{< glossterm >}}tin{{< /glossterm >}}.  

    {{< callout context="caution" title="IMPORTANT!" icon="outline/alert-triangle" >}}

    This option will also delete <strong>all navigation data</strong> such as SIDs, STARs, and any approaches associated with the airport. As such, care should be taken when using the option, as incorrect use may mean that aircraft instrument procedures can no longer be loaded correctly,

    {{< /callout >}}


-   ##### excludeAllObjects

    This option is *checked* by default, and has the same effect as ticking all the individual exclude options listed below. Unchecking this means you can then selectively exclude specific things from the rectangle.


-   ##### excludeBeaconObjects

    Checking this will exclude any beacons from objects within the rectangular area.


-   ##### excludeCarParking

    Checking this will exclude any areas designated as [CarParking Objects](../carparking/) within the rectangular area.


-   ##### excludeDecal

    Checking this will exclude all [Decal Objects](../decal-objects/) placed within the rectangular area.


-   ##### excludeEffectsObjects

    Checking this will exclude any *legacy* visual effects within the rectangular area.


-   ##### excludeLibraryObjects

    Checking this will exclude any [Scenery Objects](../scenery-objects/) within the rectangular area.


-   ##### excludePolygons

    Checking this will exclude any [Polygon Objects](../polygon-objects/) whos **vertex centroid** falls within the exclusion rectangle. This means that the size of the exclusion rectangle is irrelevant - as long as the polygon vertex centroid is within the rectangle bounds, the polygon will be excluded.


-   ##### excludeProjectedMesh

    Checking this will exclude all [ProjectedMesh Objects](../projectedmesh-objects/) within the rectangular area.


-   ##### excludeRectangles

    Checking this will exclude any [Rectangle Objects](../rectangle-objects/) within the rectangular area.


-   ##### excludeSimObjects

    Checking this will exclude any [SimObj Objects](../simobj-objects/) within the rectangular area.


-   ##### excludeSimPropContainer

    Checking this will exclude any [SimPropContainer Objects](../simpropcontainer-objects/) within the rectangular area.


-   ##### excludeTreeObjects

    Checking this will exclude any [Tree Objects](../tree-objects/) within the rectangular area.


-   ##### excludeTriggerObjects

    Checking this will exclude any triggers within the rectangular area.

    {{< callout context="note" title="NOTE" icon="outline/bulb" >}}

    Triggers are deprecated in Microsoft Flight Simulator 2024, so checking/unchecking this option will make no difference to rendering.

    {{< /callout >}}


-   ##### excludeVFX

    Checking this will exclude all [VFX Objects](../vfx-objects/) within the rectangular area.


-   ##### excludeWindsockObjects

    Checking this will exclude any [Windsocks](../windsock-objects/) within the rectangular area.


-   ##### excludeWorldScripts

    Checking this will exclude any [WorldScript Objects](../worldscript-objects/) within the rectangular area.