Add a system for setting up "real" camera framing to work between devices (#26)

- In-level authoring utility to designate level bounds
- Camera Adapter component to be placed on a level's camera to perform the adjustments
- EdgeAnchor tool, which allows anchoring of game objects to the screen bounds

Co-authored-by: Michal Pikulski <michal@foolhardyhorizons.com>
Reviewed-on: #26

Assets/Scripts/Minigames/DivingForPictures/Player/PlayerController.cs

@@ -1,6 +1,7 @@
 using UnityEngine;
 using AppleHills.Core.Settings;
 using Input;
+using AppleHillsCamera;
 
 namespace Minigames.DivingForPictures 
 {
@@ -10,6 +11,10 @@ namespace Minigames.DivingForPictures
     /// </summary>
     public class PlayerController : MonoBehaviour, ITouchInputConsumer
     {
+        
+        [Tooltip("Reference to the edge anchor that this player should follow for Y position")]
+        [SerializeField] private EdgeAnchor edgeAnchor;
+        
         // Settings reference
         private IDivingMinigameSettings _settings;
         
@@ -42,6 +47,38 @@ namespace Minigames.DivingForPictures
             _targetFingerX = transform.position.x;
             _isTouchActive = false;
             
+            // Try to find edge anchor if not assigned
+            if (edgeAnchor == null)
+            {
+                // First try to find edge anchor on the same object or parent
+                edgeAnchor = GetComponentInParent<EdgeAnchor>();
+                
+                // If not found, find any edge anchor in the scene
+                if (edgeAnchor == null)
+                {
+                    edgeAnchor = FindObjectOfType<EdgeAnchor>();
+                    if (edgeAnchor == null)
+                    {
+                        Debug.LogWarning("[PlayerController] No EdgeAnchor found in scene. Origin Y position won't update with camera changes.");
+                    }
+                    else
+                    {
+                        Debug.Log($"[PlayerController] Auto-connected to EdgeAnchor on {edgeAnchor.gameObject.name}");
+                    }
+                }
+            }
+            
+            // Subscribe to edge anchor events if it exists
+            if (edgeAnchor != null)
+            {
+                // Unsubscribe first to prevent duplicate subscriptions
+                edgeAnchor.OnPositionUpdated -= UpdateOriginYFromAnchor;
+                edgeAnchor.OnPositionUpdated += UpdateOriginYFromAnchor;
+                
+                // Update origin Y based on current anchor position
+                UpdateOriginYFromAnchor();
+            }
+            
             DivingGameManager.Instance.OnGameInitialized += Initialize;
             
             // If game is already initialized, initialize immediately
@@ -70,6 +107,12 @@ namespace Minigames.DivingForPictures
         private void OnDestroy()
         {
             DivingGameManager.Instance.OnGameInitialized -= Initialize;
+            
+            // Unsubscribe from edge anchor events
+            if (edgeAnchor != null)
+            {
+                edgeAnchor.OnPositionUpdated -= UpdateOriginYFromAnchor;
+            }
         }
 
         /// <summary>
@@ -185,5 +228,31 @@ namespace Minigames.DivingForPictures
             }
             transform.position = new Vector3(newX, newY, transform.position.z);
         }
+
+        /// <summary>
+        /// Updates the origin Y position based on camera adjustments
+        /// </summary>
+        public void UpdateOriginY(float newOriginY)
+        {
+            _originY = newOriginY;
+        }
+        
+        /// <summary>
+        /// Updates the origin Y position based on the current position of the player
+        /// This method is intended to be called by the camera adapter when the camera is adjusted.
+        /// </summary>
+        private void UpdateOriginYFromCurrentPosition()
+        {
+            _originY = transform.position.y;
+        }
+
+        /// <summary>
+        /// Updates the origin Y position based on the current position of the edge anchor
+        /// This method is intended to be called by the edge anchor when its position is updated.
+        /// </summary>
+        private void UpdateOriginYFromAnchor()
+        {
+            _originY = edgeAnchor.transform.position.y;
+        }
     }
 }