SceneView: create SceneViewProxy (#246)

* create initial SceneViewProxy class

* add disposal logic to proxy class

* add sceneViewProxy to SceneView

* add copyright

Author: hud10837

toolkit/geo-compose/src/main/java/com/arcgismaps/toolkit/geocompose/SceneView.kt

@@ -48,6 +48,7 @@ import kotlinx.coroutines.launch
  *
  * @param modifier Modifier to be applied to the composable SceneView
  * @param arcGISScene the [ArcGISScene] to be rendered by this composable SceneView
+ * @param sceneViewProxy the [SceneViewProxy] to associate with the composable SceneView
  * @param onInteractingChanged lambda invoked when the user starts and ends interacting with the composable SceneView
  * @param onRotate lambda invoked when a user performs a rotation gesture on the composable SceneView
  * @param onScale lambda invoked when a user performs a pinch gesture on the composable SceneView
@@ -64,6 +65,7 @@ import kotlinx.coroutines.launch
 public fun SceneView(
     modifier: Modifier = Modifier,
     arcGISScene: ArcGISScene? = null,
+    sceneViewProxy: SceneViewProxy? = null,
     onInteractingChanged: ((isInteracting: Boolean) -> Unit)? = null,
     onRotate: ((RotationChangeEvent) -> Unit)? = null,
     onScale: ((ScaleChangeEvent) -> Unit)? = null,
@@ -94,6 +96,13 @@ public fun SceneView(
         }
     }
 
+    DisposableEffect(sceneViewProxy) {
+        sceneViewProxy?.setSceneView(sceneView)
+        onDispose {
+            sceneViewProxy?.setSceneView(null)
+        }
+    }
+
     SceneViewEventHandler(
         sceneView,
         onInteractingChanged,

toolkit/geo-compose/src/main/java/com/arcgismaps/toolkit/geocompose/SceneViewProxy.kt

@@ -0,0 +1,53 @@
+/*
+ *  Copyright 2023 Esri
+ *
+ *  Licensed under the Apache License, Version 2.0 (the "License");
+ *  you may not use this file except in compliance with the License.
+ *  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ *
+ */
+
+package com.arcgismaps.toolkit.geocompose
+
+/**
+ * Used to perform operations on a composable [SceneView].
+ *
+ * There should be a one-to-one relationship between a SceneViewProxy and a composable [SceneView]. This
+ * relationship is established by passing an instance of SceneViewProxy to the composable [SceneView] function.
+ * Operations can only be performed once the associated composable SceneView has entered the composition.
+ * Operations performed when the associated composable SceneView is not in the composition will fail gracefully,
+ * i.e. won't throw exceptions but won't return a successful result.
+ *
+ * @since 200.4.0
+ */
+public class SceneViewProxy : GeoViewProxy("SceneView") {
+    /**
+     * The view-based [com.arcgismaps.mapping.view.SceneView] that this SceneViewProxy will operate on. This should
+     * be initialized by the composable [SceneView] when it enters the composition and set to null when
+     * it is disposed by calling [setSceneView].
+     *
+     * @since 200.4.0
+     */
+    private var sceneView: com.arcgismaps.mapping.view.SceneView? = null
+        set(value) {
+            setGeoView(value)
+        }
+
+    /**
+     * Sets the [sceneView] parameter on this operator. This should be called by the composable [SceneView]
+     * when it enters the composition and set to null when it is disposed.
+     *
+     * @since 200.4.0
+     */
+    internal fun setSceneView(sceneView: com.arcgismaps.mapping.view.SceneView?) {
+        this.sceneView = sceneView
+    }
+}