Merge pull request #507 from ExtendRealityLtd/feat/more-features

Feat/more features

Editor/Data/Attribute/MinMaxRangeAttributeDrawer.cs

@@ -29,6 +29,10 @@ public override void OnGUI(Rect position, SerializedProperty property, GUIConten
                     {
                         Undo.RecordObject(property.serializedObject.targetObject, property.displayName);
                         property.SetValue(new FloatRange(output));
+                        if (property.isInstantiatedPrefab)
+                        {
+                            PrefabUtility.RecordPrefabInstancePropertyModifications(property.serializedObject.targetObject);
+                        }
                     }
 
                     foundGeneric = true;

Runtime/Action/Action.cs

@@ -8,6 +8,7 @@
     using System.Collections.Generic;
     using UnityEngine;
     using UnityEngine.Events;
+    using Zinnia.Data.Attribute;
     using Zinnia.Data.Type;
 
     /// <summary>
@@ -65,7 +66,11 @@ protected set
         /// </summary>
         public abstract void EmitActivationState();
         /// <summary>
-        /// Makes the action receive its own default value.
+        /// Makes the action receive its own initial value to reset it back to when it was first created.
+        /// </summary>
+        public abstract void ReceiveInitialValue();
+        /// <summary>
+        /// Makes the action receive its own default value to set it back to inactive.
         /// </summary>
         public abstract void ReceiveDefaultValue();
 
@@ -88,7 +93,13 @@ protected virtual bool CanEmit()
     public abstract class Action<TSelf, TValue, TEvent> : Action where TSelf : Action<TSelf, TValue, TEvent> where TEvent : UnityEvent<TValue>, new()
     {
         /// <summary>
-        /// The initial value of the action.
+        /// The initial value upon creation of the component.
+        /// </summary>
+        [Serialized]
+        [field: DocumentedByXml, Restricted(RestrictedAttribute.Restrictions.ReadOnlyAtRunTime)]
+        public TValue InitialValue { get; protected set; }
+        /// <summary>
+        /// The value that is considered the inactive value.
         /// </summary>
         [Serialized]
         [field: DocumentedByXml]
@@ -180,6 +191,13 @@ public override void EmitActivationState()
             }
         }
 
+        /// <inheritdoc />
+        [RequiresBehaviourState]
+        public override void ReceiveInitialValue()
+        {
+            Receive(InitialValue);
+        }
+
         /// <inheritdoc />
         [RequiresBehaviourState]
         public override void ReceiveDefaultValue()
@@ -213,6 +231,14 @@ protected virtual void OnEnable()
             SubscribeToSources();
         }
 
+        protected virtual void Start()
+        {
+            if (!IsValueEqual(InitialValue))
+            {
+                ProcessValue(InitialValue);
+            }
+        }
+
         protected virtual void OnDisable()
         {
             ProcessValue(DefaultValue);

Runtime/Action/BooleanAction.cs

@@ -12,8 +12,6 @@ public class BooleanAction : Action<BooleanAction, bool, BooleanAction.UnityEven
         /// Defines the event with the <see cref="bool"/> state.
         /// </summary>
         [Serializable]
-        public class UnityEvent : UnityEvent<bool>
-        {
-        }
+        public class UnityEvent : UnityEvent<bool> { }
     }
 }

Runtime/Action/FloatAction.cs

@@ -16,9 +16,7 @@ public class FloatAction : Action<FloatAction, float, FloatAction.UnityEvent>
         /// Defines the event with the <see cref="float"/> state.
         /// </summary>
         [Serializable]
-        public class UnityEvent : UnityEvent<float>
-        {
-        }
+        public class UnityEvent : UnityEvent<float> { }
 
         /// <summary>
         /// The tolerance of equality between two <see cref="float"/> values.

Runtime/Action/SurfaceChangeAction.cs

@@ -29,7 +29,34 @@ public class SurfaceChangeAction : BooleanAction
         protected SurfaceData previousData;
 
         /// <summary>
-        /// Digests <see cref="SurfaceData"/> and compares the current surface to the previous surface to determine if a change has occured.
+        /// Sets the <see cref="CheckAxis"/> x value.
+        /// </summary>
+        /// <param name="value">The value to set to.</param>
+        public virtual void SetCheckAxisX(bool value)
+        {
+            CheckAxis = new Vector3State(value, CheckAxis.yState, CheckAxis.zState);
+        }
+
+        /// <summary>
+        /// Sets the <see cref="CheckAxis"/> y value.
+        /// </summary>
+        /// <param name="value">The value to set to.</param>
+        public virtual void SetCheckAxisY(bool value)
+        {
+            CheckAxis = new Vector3State(CheckAxis.xState, value, CheckAxis.zState);
+        }
+
+        /// <summary>
+        /// Sets the <see cref="CheckAxis"/> z value.
+        /// </summary>
+        /// <param name="value">The value to set to.</param>
+        public virtual void SetCheckAxisZ(bool value)
+        {
+            CheckAxis = new Vector3State(CheckAxis.xState, CheckAxis.yState, value);
+        }
+
+        /// <summary>
+        /// Digests <see cref="SurfaceData"/> and compares the current surface to the previous surface to determine if a change has occurred.
         /// </summary>
         /// <param name="surfaceData">The <see cref="SurfaceData"/> to check on.</param>
         [RequiresBehaviourState]

Runtime/Action/Vector2Action.cs

@@ -17,9 +17,7 @@ public class Vector2Action : Action<Vector2Action, Vector2, Vector2Action.UnityE
         /// Defines the event with the <see cref="Vector2"/> state.
         /// </summary>
         [Serializable]
-        public class UnityEvent : UnityEvent<Vector2>
-        {
-        }
+        public class UnityEvent : UnityEvent<Vector2> { }
 
         /// <summary>
         /// The tolerance of equality between two <see cref="Vector2"/> values.

Runtime/Action/Vector3Action.cs

@@ -17,9 +17,7 @@ public class Vector3Action : Action<Vector3Action, Vector3, Vector3Action.UnityE
         /// Defines the event with the <see cref="Vector3"/> state.
         /// </summary>
         [Serializable]
-        public class UnityEvent : UnityEvent<Vector3>
-        {
-        }
+        public class UnityEvent : UnityEvent<Vector3> { }
 
         /// <summary>
         /// The tolerance of equality between two <see cref="Vector3"/> values.

Runtime/Association/Collection/GameObjectsAssociationObservableList.cs

@@ -14,8 +14,6 @@ public class GameObjectsAssociationObservableList : DefaultObservableList<GameOb
         /// Defines the event with the <see cref="GameObjectsAssociation"/>.
         /// </summary>
         [Serializable]
-        public class UnityEvent : UnityEvent<GameObjectsAssociation>
-        {
-        }
+        public class UnityEvent : UnityEvent<GameObjectsAssociation> { }
     }
 }

Runtime/Cast/ParabolicLineCast.cs

@@ -53,6 +53,24 @@ public class ParabolicLineCast : PointsCast
         /// </summary>
         protected readonly List<Vector3> curvePoints = new List<Vector3>();
 
+        /// <summary>
+        /// Sets the <see cref="MaximumLength"/> x value.
+        /// </summary>
+        /// <param name="value">The value to set to.</param>
+        public virtual void SetMaximumLengthX(float value)
+        {
+            MaximumLength = new Vector2(value, MaximumLength.y);
+        }
+
+        /// <summary>
+        /// Sets the <see cref="MaximumLength"/> y value.
+        /// </summary>
+        /// <param name="value">The value to set to.</param>
+        public virtual void SetMaximumLengthY(float value)
+        {
+            MaximumLength = new Vector2(MaximumLength.x, value);
+        }
+
         protected override void OnEnable()
         {
             base.OnEnable();

Runtime/Cast/PointsCast.cs

@@ -40,7 +40,7 @@ public class EventData
             public bool IsValid { get; set; }
 
             /// <summary>
-            /// The points along the the most recent cast.
+            /// The points along the most recent cast.
             /// </summary>
             public HeapAllocationFreeReadOnlyList<Vector3> Points { get; set; }
 
@@ -108,12 +108,12 @@ public class UnityEvent : UnityEvent<EventData> { }
         /// </summary>
         public bool IsTargetHitValid { get; protected set; }
         /// <summary>
-        /// The points along the the most recent cast.
+        /// The points along the most recent cast.
         /// </summary>
         public HeapAllocationFreeReadOnlyList<Vector3> Points => points;
 
         /// <summary>
-        /// The points along the the most recent cast.
+        /// The points along the most recent cast.
         /// </summary>
         protected readonly List<Vector3> points = new List<Vector3>();
         /// <summary>

Runtime/Data/Attribute/UnityFlagsAttribute.cs

@@ -5,7 +5,5 @@
     /// <summary>
     /// Defines the <c>[UnityFlags]</c> attribute.
     /// </summary>
-    public class UnityFlagsAttribute : PropertyAttribute
-    {
-    }
+    public class UnityFlagsAttribute : PropertyAttribute { }
 }

Runtime/Data/Collection/Counter/GameObjectObservableCounter.cs

@@ -14,8 +14,6 @@ public class GameObjectObservableCounter : ObservableCounter<GameObject, GameObj
         /// Defines the event with the <see cref="GameObject"/>.
         /// </summary>
         [Serializable]
-        public class UnityEvent : UnityEvent<GameObject>
-        {
-        }
+        public class UnityEvent : UnityEvent<GameObject> { }
     }
 }

Runtime/Data/Collection/GameObjectRelations.cs

@@ -17,9 +17,7 @@ public class GameObjectRelations : MonoBehaviour
         /// Defines the event for the output <see cref="GameObject"/>.
         /// </summary>
         [Serializable]
-        public class GameObjectUnityEvent : UnityEvent<GameObject>
-        {
-        }
+        public class GameObjectUnityEvent : UnityEvent<GameObject> { }
 
         /// <summary>
         /// The collection of relations.

Runtime/Data/Collection/List/BehaviourObservableList.cs

@@ -14,8 +14,6 @@ public class BehaviourObservableList : DefaultObservableList<Behaviour, Behaviou
         /// Defines the event with the <see cref="Behaviour"/>.
         /// </summary>
         [Serializable]
-        public class UnityEvent : UnityEvent<Behaviour>
-        {
-        }
+        public class UnityEvent : UnityEvent<Behaviour> { }
     }
 }

Runtime/Data/Collection/List/CameraObservableList.cs

@@ -14,8 +14,6 @@ public class CameraObservableList : DefaultObservableList<Camera, CameraObservab
         /// Defines the event with the <see cref="Camera"/>.
         /// </summary>
         [Serializable]
-        public class UnityEvent : UnityEvent<Camera>
-        {
-        }
+        public class UnityEvent : UnityEvent<Camera> { }
     }
 }

Runtime/Data/Collection/List/FloatObservableList.cs

@@ -13,8 +13,6 @@ public class FloatObservableList : DefaultObservableList<float, FloatObservableL
         /// Defines the event with the <see cref="float"/>.
         /// </summary>
         [Serializable]
-        public class UnityEvent : UnityEvent<float>
-        {
-        }
+        public class UnityEvent : UnityEvent<float> { }
     }
 }

Runtime/Data/Collection/List/GameObjectObservableList.cs

@@ -14,8 +14,6 @@ public class GameObjectObservableList : DefaultObservableList<GameObject, GameOb
         /// Defines the event with the <see cref="GameObject"/>.
         /// </summary>
         [Serializable]
-        public class UnityEvent : UnityEvent<GameObject>
-        {
-        }
+        public class UnityEvent : UnityEvent<GameObject> { }
     }
 }

Runtime/Data/Collection/List/GameObjectRelationObservableList.cs

@@ -37,8 +37,6 @@ public class Relation
         /// Defines the event with the <see cref="Relation"/>.
         /// </summary>
         [Serializable]
-        public class UnityEvent : UnityEvent<Relation>
-        {
-        }
+        public class UnityEvent : UnityEvent<Relation> { }
     }
 }

Runtime/Data/Collection/List/SerializableTypeBehaviourObservableList.cs

@@ -25,8 +25,6 @@ public class SerializableTypeBehaviourObservableList : ObservableList<Serializab
         /// Defines the event with the <see cref="SerializableType"/>.
         /// </summary>
         [Serializable]
-        public class UnityEvent : UnityEvent<SerializableType>
-        {
-        }
+        public class UnityEvent : UnityEvent<SerializableType> { }
     }
 }

Runtime/Data/Collection/List/SerializableTypeComponentObservableList.cs

@@ -25,8 +25,6 @@ public class SerializableTypeComponentObservableList : ObservableList<Serializab
         /// Defines the event with the <see cref="SerializableType"/>.
         /// </summary>
         [Serializable]
-        public class UnityEvent : UnityEvent<SerializableType>
-        {
-        }
+        public class UnityEvent : UnityEvent<SerializableType> { }
     }
 }

Runtime/Data/Collection/List/StringObservableList.cs

@@ -13,8 +13,6 @@ public class StringObservableList : DefaultObservableList<string, StringObservab
         /// Defines the event with the <see cref="string"/>.
         /// </summary>
         [Serializable]
-        public class UnityEvent : UnityEvent<string>
-        {
-        }
+        public class UnityEvent : UnityEvent<string> { }
     }
 }

Runtime/Data/Collection/List/UnityObjectObservableList.cs

@@ -14,8 +14,6 @@ public class UnityObjectObservableList : DefaultObservableList<Object, UnityObje
         /// Defines the event with the <see cref="Object"/>.
         /// </summary>
         [Serializable]
-        public class UnityEvent : UnityEvent<Object>
-        {
-        }
+        public class UnityEvent : UnityEvent<Object> { }
     }
 }

Runtime/Data/Collection/List/Vector2ObservableList.cs

@@ -14,8 +14,6 @@ public class Vector2ObservableList : DefaultObservableList<Vector2, Vector2Obser
         /// Defines the event with the <see cref="Vector2"/>.
         /// </summary>
         [Serializable]
-        public class UnityEvent : UnityEvent<Vector2>
-        {
-        }
+        public class UnityEvent : UnityEvent<Vector2> { }
     }
 }

Runtime/Data/Collection/List/Vector3ObservableList.cs

@@ -14,8 +14,6 @@ public class Vector3ObservableList : DefaultObservableList<Vector3, Vector3Obser
         /// Defines the event with the <see cref="Vector3"/>.
         /// </summary>
         [Serializable]
-        public class UnityEvent : UnityEvent<Vector3>
-        {
-        }
+        public class UnityEvent : UnityEvent<Vector3> { }
     }
 }

Runtime/Data/Collection/Stack/GameObjectObservableStack.cs

@@ -19,9 +19,7 @@ public class GameObjectElementEvents : ObservableStackElementEvents<GameObject,
             /// Defines the event with the <see cref="GameObject"/>.
             /// </summary>
             [Serializable]
-            public class UnityEvent : UnityEvent<GameObject>
-            {
-            }
+            public class UnityEvent : UnityEvent<GameObject> { }
         }
     }
 }

Runtime/Data/Operation/Cache/FloatCache.cs

@@ -13,9 +13,7 @@ public class FloatCache : ValueCache<float, FloatCache.UnityEvent>
         /// Defines the event with the specified <see cref="float"/>.
         /// </summary>
         [Serializable]
-        public class UnityEvent : UnityEvent<float>
-        {
-        }
+        public class UnityEvent : UnityEvent<float> { }
 
         /// <summary>
         /// The tolerance to consider the current value and the cached value equal.

Runtime/Data/Operation/Cache/GameObjectCache.cs

@@ -11,8 +11,6 @@ public class GameObjectCache : ValueCache<GameObject, GameObjectCache.UnityEvent
         /// Defines the event with the specified <see cref="GameObject"/>.
         /// </summary>
         [Serializable]
-        public class UnityEvent : UnityEvent<GameObject>
-        {
-        }
+        public class UnityEvent : UnityEvent<GameObject> { }
     }
 }