feat: Add boundary class for camera

Author: jcs090218

Assets/JCSUnity/Scripts/Actions/JCS_Boundary.cs

@@ -0,0 +1,49 @@
+/**
+ * $File: JCS_Boundary.cs $
+ * $Date: $
+ * $Revision: $
+ * $Creator: Jen-Chieh Shen $
+ * $Notice: See LICENSE.txt for modification and distribution information
+ *                   Copyright (c) 2025 by Shen, Jen-Chieh $
+ */
+using UnityEngine;
+using MyBox;
+
+namespace JCSUnity
+{
+    /// <summary>
+    /// Boundary definition.
+    /// </summary>
+    public class JCS_Boundary : MonoBehaviour
+    {
+        /* Variables */
+
+#if UNITY_EDITOR
+        [Separator("Helper Variables (JCS_Boundary)")]
+
+        [Tooltip("The wire color for gizmos draw.")]
+        [SerializeField]
+        private Color mWireColor = new Color(0.8f, 0.3f, 0.3f, 0.8f);
+#endif
+
+        /* Setter & Getter */
+
+        /* Functions */
+
+#if UNITY_EDITOR
+        private void OnDrawGizmosSelected()
+        {
+            Gizmos.color = mWireColor;
+            Gizmos.DrawWireCube(transform.position, transform.localScale);
+        }
+#endif
+
+        /// <summary>
+        /// Bounds of this spawner; now is only a cube space.
+        /// </summary>
+        public Bounds GetBounds()
+        {
+            return new Bounds(transform.position, transform.localScale);
+        }
+    }
+}

Assets/JCSUnity/Scripts/Actions/JCS_Boundary.cs.meta

@@ -99,21 +99,6 @@ public class JCS_2DCamera : JCS_Camera
 
         private float mWheelDegree = 0;
 
-        [Header("- Scene")]
-
-        [Tooltip("Maxinum this camera can go in x-axis.")]
-        [SerializeField]
-        private float mMax_X_PositionInScene = float.PositiveInfinity;
-        [Tooltip("Mininum this camera can go in x-axis.")]
-        [SerializeField]
-        private float mMin_X_PositionInScene = float.NegativeInfinity;
-        [Tooltip("Maxinum this camera can go in y-axis.")]
-        [SerializeField]
-        private float mMax_Y_PositionInScene = float.PositiveInfinity;
-        [Tooltip("Mininum this camera can go in y-axis.")]
-        [SerializeField]
-        private float mMin_Y_PositionInScene = float.NegativeInfinity;
-
         /* Setter & Getter */
 
         public bool FreezeX { get { return this.mFreezeX; } set { this.mFreezeX = value; } }
@@ -236,9 +221,6 @@ protected virtual void FixedUpdate()
 
             // do freezing the last
             DoFreezing();
-
-            // Do the camera boundaries check!!
-            CameraBoundaries();
         }
 
         /// <summary>
@@ -281,41 +263,6 @@ public void ZoomCamera(float depthDistance)
             this.mTargetPosition.z += cameraDepth;
         }
 
-        /// <summary>
-        /// 4 boundaries (top, bottom, right, left) that camera should not 
-        /// go through.
-        /// 
-        /// check the boundries and do the trick!
-        /// </summary>
-        private void CameraBoundaries()
-        {
-            Vector3 camPos = this.transform.position;
-
-            if (camPos.x > mMax_X_PositionInScene)
-            {
-                camPos.x = mMax_X_PositionInScene;
-                mVelocity.x = 0;
-            }
-            else if (camPos.x < mMin_X_PositionInScene)
-            {
-                camPos.x = mMin_X_PositionInScene;
-                mVelocity.x = 0;
-            }
-
-            if (camPos.y > mMax_Y_PositionInScene)
-            {
-                camPos.y = mMax_Y_PositionInScene;
-                mVelocity.y = 0;
-            }
-            else if (camPos.y < mMin_Y_PositionInScene)
-            {
-                camPos.y = mMin_Y_PositionInScene;
-                mVelocity.y = 0;
-            }
-
-            this.transform.position = camPos;
-        }
-
         /// <summary>
         /// Do freezing.
         /// </summary>

Assets/JCSUnity/Scripts/Interactive/2D/Camera/JCS_2DCamera.cs

@@ -214,7 +214,6 @@ protected override void LateUpdate()
 
             UpDownMovement();
 
-
             this.mRecordPosition = this.transform.position;
 
             {

Assets/JCSUnity/Scripts/Interactive/3D/JCS_3DCamera.cs

@@ -14,7 +14,7 @@
 namespace JCSUnity
 {
     /// <summary>
-    /// Camera class for JCSUnity framework.
+    /// Camera based class.
     /// </summary>
     [RequireComponent(typeof(Camera))]
     public abstract class JCS_Camera : MonoBehaviour
@@ -88,6 +88,12 @@ public abstract class JCS_Camera : MonoBehaviour
         [SerializeField]
         protected bool mSmoothTrack = true;
 
+        [Header("- Boundary")]
+
+        [Tooltip("The movement boundary.")]
+        [SerializeField]
+        protected JCS_Boundary mBoundary = null;
+
         /* Setter & Getter */
 
         public Vector3 PositionOffset { get { return this.mPositionOffset; } set { this.mPositionOffset = value; } }
@@ -106,6 +112,8 @@ public abstract class JCS_Camera : MonoBehaviour
 
         public JCS_TimeType DeltaTimeType { get { return this.mTimeType; } set { this.mTimeType = value; } }
 
+        public JCS_Boundary Boundary { get { return this.mBoundary; } set { this.mBoundary = value; } }
+
         /* Functions */
 
         protected virtual void Awake()
@@ -138,6 +146,9 @@ protected virtual void LateUpdate()
 #if UNITY_EDITOR
             DisplayGameDepthCamera();
 #endif
+
+            // Do the camera boundaries check!!
+            DoBoundaries();
         }
 
         /// <summary>
@@ -667,6 +678,24 @@ protected virtual void OnResizableIdle()
             }
         }
 
+        /// <summary>
+        /// 4 boundaries (top, bottom, right, left) that camera should not 
+        /// go through.
+        /// 
+        /// check the boundries and do the trick!
+        /// </summary>
+        private void DoBoundaries()
+        {
+            if (mBoundary == null)
+                return;
+
+            Bounds bounds = mBoundary.GetBounds();
+
+            Vector3 camPos = this.transform.position;
+
+            this.transform.position = bounds.ClosestPoint(camPos);
+        }
+
         /// <summary>
         /// Resize the game if screen size changes.
         /// </summary>