Update filter building scene layer README

src/MAUI/Maui.Samples/Samples/Layers/FilterBuildingSceneLayer/readme.md

@@ -10,17 +10,28 @@ Buildings and their component parts (in this example, structural, electrical, or
 
 ## How to use the sample
 
-In the filter controls, select floor and category options to filter what parts of the Building Scene Layer are displayed in the scene. Tap on any of the building features to identify them.
+Once the scene is loaded, tap the "Building Filter Settings" button to view the filtering options.
+
+* Select a floor from the "Floor" menu to view the internal details of each floor or "All" to view the entire model. Selecting a floor applies a filter that hides all floors above the selected floor and gives the floors below a transparent, X-ray renderer.
+* Expand the categories under the top-level disciplines to show or hide individual categories in the building model. The entire discipline may be shown or hidden as well.
+* Tap on any features in the building to view the attributes of the feature.
 
 ## How it works
 
 1. Create a `Scene` with the URL to a Building Scene Layer service.
 2. Create a `LocalSceneView` and add the scene.
 3. Retrieve the `BuildingSceneLayer` from the scene's operational layers.
-4. The Scene Settings panel displays filtering options.
-5. Select a floor from the "Floor" dropdown to view the internal details of each floor or "All" to view the entire model.
-6. Expand the categories to show or hide individual items in the building model. The entire category may be shown or hidden as well.
-7. Tap on any of the building features to view the attributes of the feature.
+4. When a floor is selected:
+    1. A new `BuildingFilter` is created with two `BuildingFilterBlock` items.
+    2. One block defines the solid renderer for features on the selected floor.
+    3. The second block defines the X-ray filter for features on the floors below the selected floor.
+    4. Features that exist on floors above the selected floor are not rendered.
+    5. If "All" is selected, the `ActiveFilter` property on the building scene layer is set to `null` so all features are rendered according to their default settings.
+5. Architectural disciplines and categories are represented by `BuildingGroupSublayer` and `BuildingSublayer` objects containing features within a building scene layer. When checked or unchecked, the visibility of the group or sublayer is set to true (visible) or false (hidden).
+6. When a building feature is tapped on:
+    1. A call to `IdentifyLayerAsync` on the `LocalSceneView` is initiated based on the screen offset of the click.
+    2. The `SublayerResults` property of the returned `IdentifyLayerResult` will contain the identified features. Note that the building scene layer features are NOT returned in the `GeoElements` property of the results.
+    3. The details of the first identified feature are shown in a popup.
 
 ## Relevant API
 

src/WPF/WPF.Viewer/Samples/Layers/FilterBuildingSceneLayer/readme.md

@@ -10,17 +10,28 @@ Buildings and their component parts (in this example, structural, electrical, or
 
 ## How to use the sample
 
-In the filter controls, select floor and category options to filter what parts of the Building Scene Layer are displayed in the scene. Click on any of the building features to identify them.
+Once the scene is loaded, click the "Building Filter Settings" button to view the filtering options.
+
+* Select a floor from the "Floor" menu to view the internal details of each floor or "All" to view the entire model. Selecting a floor applies a filter that hides all floors above the selected floor and gives the floors below a transparent, X-ray renderer.
+* Expand the categories under the top-level disciplines to show or hide individual categories in the building model. The entire discipline may be shown or hidden as well.
+* Click on any features in the building to view the attributes of the feature.
 
 ## How it works
 
 1. Create a `Scene` with the URL to a Building Scene Layer service.
 2. Create a `LocalSceneView` and add the scene.
 3. Retrieve the `BuildingSceneLayer` from the scene's operational layers.
-4. The Scene Settings panel displays filtering options.
-5. Select a floor from the "Floor" dropdown to view the internal details of each floor or "All" to view the entire model.
-6. Expand the categories to show or hide individual items in the building model. The entire category may be shown or hidden as well.
-7. Click on any of the building features to view the attributes of the feature.
+4. When a floor is selected:
+    1. A new `BuildingFilter` is created with two `BuildingFilterBlock` items.
+    2. One block defines the solid renderer for features on the selected floor.
+    3. The second block defines the X-ray filter for features on the floors below the selected floor.
+    4. Features that exist on floors above the selected floor are not rendered.
+    5. If "All" is selected, the `ActiveFilter` property on the building scene layer is set to `null` so all features are rendered according to their default settings.
+5. Architectural disciplines and categories are represented by `BuildingGroupSublayer` and `BuildingSublayer` objects containing features within a building scene layer. When checked or unchecked, the visibility of the group or sublayer is set to true (visible) or false (hidden).
+6. When a building feature is clicked on:
+    1. A call to `IdentifyLayerAsync` on the `LocalSceneView` is initiated based on the screen offset of the click.
+    2. The `SublayerResults` property of the returned `IdentifyLayerResult` will contain the identified features. Note that the building scene layer features are NOT returned in the `GeoElements` property of the results.
+    3. The details of the first identified feature are shown in a popup.
 
 ## Relevant API
 

src/WinUI/ArcGIS.WinUI.Viewer/Samples/Layers/FilterBuildingSceneLayer/readme.md

@@ -10,17 +10,28 @@ Buildings and their component parts (in this example, structural, electrical, or
 
 ## How to use the sample
 
-In the filter controls, select floor and category options to filter what parts of the Building Scene Layer are displayed in the scene. Click on any of the building features to identify them.
+Once the scene is loaded, click the "Building Filter Settings" button to view the filtering options.
+
+* Select a floor from the "Floor" menu to view the internal details of each floor or "All" to view the entire model. Selecting a floor applies a filter that hides all floors above the selected floor and gives the floors below a transparent, X-ray renderer.
+* Expand the categories under the top-level disciplines to show or hide individual categories in the building model. The entire discipline may be shown or hidden as well.
+* Click on any features in the building to view the attributes of the feature.
 
 ## How it works
 
 1. Create a `Scene` with the URL to a Building Scene Layer service.
 2. Create a `LocalSceneView` and add the scene.
 3. Retrieve the `BuildingSceneLayer` from the scene's operational layers.
-4. The Scene Settings panel displays filtering options.
-5. Select a floor from the "Floor" dropdown to view the internal details of each floor or "All" to view the entire model.
-6. Expand the categories to show or hide individual items in the building model. The entire category may be shown or hidden as well.
-7. Click on any of the building features to view the attributes of the feature.
+4. When a floor is selected:
+    1. A new `BuildingFilter` is created with two `BuildingFilterBlock` items.
+    2. One block defines the solid renderer for features on the selected floor.
+    3. The second block defines the X-ray filter for features on the floors below the selected floor.
+    4. Features that exist on floors above the selected floor are not rendered.
+    5. If "All" is selected, the `ActiveFilter` property on the building scene layer is set to `null` so all features are rendered according to their default settings.
+5. Architectural disciplines and categories are represented by `BuildingGroupSublayer` and `BuildingSublayer` objects containing features within a building scene layer. When checked or unchecked, the visibility of the group or sublayer is set to true (visible) or false (hidden).
+6. When a building feature is clicked on:
+    1. A call to `IdentifyLayerAsync` on the `LocalSceneView` is initiated based on the screen offset of the click.
+    2. The `SublayerResults` property of the returned `IdentifyLayerResult` will contain the identified features. Note that the building scene layer features are NOT returned in the `GeoElements` property of the results.
+    3. The details of the first identified feature are shown in a popup.
 
 ## Relevant API