Compare commits
185 Commits
6e5b805803
...
tests
Author | SHA1 | Date | |
---|---|---|---|
22b3a342a8 | |||
d0aee7fe16 | |||
be15cba9e1 | |||
ac0eac3fbb | |||
3c23ac7f1e | |||
57807c2a62 | |||
3452194941 | |||
11612ff0db | |||
63bc94c7a6 | |||
e00319d7ff | |||
11719440dc | |||
f246d68aa7 | |||
6e87c67096 | |||
b8217f2106 | |||
9824980cbf | |||
93a79cd075 | |||
f6e52abcc1 | |||
03232f72e8 | |||
37aca44e45 | |||
9f4d95a57b | |||
65eac57fce | |||
08311acc9a | |||
f8fbae6130 | |||
df06e8d134 | |||
ad365dc722 | |||
200e8ae7da | |||
65cfaf1b4a | |||
83b155fc5e | |||
7db56e7f3e | |||
42064875a0 | |||
41245c0c1c | |||
0e5cc8f898 | |||
c8bb991865 | |||
bc1c76d746 | |||
8f03628bd6 | |||
a1feb0bad3 | |||
978cba96c8 | |||
7212094a3d | |||
14843ddeba | |||
5315db0077 | |||
026f343d43 | |||
da5f31f9d7 | |||
fa1614f238 | |||
0c096d39db | |||
dae6549bad | |||
767fc28488 | |||
c3be8f60b7 | |||
33cb44bf36 | |||
4c1018ddec | |||
cf7061fd58 | |||
e6b7b9953f | |||
4a3775a0de | |||
4d353662a1 | |||
ca0b2de917 | |||
2335c3ec62 | |||
30ccab1b93 | |||
f56d6a7fc8 | |||
29a7f5880f | |||
eee3056614 | |||
152b0e93db | |||
3f914fe46f | |||
62b54ee836 | |||
6a41407005 | |||
adfa6c6ba0 | |||
a53766f472 | |||
40735c713a | |||
2054ae3a35 | |||
9066e11c12 | |||
f16a7e55c9 | |||
e3b32b3c4a | |||
a02584f3b6 | |||
45524e474e | |||
fbdea47dc7 | |||
f5fbd4e5ef | |||
c7f63dc638 | |||
beecefec1c | |||
24d1a1d764 | |||
9edf3b0aa6 | |||
8d49fb467c | |||
2caa042317 | |||
fe8bde855d | |||
ac620264b1 | |||
f31b84f519 | |||
efb7cc7452 | |||
7a3202a053 | |||
86c9ed2ba9 | |||
56321864fb | |||
6adc002f1a | |||
1acc8bdb8f | |||
61e2761580 | |||
996e61d0ad | |||
b1b5af94d3 | |||
b0f8b0dad6 | |||
67d7f401b8 | |||
9bf17cc191 | |||
bf8fbebae3 | |||
1b0f25e854 | |||
61a7f685c1 | |||
feb2a05aa3 | |||
cd30047e4a | |||
a3b03efd47 | |||
4213b3f8b5 | |||
d3fb612904 | |||
8f8558a262 | |||
2df41e1881 | |||
114fa82b9d | |||
bcce427376 | |||
6a750f8ce0 | |||
3e02ee7b6f | |||
6b9020bd24 | |||
832514ba7d | |||
877a004a13 | |||
b1970d93f9 | |||
e7bd924494 | |||
37b87f0f85 | |||
3b6a93d37a | |||
0bf38234c6 | |||
ed6969c16a | |||
b0b421151f | |||
41c5def097 | |||
fbbdfb07fa | |||
bf283d804c | |||
063ea08707 | |||
fd11a94ddf | |||
be2295b92d | |||
a93e55619c | |||
48ae24af47 | |||
1366a417f1 | |||
4bfe98852c | |||
98edbe1af5 | |||
3725a3b0fd | |||
f43ab36742 | |||
c7aafd85bc | |||
5de08b8fe4 | |||
16e4077d40 | |||
fc3c1ed1f9 | |||
b100b5c2fe | |||
5e28ba8814 | |||
4c235e3230 | |||
131203d578 | |||
bd5eb432b7 | |||
d2ca85568f | |||
4c41870732 | |||
f77afa3632 | |||
eb61598489 | |||
efe51b491d | |||
fa3a4d1e0d | |||
6e7a0993f5 | |||
d70bee2c6b | |||
5812f43117 | |||
d102c5471d | |||
fb363970fc | |||
791349686b | |||
3a0942ff46 | |||
b002dd469a | |||
f92f36442c | |||
bb934b59f3 | |||
c704173183 | |||
c3876add1e | |||
35a75d993b | |||
2637f99456 | |||
9581f5aa54 | |||
82cc25a9ef | |||
336e7e16e7 | |||
a3a8fb4e84 | |||
35f6c3850e | |||
f51d5f342e | |||
9c129cefe2 | |||
a254bb721b | |||
5fa7420c04 | |||
5bcc256777 | |||
680d718957 | |||
20bc6a1adb | |||
eb454a471c | |||
c205e710bc | |||
cddb30c631 | |||
29f6c83bf0 | |||
c20f210b29 | |||
1ea1844677 | |||
5b2c13f8bf | |||
c39ee44442 | |||
4623b4861a | |||
0a868b82e5 | |||
d92d16cfad | |||
0184d1758c |
3
.gitmodules
vendored
Normal file
3
.gitmodules
vendored
Normal file
@@ -0,0 +1,3 @@
|
|||||||
|
[submodule "Engine.Serializers/YamlDotNet"]
|
||||||
|
path = Engine.Serializers/YamlDotNet
|
||||||
|
url = git@github.com:Syntriax/YamlDotNet.git
|
2
Engine.Core/.gitignore
vendored
2
Engine.Core/.gitignore
vendored
@@ -482,3 +482,5 @@ $RECYCLE.BIN/
|
|||||||
|
|
||||||
# Vim temporary swap files
|
# Vim temporary swap files
|
||||||
*.swp
|
*.swp
|
||||||
|
|
||||||
|
!Debug
|
||||||
|
@@ -8,7 +8,7 @@ public interface IAssignable
|
|||||||
/// <summary>
|
/// <summary>
|
||||||
/// Event triggered when the <see cref="IAssignable"/>'s fields are unassigned and completely ready to recycle.
|
/// Event triggered when the <see cref="IAssignable"/>'s fields are unassigned and completely ready to recycle.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
event UnassignEventHandler? OnUnassigned;
|
Event<IAssignable>? OnUnassigned { get; }
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Unassign <see cref="IAssignable"/>'s all fields and make it ready to recycle.
|
/// Unassign <see cref="IAssignable"/>'s all fields and make it ready to recycle.
|
||||||
@@ -17,6 +17,4 @@ public interface IAssignable
|
|||||||
/// <see cref="true"/>, if the fields are unsigned successfully, <see cref="false"/> if not.
|
/// <see cref="true"/>, if the fields are unsigned successfully, <see cref="false"/> if not.
|
||||||
/// </returns>
|
/// </returns>
|
||||||
bool Unassign();
|
bool Unassign();
|
||||||
|
|
||||||
delegate void UnassignEventHandler(IAssignable sender);
|
|
||||||
}
|
}
|
||||||
|
@@ -8,7 +8,7 @@ public interface IHasBehaviourController : IAssignable
|
|||||||
/// <summary>
|
/// <summary>
|
||||||
/// Event triggered when the <see cref="IBehaviourController"/> value has has been assigned a new value.
|
/// Event triggered when the <see cref="IBehaviourController"/> value has has been assigned a new value.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
event BehaviourControllerAssignedEventHandler? OnBehaviourControllerAssigned;
|
Event<IHasBehaviourController> OnBehaviourControllerAssigned { get; }
|
||||||
|
|
||||||
/// <inheritdoc cref="IBehaviourController" />
|
/// <inheritdoc cref="IBehaviourController" />
|
||||||
IBehaviourController BehaviourController { get; }
|
IBehaviourController BehaviourController { get; }
|
||||||
@@ -21,6 +21,4 @@ public interface IHasBehaviourController : IAssignable
|
|||||||
/// <see cref="true"/>, if the value given assigned successfully assigned, <see cref="false"/> if not.
|
/// <see cref="true"/>, if the value given assigned successfully assigned, <see cref="false"/> if not.
|
||||||
/// </returns>
|
/// </returns>
|
||||||
bool Assign(IBehaviourController behaviourController);
|
bool Assign(IBehaviourController behaviourController);
|
||||||
|
|
||||||
delegate void BehaviourControllerAssignedEventHandler(IHasBehaviourController sender);
|
|
||||||
}
|
}
|
||||||
|
@@ -8,7 +8,7 @@ public interface IHasEntity : IAssignable
|
|||||||
/// <summary>
|
/// <summary>
|
||||||
/// Event triggered when the <see cref="IEntity"/> value has has been assigned a new value.
|
/// Event triggered when the <see cref="IEntity"/> value has has been assigned a new value.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
event EntityAssignedEventHandler? OnEntityAssigned;
|
Event<IHasEntity> OnEntityAssigned { get; }
|
||||||
|
|
||||||
/// <inheritdoc cref="IEntity" />
|
/// <inheritdoc cref="IEntity" />
|
||||||
IEntity Entity { get; }
|
IEntity Entity { get; }
|
||||||
@@ -21,6 +21,4 @@ public interface IHasEntity : IAssignable
|
|||||||
/// <see cref="true"/>, if the value given assigned successfully assigned, <see cref="false"/> if not.
|
/// <see cref="true"/>, if the value given assigned successfully assigned, <see cref="false"/> if not.
|
||||||
/// </returns>
|
/// </returns>
|
||||||
bool Assign(IEntity entity);
|
bool Assign(IEntity entity);
|
||||||
|
|
||||||
delegate void EntityAssignedEventHandler(IHasEntity sender);
|
|
||||||
}
|
}
|
||||||
|
@@ -8,7 +8,7 @@ public interface IHasStateEnable : IAssignable
|
|||||||
/// <summary>
|
/// <summary>
|
||||||
/// Event triggered when the <see cref="IStateEnable"/> value has has been assigned a new value.
|
/// Event triggered when the <see cref="IStateEnable"/> value has has been assigned a new value.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
event StateEnableAssignedEventHandler? OnStateEnableAssigned;
|
Event<IHasStateEnable> OnStateEnableAssigned { get; }
|
||||||
|
|
||||||
/// <inheritdoc cref="IStateEnable" />
|
/// <inheritdoc cref="IStateEnable" />
|
||||||
IStateEnable StateEnable { get; }
|
IStateEnable StateEnable { get; }
|
||||||
@@ -21,6 +21,4 @@ public interface IHasStateEnable : IAssignable
|
|||||||
/// <see cref="true"/>, if the value given assigned successfully assigned, <see cref="false"/> if not.
|
/// <see cref="true"/>, if the value given assigned successfully assigned, <see cref="false"/> if not.
|
||||||
/// </returns>
|
/// </returns>
|
||||||
bool Assign(IStateEnable stateEnable);
|
bool Assign(IStateEnable stateEnable);
|
||||||
|
|
||||||
delegate void StateEnableAssignedEventHandler(IHasStateEnable sender);
|
|
||||||
}
|
}
|
||||||
|
@@ -8,7 +8,7 @@ public interface IHasUniverse : IAssignable
|
|||||||
/// <summary>
|
/// <summary>
|
||||||
/// Event triggered when the <see cref="IUniverse"/> value has has been assigned a new value.
|
/// Event triggered when the <see cref="IUniverse"/> value has has been assigned a new value.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
event UniverseAssignedEventHandler? OnUniverseAssigned;
|
Event<IHasUniverse> OnUniverseAssigned { get; }
|
||||||
|
|
||||||
/// <inheritdoc cref="IUniverse" />
|
/// <inheritdoc cref="IUniverse" />
|
||||||
IUniverse Universe { get; }
|
IUniverse Universe { get; }
|
||||||
@@ -21,6 +21,4 @@ public interface IHasUniverse : IAssignable
|
|||||||
/// <see cref="true"/>, if the value given assigned successfully assigned, <see cref="false"/> if not.
|
/// <see cref="true"/>, if the value given assigned successfully assigned, <see cref="false"/> if not.
|
||||||
/// </returns>
|
/// </returns>
|
||||||
bool Assign(IUniverse universe);
|
bool Assign(IUniverse universe);
|
||||||
|
|
||||||
delegate void UniverseAssignedEventHandler(IHasUniverse sender);
|
|
||||||
}
|
}
|
||||||
|
@@ -8,7 +8,7 @@ public interface IHasUniverseObject : IAssignable
|
|||||||
/// <summary>
|
/// <summary>
|
||||||
/// Event triggered when the <see cref="IUniverseObject"/> value has has been assigned a new value.
|
/// Event triggered when the <see cref="IUniverseObject"/> value has has been assigned a new value.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
event UniverseObjectAssignedEventHandler? OnUniverseObjectAssigned;
|
Event<IHasUniverseObject> OnUniverseObjectAssigned { get; }
|
||||||
|
|
||||||
/// <inheritdoc cref="IUniverseObject" />
|
/// <inheritdoc cref="IUniverseObject" />
|
||||||
IUniverseObject UniverseObject { get; }
|
IUniverseObject UniverseObject { get; }
|
||||||
@@ -21,6 +21,4 @@ public interface IHasUniverseObject : IAssignable
|
|||||||
/// <see cref="true"/>, if the value given assigned successfully assigned, <see cref="false"/> if not.
|
/// <see cref="true"/>, if the value given assigned successfully assigned, <see cref="false"/> if not.
|
||||||
/// </returns>
|
/// </returns>
|
||||||
bool Assign(IUniverseObject universeObject);
|
bool Assign(IUniverseObject universeObject);
|
||||||
|
|
||||||
delegate void UniverseObjectAssignedEventHandler(IHasUniverseObject sender);
|
|
||||||
}
|
}
|
||||||
|
@@ -8,12 +8,12 @@ public interface IActive
|
|||||||
/// <summary>
|
/// <summary>
|
||||||
/// Event triggered when the <see cref="IsActive"/> state of the <see cref="IActive"/> changes.
|
/// Event triggered when the <see cref="IsActive"/> state of the <see cref="IActive"/> changes.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
event ActiveChangedEventHandler? OnActiveChanged;
|
Event<IActive, ActiveChangedArguments> OnActiveChanged { get; }
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// The value indicating whether the <see cref="IActive"/> is enabled.
|
/// The value indicating whether the <see cref="IActive"/> is enabled.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
bool IsActive { get; }
|
bool IsActive { get; }
|
||||||
|
|
||||||
delegate void ActiveChangedEventHandler(IActive sender, bool previousState);
|
readonly record struct ActiveChangedArguments(bool PreviousState);
|
||||||
}
|
}
|
||||||
|
@@ -8,12 +8,12 @@ public interface IBehaviour : IEntity, IActive, IHasBehaviourController, IHasSta
|
|||||||
/// <summary>
|
/// <summary>
|
||||||
/// Event triggered when the priority of the <see cref="IBehaviour"/> changes.
|
/// Event triggered when the priority of the <see cref="IBehaviour"/> changes.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
event PriorityChangedEventHandler? OnPriorityChanged;
|
Event<IBehaviour, PriorityChangedArguments> OnPriorityChanged { get; }
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// The priority of the <see cref="IBehaviour"/>.
|
/// The priority of the <see cref="IBehaviour"/>.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
int Priority { get; set; }
|
int Priority { get; set; }
|
||||||
|
|
||||||
delegate void PriorityChangedEventHandler(IBehaviour sender, int previousPriority);
|
readonly record struct PriorityChangedArguments(int PreviousPriority);
|
||||||
}
|
}
|
||||||
|
@@ -1,5 +1,3 @@
|
|||||||
using System.Collections.Generic;
|
|
||||||
|
|
||||||
namespace Syntriax.Engine.Core;
|
namespace Syntriax.Engine.Core;
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
@@ -7,29 +5,38 @@ namespace Syntriax.Engine.Core;
|
|||||||
/// Provides mechanisms for tracking additions and removals, and notifies subscribers when such events occur on the assigned <see cref="IUniverse"/>.
|
/// Provides mechanisms for tracking additions and removals, and notifies subscribers when such events occur on the assigned <see cref="IUniverse"/>.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
/// <typeparam name="T">The type of objects tracked by the collector.</typeparam>
|
/// <typeparam name="T">The type of objects tracked by the collector.</typeparam>
|
||||||
public interface IBehaviourCollector<T> : IHasUniverse, IEnumerable<T> where T : class
|
public interface IBehaviourCollector<T> : IHasUniverse where T : class
|
||||||
{
|
{
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Event triggered when an object of type <typeparamref name="T"/> is added to the collector.
|
/// Event triggered when an object of type <typeparamref name="T"/> is added to the collector.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
event CollectedEventHandler? OnCollected;
|
Event<IBehaviourCollector<T>, BehaviourCollectedArguments> OnCollected { get; }
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Event triggered when an object of type <typeparamref name="T"/> is removed from the collector.
|
/// Event triggered when an object of type <typeparamref name="T"/> is removed from the collector.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
event RemovedEventHandler? OnRemoved;
|
Event<IBehaviourCollector<T>, BehaviourRemovedArguments> OnRemoved { get; }
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Amount of <typeparamref name="T"/> collected.
|
||||||
|
/// </summary>
|
||||||
|
int Count { get; }
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Get a <typeparamref name="T"/> collected by it's index.
|
||||||
|
/// </summary>
|
||||||
|
T this[System.Index index] { get; }
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Delegate for handling the <see cref="OnCollected"/> event.
|
/// Delegate for handling the <see cref="OnCollected"/> event.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
/// <param name="sender">The instance of the <see cref="IBehaviourCollector{T}"/> that triggered the event.</param>
|
/// <param name="sender">The instance of the <see cref="IBehaviourCollector{T}"/> that triggered the event.</param>
|
||||||
/// <param name="behaviourCollected">The object of type <typeparamref name="T"/> that was added to the collector.</param>
|
/// <param name="behaviourCollected">The object of type <typeparamref name="T"/> that was added to the collector.</param>
|
||||||
delegate void CollectedEventHandler(IBehaviourCollector<T> sender, T behaviourCollected);
|
readonly record struct BehaviourCollectedArguments(T BehaviourCollected);
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Delegate for handling the <see cref="OnRemoved"/> event.
|
/// Delegate for handling the <see cref="OnRemoved"/> event.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
/// <param name="sender">The instance of the <see cref="IBehaviourCollector{T}"/> that triggered the event.</param>
|
/// <param name="BehaviourRemoved">The object of type <typeparamref name="T"/> that was removed from the collector.</param>
|
||||||
/// <param name="behaviourRemoved">The object of type <typeparamref name="T"/> that was removed from the collector.</param>
|
readonly record struct BehaviourRemovedArguments(T BehaviourRemoved);
|
||||||
delegate void RemovedEventHandler(IBehaviourCollector<T> sender, T behaviourRemoved);
|
|
||||||
}
|
}
|
||||||
|
@@ -3,34 +3,29 @@ using System.Collections.Generic;
|
|||||||
namespace Syntriax.Engine.Core;
|
namespace Syntriax.Engine.Core;
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Represents a controller for managing <see cref="IBehaviour"/>s and notify them accordingly about the engine's updates. Connected to an <see cref="IUniverseObject"/>.
|
/// Represents a controller for managing <see cref="IBehaviour"/>s. Connected to an <see cref="IUniverseObject"/>.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
public interface IBehaviourController : IInitializable, IHasUniverseObject, IEnumerable<IBehaviour>
|
public interface IBehaviourController : IEntity, IHasUniverseObject
|
||||||
{
|
{
|
||||||
/// <summary>
|
|
||||||
/// Event triggered before the update of <see cref="IBehaviour"/>s.
|
|
||||||
/// </summary>
|
|
||||||
event PreUpdateEventHandler? OnPreUpdate;
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Event triggered during the update of <see cref="IBehaviour"/>s.
|
|
||||||
/// </summary>
|
|
||||||
event UpdateEventHandler? OnUpdate;
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Event triggered before the drawing phase.
|
|
||||||
/// </summary>
|
|
||||||
event PreDrawEventHandler? OnPreDraw;
|
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Event triggered when a <see cref="IBehaviour"/> is added to the <see cref="IBehaviourController"/>.
|
/// Event triggered when a <see cref="IBehaviour"/> is added to the <see cref="IBehaviourController"/>.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
event BehaviourAddedEventHandler? OnBehaviourAdded;
|
Event<IBehaviourController, BehaviourAddedArguments> OnBehaviourAdded { get; }
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Event triggered when a <see cref="IBehaviour"/> is removed from the <see cref="IBehaviourController"/>.
|
/// Event triggered when a <see cref="IBehaviour"/> is removed from the <see cref="IBehaviourController"/>.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
event BehaviourRemovedEventHandler? OnBehaviourRemoved;
|
Event<IBehaviourController, BehaviourRemovedArguments> OnBehaviourRemoved { get; }
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Amount of <see cref="IBehaviour"/> collected.
|
||||||
|
/// </summary>
|
||||||
|
int Count { get; }
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Get a <see cref="IBehaviour"/> collected by it's index.
|
||||||
|
/// </summary>
|
||||||
|
IBehaviour this[System.Index index] { get; }
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Adds a <see cref="IBehaviour"/> to the <see cref="IBehaviourController"/>.
|
/// Adds a <see cref="IBehaviour"/> to the <see cref="IBehaviourController"/>.
|
||||||
@@ -83,20 +78,6 @@ public interface IBehaviourController : IInitializable, IHasUniverseObject, IEnu
|
|||||||
/// <param name="behaviour">The <see cref="IBehaviour"/> to remove.</param>
|
/// <param name="behaviour">The <see cref="IBehaviour"/> to remove.</param>
|
||||||
void RemoveBehaviour<T>(T behaviour) where T : class, IBehaviour;
|
void RemoveBehaviour<T>(T behaviour) where T : class, IBehaviour;
|
||||||
|
|
||||||
/// <summary>
|
readonly record struct BehaviourAddedArguments(IBehaviour BehaviourAdded);
|
||||||
/// Updates all <see cref="IBehaviour"/>s in the <see cref="IBehaviourController"/>.
|
readonly record struct BehaviourRemovedArguments(IBehaviour BehaviourRemoved);
|
||||||
/// </summary>
|
|
||||||
void Update();
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Performs pre-draw operations.
|
|
||||||
/// </summary>
|
|
||||||
void UpdatePreDraw();
|
|
||||||
|
|
||||||
delegate void PreUpdateEventHandler(IBehaviourController sender);
|
|
||||||
delegate void UpdateEventHandler(IBehaviourController sender);
|
|
||||||
delegate void PreDrawEventHandler(IBehaviourController sender);
|
|
||||||
delegate void BehaviourAddedEventHandler(IBehaviourController sender, IBehaviour behaviourAdded);
|
|
||||||
delegate void BehaviourRemovedEventHandler(IBehaviourController sender, IBehaviour behaviourRemoved);
|
|
||||||
|
|
||||||
}
|
}
|
||||||
|
@@ -9,12 +9,12 @@ public interface IEntity : IInitializable, IHasStateEnable
|
|||||||
/// Event triggered when the <see cref="Id"/> of the <see cref="IEntity"/> changes.
|
/// Event triggered when the <see cref="Id"/> of the <see cref="IEntity"/> changes.
|
||||||
/// The string action parameter is the previous <see cref="Id"/> of the <see cref="IEntity"/>.
|
/// The string action parameter is the previous <see cref="Id"/> of the <see cref="IEntity"/>.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
event IdChangedEventHandler? OnIdChanged;
|
Event<IEntity, IdChangedArguments> OnIdChanged { get; }
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// The ID of the <see cref="IEntity"/>.
|
/// The ID of the <see cref="IEntity"/>.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
string Id { get; set; }
|
string Id { get; set; }
|
||||||
|
|
||||||
delegate void IdChangedEventHandler(IEntity sender, string previousId);
|
readonly record struct IdChangedArguments(string PreviousId);
|
||||||
}
|
}
|
||||||
|
@@ -8,12 +8,12 @@ public interface IInitializable
|
|||||||
/// <summary>
|
/// <summary>
|
||||||
/// Event triggered when the <see cref="Initialize"/> method is called successfully.
|
/// Event triggered when the <see cref="Initialize"/> method is called successfully.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
event InitializedEventHandler? OnInitialized;
|
Event<IInitializable> OnInitialized { get; }
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Event triggered when the <see cref="IInitializable"/> method is called successfully.
|
/// Event triggered when the <see cref="IInitializable"/> method is called successfully.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
event FinalizedEventHandler? OnFinalized;
|
Event<IInitializable> OnFinalized { get; }
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// The value indicating whether the entity has been initialized.
|
/// The value indicating whether the entity has been initialized.
|
||||||
@@ -31,7 +31,4 @@ public interface IInitializable
|
|||||||
/// </summary>
|
/// </summary>
|
||||||
/// <returns><see cref="true"/> if finalization is successful, otherwise <see cref="false"/>.</returns>
|
/// <returns><see cref="true"/> if finalization is successful, otherwise <see cref="false"/>.</returns>
|
||||||
bool Finalize();
|
bool Finalize();
|
||||||
|
|
||||||
delegate void InitializedEventHandler(IInitializable sender);
|
|
||||||
delegate void FinalizedEventHandler(IInitializable sender);
|
|
||||||
}
|
}
|
||||||
|
@@ -8,12 +8,12 @@ public interface INameable
|
|||||||
/// <summary>
|
/// <summary>
|
||||||
/// Event triggered when the name of the entity changes.
|
/// Event triggered when the name of the entity changes.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
event NameChangedEventHandler? OnNameChanged;
|
Event<INameable, NameChangedArguments> OnNameChanged { get; }
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// The name of the entity.
|
/// The name of the entity.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
string Name { get; set; }
|
string Name { get; set; }
|
||||||
|
|
||||||
delegate void NameChangedEventHandler(INameable sender, string previousName);
|
readonly record struct NameChangedArguments(string PreviousName);
|
||||||
}
|
}
|
||||||
|
@@ -8,12 +8,12 @@ public interface IStateEnable : IHasEntity
|
|||||||
/// <summary>
|
/// <summary>
|
||||||
/// Event triggered when the <see cref="Enabled"/> state of the <see cref="IStateEnable"/> changes.
|
/// Event triggered when the <see cref="Enabled"/> state of the <see cref="IStateEnable"/> changes.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
event EnabledChangedEventHandler? OnEnabledChanged;
|
Event<IStateEnable, EnabledChangedArguments> OnEnabledChanged { get; }
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// The value indicating whether the <see cref="IStateEnable"/> is enabled.
|
/// The value indicating whether the <see cref="IStateEnable"/> is enabled.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
bool Enabled { get; set; }
|
bool Enabled { get; set; }
|
||||||
|
|
||||||
delegate void EnabledChangedEventHandler(IStateEnable sender, bool previousState);
|
readonly record struct EnabledChangedArguments(bool PreviousState);
|
||||||
}
|
}
|
||||||
|
@@ -8,17 +8,37 @@ public interface ITransform2D : IBehaviour
|
|||||||
/// <summary>
|
/// <summary>
|
||||||
/// Event triggered when the <see cref="Position"/> of the <see cref="ITransform2D"/> changes.
|
/// Event triggered when the <see cref="Position"/> of the <see cref="ITransform2D"/> changes.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
event PositionChangedEventHandler? OnPositionChanged;
|
Event<ITransform2D, PositionChangedArguments> OnPositionChanged { get; }
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Event triggered when the <see cref="Scale"/> of the <see cref="ITransform2D"/> changes.
|
/// Event triggered when the <see cref="Scale"/> of the <see cref="ITransform2D"/> changes.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
event ScaleChangedEventHandler? OnScaleChanged;
|
Event<ITransform2D, ScaleChangedArguments> OnScaleChanged { get; }
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Event triggered when the <see cref="Rotation"/> of the <see cref="ITransform"/> changes.
|
/// Event triggered when the <see cref="Rotation"/> of the <see cref="ITransform"/> changes.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
event RotationChangedEventHandler? OnRotationChanged;
|
Event<ITransform2D, RotationChangedArguments> OnRotationChanged { get; }
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// The <see cref="Vector2D"/> pointing upwards in world space.
|
||||||
|
/// </summary>
|
||||||
|
Vector2D Up { get; }
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// The <see cref="Vector2D"/> pointing upwards in world space.
|
||||||
|
/// </summary>
|
||||||
|
Vector2D Down { get; }
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// The <see cref="Vector2D"/> pointing upwards in world space.
|
||||||
|
/// </summary>
|
||||||
|
Vector2D Left { get; }
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// The <see cref="Vector2D"/> pointing upwards in world space.
|
||||||
|
/// </summary>
|
||||||
|
Vector2D Right { get; }
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// The world position of the <see cref="ITransform2D"/> in 2D space.
|
/// The world position of the <see cref="ITransform2D"/> in 2D space.
|
||||||
@@ -51,23 +71,20 @@ public interface ITransform2D : IBehaviour
|
|||||||
float LocalRotation { get; set; }
|
float LocalRotation { get; set; }
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Delegate for the event triggered when the <see cref="ITransform2D"/>'s rotation changes.
|
/// Arguments for the event triggered when the <see cref="ITransform2D"/>'s rotation changes.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
/// <param name="sender">The <see cref="ITransform2D"/> that the parent has changed.</param>
|
/// <param name="PreviousPosition">The previous <see cref="Position"/> of the <see cref="ITransform2D"/>.</param>
|
||||||
/// <param name="previousPosition">The previous <see cref="Position"/> of the <see cref="ITransform2D"/>.</param>
|
readonly record struct PositionChangedArguments(Vector2D PreviousPosition);
|
||||||
delegate void PositionChangedEventHandler(ITransform2D sender, Vector2D previousPosition);
|
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Delegate for the event triggered when the <see cref="ITransform2D"/>'s rotation changes.
|
/// Arguments for the event triggered when the <see cref="ITransform2D"/>'s rotation changes.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
/// <param name="sender">The <see cref="ITransform2D"/> that the parent has changed.</param>
|
/// <param name="PreviousScale">The previous <see cref="Scale"/> of the <see cref="ITransform2D"/>.</param>
|
||||||
/// <param name="previousScale">The previous <see cref="Scale"/> of the <see cref="ITransform2D"/>.</param>
|
readonly record struct ScaleChangedArguments(Vector2D PreviousScale);
|
||||||
delegate void ScaleChangedEventHandler(ITransform2D sender, Vector2D previousScale);
|
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Delegate for the event triggered when the <see cref="ITransform2D"/>'s rotation changes.
|
/// Arguments for the event triggered when the <see cref="ITransform2D"/>'s rotation changes.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
/// <param name="sender">The <see cref="ITransform2D"/> that the parent has changed.</param>
|
/// <param name="PreviousRotation">The previous <see cref="Rotation"/> of the <see cref="ITransform2D"/>.</param>
|
||||||
/// <param name="previousRotation">The previous <see cref="Rotation"/> of the <see cref="ITransform2D"/>.</param>
|
readonly record struct RotationChangedArguments(float PreviousRotation);
|
||||||
delegate void RotationChangedEventHandler(ITransform2D sender, float previousRotation);
|
|
||||||
}
|
}
|
||||||
|
@@ -10,32 +10,57 @@ public interface IUniverse : IEntity, IEnumerable<IUniverseObject>
|
|||||||
/// <summary>
|
/// <summary>
|
||||||
/// Event triggered when <see cref="Update(UniverseTime)"/> is about to be called called on the <see cref="IUniverse"/>.
|
/// Event triggered when <see cref="Update(UniverseTime)"/> is about to be called called on the <see cref="IUniverse"/>.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
event UpdateEventHandler? OnPreUpdate;
|
Event<IUniverse, UpdateArguments> OnPreUpdate { get; }
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Event triggered when <see cref="Update(UniverseTime)"/> is called on the <see cref="IUniverse"/>.
|
/// Event triggered when <see cref="Update(UniverseTime)"/> is called on the <see cref="IUniverse"/>.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
event UpdateEventHandler? OnUpdate;
|
Event<IUniverse, UpdateArguments> OnUpdate { get; }
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Event triggered when <see cref="PreDraw"/> is called on the <see cref="IUniverse"/>.
|
/// Event triggered after <see cref="Update(UniverseTime)"/> is called on the <see cref="IUniverse"/>.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
event PreDrawEventHandler? OnPreDraw;
|
Event<IUniverse, UpdateArguments> OnPostUpdate { get; }
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Event triggered when <see cref="Draw"/> is about to be called called on the <see cref="IUniverse"/>.
|
||||||
|
/// </summary>
|
||||||
|
Event<IUniverse> OnPreDraw { get; }
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Event triggered when <see cref="Draw"/> is called on the <see cref="IUniverse"/>.
|
||||||
|
/// </summary>
|
||||||
|
Event<IUniverse> OnDraw { get; }
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Event triggered after <see cref="Draw"/> is called on the <see cref="IUniverse"/>.
|
||||||
|
/// </summary>
|
||||||
|
Event<IUniverse> OnPostDraw { get; }
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Event triggered when a <see cref="IUniverseObject"/> is about to be registered to the <see cref="IUniverse"/>.
|
||||||
|
/// </summary>
|
||||||
|
Event<IUniverse, UniverseObjectRegisteredArguments> OnPreUniverseObjectRegistered { get; }
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Event triggered when a <see cref="IUniverseObject"/> is registered to the <see cref="IUniverse"/>.
|
/// Event triggered when a <see cref="IUniverseObject"/> is registered to the <see cref="IUniverse"/>.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
event UniverseObjectRegisteredEventHandler? OnUniverseObjectRegistered;
|
Event<IUniverse, UniverseObjectRegisteredArguments> OnUniverseObjectRegistered { get; }
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Event triggered when a <see cref="IUniverseObject"/> is about to be unregistered from the <see cref="IUniverse"/>.
|
||||||
|
/// </summary>
|
||||||
|
Event<IUniverse, UniverseObjectUnRegisteredArguments> OnPreUniverseObjectUnRegistered { get; }
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Event triggered when a <see cref="IUniverseObject"/> is unregistered from the <see cref="IUniverse"/>.
|
/// Event triggered when a <see cref="IUniverseObject"/> is unregistered from the <see cref="IUniverse"/>.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
event UniverseObjectUnRegisteredEventHandler? OnUniverseObjectUnRegistered;
|
Event<IUniverse, UniverseObjectUnRegisteredArguments> OnUniverseObjectUnRegistered { get; }
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Event triggered when <see cref="TimeScale"/> is changed on the <see cref="IUniverse"/>.
|
/// Event triggered when <see cref="TimeScale"/> is changed on the <see cref="IUniverse"/>.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
event TimeScaleChangedEventHandler? OnTimeScaleChanged;
|
Event<IUniverse, TimeScaleChangedArguments> OnTimeScaleChanged { get; }
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Current time scale the <see cref="IUniverse"/> operates on.
|
/// Current time scale the <see cref="IUniverse"/> operates on.
|
||||||
@@ -84,15 +109,12 @@ public interface IUniverse : IEntity, IEnumerable<IUniverseObject>
|
|||||||
void Update(UniverseTime universeTime);
|
void Update(UniverseTime universeTime);
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Performs operations that should be done before the draw calls.
|
/// Performs operations that should be done to the draw.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
void PreDraw();
|
void Draw();
|
||||||
|
|
||||||
delegate void TimeScaleChangedEventHandler(IUniverse sender, float previousTimeScale);
|
readonly record struct TimeScaleChangedArguments(float PreviousTimeScale);
|
||||||
|
readonly record struct UpdateArguments(UniverseTime EngineTime);
|
||||||
delegate void UpdateEventHandler(IUniverse sender, UniverseTime engineTime);
|
readonly record struct UniverseObjectRegisteredArguments(IUniverseObject UniverseObjectRegistered);
|
||||||
delegate void PreDrawEventHandler(IUniverse sender);
|
readonly record struct UniverseObjectUnRegisteredArguments(IUniverseObject UniverseObjectUnregistered);
|
||||||
|
|
||||||
delegate void UniverseObjectRegisteredEventHandler(IUniverse sender, IUniverseObject universeObjectRegistered);
|
|
||||||
delegate void UniverseObjectUnRegisteredEventHandler(IUniverse sender, IUniverseObject universeObjectUnregistered);
|
|
||||||
}
|
}
|
||||||
|
@@ -7,32 +7,32 @@ namespace Syntriax.Engine.Core;
|
|||||||
/// This interface allows for tracking the object's presence in the universe and provides events
|
/// This interface allows for tracking the object's presence in the universe and provides events
|
||||||
/// for notifying when the see enters or exits the universe.
|
/// for notifying when the see enters or exits the universe.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
public interface IUniverseObject : IEntity, IActive, INameable, IHasBehaviourController, IEnumerable<IUniverseObject>
|
public interface IUniverseObject : IEntity, IActive, INameable, IHasBehaviourController
|
||||||
{
|
{
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Event triggered when the <see cref="IUniverseObject"/> enters the universe.
|
/// Event triggered when the <see cref="IUniverseObject"/> enters the universe.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
event EnteredUniverseEventHandler? OnEnteredUniverse;
|
Event<IUniverseObject, EnteredUniverseArguments> OnEnteredUniverse { get; }
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Event triggered when the <see cref="IUniverseObject"/> exits the universe.
|
/// Event triggered when the <see cref="IUniverseObject"/> exits the universe.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
event ExitedUniverseEventHandler? OnExitedUniverse;
|
Event<IUniverseObject, ExitedUniverseArguments> OnExitedUniverse { get; }
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Event triggered when the <see cref="Parent"/> of the <see cref="IUniverseObject"/> changes. The second parameter is the old <see cref="IUniverseObject"/>.
|
/// Event triggered when the <see cref="Parent"/> of the <see cref="IUniverseObject"/> changes. The second parameter is the old <see cref="IUniverseObject"/>.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
event ParentChangedEventHandler? OnParentChanged;
|
Event<IUniverseObject, ParentChangedArguments> OnParentChanged { get; }
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Event triggered when a new <see cref="IUniverseObject"/> is added to the <see cref="Children"/>.
|
/// Event triggered when a new <see cref="IUniverseObject"/> is added to the <see cref="Children"/>.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
event ChildrenAddedEventHandler? OnChildrenAdded;
|
Event<IUniverseObject, ChildrenAddedArguments> OnChildrenAdded { get; }
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Event triggered when an <see cref="IUniverseObject"/> is removed from the <see cref="Children"/>.
|
/// Event triggered when an <see cref="IUniverseObject"/> is removed from the <see cref="Children"/>.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
event ChildrenRemovedEventHandler? OnChildrenRemoved;
|
Event<IUniverseObject, ChildrenRemovedArguments> OnChildrenRemoved { get; }
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Gets the <see cref="IUniverse"/> this <see cref="IUniverseObject"/> is connected to, if any.
|
/// Gets the <see cref="IUniverse"/> this <see cref="IUniverseObject"/> is connected to, if any.
|
||||||
@@ -47,7 +47,7 @@ public interface IUniverseObject : IEntity, IActive, INameable, IHasBehaviourCon
|
|||||||
/// <summary>
|
/// <summary>
|
||||||
/// The parent <see cref="IUniverseObject"/> of the <see cref="IUniverseObject"/>.
|
/// The parent <see cref="IUniverseObject"/> of the <see cref="IUniverseObject"/>.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
IUniverseObject? Parent { get; }
|
IUniverseObject? Parent { get; set; }
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// The <see cref="IUniverseObject"/>s that have this <see cref="IUniverseObject"/> as their <see cref="Parent"/>.
|
/// The <see cref="IUniverseObject"/>s that have this <see cref="IUniverseObject"/> as their <see cref="Parent"/>.
|
||||||
@@ -75,12 +75,6 @@ public interface IUniverseObject : IEntity, IActive, INameable, IHasBehaviourCon
|
|||||||
/// </returns>
|
/// </returns>
|
||||||
internal bool ExitUniverse();
|
internal bool ExitUniverse();
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Sets the parent <see cref="IUniverseObject"/> of this <see cref="IUniverseObject"/>.
|
|
||||||
/// </summary>
|
|
||||||
/// <param name="universeObject">The parent <see cref="IUniverseObject"/> to set.</param>
|
|
||||||
void SetParent(IUniverseObject? universeObject);
|
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Adds a child <see cref="IUniverseObject"/> to this <see cref="IUniverseObject"/>.
|
/// Adds a child <see cref="IUniverseObject"/> to this <see cref="IUniverseObject"/>.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
@@ -94,38 +88,38 @@ public interface IUniverseObject : IEntity, IActive, INameable, IHasBehaviourCon
|
|||||||
void RemoveChild(IUniverseObject universeObject);
|
void RemoveChild(IUniverseObject universeObject);
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// EventHandler delegate for the event triggered when the <see cref="IUniverseObject"/> enters the universe of a <see cref="IUniverse">.
|
/// Arguments for the event triggered when the <see cref="IUniverseObject"/> enters the universe of a <see cref="IUniverse">.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
/// <param name="sender">The <see cref="IUniverseObject"/> that entered the universe.</param>
|
/// <param name="sender">The <see cref="IUniverseObject"/> that entered the universe.</param>
|
||||||
/// <param name="universe">The <see cref="IUniverse"/> that the <see cref="IUniverseObject"/> has entered it's universe.</param>
|
/// <param name="universe">The <see cref="IUniverse"/> that the <see cref="IUniverseObject"/> has entered it's universe.</param>
|
||||||
delegate void EnteredUniverseEventHandler(IUniverseObject sender, IUniverse universe);
|
readonly record struct EnteredUniverseArguments(IUniverse Universe);
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// EventHandler delegate for the event triggered when the <see cref="IUniverseObject"/> exits the universe of a <see cref="IUniverse">.
|
/// Arguments for the event triggered when the <see cref="IUniverseObject"/> exits the universe of a <see cref="IUniverse">.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
/// <param name="sender">The <see cref="IUniverseObject"/> that exited the universe.</param>
|
/// <param name="sender">The <see cref="IUniverseObject"/> that exited the universe.</param>
|
||||||
/// <param name="universe">The <see cref="IUniverse"/> that the <see cref="IUniverseObject"/> has exited it's universe.</param>
|
/// <param name="universe">The <see cref="IUniverse"/> that the <see cref="IUniverseObject"/> has exited it's universe.</param>
|
||||||
delegate void ExitedUniverseEventHandler(IUniverseObject sender, IUniverse universe);
|
readonly record struct ExitedUniverseArguments(IUniverse Universe);
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Delegate for the event triggered when the <see cref="IUniverseObject"/>'s parent changes.
|
/// Arguments for the event triggered when the <see cref="IUniverseObject"/>'s parent changes.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
/// <param name="sender">The <see cref="IUniverseObject"/> that the parent has changed.</param>
|
/// <param name="sender">The <see cref="IUniverseObject"/> that the parent has changed.</param>
|
||||||
/// <param name="previousParent">The previous <see cref="IUniverseObject"/> the sender was a child of.</param>
|
/// <param name="previousParent">The previous <see cref="IUniverseObject"/> the sender was a child of.</param>
|
||||||
/// <param name="newParent">The new and current <see cref="IUniverseObject"/> the sender is a child of.</param>
|
/// <param name="newParent">The new and current <see cref="IUniverseObject"/> the sender is a child of.</param>
|
||||||
delegate void ParentChangedEventHandler(IUniverseObject sender, IUniverseObject? previousParent, IUniverseObject? newParent);
|
readonly record struct ParentChangedArguments(IUniverseObject? PreviousParent, IUniverseObject? CurrentParent);
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Delegate for the event triggered when a new <see cref="IUniverseObject"/> added as a child.
|
/// Arguments for the event triggered when a new <see cref="IUniverseObject"/> added as a child.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
/// <param name="sender">The parent <see cref="IUniverseObject"/> this event is being called from.</param>
|
/// <param name="sender">The parent <see cref="IUniverseObject"/> this event is being called from.</param>
|
||||||
/// <param name="childrenAdded">The <see cref="IUniverseObject"/> that got removed as a children of the sender <see cref="IUniverseObject"/>.</param>
|
/// <param name="childrenAdded">The <see cref="IUniverseObject"/> that got removed as a children of the sender <see cref="IUniverseObject"/>.</param>
|
||||||
delegate void ChildrenAddedEventHandler(IUniverseObject sender, IUniverseObject childrenAdded);
|
readonly record struct ChildrenAddedArguments(IUniverseObject ChildrenAdded);
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Delegate for the event triggered when a new <see cref="IUniverseObject"/> removed from being a child.
|
/// Delegate for the event triggered when a new <see cref="IUniverseObject"/> removed from being a child.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
/// <param name="sender">The parent <see cref="IUniverseObject"/> this event is being called from.</param>
|
/// <param name="sender">The parent <see cref="IUniverseObject"/> this event is being called from.</param>
|
||||||
/// <param name="childrenAdded">The <see cref="IUniverseObject"/> that got removed as a children of the sender <see cref="IUniverseObject"/>.</param>
|
/// <param name="childrenAdded">The <see cref="IUniverseObject"/> that got removed as a children of the sender <see cref="IUniverseObject"/>.</param>
|
||||||
delegate void ChildrenRemovedEventHandler(IUniverseObject sender, IUniverseObject childrenRemoved);
|
readonly record struct ChildrenRemovedArguments(IUniverseObject ChildrenRemoved);
|
||||||
}
|
}
|
||||||
|
@@ -1,89 +1,92 @@
|
|||||||
using System;
|
using System;
|
||||||
using System.Collections;
|
|
||||||
using System.Collections.Generic;
|
using System.Collections.Generic;
|
||||||
|
|
||||||
namespace Syntriax.Engine.Core;
|
namespace Syntriax.Engine.Core;
|
||||||
|
|
||||||
public class ActiveBehaviourCollector<T> : IBehaviourCollector<T> where T : class, IBehaviour
|
public class ActiveBehaviourCollector<T> : IBehaviourCollector<T> where T : class, IBehaviour
|
||||||
{
|
{
|
||||||
public event IAssignable.UnassignEventHandler? OnUnassigned = null;
|
public Event<IBehaviourCollector<T>, IBehaviourCollector<T>.BehaviourCollectedArguments> OnCollected { get; } = new();
|
||||||
public event IHasUniverse.UniverseAssignedEventHandler? OnUniverseAssigned = null;
|
public Event<IBehaviourCollector<T>, IBehaviourCollector<T>.BehaviourRemovedArguments> OnRemoved { get; } = new();
|
||||||
|
public Event<IHasUniverse> OnUniverseAssigned { get; } = new();
|
||||||
|
public Event<IAssignable>? OnUnassigned { get; } = new();
|
||||||
|
|
||||||
public event IBehaviourCollector<T>.CollectedEventHandler? OnCollected = null;
|
private readonly Event<IBehaviourController, IBehaviourController.BehaviourAddedArguments>.EventHandler delegateOnBehaviourAdded = null!;
|
||||||
public event IBehaviourCollector<T>.RemovedEventHandler? OnRemoved = null;
|
private readonly Event<IBehaviourController, IBehaviourController.BehaviourRemovedArguments>.EventHandler delegateOnBehaviourRemoved = null!;
|
||||||
|
private readonly Event<IActive, IActive.ActiveChangedArguments>.EventHandler delegateOnBehaviourStateChanged = null!;
|
||||||
|
private readonly Event<IUniverse, IUniverse.UniverseObjectRegisteredArguments>.EventHandler delegateOnUniverseObjectRegistered = null!;
|
||||||
|
private readonly Event<IUniverse, IUniverse.UniverseObjectUnRegisteredArguments>.EventHandler delegateOnUniverseObjectUnregistered = null!;
|
||||||
|
|
||||||
private readonly List<T> monitoringBehaviours = new(32);
|
private readonly List<T> monitoringBehaviours = new(32);
|
||||||
protected readonly List<T> activeBehaviours = new(32);
|
protected readonly List<T> activeBehaviours = new(32);
|
||||||
protected readonly Dictionary<IActive, T> monitoringActiveToBehaviour = new(32);
|
protected readonly Dictionary<IActive, T> monitoringActiveToBehaviour = new(32);
|
||||||
|
|
||||||
public IReadOnlyList<T> Behaviours => activeBehaviours;
|
|
||||||
public IUniverse Universe { get; private set; } = null!;
|
public IUniverse Universe { get; private set; } = null!;
|
||||||
|
|
||||||
public T this[Index index] => activeBehaviours[index];
|
private void OnUniverseObjectRegistered(IUniverse manager, IUniverse.UniverseObjectRegisteredArguments args)
|
||||||
|
|
||||||
public ActiveBehaviourCollector() { }
|
|
||||||
public ActiveBehaviourCollector(IUniverse universe) => Assign(universe);
|
|
||||||
|
|
||||||
private void OnUniverseObjectRegistered(IUniverse manager, IUniverseObject universeObject)
|
|
||||||
{
|
{
|
||||||
universeObject.BehaviourController.OnBehaviourAdded += OnBehaviourAdded;
|
IUniverseObject universeObject = args.UniverseObjectRegistered;
|
||||||
universeObject.BehaviourController.OnBehaviourRemoved += OnBehaviourRemoved;
|
|
||||||
|
|
||||||
foreach (IBehaviour item in universeObject.BehaviourController)
|
universeObject.BehaviourController.OnBehaviourAdded.AddListener(delegateOnBehaviourAdded);
|
||||||
OnBehaviourAdded(universeObject.BehaviourController, item);
|
universeObject.BehaviourController.OnBehaviourRemoved.AddListener(delegateOnBehaviourRemoved);
|
||||||
|
|
||||||
|
for (int i = 0; i < universeObject.BehaviourController.Count; i++)
|
||||||
|
OnBehaviourAdded(universeObject.BehaviourController, new(universeObject.BehaviourController[i]));
|
||||||
}
|
}
|
||||||
|
|
||||||
private void OnUniverseObjectUnregistered(IUniverse manager, IUniverseObject universeObject)
|
private void OnUniverseObjectUnregistered(IUniverse manager, IUniverse.UniverseObjectUnRegisteredArguments args)
|
||||||
{
|
{
|
||||||
universeObject.BehaviourController.OnBehaviourAdded -= OnBehaviourAdded;
|
IUniverseObject universeObject = args.UniverseObjectUnregistered;
|
||||||
universeObject.BehaviourController.OnBehaviourRemoved -= OnBehaviourRemoved;
|
|
||||||
|
|
||||||
foreach (IBehaviour item in universeObject.BehaviourController)
|
universeObject.BehaviourController.OnBehaviourAdded.RemoveListener(delegateOnBehaviourAdded);
|
||||||
OnBehaviourRemoved(universeObject.BehaviourController, item);
|
universeObject.BehaviourController.OnBehaviourRemoved.RemoveListener(delegateOnBehaviourRemoved);
|
||||||
|
|
||||||
|
for (int i = 0; i < universeObject.BehaviourController.Count; i++)
|
||||||
|
OnBehaviourRemoved(universeObject.BehaviourController, new(universeObject.BehaviourController[i]));
|
||||||
}
|
}
|
||||||
|
|
||||||
protected virtual void OnBehaviourAdd(IBehaviour behaviour) { }
|
protected virtual void OnBehaviourAdd(IBehaviour behaviour) { }
|
||||||
private void OnBehaviourAdded(IBehaviourController controller, IBehaviour behaviour)
|
private void OnBehaviourAdded(IBehaviourController controller, IBehaviourController.BehaviourAddedArguments args)
|
||||||
{
|
{
|
||||||
if (behaviour is not T tBehaviour)
|
if (args.BehaviourAdded is not T tBehaviour)
|
||||||
return;
|
return;
|
||||||
|
|
||||||
monitoringBehaviours.Add(tBehaviour);
|
monitoringBehaviours.Add(tBehaviour);
|
||||||
monitoringActiveToBehaviour.Add(tBehaviour, tBehaviour);
|
monitoringActiveToBehaviour.Add(tBehaviour, tBehaviour);
|
||||||
tBehaviour.OnActiveChanged += OnBehaviourStateChanged;
|
tBehaviour.OnActiveChanged.AddListener(delegateOnBehaviourStateChanged);
|
||||||
OnBehaviourStateChanged(tBehaviour, !tBehaviour.IsActive);
|
OnBehaviourStateChanged(tBehaviour, new(!tBehaviour.IsActive));
|
||||||
}
|
}
|
||||||
|
|
||||||
private void OnBehaviourStateChanged(IActive sender, bool previousState)
|
protected virtual void AddBehaviour(T behaviour) => activeBehaviours.Add(behaviour);
|
||||||
|
private void OnBehaviourStateChanged(IActive sender, IActive.ActiveChangedArguments args)
|
||||||
{
|
{
|
||||||
T behaviour = monitoringActiveToBehaviour[sender];
|
T behaviour = monitoringActiveToBehaviour[sender];
|
||||||
if (sender.IsActive)
|
if (sender.IsActive)
|
||||||
{
|
{
|
||||||
activeBehaviours.Add(behaviour);
|
AddBehaviour(behaviour);
|
||||||
OnBehaviourAdd(behaviour);
|
OnBehaviourAdd(behaviour);
|
||||||
OnCollected?.InvokeSafe(this, behaviour);
|
OnCollected?.Invoke(this, new(behaviour));
|
||||||
}
|
}
|
||||||
else if (activeBehaviours.Remove(behaviour))
|
else if (activeBehaviours.Remove(behaviour))
|
||||||
{
|
{
|
||||||
OnBehaviourRemove(behaviour);
|
OnBehaviourRemove(behaviour);
|
||||||
OnRemoved?.InvokeSafe(this, behaviour);
|
OnRemoved?.Invoke(this, new(behaviour));
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
protected virtual void OnBehaviourRemove(IBehaviour behaviour) { }
|
protected virtual void OnBehaviourRemove(IBehaviour behaviour) { }
|
||||||
private void OnBehaviourRemoved(IBehaviourController controller, IBehaviour behaviour)
|
private void OnBehaviourRemoved(IBehaviourController controller, IBehaviourController.BehaviourRemovedArguments args)
|
||||||
{
|
{
|
||||||
if (behaviour is not T tBehaviour)
|
if (args.BehaviourRemoved is not T tBehaviour)
|
||||||
return;
|
return;
|
||||||
|
|
||||||
if (!monitoringBehaviours.Remove(tBehaviour) || !monitoringActiveToBehaviour.Remove(tBehaviour))
|
if (!monitoringBehaviours.Remove(tBehaviour) || !monitoringActiveToBehaviour.Remove(tBehaviour))
|
||||||
return;
|
return;
|
||||||
|
|
||||||
tBehaviour.OnActiveChanged -= OnBehaviourStateChanged;
|
tBehaviour.OnActiveChanged.RemoveListener(delegateOnBehaviourStateChanged);
|
||||||
if (activeBehaviours.Remove(tBehaviour))
|
if (activeBehaviours.Remove(tBehaviour))
|
||||||
{
|
{
|
||||||
OnBehaviourRemove(tBehaviour);
|
OnBehaviourRemove(tBehaviour);
|
||||||
OnRemoved?.InvokeSafe(this, tBehaviour);
|
OnRemoved?.Invoke(this, new(tBehaviour));
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -93,13 +96,13 @@ public class ActiveBehaviourCollector<T> : IBehaviourCollector<T> where T : clas
|
|||||||
return false;
|
return false;
|
||||||
|
|
||||||
foreach (IUniverseObject universeObject in universe.UniverseObjects)
|
foreach (IUniverseObject universeObject in universe.UniverseObjects)
|
||||||
OnUniverseObjectRegistered(universe, universeObject);
|
OnUniverseObjectRegistered(universe, new(universeObject));
|
||||||
|
|
||||||
universe.OnUniverseObjectRegistered += OnUniverseObjectRegistered;
|
universe.OnUniverseObjectRegistered.AddListener(delegateOnUniverseObjectRegistered);
|
||||||
universe.OnUniverseObjectUnRegistered += OnUniverseObjectUnregistered;
|
universe.OnUniverseObjectUnRegistered.AddListener(delegateOnUniverseObjectUnregistered);
|
||||||
|
|
||||||
Universe = universe;
|
Universe = universe;
|
||||||
OnUniverseAssigned?.InvokeSafe(this);
|
OnUniverseAssigned?.Invoke(this);
|
||||||
|
|
||||||
return true;
|
return true;
|
||||||
}
|
}
|
||||||
@@ -110,16 +113,36 @@ public class ActiveBehaviourCollector<T> : IBehaviourCollector<T> where T : clas
|
|||||||
return false;
|
return false;
|
||||||
|
|
||||||
foreach (IUniverseObject universeObject in Universe.UniverseObjects)
|
foreach (IUniverseObject universeObject in Universe.UniverseObjects)
|
||||||
OnUniverseObjectUnregistered(Universe, universeObject);
|
OnUniverseObjectUnregistered(Universe, new(universeObject));
|
||||||
|
|
||||||
Universe.OnUniverseObjectRegistered -= OnUniverseObjectRegistered;
|
Universe.OnUniverseObjectRegistered.RemoveListener(delegateOnUniverseObjectRegistered);
|
||||||
Universe.OnUniverseObjectUnRegistered -= OnUniverseObjectUnregistered;
|
Universe.OnUniverseObjectUnRegistered.RemoveListener(delegateOnUniverseObjectUnregistered);
|
||||||
|
|
||||||
Universe = null!;
|
Universe = null!;
|
||||||
OnUnassigned?.InvokeSafe(this);
|
OnUnassigned?.Invoke(this);
|
||||||
return true;
|
return true;
|
||||||
}
|
}
|
||||||
|
|
||||||
public IEnumerator<T> GetEnumerator() => activeBehaviours.GetEnumerator();
|
public int Count => activeBehaviours.Count;
|
||||||
IEnumerator IEnumerable.GetEnumerator() => activeBehaviours.GetEnumerator();
|
public T this[Index index] => activeBehaviours[index];
|
||||||
|
|
||||||
|
public ActiveBehaviourCollector()
|
||||||
|
{
|
||||||
|
delegateOnBehaviourAdded = OnBehaviourAdded;
|
||||||
|
delegateOnBehaviourRemoved = OnBehaviourRemoved;
|
||||||
|
delegateOnBehaviourStateChanged = OnBehaviourStateChanged;
|
||||||
|
delegateOnUniverseObjectRegistered = OnUniverseObjectRegistered;
|
||||||
|
delegateOnUniverseObjectUnregistered = OnUniverseObjectUnregistered;
|
||||||
|
}
|
||||||
|
|
||||||
|
public ActiveBehaviourCollector(IUniverse universe)
|
||||||
|
{
|
||||||
|
delegateOnBehaviourAdded = OnBehaviourAdded;
|
||||||
|
delegateOnBehaviourRemoved = OnBehaviourRemoved;
|
||||||
|
delegateOnBehaviourStateChanged = OnBehaviourStateChanged;
|
||||||
|
delegateOnUniverseObjectRegistered = OnUniverseObjectRegistered;
|
||||||
|
delegateOnUniverseObjectUnregistered = OnUniverseObjectUnregistered;
|
||||||
|
|
||||||
|
Assign(universe);
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
@@ -1,11 +1,14 @@
|
|||||||
using System;
|
using System;
|
||||||
|
using System.Collections.Generic;
|
||||||
|
|
||||||
namespace Syntriax.Engine.Core;
|
namespace Syntriax.Engine.Core;
|
||||||
|
|
||||||
public class ActiveBehaviourCollectorSorted<T> : ActiveBehaviourCollector<T> where T : class, IBehaviour
|
public class ActiveBehaviourCollectorSorted<T> : ActiveBehaviourCollector<T> where T : class, IBehaviour
|
||||||
{
|
{
|
||||||
private Comparison<T>? _sortBy = null;
|
private readonly Event<IBehaviour, IBehaviour.PriorityChangedArguments>.EventHandler delegateOnPriorityChanged = null!;
|
||||||
public Comparison<T>? SortBy
|
|
||||||
|
private IComparer<T>? _sortBy = null;
|
||||||
|
public IComparer<T>? SortBy
|
||||||
{
|
{
|
||||||
get => _sortBy;
|
get => _sortBy;
|
||||||
set
|
set
|
||||||
@@ -17,12 +20,48 @@ public class ActiveBehaviourCollectorSorted<T> : ActiveBehaviourCollector<T> whe
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
protected override void OnBehaviourAdd(IBehaviour behaviour)
|
protected override void AddBehaviour(T behaviour)
|
||||||
{
|
{
|
||||||
if (SortBy is not null)
|
if (SortBy is null)
|
||||||
activeBehaviours.Sort(SortBy);
|
{
|
||||||
|
activeBehaviours.Add(behaviour);
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
int insertionIndex = activeBehaviours.BinarySearch(behaviour, SortBy);
|
||||||
|
|
||||||
|
if (insertionIndex < 0)
|
||||||
|
insertionIndex = ~insertionIndex;
|
||||||
|
|
||||||
|
activeBehaviours.Insert(insertionIndex, behaviour);
|
||||||
}
|
}
|
||||||
|
|
||||||
public ActiveBehaviourCollectorSorted() { }
|
protected override void OnBehaviourAdd(IBehaviour behaviour)
|
||||||
public ActiveBehaviourCollectorSorted(IUniverse universe, Comparison<T> sortBy) : base(universe) => SortBy = sortBy;
|
{
|
||||||
|
behaviour.OnPriorityChanged.AddListener(delegateOnPriorityChanged);
|
||||||
|
}
|
||||||
|
|
||||||
|
protected override void OnBehaviourRemove(IBehaviour behaviour)
|
||||||
|
{
|
||||||
|
behaviour.OnPriorityChanged.RemoveListener(delegateOnPriorityChanged);
|
||||||
|
}
|
||||||
|
|
||||||
|
private void OnPriorityChanged(IBehaviour sender, IBehaviour.PriorityChangedArguments args)
|
||||||
|
{
|
||||||
|
T behaviour = (T)sender;
|
||||||
|
activeBehaviours.Remove(behaviour);
|
||||||
|
AddBehaviour(behaviour);
|
||||||
|
}
|
||||||
|
|
||||||
|
public ActiveBehaviourCollectorSorted()
|
||||||
|
{
|
||||||
|
delegateOnPriorityChanged = OnPriorityChanged;
|
||||||
|
}
|
||||||
|
|
||||||
|
public ActiveBehaviourCollectorSorted(IUniverse universe, Comparison<T> sortBy) : base(universe)
|
||||||
|
{
|
||||||
|
delegateOnPriorityChanged = OnPriorityChanged;
|
||||||
|
|
||||||
|
SortBy = Comparer<T>.Create(sortBy);
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
@@ -4,13 +4,11 @@ namespace Syntriax.Engine.Core;
|
|||||||
|
|
||||||
public abstract class BaseEntity : IEntity
|
public abstract class BaseEntity : IEntity
|
||||||
{
|
{
|
||||||
public event IEntity.IdChangedEventHandler? OnIdChanged = null;
|
public Event<IEntity, IEntity.IdChangedArguments> OnIdChanged { get; } = new();
|
||||||
|
public Event<IInitializable> OnInitialized { get; } = new();
|
||||||
public event IInitializable.InitializedEventHandler? OnInitialized = null;
|
public Event<IInitializable> OnFinalized { get; } = new();
|
||||||
public event IInitializable.FinalizedEventHandler? OnFinalized = null;
|
public Event<IHasStateEnable> OnStateEnableAssigned { get; } = new();
|
||||||
|
public Event<IAssignable> OnUnassigned { get; } = new();
|
||||||
public event IHasStateEnable.StateEnableAssignedEventHandler? OnStateEnableAssigned = null;
|
|
||||||
public event IAssignable.UnassignEventHandler? OnUnassigned = null;
|
|
||||||
|
|
||||||
private IStateEnable _stateEnable = null!;
|
private IStateEnable _stateEnable = null!;
|
||||||
|
|
||||||
@@ -33,7 +31,7 @@ public abstract class BaseEntity : IEntity
|
|||||||
string previousId = _id;
|
string previousId = _id;
|
||||||
|
|
||||||
_id = value;
|
_id = value;
|
||||||
OnIdChanged?.InvokeSafe(this, previousId);
|
OnIdChanged?.Invoke(this, new(previousId));
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -47,9 +45,9 @@ public abstract class BaseEntity : IEntity
|
|||||||
|
|
||||||
_initialized = value;
|
_initialized = value;
|
||||||
if (value)
|
if (value)
|
||||||
OnInitialized?.InvokeSafe(this);
|
OnInitialized?.Invoke(this);
|
||||||
else
|
else
|
||||||
OnFinalized?.InvokeSafe(this);
|
OnFinalized?.Invoke(this);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -62,7 +60,7 @@ public abstract class BaseEntity : IEntity
|
|||||||
_stateEnable = stateEnable;
|
_stateEnable = stateEnable;
|
||||||
_stateEnable.Assign(this);
|
_stateEnable.Assign(this);
|
||||||
OnAssign(stateEnable);
|
OnAssign(stateEnable);
|
||||||
OnStateEnableAssigned?.InvokeSafe(this);
|
OnStateEnableAssigned?.Invoke(this);
|
||||||
return true;
|
return true;
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -76,7 +74,7 @@ public abstract class BaseEntity : IEntity
|
|||||||
|
|
||||||
_stateEnable = null!;
|
_stateEnable = null!;
|
||||||
_stateEnable.Unassign();
|
_stateEnable.Unassign();
|
||||||
OnUnassigned?.InvokeSafe(this);
|
OnUnassigned?.Invoke(this);
|
||||||
return true;
|
return true;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
@@ -2,108 +2,49 @@ namespace Syntriax.Engine.Core;
|
|||||||
|
|
||||||
public abstract class Behaviour : BehaviourBase
|
public abstract class Behaviour : BehaviourBase
|
||||||
{
|
{
|
||||||
private bool isInitializedThisFrame = false;
|
private readonly Event<IUniverseObject, IUniverseObject.EnteredUniverseArguments>.EventHandler delegateEnteredUniverse = null!;
|
||||||
|
private readonly Event<IUniverseObject, IUniverseObject.ExitedUniverseArguments>.EventHandler delegateExitedUniverse = null!;
|
||||||
protected IUniverse Universe => BehaviourController.UniverseObject.Universe;
|
|
||||||
protected IUniverseObject UniverseObject => BehaviourController.UniverseObject;
|
|
||||||
|
|
||||||
public Behaviour()
|
public Behaviour()
|
||||||
{
|
{
|
||||||
OnInitialized += OnInitialize;
|
OnInitialized.AddListener(OnInitialize);
|
||||||
OnFinalized += OnFinalize;
|
OnFinalized.AddListener(OnFinalize);
|
||||||
OnUnassigned += OnUnassign;
|
OnUnassigned.AddListener(OnUnassign);
|
||||||
|
|
||||||
|
delegateEnteredUniverse = EnteredUniverse;
|
||||||
|
delegateExitedUniverse = ExitedUniverse;
|
||||||
}
|
}
|
||||||
|
|
||||||
protected virtual void OnUnassign() { }
|
protected virtual void OnUnassign() { }
|
||||||
protected virtual void OnUnassign(IAssignable assignable) => OnUnassign();
|
protected void OnUnassign(IAssignable assignable) => OnUnassign();
|
||||||
|
|
||||||
protected virtual void OnInitialize() { }
|
protected virtual void OnInitialize() { }
|
||||||
protected virtual void OnInitialize(IInitializable _)
|
protected void OnInitialize(IInitializable _)
|
||||||
{
|
{
|
||||||
isInitializedThisFrame = true;
|
BehaviourController.UniverseObject.OnEnteredUniverse.AddListener(delegateEnteredUniverse);
|
||||||
|
BehaviourController.UniverseObject.OnExitedUniverse.AddListener(delegateExitedUniverse);
|
||||||
BehaviourController.OnPreUpdate += PreUpdate;
|
|
||||||
BehaviourController.OnPreDraw += PreDraw;
|
|
||||||
BehaviourController.OnUpdate += Update;
|
|
||||||
BehaviourController.UniverseObject.OnEnteredUniverse += EnteredUniverse;
|
|
||||||
BehaviourController.UniverseObject.OnExitedUniverse += ExitedUniverse;
|
|
||||||
|
|
||||||
OnInitialize();
|
OnInitialize();
|
||||||
|
|
||||||
if (UniverseObject.IsInUniverse)
|
if (UniverseObject.IsInUniverse)
|
||||||
EnteredUniverse(UniverseObject, Universe);
|
EnteredUniverse(UniverseObject, new(Universe));
|
||||||
}
|
}
|
||||||
|
|
||||||
protected virtual void OnFinalize() { }
|
protected virtual void OnFinalize() { }
|
||||||
protected virtual void OnFinalize(IInitializable _)
|
protected void OnFinalize(IInitializable _)
|
||||||
{
|
{
|
||||||
BehaviourController.OnPreUpdate -= PreUpdate;
|
BehaviourController.UniverseObject.OnEnteredUniverse.RemoveListener(delegateEnteredUniverse);
|
||||||
BehaviourController.OnPreDraw -= PreDraw;
|
BehaviourController.UniverseObject.OnExitedUniverse.RemoveListener(delegateExitedUniverse);
|
||||||
BehaviourController.OnUpdate -= Update;
|
|
||||||
BehaviourController.UniverseObject.OnEnteredUniverse -= EnteredUniverse;
|
|
||||||
BehaviourController.UniverseObject.OnExitedUniverse -= ExitedUniverse;
|
|
||||||
|
|
||||||
OnFinalize();
|
OnFinalize();
|
||||||
|
|
||||||
if (UniverseObject.IsInUniverse)
|
if (UniverseObject.IsInUniverse)
|
||||||
ExitedUniverse(UniverseObject, Universe);
|
ExitedUniverse(UniverseObject, new(Universe));
|
||||||
}
|
|
||||||
|
|
||||||
protected virtual void OnPreUpdatePreActiveCheck() { }
|
|
||||||
protected virtual void OnPreUpdate() { }
|
|
||||||
protected virtual void PreUpdate(IBehaviourController _)
|
|
||||||
{
|
|
||||||
Debug.AssertHelpers.AssertInitialized(this);
|
|
||||||
|
|
||||||
OnPreUpdatePreActiveCheck();
|
|
||||||
|
|
||||||
if (!IsActive)
|
|
||||||
return;
|
|
||||||
|
|
||||||
if (isInitializedThisFrame)
|
|
||||||
FirstActiveFrame();
|
|
||||||
|
|
||||||
OnPreUpdate();
|
|
||||||
}
|
|
||||||
|
|
||||||
protected virtual void OnFirstActiveFrame() { }
|
|
||||||
protected virtual void FirstActiveFrame()
|
|
||||||
{
|
|
||||||
OnFirstActiveFrame();
|
|
||||||
isInitializedThisFrame = false;
|
|
||||||
}
|
|
||||||
|
|
||||||
protected virtual void OnUpdatePreActiveCheck() { }
|
|
||||||
protected virtual void OnUpdate() { }
|
|
||||||
protected virtual void Update(IBehaviourController _)
|
|
||||||
{
|
|
||||||
Debug.AssertHelpers.AssertInitialized(this);
|
|
||||||
|
|
||||||
OnUpdatePreActiveCheck();
|
|
||||||
|
|
||||||
if (!IsActive)
|
|
||||||
return;
|
|
||||||
|
|
||||||
OnUpdate();
|
|
||||||
}
|
|
||||||
|
|
||||||
protected virtual void OnPreDrawPreActiveCheck() { }
|
|
||||||
protected virtual void OnPreDraw() { }
|
|
||||||
protected virtual void PreDraw(IBehaviourController _)
|
|
||||||
{
|
|
||||||
Debug.AssertHelpers.AssertInitialized(this);
|
|
||||||
|
|
||||||
OnPreDrawPreActiveCheck();
|
|
||||||
|
|
||||||
if (!StateEnable.Enabled)
|
|
||||||
return;
|
|
||||||
|
|
||||||
OnPreDraw();
|
|
||||||
}
|
}
|
||||||
|
|
||||||
protected virtual void OnEnteredUniverse(IUniverse universe) { }
|
protected virtual void OnEnteredUniverse(IUniverse universe) { }
|
||||||
protected virtual void EnteredUniverse(IUniverseObject sender, IUniverse universe) => OnEnteredUniverse(universe);
|
protected void EnteredUniverse(IUniverseObject sender, IUniverseObject.EnteredUniverseArguments args) => OnEnteredUniverse(args.Universe);
|
||||||
|
|
||||||
protected virtual void OnExitedUniverse(IUniverse universe) { }
|
protected virtual void OnExitedUniverse(IUniverse universe) { }
|
||||||
protected virtual void ExitedUniverse(IUniverseObject sender, IUniverse universe) => OnExitedUniverse(universe);
|
protected void ExitedUniverse(IUniverseObject sender, IUniverseObject.ExitedUniverseArguments args) => OnExitedUniverse(args.Universe);
|
||||||
}
|
}
|
||||||
|
@@ -4,23 +4,6 @@ public abstract class Behaviour2D : Behaviour, IBehaviour2D
|
|||||||
{
|
{
|
||||||
public ITransform2D Transform { get; private set; } = null!;
|
public ITransform2D Transform { get; private set; } = null!;
|
||||||
|
|
||||||
protected sealed override void OnInitialize(IInitializable _)
|
protected override void OnInitialize() => Transform = BehaviourController.GetRequiredBehaviour<ITransform2D>();
|
||||||
{
|
protected override void OnFinalize() => Transform = null!;
|
||||||
Transform = BehaviourController.GetRequiredBehaviour<ITransform2D>();
|
|
||||||
base.OnInitialize(_);
|
|
||||||
}
|
|
||||||
|
|
||||||
protected sealed override void OnFinalize(IInitializable _)
|
|
||||||
{
|
|
||||||
Transform = null!;
|
|
||||||
base.OnFinalize(_);
|
|
||||||
}
|
|
||||||
|
|
||||||
protected sealed override void OnUnassign(IAssignable assignable) => base.OnUnassign(assignable);
|
|
||||||
protected sealed override void PreUpdate(IBehaviourController behaviourController) => base.PreUpdate(behaviourController);
|
|
||||||
protected sealed override void FirstActiveFrame() => base.FirstActiveFrame();
|
|
||||||
protected sealed override void Update(IBehaviourController behaviourController) => base.Update(behaviourController);
|
|
||||||
protected sealed override void PreDraw(IBehaviourController behaviourController) => base.PreDraw(behaviourController);
|
|
||||||
protected sealed override void EnteredUniverse(IUniverseObject sender, IUniverse universe) => base.EnteredUniverse(sender, universe);
|
|
||||||
protected sealed override void ExitedUniverse(IUniverseObject sender, IUniverse universe) => base.ExitedUniverse(sender, universe);
|
|
||||||
}
|
}
|
||||||
|
@@ -3,9 +3,16 @@ namespace Syntriax.Engine.Core;
|
|||||||
[System.Diagnostics.DebuggerDisplay("{GetType().Name, nq}, Priority: {Priority}, Initialized: {Initialized}")]
|
[System.Diagnostics.DebuggerDisplay("{GetType().Name, nq}, Priority: {Priority}, Initialized: {Initialized}")]
|
||||||
public abstract class BehaviourBase : BaseEntity, IBehaviour
|
public abstract class BehaviourBase : BaseEntity, IBehaviour
|
||||||
{
|
{
|
||||||
public event IHasBehaviourController.BehaviourControllerAssignedEventHandler? OnBehaviourControllerAssigned = null;
|
public Event<IBehaviour, IBehaviour.PriorityChangedArguments> OnPriorityChanged { get; } = new();
|
||||||
public event IBehaviour.PriorityChangedEventHandler? OnPriorityChanged = null;
|
public Event<IActive, IActive.ActiveChangedArguments> OnActiveChanged { get; } = new();
|
||||||
public event IActive.ActiveChangedEventHandler? OnActiveChanged = null;
|
public Event<IHasBehaviourController> OnBehaviourControllerAssigned { get; } = new();
|
||||||
|
|
||||||
|
private readonly Event<IHasUniverseObject>.EventHandler delegateOnUniverseObjectAssigned = null!;
|
||||||
|
private readonly Event<IActive, IActive.ActiveChangedArguments>.EventHandler delegateOnUniverseObjectActiveChanged = null!;
|
||||||
|
private readonly Event<IStateEnable, IStateEnable.EnabledChangedArguments>.EventHandler delegateOnStateEnabledChanged = null!;
|
||||||
|
|
||||||
|
public IUniverse Universe => BehaviourController.UniverseObject.Universe;
|
||||||
|
public IUniverseObject UniverseObject => BehaviourController.UniverseObject;
|
||||||
|
|
||||||
private IBehaviourController _behaviourController = null!;
|
private IBehaviourController _behaviourController = null!;
|
||||||
public IBehaviourController BehaviourController => _behaviourController;
|
public IBehaviourController BehaviourController => _behaviourController;
|
||||||
@@ -21,7 +28,7 @@ public abstract class BehaviourBase : BaseEntity, IBehaviour
|
|||||||
|
|
||||||
int previousPriority = _priority;
|
int previousPriority = _priority;
|
||||||
_priority = value;
|
_priority = value;
|
||||||
OnPriorityChanged?.InvokeSafe(this, previousPriority);
|
OnPriorityChanged?.Invoke(this, new(previousPriority));
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -36,16 +43,17 @@ public abstract class BehaviourBase : BaseEntity, IBehaviour
|
|||||||
|
|
||||||
_behaviourController = behaviourController;
|
_behaviourController = behaviourController;
|
||||||
OnAssign(behaviourController);
|
OnAssign(behaviourController);
|
||||||
behaviourController.OnUniverseObjectAssigned += OnUniverseObjectAssigned;
|
behaviourController.OnUniverseObjectAssigned.AddListener(delegateOnUniverseObjectAssigned);
|
||||||
|
behaviourController.StateEnable.OnEnabledChanged.AddListener(delegateOnStateEnabledChanged);
|
||||||
if (behaviourController.UniverseObject is not null)
|
if (behaviourController.UniverseObject is not null)
|
||||||
OnUniverseObjectAssigned(behaviourController);
|
OnUniverseObjectAssigned(behaviourController);
|
||||||
OnBehaviourControllerAssigned?.InvokeSafe(this);
|
OnBehaviourControllerAssigned?.Invoke(this);
|
||||||
return true;
|
return true;
|
||||||
}
|
}
|
||||||
|
|
||||||
private void OnUniverseObjectAssigned(IHasUniverseObject sender)
|
private void OnUniverseObjectAssigned(IHasUniverseObject sender)
|
||||||
{
|
{
|
||||||
sender.UniverseObject.OnActiveChanged += OnUniverseObjectActiveChanged;
|
sender.UniverseObject.OnActiveChanged.AddListener(delegateOnUniverseObjectActiveChanged);
|
||||||
UpdateActive();
|
UpdateActive();
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -53,32 +61,43 @@ public abstract class BehaviourBase : BaseEntity, IBehaviour
|
|||||||
{
|
{
|
||||||
base.OnAssign(stateEnable);
|
base.OnAssign(stateEnable);
|
||||||
|
|
||||||
stateEnable.OnEnabledChanged += OnStateEnabledChanged;
|
stateEnable.OnEnabledChanged.AddListener(delegateOnStateEnabledChanged);
|
||||||
}
|
}
|
||||||
|
|
||||||
protected override void UnassignInternal()
|
protected override void UnassignInternal()
|
||||||
{
|
{
|
||||||
StateEnable.OnEnabledChanged -= OnStateEnabledChanged;
|
BehaviourController.UniverseObject.OnActiveChanged.RemoveListener(delegateOnUniverseObjectActiveChanged);
|
||||||
BehaviourController.OnUniverseObjectAssigned -= OnUniverseObjectAssigned;
|
StateEnable.OnEnabledChanged.RemoveListener(delegateOnStateEnabledChanged);
|
||||||
|
BehaviourController.OnUniverseObjectAssigned.RemoveListener(delegateOnUniverseObjectAssigned);
|
||||||
|
BehaviourController.StateEnable.OnEnabledChanged.RemoveListener(delegateOnStateEnabledChanged);
|
||||||
base.UnassignInternal();
|
base.UnassignInternal();
|
||||||
_behaviourController = null!;
|
_behaviourController = null!;
|
||||||
}
|
}
|
||||||
|
|
||||||
protected override void InitializeInternal()
|
protected override void InitializeInternal()
|
||||||
{
|
{
|
||||||
Debug.AssertHelpers.AssertBehaviourControllerAssigned(this);
|
Debug.Assert.AssertBehaviourControllerAssigned(this);
|
||||||
Debug.AssertHelpers.AssertStateEnableAssigned(this);
|
Debug.Assert.AssertStateEnableAssigned(this);
|
||||||
|
|
||||||
|
UpdateActive();
|
||||||
}
|
}
|
||||||
|
|
||||||
private void OnStateEnabledChanged(IStateEnable sender, bool previousState) => UpdateActive();
|
private void OnStateEnabledChanged(IStateEnable sender, IStateEnable.EnabledChangedArguments args) => UpdateActive();
|
||||||
private void OnUniverseObjectActiveChanged(IActive sender, bool previousState) => UpdateActive();
|
private void OnUniverseObjectActiveChanged(IActive sender, IActive.ActiveChangedArguments args) => UpdateActive();
|
||||||
|
|
||||||
private void UpdateActive()
|
private void UpdateActive()
|
||||||
{
|
{
|
||||||
bool previousActive = IsActive;
|
bool previousActive = IsActive;
|
||||||
_isActive = StateEnable.Enabled && _behaviourController.UniverseObject.IsActive;
|
_isActive = StateEnable.Enabled && _behaviourController.StateEnable.Enabled && _behaviourController.UniverseObject.IsActive;
|
||||||
|
|
||||||
if (previousActive != IsActive)
|
if (previousActive != IsActive)
|
||||||
OnActiveChanged?.InvokeSafe(this, previousActive);
|
OnActiveChanged?.Invoke(this, new(previousActive));
|
||||||
|
}
|
||||||
|
|
||||||
|
protected BehaviourBase()
|
||||||
|
{
|
||||||
|
delegateOnUniverseObjectAssigned = OnUniverseObjectAssigned;
|
||||||
|
delegateOnUniverseObjectActiveChanged = OnUniverseObjectActiveChanged;
|
||||||
|
delegateOnStateEnabledChanged = OnStateEnabledChanged;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
@@ -1,67 +1,69 @@
|
|||||||
using System;
|
using System;
|
||||||
using System.Collections;
|
|
||||||
using System.Collections.Generic;
|
using System.Collections.Generic;
|
||||||
|
|
||||||
namespace Syntriax.Engine.Core;
|
namespace Syntriax.Engine.Core;
|
||||||
|
|
||||||
public class BehaviourCollector<T> : IBehaviourCollector<T> where T : class
|
public class BehaviourCollector<T> : IBehaviourCollector<T> where T : class
|
||||||
{
|
{
|
||||||
public event IAssignable.UnassignEventHandler? OnUnassigned = null;
|
public Event<IBehaviourCollector<T>, IBehaviourCollector<T>.BehaviourCollectedArguments> OnCollected { get; } = new();
|
||||||
public event IHasUniverse.UniverseAssignedEventHandler? OnUniverseAssigned = null;
|
public Event<IBehaviourCollector<T>, IBehaviourCollector<T>.BehaviourRemovedArguments> OnRemoved { get; } = new();
|
||||||
|
public Event<IHasUniverse> OnUniverseAssigned { get; } = new();
|
||||||
|
public Event<IAssignable>? OnUnassigned { get; } = new();
|
||||||
|
|
||||||
public event IBehaviourCollector<T>.CollectedEventHandler? OnCollected = null;
|
private readonly Event<IBehaviourController, IBehaviourController.BehaviourAddedArguments>.EventHandler delegateOnBehaviourAdded = null!;
|
||||||
public event IBehaviourCollector<T>.RemovedEventHandler? OnRemoved = null;
|
private readonly Event<IBehaviourController, IBehaviourController.BehaviourRemovedArguments>.EventHandler delegateOnBehaviourRemoved = null!;
|
||||||
|
private readonly Event<IUniverse, IUniverse.UniverseObjectRegisteredArguments>.EventHandler delegateOnUniverseObjectRegistered = null!;
|
||||||
|
private readonly Event<IUniverse, IUniverse.UniverseObjectUnRegisteredArguments>.EventHandler delegateOnUniverseObjectUnregistered = null!;
|
||||||
|
|
||||||
protected readonly List<T> behaviours = new(32);
|
protected readonly List<T> behaviours = new(32);
|
||||||
|
|
||||||
public IReadOnlyList<T> Behaviours => behaviours;
|
|
||||||
public IUniverse Universe { get; private set; } = null!;
|
public IUniverse Universe { get; private set; } = null!;
|
||||||
|
|
||||||
public T this[Index index] => behaviours[index];
|
private void OnUniverseObjectRegistered(IUniverse manager, IUniverse.UniverseObjectRegisteredArguments args)
|
||||||
|
|
||||||
public BehaviourCollector() { }
|
|
||||||
public BehaviourCollector(IUniverse universe) => Assign(universe);
|
|
||||||
|
|
||||||
private void OnUniverseObjectRegistered(IUniverse manager, IUniverseObject universeObject)
|
|
||||||
{
|
{
|
||||||
universeObject.BehaviourController.OnBehaviourAdded += OnBehaviourAdded;
|
IUniverseObject universeObject = args.UniverseObjectRegistered;
|
||||||
universeObject.BehaviourController.OnBehaviourRemoved += OnBehaviourRemoved;
|
|
||||||
|
|
||||||
foreach (IBehaviour item in universeObject.BehaviourController)
|
universeObject.BehaviourController.OnBehaviourAdded.AddListener(delegateOnBehaviourAdded);
|
||||||
OnBehaviourAdded(universeObject.BehaviourController, item);
|
universeObject.BehaviourController.OnBehaviourRemoved.AddListener(delegateOnBehaviourRemoved);
|
||||||
|
|
||||||
|
for (int i = 0; i < universeObject.BehaviourController.Count; i++)
|
||||||
|
OnBehaviourAdded(universeObject.BehaviourController, new(universeObject.BehaviourController[i]));
|
||||||
}
|
}
|
||||||
|
|
||||||
private void OnUniverseObjectUnregistered(IUniverse manager, IUniverseObject universeObject)
|
private void OnUniverseObjectUnregistered(IUniverse manager, IUniverse.UniverseObjectUnRegisteredArguments args)
|
||||||
{
|
{
|
||||||
universeObject.BehaviourController.OnBehaviourAdded -= OnBehaviourAdded;
|
IUniverseObject universeObject = args.UniverseObjectUnregistered;
|
||||||
universeObject.BehaviourController.OnBehaviourRemoved -= OnBehaviourRemoved;
|
|
||||||
|
|
||||||
foreach (IBehaviour item in universeObject.BehaviourController)
|
universeObject.BehaviourController.OnBehaviourAdded.RemoveListener(delegateOnBehaviourAdded);
|
||||||
OnBehaviourRemoved(universeObject.BehaviourController, item);
|
universeObject.BehaviourController.OnBehaviourRemoved.RemoveListener(delegateOnBehaviourRemoved);
|
||||||
|
|
||||||
|
for (int i = 0; i < universeObject.BehaviourController.Count; i++)
|
||||||
|
OnBehaviourRemoved(universeObject.BehaviourController, new(universeObject.BehaviourController[i]));
|
||||||
}
|
}
|
||||||
|
|
||||||
|
protected virtual void AddBehaviour(T behaviour) => behaviours.Add(behaviour);
|
||||||
protected virtual void OnBehaviourAdd(IBehaviour behaviour) { }
|
protected virtual void OnBehaviourAdd(IBehaviour behaviour) { }
|
||||||
private void OnBehaviourAdded(IBehaviourController controller, IBehaviour behaviour)
|
private void OnBehaviourAdded(IBehaviourController controller, IBehaviourController.BehaviourAddedArguments args)
|
||||||
{
|
{
|
||||||
if (behaviour is not T tBehaviour)
|
if (args.BehaviourAdded is not T tBehaviour)
|
||||||
return;
|
return;
|
||||||
|
|
||||||
behaviours.Add(tBehaviour);
|
AddBehaviour(tBehaviour);
|
||||||
OnBehaviourAdd(behaviour);
|
OnBehaviourAdd(args.BehaviourAdded);
|
||||||
OnCollected?.InvokeSafe(this, tBehaviour);
|
OnCollected?.Invoke(this, new(tBehaviour));
|
||||||
}
|
}
|
||||||
|
|
||||||
protected virtual void OnBehaviourRemove(IBehaviour behaviour) { }
|
protected virtual void OnBehaviourRemove(IBehaviour behaviour) { }
|
||||||
private void OnBehaviourRemoved(IBehaviourController controller, IBehaviour behaviour)
|
private void OnBehaviourRemoved(IBehaviourController controller, IBehaviourController.BehaviourRemovedArguments args)
|
||||||
{
|
{
|
||||||
if (behaviour is not T tBehaviour)
|
if (args.BehaviourRemoved is not T tBehaviour)
|
||||||
return;
|
return;
|
||||||
|
|
||||||
if (!behaviours.Remove(tBehaviour))
|
if (!behaviours.Remove(tBehaviour))
|
||||||
return;
|
return;
|
||||||
|
|
||||||
OnBehaviourRemove(behaviour);
|
OnBehaviourRemove(args.BehaviourRemoved);
|
||||||
OnRemoved?.InvokeSafe(this, tBehaviour);
|
OnRemoved?.Invoke(this, new(tBehaviour));
|
||||||
}
|
}
|
||||||
|
|
||||||
protected virtual void OnAssign(IUniverse universe) { }
|
protected virtual void OnAssign(IUniverse universe) { }
|
||||||
@@ -71,14 +73,14 @@ public class BehaviourCollector<T> : IBehaviourCollector<T> where T : class
|
|||||||
return false;
|
return false;
|
||||||
|
|
||||||
foreach (IUniverseObject universeObject in universe.UniverseObjects)
|
foreach (IUniverseObject universeObject in universe.UniverseObjects)
|
||||||
OnUniverseObjectRegistered(universe, universeObject);
|
OnUniverseObjectRegistered(universe, new(universeObject));
|
||||||
|
|
||||||
universe.OnUniverseObjectRegistered += OnUniverseObjectRegistered;
|
universe.OnUniverseObjectRegistered.AddListener(delegateOnUniverseObjectRegistered);
|
||||||
universe.OnUniverseObjectUnRegistered += OnUniverseObjectUnregistered;
|
universe.OnPreUniverseObjectUnRegistered.AddListener(delegateOnUniverseObjectUnregistered);
|
||||||
|
|
||||||
Universe = universe;
|
Universe = universe;
|
||||||
OnAssign(universe);
|
OnAssign(universe);
|
||||||
OnUniverseAssigned?.InvokeSafe(this);
|
OnUniverseAssigned?.Invoke(this);
|
||||||
|
|
||||||
return true;
|
return true;
|
||||||
}
|
}
|
||||||
@@ -89,16 +91,34 @@ public class BehaviourCollector<T> : IBehaviourCollector<T> where T : class
|
|||||||
return false;
|
return false;
|
||||||
|
|
||||||
foreach (IUniverseObject universeObject in Universe.UniverseObjects)
|
foreach (IUniverseObject universeObject in Universe.UniverseObjects)
|
||||||
OnUniverseObjectUnregistered(Universe, universeObject);
|
OnUniverseObjectUnregistered(Universe, new(universeObject));
|
||||||
|
|
||||||
Universe.OnUniverseObjectRegistered -= OnUniverseObjectRegistered;
|
Universe.OnUniverseObjectRegistered.RemoveListener(delegateOnUniverseObjectRegistered);
|
||||||
Universe.OnUniverseObjectUnRegistered -= OnUniverseObjectUnregistered;
|
Universe.OnPreUniverseObjectUnRegistered.RemoveListener(delegateOnUniverseObjectUnregistered);
|
||||||
|
|
||||||
Universe = null!;
|
Universe = null!;
|
||||||
OnUnassigned?.InvokeSafe(this);
|
OnUnassigned?.Invoke(this);
|
||||||
return true;
|
return true;
|
||||||
}
|
}
|
||||||
|
|
||||||
public IEnumerator<T> GetEnumerator() => behaviours.GetEnumerator();
|
public int Count => behaviours.Count;
|
||||||
IEnumerator IEnumerable.GetEnumerator() => behaviours.GetEnumerator();
|
public T this[Index index] => behaviours[index];
|
||||||
|
|
||||||
|
public BehaviourCollector()
|
||||||
|
{
|
||||||
|
delegateOnBehaviourAdded = OnBehaviourAdded;
|
||||||
|
delegateOnBehaviourRemoved = OnBehaviourRemoved;
|
||||||
|
delegateOnUniverseObjectRegistered = OnUniverseObjectRegistered;
|
||||||
|
delegateOnUniverseObjectUnregistered = OnUniverseObjectUnregistered;
|
||||||
|
}
|
||||||
|
|
||||||
|
public BehaviourCollector(IUniverse universe)
|
||||||
|
{
|
||||||
|
delegateOnBehaviourAdded = OnBehaviourAdded;
|
||||||
|
delegateOnBehaviourRemoved = OnBehaviourRemoved;
|
||||||
|
delegateOnUniverseObjectRegistered = OnUniverseObjectRegistered;
|
||||||
|
delegateOnUniverseObjectUnregistered = OnUniverseObjectUnregistered;
|
||||||
|
|
||||||
|
Assign(universe);
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
@@ -1,11 +1,14 @@
|
|||||||
using System;
|
using System;
|
||||||
|
using System.Collections.Generic;
|
||||||
|
|
||||||
namespace Syntriax.Engine.Core;
|
namespace Syntriax.Engine.Core;
|
||||||
|
|
||||||
public class BehaviourCollectorSorted<T> : BehaviourCollector<T> where T : class
|
public class BehaviourCollectorSorted<T> : BehaviourCollector<T> where T : class
|
||||||
{
|
{
|
||||||
private Comparison<T>? _sortBy = null;
|
private readonly Event<IBehaviour, IBehaviour.PriorityChangedArguments>.EventHandler delegateOnPriorityChanged = null!;
|
||||||
public Comparison<T>? SortBy
|
|
||||||
|
private IComparer<T>? _sortBy = null;
|
||||||
|
public IComparer<T>? SortBy
|
||||||
{
|
{
|
||||||
get => _sortBy;
|
get => _sortBy;
|
||||||
set
|
set
|
||||||
@@ -17,12 +20,48 @@ public class BehaviourCollectorSorted<T> : BehaviourCollector<T> where T : class
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
protected override void OnBehaviourAdd(IBehaviour behaviour)
|
protected override void AddBehaviour(T behaviour)
|
||||||
{
|
{
|
||||||
if (SortBy is not null)
|
if (SortBy is null)
|
||||||
behaviours.Sort(SortBy);
|
{
|
||||||
|
behaviours.Add(behaviour);
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
int insertionIndex = behaviours.BinarySearch(behaviour, SortBy);
|
||||||
|
|
||||||
|
if (insertionIndex < 0)
|
||||||
|
insertionIndex = ~insertionIndex;
|
||||||
|
|
||||||
|
behaviours.Insert(insertionIndex, behaviour);
|
||||||
}
|
}
|
||||||
|
|
||||||
public BehaviourCollectorSorted() { }
|
protected override void OnBehaviourAdd(IBehaviour behaviour)
|
||||||
public BehaviourCollectorSorted(IUniverse universe, Comparison<T> sortBy) : base(universe) => SortBy = sortBy;
|
{
|
||||||
|
behaviour.OnPriorityChanged.AddListener(delegateOnPriorityChanged);
|
||||||
|
}
|
||||||
|
|
||||||
|
protected override void OnBehaviourRemove(IBehaviour behaviour)
|
||||||
|
{
|
||||||
|
behaviour.OnPriorityChanged.RemoveListener(delegateOnPriorityChanged);
|
||||||
|
}
|
||||||
|
|
||||||
|
private void OnPriorityChanged(IBehaviour sender, IBehaviour.PriorityChangedArguments args)
|
||||||
|
{
|
||||||
|
T behaviour = (T)sender;
|
||||||
|
behaviours.Remove(behaviour);
|
||||||
|
AddBehaviour(behaviour);
|
||||||
|
}
|
||||||
|
|
||||||
|
public BehaviourCollectorSorted()
|
||||||
|
{
|
||||||
|
delegateOnPriorityChanged = OnPriorityChanged;
|
||||||
|
}
|
||||||
|
|
||||||
|
public BehaviourCollectorSorted(IUniverse universe, Comparison<T> sortBy) : base(universe)
|
||||||
|
{
|
||||||
|
delegateOnPriorityChanged = OnPriorityChanged;
|
||||||
|
|
||||||
|
SortBy = Comparer<T>.Create(sortBy);
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
@@ -1,64 +1,42 @@
|
|||||||
using System;
|
using System;
|
||||||
using System.Collections;
|
|
||||||
using System.Collections.Generic;
|
using System.Collections.Generic;
|
||||||
using System.Linq;
|
|
||||||
|
|
||||||
namespace Syntriax.Engine.Core;
|
namespace Syntriax.Engine.Core;
|
||||||
|
|
||||||
[System.Diagnostics.DebuggerDisplay("Behaviour Count: {behaviours.Count}")]
|
[System.Diagnostics.DebuggerDisplay("Behaviour Count: {behaviours.Count}")]
|
||||||
public class BehaviourController : IBehaviourController
|
public class BehaviourController : BaseEntity, IBehaviourController
|
||||||
{
|
{
|
||||||
public event IBehaviourController.PreUpdateEventHandler? OnPreUpdate = null;
|
public Event<IBehaviourController, IBehaviourController.BehaviourAddedArguments> OnBehaviourAdded { get; } = new();
|
||||||
public event IBehaviourController.UpdateEventHandler? OnUpdate = null;
|
public Event<IBehaviourController, IBehaviourController.BehaviourRemovedArguments> OnBehaviourRemoved { get; } = new();
|
||||||
public event IBehaviourController.PreDrawEventHandler? OnPreDraw = null;
|
public Event<IHasUniverseObject> OnUniverseObjectAssigned { get; } = new();
|
||||||
|
|
||||||
public event IBehaviourController.BehaviourAddedEventHandler? OnBehaviourAdded = null;
|
private readonly List<IBehaviour> behaviours = new(Constants.BEHAVIOURS_SIZE_INITIAL);
|
||||||
public event IBehaviourController.BehaviourRemovedEventHandler? OnBehaviourRemoved = null;
|
|
||||||
public event IHasUniverseObject.UniverseObjectAssignedEventHandler? OnUniverseObjectAssigned = null;
|
|
||||||
|
|
||||||
public event IInitializable.InitializedEventHandler? OnInitialized = null;
|
|
||||||
public event IInitializable.FinalizedEventHandler? OnFinalized = null;
|
|
||||||
|
|
||||||
public event IAssignable.UnassignEventHandler? OnUnassigned = null;
|
|
||||||
|
|
||||||
private readonly IList<IBehaviour> behaviours = new List<IBehaviour>(Constants.BEHAVIOURS_SIZE_INITIAL);
|
|
||||||
|
|
||||||
private IUniverseObject _universeObject = null!;
|
private IUniverseObject _universeObject = null!;
|
||||||
private bool _initialized = false;
|
|
||||||
|
|
||||||
public IUniverseObject UniverseObject => _universeObject;
|
public IUniverseObject UniverseObject => _universeObject;
|
||||||
|
public int Count => behaviours.Count;
|
||||||
public bool IsInitialized
|
public IBehaviour this[Index index] => behaviours[index];
|
||||||
{
|
|
||||||
get => _initialized;
|
|
||||||
private set
|
|
||||||
{
|
|
||||||
if (value == _initialized)
|
|
||||||
return;
|
|
||||||
|
|
||||||
_initialized = value;
|
|
||||||
if (value)
|
|
||||||
OnInitialized?.InvokeSafe(this);
|
|
||||||
else
|
|
||||||
OnFinalized?.InvokeSafe(this);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
public T AddBehaviour<T>(T behaviour) where T : class, IBehaviour
|
public T AddBehaviour<T>(T behaviour) where T : class, IBehaviour
|
||||||
{
|
{
|
||||||
InsertBehaviourByPriority(behaviour);
|
InsertBehaviourByPriority(behaviour);
|
||||||
|
|
||||||
behaviour.Assign(this);
|
behaviour.Assign(this);
|
||||||
behaviour.Assign(Factory.StateEnableFactory.Instantiate(behaviour));
|
|
||||||
|
|
||||||
behaviour.Initialize();
|
if (IsInitialized)
|
||||||
behaviour.OnPriorityChanged += OnPriorityChange;
|
behaviour.Initialize();
|
||||||
OnBehaviourAdded?.InvokeSafe(this, behaviour);
|
|
||||||
|
behaviour.OnPriorityChanged.AddListener(OnPriorityChange);
|
||||||
|
OnBehaviourAdded?.Invoke(this, new(behaviour));
|
||||||
return behaviour;
|
return behaviour;
|
||||||
}
|
}
|
||||||
|
|
||||||
public T AddBehaviour<T>(params object?[]? args) where T : class, IBehaviour
|
public T AddBehaviour<T>(params object?[]? args) where T : class, IBehaviour
|
||||||
=> AddBehaviour(Factory.BehaviourFactory.Instantiate<T>(_universeObject, args));
|
{
|
||||||
|
T behaviour = Factory.BehaviourFactory.Instantiate<T>(args);
|
||||||
|
return AddBehaviour(behaviour);
|
||||||
|
}
|
||||||
|
|
||||||
public T? GetBehaviour<T>()
|
public T? GetBehaviour<T>()
|
||||||
{
|
{
|
||||||
@@ -71,17 +49,13 @@ public class BehaviourController : IBehaviourController
|
|||||||
|
|
||||||
public IReadOnlyList<T> GetBehaviours<T>()
|
public IReadOnlyList<T> GetBehaviours<T>()
|
||||||
{
|
{
|
||||||
List<T>? behaviours = null;
|
List<T> behaviours = [];
|
||||||
|
|
||||||
foreach (IBehaviour behaviourItem in this.behaviours)
|
foreach (IBehaviour behaviourItem in this.behaviours)
|
||||||
{
|
if (behaviourItem is T behaviour)
|
||||||
if (behaviourItem is not T behaviour)
|
behaviours.Add(behaviour);
|
||||||
continue;
|
|
||||||
|
|
||||||
behaviours ??= [];
|
return behaviours;
|
||||||
behaviours.Add(behaviour);
|
|
||||||
}
|
|
||||||
|
|
||||||
return behaviours ?? Enumerable.Empty<T>().ToList();
|
|
||||||
}
|
}
|
||||||
|
|
||||||
public void GetBehaviours<T>(IList<T> results)
|
public void GetBehaviours<T>(IList<T> results)
|
||||||
@@ -98,7 +72,7 @@ public class BehaviourController : IBehaviourController
|
|||||||
|
|
||||||
public void RemoveBehaviour<T>(bool removeAll = false) where T : class, IBehaviour
|
public void RemoveBehaviour<T>(bool removeAll = false) where T : class, IBehaviour
|
||||||
{
|
{
|
||||||
for (int i = behaviours.Count; i >= 0; i--)
|
for (int i = behaviours.Count - 1; i >= 0; i--)
|
||||||
{
|
{
|
||||||
if (behaviours[i] is not T behaviour)
|
if (behaviours[i] is not T behaviour)
|
||||||
continue;
|
continue;
|
||||||
@@ -115,10 +89,10 @@ public class BehaviourController : IBehaviourController
|
|||||||
if (!behaviours.Contains(behaviour))
|
if (!behaviours.Contains(behaviour))
|
||||||
throw new Exception($"{behaviour.GetType().Name} does not exist in {UniverseObject.Name}'s {nameof(IBehaviourController)}.");
|
throw new Exception($"{behaviour.GetType().Name} does not exist in {UniverseObject.Name}'s {nameof(IBehaviourController)}.");
|
||||||
|
|
||||||
behaviour.OnPriorityChanged -= OnPriorityChange;
|
behaviour.OnPriorityChanged.RemoveListener(OnPriorityChange);
|
||||||
behaviour.Finalize();
|
behaviour.Finalize();
|
||||||
behaviours.Remove(behaviour);
|
behaviours.Remove(behaviour);
|
||||||
OnBehaviourRemoved?.InvokeSafe(this, behaviour);
|
OnBehaviourRemoved?.Invoke(this, new(behaviour));
|
||||||
}
|
}
|
||||||
|
|
||||||
protected virtual void OnAssign(IUniverseObject universeObject) { }
|
protected virtual void OnAssign(IUniverseObject universeObject) { }
|
||||||
@@ -129,61 +103,22 @@ public class BehaviourController : IBehaviourController
|
|||||||
|
|
||||||
_universeObject = universeObject;
|
_universeObject = universeObject;
|
||||||
OnAssign(universeObject);
|
OnAssign(universeObject);
|
||||||
OnUniverseObjectAssigned?.InvokeSafe(this);
|
OnUniverseObjectAssigned?.Invoke(this);
|
||||||
return true;
|
return true;
|
||||||
}
|
}
|
||||||
|
|
||||||
public bool Initialize()
|
protected override void InitializeInternal()
|
||||||
{
|
{
|
||||||
if (IsInitialized)
|
Debug.Assert.AssertUniverseObjectAssigned(this);
|
||||||
return false;
|
|
||||||
|
|
||||||
Debug.AssertHelpers.AssertUniverseObjectAssigned(this);
|
|
||||||
|
|
||||||
foreach (IBehaviour behaviour in behaviours)
|
foreach (IBehaviour behaviour in behaviours)
|
||||||
behaviour.Initialize();
|
behaviour.Initialize();
|
||||||
|
|
||||||
IsInitialized = true;
|
|
||||||
return true;
|
|
||||||
}
|
}
|
||||||
|
|
||||||
public bool Finalize()
|
protected override void FinalizeInternal()
|
||||||
{
|
{
|
||||||
if (!IsInitialized)
|
|
||||||
return false;
|
|
||||||
|
|
||||||
foreach (IBehaviour behaviour in behaviours)
|
foreach (IBehaviour behaviour in behaviours)
|
||||||
behaviour.Finalize();
|
behaviour.Finalize();
|
||||||
|
|
||||||
IsInitialized = false;
|
|
||||||
return true;
|
|
||||||
}
|
|
||||||
|
|
||||||
public bool Unassign()
|
|
||||||
{
|
|
||||||
if (IsInitialized)
|
|
||||||
return false;
|
|
||||||
|
|
||||||
_universeObject = null!;
|
|
||||||
OnUnassigned?.InvokeSafe(this);
|
|
||||||
return true;
|
|
||||||
}
|
|
||||||
|
|
||||||
public void Update()
|
|
||||||
{
|
|
||||||
if (!UniverseObject.StateEnable.Enabled)
|
|
||||||
return;
|
|
||||||
|
|
||||||
OnPreUpdate?.InvokeSafe(this);
|
|
||||||
OnUpdate?.InvokeSafe(this);
|
|
||||||
}
|
|
||||||
|
|
||||||
public void UpdatePreDraw()
|
|
||||||
{
|
|
||||||
if (!UniverseObject.StateEnable.Enabled)
|
|
||||||
return;
|
|
||||||
|
|
||||||
OnPreDraw?.InvokeSafe(this);
|
|
||||||
}
|
}
|
||||||
|
|
||||||
public BehaviourController() { }
|
public BehaviourController() { }
|
||||||
@@ -206,12 +141,9 @@ public class BehaviourController : IBehaviourController
|
|||||||
behaviours.Add(behaviour);
|
behaviours.Add(behaviour);
|
||||||
}
|
}
|
||||||
|
|
||||||
private void OnPriorityChange(IBehaviour sender, int previousPriority)
|
private void OnPriorityChange(IBehaviour sender, IBehaviour.PriorityChangedArguments args)
|
||||||
{
|
{
|
||||||
behaviours.Remove(sender);
|
behaviours.Remove(sender);
|
||||||
InsertBehaviourByPriority(sender);
|
InsertBehaviourByPriority(sender);
|
||||||
}
|
}
|
||||||
|
|
||||||
public IEnumerator<IBehaviour> GetEnumerator() => behaviours.GetEnumerator();
|
|
||||||
IEnumerator IEnumerable.GetEnumerator() => behaviours.GetEnumerator();
|
|
||||||
}
|
}
|
||||||
|
@@ -3,7 +3,7 @@ using System.Collections.Generic;
|
|||||||
|
|
||||||
namespace Syntriax.Engine.Core;
|
namespace Syntriax.Engine.Core;
|
||||||
|
|
||||||
public class CoroutineManager : UniverseObject
|
public class CoroutineManager : Behaviour, IUpdate
|
||||||
{
|
{
|
||||||
private readonly List<IEnumerator> enumerators = [];
|
private readonly List<IEnumerator> enumerators = [];
|
||||||
|
|
||||||
@@ -18,17 +18,7 @@ public class CoroutineManager : UniverseObject
|
|||||||
enumerators.Remove(enumerator);
|
enumerators.Remove(enumerator);
|
||||||
}
|
}
|
||||||
|
|
||||||
protected override void OnEnteringUniverse(IUniverse universe)
|
void IUpdate.Update()
|
||||||
{
|
|
||||||
universe.OnUpdate += OnUpdate;
|
|
||||||
}
|
|
||||||
|
|
||||||
protected override void OnExitingUniverse(IUniverse universe)
|
|
||||||
{
|
|
||||||
universe.OnUpdate -= OnUpdate;
|
|
||||||
}
|
|
||||||
|
|
||||||
private void OnUpdate(IUniverse sender, UniverseTime time)
|
|
||||||
{
|
{
|
||||||
for (int i = enumerators.Count - 1; i >= 0; i--)
|
for (int i = enumerators.Count - 1; i >= 0; i--)
|
||||||
{
|
{
|
||||||
@@ -39,4 +29,6 @@ public class CoroutineManager : UniverseObject
|
|||||||
enumerators.RemoveAt(i);
|
enumerators.RemoveAt(i);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
public CoroutineManager() => Priority = int.MinValue;
|
||||||
}
|
}
|
||||||
|
@@ -2,7 +2,7 @@ using System.Runtime.CompilerServices;
|
|||||||
|
|
||||||
namespace Syntriax.Engine.Core.Debug;
|
namespace Syntriax.Engine.Core.Debug;
|
||||||
|
|
||||||
public class AssertHelpers
|
public static class Assert
|
||||||
{
|
{
|
||||||
[MethodImpl(MethodImplOptions.AggressiveInlining)]
|
[MethodImpl(MethodImplOptions.AggressiveInlining)]
|
||||||
public static void AssertInitialized(IInitializable initializable)
|
public static void AssertInitialized(IInitializable initializable)
|
||||||
@@ -10,21 +10,21 @@ public class AssertHelpers
|
|||||||
|
|
||||||
[MethodImpl(MethodImplOptions.AggressiveInlining)]
|
[MethodImpl(MethodImplOptions.AggressiveInlining)]
|
||||||
public static void AssertBehaviourControllerAssigned(IHasBehaviourController assignable)
|
public static void AssertBehaviourControllerAssigned(IHasBehaviourController assignable)
|
||||||
=> System.Diagnostics.Debug.Assert(assignable.BehaviourController is not null, $"{assignable.GetType().Name} must be initialized");
|
=> System.Diagnostics.Debug.Assert(assignable.BehaviourController is not null, $"{assignable.GetType().Name} must be assigned an {nameof(IBehaviourController)}");
|
||||||
|
|
||||||
[MethodImpl(MethodImplOptions.AggressiveInlining)]
|
[MethodImpl(MethodImplOptions.AggressiveInlining)]
|
||||||
public static void AssertEntityAssigned(IHasEntity assignable)
|
public static void AssertEntityAssigned(IHasEntity assignable)
|
||||||
=> System.Diagnostics.Debug.Assert(assignable.Entity is not null, $"{assignable.GetType().Name} must be initialized");
|
=> System.Diagnostics.Debug.Assert(assignable.Entity is not null, $"{assignable.GetType().Name} must be assigned an {nameof(IEntity)}");
|
||||||
|
|
||||||
[MethodImpl(MethodImplOptions.AggressiveInlining)]
|
[MethodImpl(MethodImplOptions.AggressiveInlining)]
|
||||||
public static void AssertUniverseAssigned(IHasUniverse assignable)
|
public static void AssertUniverseAssigned(IHasUniverse assignable)
|
||||||
=> System.Diagnostics.Debug.Assert(assignable.Universe is not null, $"{assignable.GetType().Name} must be initialized");
|
=> System.Diagnostics.Debug.Assert(assignable.Universe is not null, $"{assignable.GetType().Name} must be assigned an {nameof(IUniverse)}");
|
||||||
|
|
||||||
[MethodImpl(MethodImplOptions.AggressiveInlining)]
|
[MethodImpl(MethodImplOptions.AggressiveInlining)]
|
||||||
public static void AssertUniverseObjectAssigned(IHasUniverseObject assignable)
|
public static void AssertUniverseObjectAssigned(IHasUniverseObject assignable)
|
||||||
=> System.Diagnostics.Debug.Assert(assignable.UniverseObject is not null, $"{assignable.GetType().Name} must be initialized");
|
=> System.Diagnostics.Debug.Assert(assignable.UniverseObject is not null, $"{assignable.GetType().Name} must be assigned an {nameof(IUniverseObject)}");
|
||||||
|
|
||||||
[MethodImpl(MethodImplOptions.AggressiveInlining)]
|
[MethodImpl(MethodImplOptions.AggressiveInlining)]
|
||||||
public static void AssertStateEnableAssigned(IHasStateEnable assignable)
|
public static void AssertStateEnableAssigned(IHasStateEnable assignable)
|
||||||
=> System.Diagnostics.Debug.Assert(assignable.StateEnable is not null, $"{assignable.GetType().Name} must be initialized");
|
=> System.Diagnostics.Debug.Assert(assignable.StateEnable is not null, $"{assignable.GetType().Name} must be assigned an {nameof(IStateEnable)}");
|
||||||
}
|
}
|
8
Engine.Core/Debug/ConsoleLogger.cs
Normal file
8
Engine.Core/Debug/ConsoleLogger.cs
Normal file
@@ -0,0 +1,8 @@
|
|||||||
|
using System;
|
||||||
|
|
||||||
|
namespace Syntriax.Engine.Core.Debug;
|
||||||
|
|
||||||
|
public class ConsoleLogger : LoggerBase
|
||||||
|
{
|
||||||
|
protected override void Write(string message) => Console.WriteLine(message);
|
||||||
|
}
|
29
Engine.Core/Debug/FileLogger.cs
Normal file
29
Engine.Core/Debug/FileLogger.cs
Normal file
@@ -0,0 +1,29 @@
|
|||||||
|
using System;
|
||||||
|
using System.IO;
|
||||||
|
|
||||||
|
namespace Syntriax.Engine.Core.Debug;
|
||||||
|
|
||||||
|
public class FileLogger : LoggerBase
|
||||||
|
{
|
||||||
|
public readonly string FilePath;
|
||||||
|
|
||||||
|
protected override void Write(string message)
|
||||||
|
{
|
||||||
|
File.AppendAllTextAsync(FilePath, $"{message}{Environment.NewLine}");
|
||||||
|
}
|
||||||
|
|
||||||
|
public FileLogger(string filePath)
|
||||||
|
{
|
||||||
|
FilePath = filePath;
|
||||||
|
|
||||||
|
bool isRelativePath = Path.GetFullPath(filePath).CompareTo(filePath) != 0;
|
||||||
|
|
||||||
|
if (isRelativePath)
|
||||||
|
FilePath = Path.GetFullPath(Path.Combine(AppDomain.CurrentDomain.BaseDirectory, filePath));
|
||||||
|
|
||||||
|
if (Path.GetDirectoryName(FilePath) is string directoryPath)
|
||||||
|
Directory.CreateDirectory(directoryPath);
|
||||||
|
|
||||||
|
File.Open(FilePath, FileMode.Create).Close();
|
||||||
|
}
|
||||||
|
}
|
18
Engine.Core/Debug/ILogger.cs
Normal file
18
Engine.Core/Debug/ILogger.cs
Normal file
@@ -0,0 +1,18 @@
|
|||||||
|
namespace Syntriax.Engine.Core.Debug;
|
||||||
|
|
||||||
|
public interface ILogger
|
||||||
|
{
|
||||||
|
static ILogger Shared { get; set; } = new ConsoleLogger();
|
||||||
|
|
||||||
|
Level FilterLevel { get; set; }
|
||||||
|
|
||||||
|
void Log(string message, Level level = Level.Info, bool force = false);
|
||||||
|
|
||||||
|
enum Level
|
||||||
|
{
|
||||||
|
Trace,
|
||||||
|
Info,
|
||||||
|
Warning,
|
||||||
|
Error,
|
||||||
|
};
|
||||||
|
}
|
20
Engine.Core/Debug/LoggerBase.cs
Normal file
20
Engine.Core/Debug/LoggerBase.cs
Normal file
@@ -0,0 +1,20 @@
|
|||||||
|
using System;
|
||||||
|
|
||||||
|
namespace Syntriax.Engine.Core.Debug;
|
||||||
|
|
||||||
|
public abstract class LoggerBase : ILogger
|
||||||
|
{
|
||||||
|
public ILogger.Level FilterLevel { get; set; } = ILogger.Level.Trace;
|
||||||
|
|
||||||
|
public void Log(string message, ILogger.Level level = ILogger.Level.Info, bool force = false)
|
||||||
|
{
|
||||||
|
if (!force && level < FilterLevel)
|
||||||
|
return;
|
||||||
|
|
||||||
|
string timestamp = DateTime.Now.ToString("yyyy-MM-dd hh:mm:ss tt");
|
||||||
|
|
||||||
|
Write($"[{timestamp}] [{level}] \t{message}");
|
||||||
|
}
|
||||||
|
|
||||||
|
protected abstract void Write(string message);
|
||||||
|
}
|
9
Engine.Core/Debug/LoggerContainer.cs
Normal file
9
Engine.Core/Debug/LoggerContainer.cs
Normal file
@@ -0,0 +1,9 @@
|
|||||||
|
namespace Syntriax.Engine.Core.Debug;
|
||||||
|
|
||||||
|
public class LoggerContainer : Behaviour, ILogger
|
||||||
|
{
|
||||||
|
public ILogger Logger { get; set; } = ILogger.Shared;
|
||||||
|
|
||||||
|
public ILogger.Level FilterLevel { get => Logger.FilterLevel; set => Logger.FilterLevel = value; }
|
||||||
|
public void Log(string message, ILogger.Level level = ILogger.Level.Info, bool force = false) => Logger.Log(message, level, force);
|
||||||
|
}
|
36
Engine.Core/Debug/LoggerExtensions.cs
Normal file
36
Engine.Core/Debug/LoggerExtensions.cs
Normal file
@@ -0,0 +1,36 @@
|
|||||||
|
using System;
|
||||||
|
using System.Diagnostics;
|
||||||
|
|
||||||
|
namespace Syntriax.Engine.Core.Debug;
|
||||||
|
|
||||||
|
public static class LoggerExtensions
|
||||||
|
{
|
||||||
|
public static void Log<T>(this ILogger logger, T caller, string message, ILogger.Level level = ILogger.Level.Info, bool force = false)
|
||||||
|
{
|
||||||
|
string body = $"{caller?.GetType().Name ?? typeof(T).Name}: {message}";
|
||||||
|
logger.Log(body, level, force);
|
||||||
|
}
|
||||||
|
|
||||||
|
public static void LogWarning<T>(this ILogger logger, T caller, string message, bool force = false) => Log(logger, caller, message, ILogger.Level.Info, force);
|
||||||
|
|
||||||
|
public static void LogError<T>(this ILogger logger, T caller, string message, bool force = false)
|
||||||
|
{
|
||||||
|
Log(logger, caller, message, ILogger.Level.Error, force);
|
||||||
|
LogTrace(logger, caller, new StackTrace(), force);
|
||||||
|
}
|
||||||
|
|
||||||
|
public static void LogException<T>(this ILogger logger, T caller, Exception exception, bool force = false)
|
||||||
|
{
|
||||||
|
Log(logger, caller, $"Exception of type {exception.GetType().Name} occured", ILogger.Level.Error, force);
|
||||||
|
Log(logger, caller, $"Message: {exception.Message}", ILogger.Level.Error, force);
|
||||||
|
Log(logger, caller, $"InnerException: {exception.InnerException}", ILogger.Level.Error, force);
|
||||||
|
|
||||||
|
// Not using LogTrace because exception.StackTrace is a type of string
|
||||||
|
Log(logger, caller, $"{nameof(StackTrace)}:{Environment.NewLine}{exception.StackTrace}", ILogger.Level.Trace);
|
||||||
|
}
|
||||||
|
|
||||||
|
public static void LogTrace<T>(this ILogger logger, T caller, StackTrace? stackTrace = null, bool force = false)
|
||||||
|
{
|
||||||
|
Log(logger, caller, $"{nameof(StackTrace)}:{Environment.NewLine}{stackTrace ?? new()}", ILogger.Level.Trace, force);
|
||||||
|
}
|
||||||
|
}
|
23
Engine.Core/Debug/LoggerWrapper.cs
Normal file
23
Engine.Core/Debug/LoggerWrapper.cs
Normal file
@@ -0,0 +1,23 @@
|
|||||||
|
namespace Syntriax.Engine.Core.Debug;
|
||||||
|
|
||||||
|
public class LoggerWrapper(ILogger firstLogger, ILogger secondLogger) : ILogger
|
||||||
|
{
|
||||||
|
private readonly ILogger firstLogger = firstLogger;
|
||||||
|
private readonly ILogger secondLogger = secondLogger;
|
||||||
|
|
||||||
|
public ILogger.Level FilterLevel
|
||||||
|
{
|
||||||
|
get => firstLogger.FilterLevel;
|
||||||
|
set
|
||||||
|
{
|
||||||
|
firstLogger.FilterLevel = value;
|
||||||
|
secondLogger.FilterLevel = value;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public void Log(string message, ILogger.Level level = ILogger.Level.Info, bool force = false)
|
||||||
|
{
|
||||||
|
firstLogger.Log(message, level, force);
|
||||||
|
secondLogger.Log(message, level, force);
|
||||||
|
}
|
||||||
|
}
|
6
Engine.Core/Debug/LoggerWrapperExtensions.cs
Normal file
6
Engine.Core/Debug/LoggerWrapperExtensions.cs
Normal file
@@ -0,0 +1,6 @@
|
|||||||
|
namespace Syntriax.Engine.Core.Debug;
|
||||||
|
|
||||||
|
public static class LoggerWrapperExtensions
|
||||||
|
{
|
||||||
|
public static ILogger WrapWith(this ILogger thisLogger, ILogger logger) => new LoggerWrapper(thisLogger, logger);
|
||||||
|
}
|
@@ -1,7 +1,7 @@
|
|||||||
<Project Sdk="Microsoft.NET.Sdk">
|
<Project Sdk="Microsoft.NET.Sdk">
|
||||||
|
|
||||||
<PropertyGroup>
|
<PropertyGroup>
|
||||||
<TargetFramework>net8.0</TargetFramework>
|
<TargetFramework>net9.0</TargetFramework>
|
||||||
<ImplicitUsings>false</ImplicitUsings>
|
<ImplicitUsings>false</ImplicitUsings>
|
||||||
<Nullable>enable</Nullable>
|
<Nullable>enable</Nullable>
|
||||||
<RootNamespace>Syntriax.Engine.Core</RootNamespace>
|
<RootNamespace>Syntriax.Engine.Core</RootNamespace>
|
||||||
|
@@ -1,9 +1,3 @@
|
|||||||
using System;
|
|
||||||
|
|
||||||
namespace Syntriax.Engine.Core.Exceptions;
|
namespace Syntriax.Engine.Core.Exceptions;
|
||||||
|
|
||||||
public class BehaviourNotFoundException(string? message) : Exception(message)
|
public class BehaviourNotFoundException(string? message) : NotFoundException(message);
|
||||||
{
|
|
||||||
public static NotAssignedException FromType<TBehaviour>()
|
|
||||||
=> new($"{typeof(TBehaviour).FullName} was not found");
|
|
||||||
}
|
|
||||||
|
9
Engine.Core/Exceptions/NotFoundException.cs
Normal file
9
Engine.Core/Exceptions/NotFoundException.cs
Normal file
@@ -0,0 +1,9 @@
|
|||||||
|
using System;
|
||||||
|
|
||||||
|
namespace Syntriax.Engine.Core.Exceptions;
|
||||||
|
|
||||||
|
public class NotFoundException(string? message) : Exception(message)
|
||||||
|
{
|
||||||
|
public static NotAssignedException FromType<T>()
|
||||||
|
=> new($"{typeof(T).FullName} was not found");
|
||||||
|
}
|
@@ -1,9 +1,3 @@
|
|||||||
using System;
|
|
||||||
|
|
||||||
namespace Syntriax.Engine.Core.Exceptions;
|
namespace Syntriax.Engine.Core.Exceptions;
|
||||||
|
|
||||||
public class UniverseObjectNotFoundException(string? message) : Exception(message)
|
public class UniverseObjectNotFoundException(string? message) : NotFoundException(message);
|
||||||
{
|
|
||||||
public static NotAssignedException FromType<TUniverseObject>()
|
|
||||||
=> new($"{typeof(TUniverseObject).FullName} was not found");
|
|
||||||
}
|
|
||||||
|
@@ -1,3 +1,4 @@
|
|||||||
|
using System.Collections.Generic;
|
||||||
using System.Diagnostics.CodeAnalysis;
|
using System.Diagnostics.CodeAnalysis;
|
||||||
|
|
||||||
using Syntriax.Engine.Core.Exceptions;
|
using Syntriax.Engine.Core.Exceptions;
|
||||||
@@ -26,7 +27,7 @@ public static class BehaviourControllerExtensions
|
|||||||
/// <param name="behaviourController">The <see cref="IBehaviourController"/> to start searching from.</param>
|
/// <param name="behaviourController">The <see cref="IBehaviourController"/> to start searching from.</param>
|
||||||
/// <returns>The <see cref="IBehaviour"/> of the specified type if found; otherwise, throws <see cref="BehaviourNotFoundException"/>.</returns>
|
/// <returns>The <see cref="IBehaviour"/> of the specified type if found; otherwise, throws <see cref="BehaviourNotFoundException"/>.</returns>
|
||||||
public static T GetRequiredBehaviour<T>(this IBehaviourController behaviourController) where T : class
|
public static T GetRequiredBehaviour<T>(this IBehaviourController behaviourController) where T : class
|
||||||
=> behaviourController.GetBehaviour<T>() ?? throw new BehaviourNotFoundException($"{behaviourController.UniverseObject.Name}'s {nameof(IBehaviourController)} does not contain any {typeof(T).FullName}");
|
=> behaviourController.GetBehaviour<T>() ?? throw new BehaviourNotFoundException($"{behaviourController.UniverseObject?.Name ?? "NULL"}'s {nameof(IBehaviourController)} does not contain any {typeof(T).FullName}");
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Gets an existing <see cref="IBehaviour"/> of the specified type, or adds and returns a new one if it doesn't exist.
|
/// Gets an existing <see cref="IBehaviour"/> of the specified type, or adds and returns a new one if it doesn't exist.
|
||||||
@@ -38,6 +39,19 @@ public static class BehaviourControllerExtensions
|
|||||||
public static T GetOrAddBehaviour<T>(this IBehaviourController behaviourController, params object?[]? args) where T : class, IBehaviour
|
public static T GetOrAddBehaviour<T>(this IBehaviourController behaviourController, params object?[]? args) where T : class, IBehaviour
|
||||||
=> behaviourController.GetBehaviour<T>() ?? behaviourController.AddBehaviour<T>(args);
|
=> behaviourController.GetBehaviour<T>() ?? behaviourController.AddBehaviour<T>(args);
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Gets an existing <see cref="IBehaviour"/> of the specified type, or adds and returns the fallback type if it doesn't exist.
|
||||||
|
/// </summary>
|
||||||
|
/// <typeparam name="TOriginal">The type of <see cref="IBehaviour"/> to get.</typeparam>
|
||||||
|
/// <typeparam name="TFallback">The type of <see cref="IBehaviour"/> to add. It must be assignable from <typeparamref name="TOriginal"/></typeparam>
|
||||||
|
/// <param name="behaviourController">The <see cref="IBehaviourController"/> to search in.</param>
|
||||||
|
/// <param name="args">Optional arguments to pass to the constructor of the <see cref="IBehaviour"/> if a new one is added.</param>
|
||||||
|
/// <returns>The existing or newly added <see cref="IBehaviour"/> of the specified type.</returns>
|
||||||
|
public static TOriginal GetOrAddBehaviour<TOriginal, TFallback>(this IBehaviourController behaviourController, params object?[]? args)
|
||||||
|
where TOriginal : class
|
||||||
|
where TFallback : class, IBehaviour, TOriginal
|
||||||
|
=> behaviourController.GetBehaviour<TOriginal>() ?? behaviourController.AddBehaviour<TFallback>(args);
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Tries to get a <see cref="IBehaviour"/> of the specified type in it's <see cref="IUniverseObject"/>'s parents recursively.
|
/// Tries to get a <see cref="IBehaviour"/> of the specified type in it's <see cref="IUniverseObject"/>'s parents recursively.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
@@ -79,7 +93,28 @@ public static class BehaviourControllerExtensions
|
|||||||
/// <param name="behaviourController">The <see cref="IBehaviourController"/> to start searching from.</param>
|
/// <param name="behaviourController">The <see cref="IBehaviourController"/> to start searching from.</param>
|
||||||
/// <returns>The <see cref="IBehaviour"/> of the specified type if found; otherwise, throws <see cref="BehaviourNotFoundException"/>.</returns>
|
/// <returns>The <see cref="IBehaviour"/> of the specified type if found; otherwise, throws <see cref="BehaviourNotFoundException"/>.</returns>
|
||||||
public static T GetRequiredBehaviourInParent<T>(this IBehaviourController behaviourController) where T : class
|
public static T GetRequiredBehaviourInParent<T>(this IBehaviourController behaviourController) where T : class
|
||||||
=> behaviourController.GetBehaviourInParent<T>() ?? throw new BehaviourNotFoundException($"{behaviourController.UniverseObject.Name}'s {nameof(IBehaviourController)} does not contain any {typeof(T).FullName} on any parent");
|
=> behaviourController.GetBehaviourInParent<T>() ?? throw new BehaviourNotFoundException($"{behaviourController.UniverseObject?.Name ?? "NULL"}'s {nameof(IBehaviourController)} does not contain any {typeof(T).FullName} on any parent");
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Gets all <see cref="IBehaviour"/>s of the specified type in it's <see cref="IUniverseObject"/>'s parents recursively and stores them in the provided list.
|
||||||
|
/// </summary>
|
||||||
|
/// <typeparam name="T">The type of <see cref="IBehaviour"/>s to get.</typeparam>
|
||||||
|
/// <param name="behavioursInParent">The list to store the <see cref="IBehaviour"/>s.</param>
|
||||||
|
public static void GetBehavioursInParent<T>(this IBehaviourController behaviourController, IList<T> behavioursInParent) where T : class
|
||||||
|
{
|
||||||
|
IBehaviourController? controller = behaviourController;
|
||||||
|
List<T> cache = [];
|
||||||
|
behavioursInParent.Clear();
|
||||||
|
|
||||||
|
while (controller is not null)
|
||||||
|
{
|
||||||
|
controller.GetBehaviours(cache);
|
||||||
|
foreach (T behaviour in cache)
|
||||||
|
behavioursInParent.Add(behaviour);
|
||||||
|
|
||||||
|
controller = controller.UniverseObject.Parent?.BehaviourController;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Tries to get a <see cref="IBehaviour"/> of the specified type in it's <see cref="IUniverseObject"/>'s children recursively.
|
/// Tries to get a <see cref="IBehaviour"/> of the specified type in it's <see cref="IUniverseObject"/>'s children recursively.
|
||||||
@@ -105,7 +140,7 @@ public static class BehaviourControllerExtensions
|
|||||||
if (behaviourController.GetBehaviour<T>() is T localBehaviour)
|
if (behaviourController.GetBehaviour<T>() is T localBehaviour)
|
||||||
return localBehaviour;
|
return localBehaviour;
|
||||||
|
|
||||||
foreach (IUniverseObject child in behaviourController.UniverseObject)
|
foreach (IUniverseObject child in behaviourController.UniverseObject.Children)
|
||||||
if (GetBehaviourInChildren<T>(child.BehaviourController) is T behaviour)
|
if (GetBehaviourInChildren<T>(child.BehaviourController) is T behaviour)
|
||||||
return behaviour;
|
return behaviour;
|
||||||
|
|
||||||
@@ -119,5 +154,29 @@ public static class BehaviourControllerExtensions
|
|||||||
/// <param name="behaviourController">The <see cref="IBehaviourController"/> to start searching from.</param>
|
/// <param name="behaviourController">The <see cref="IBehaviourController"/> to start searching from.</param>
|
||||||
/// <returns>The <see cref="IBehaviour"/> of the specified type if found; otherwise, throws <see cref="BehaviourNotFoundException"/>.</returns>
|
/// <returns>The <see cref="IBehaviour"/> of the specified type if found; otherwise, throws <see cref="BehaviourNotFoundException"/>.</returns>
|
||||||
public static T GetRequiredBehaviourInChildren<T>(this IBehaviourController behaviourController) where T : class
|
public static T GetRequiredBehaviourInChildren<T>(this IBehaviourController behaviourController) where T : class
|
||||||
=> behaviourController.GetBehaviourInChildren<T>() ?? throw new BehaviourNotFoundException($"{behaviourController.UniverseObject.Name}'s {nameof(IBehaviourController)} does not contain any {typeof(T).FullName} on any children ");
|
=> behaviourController.GetBehaviourInChildren<T>() ?? throw new BehaviourNotFoundException($"{behaviourController.UniverseObject?.Name ?? "NULL"}'s {nameof(IBehaviourController)} does not contain any {typeof(T).FullName} on any children ");
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Gets all <see cref="IBehaviour"/>s of the specified type in it's <see cref="IUniverseObject"/>'s children recursively and stores them in the provided list.
|
||||||
|
/// </summary>
|
||||||
|
/// <typeparam name="T">The type of <see cref="IBehaviour"/>s to get.</typeparam>
|
||||||
|
/// <param name="behavioursInChildren">The list to store the <see cref="IBehaviour"/>s.</param>
|
||||||
|
public static void GetBehavioursInChildren<T>(this IBehaviourController behaviourController, IList<T> behavioursInChildren) where T : class
|
||||||
|
{
|
||||||
|
List<T> cache = [];
|
||||||
|
behavioursInChildren.Clear();
|
||||||
|
|
||||||
|
TraverseChildrenForBehaviour(behaviourController.UniverseObject, behavioursInChildren, cache);
|
||||||
|
}
|
||||||
|
|
||||||
|
private static void TraverseChildrenForBehaviour<T>(IUniverseObject universeObject, IList<T> behaviours, IList<T> cache) where T : class
|
||||||
|
{
|
||||||
|
universeObject.BehaviourController.GetBehaviours(cache);
|
||||||
|
|
||||||
|
foreach (T behaviour in cache)
|
||||||
|
behaviours.Add(behaviour);
|
||||||
|
|
||||||
|
foreach (IUniverseObject child in universeObject.Children)
|
||||||
|
TraverseChildrenForBehaviour(child, behaviours, cache);
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
@@ -1,34 +0,0 @@
|
|||||||
using System.Collections.Generic;
|
|
||||||
using System.Diagnostics.CodeAnalysis;
|
|
||||||
|
|
||||||
namespace Syntriax.Engine.Core;
|
|
||||||
|
|
||||||
public static class BehaviourExtensions
|
|
||||||
{
|
|
||||||
public static T? FindBehaviour<T>(this IEnumerable<IUniverseObject> universeObjects) where T : class
|
|
||||||
{
|
|
||||||
foreach (IUniverseObject universeObject in universeObjects)
|
|
||||||
if (universeObject.BehaviourController.GetBehaviour<T>() is T behaviour)
|
|
||||||
return behaviour;
|
|
||||||
|
|
||||||
return default;
|
|
||||||
}
|
|
||||||
|
|
||||||
public static bool TryFindBehaviour<T>(this IEnumerable<IUniverseObject> universeObjects, [NotNullWhen(returnValue: true)] out T? behaviour) where T : class
|
|
||||||
{
|
|
||||||
behaviour = FindBehaviour<T>(universeObjects);
|
|
||||||
return behaviour is not null;
|
|
||||||
}
|
|
||||||
|
|
||||||
public static void FindBehaviours<T>(this IEnumerable<IUniverseObject> universeObjects, List<T> behaviours) where T : class
|
|
||||||
{
|
|
||||||
behaviours.Clear();
|
|
||||||
List<T> cache = [];
|
|
||||||
|
|
||||||
foreach (IUniverseObject universeObject in universeObjects)
|
|
||||||
{
|
|
||||||
universeObject.BehaviourController.GetBehaviours(cache);
|
|
||||||
behaviours.AddRange(cache);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
@@ -7,9 +7,30 @@ public static class UniverseExtensions
|
|||||||
public static IUniverseObject InstantiateUniverseObject(this IUniverse universe, params object?[]? args)
|
public static IUniverseObject InstantiateUniverseObject(this IUniverse universe, params object?[]? args)
|
||||||
=> universe.InstantiateUniverseObject<UniverseObject>(args);
|
=> universe.InstantiateUniverseObject<UniverseObject>(args);
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Searches through all <see cref="IUniverseObject"/>s to find the specified instance of the type.
|
||||||
|
/// </summary>
|
||||||
|
/// <typeparam name="T">Type to be searched through the <see cref="IUniverse"/>.</typeparam>
|
||||||
|
/// <returns>The specified type if found; otherwise, throws <see cref="UniverseObjectNotFoundException"/>.</returns>
|
||||||
public static T GetRequiredUniverseObject<T>(this IUniverse universe) where T : class
|
public static T GetRequiredUniverseObject<T>(this IUniverse universe) where T : class
|
||||||
=> universe.GetUniverseObject<T>() ?? throw new UniverseObjectNotFoundException($"{universe.GetType().FullName}({universe.Id}) does not contain any {nameof(IUniverseObject)} object of type {typeof(T).FullName}");
|
=> universe.GetUniverseObject<T>() ?? throw new UniverseObjectNotFoundException($"{universe.GetType().FullName}({universe.Id}) does not contain any {nameof(IUniverseObject)} object of type {typeof(T).FullName}");
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Searches through all <see cref="IBehaviours"/>s to find the specified instance of the type.
|
||||||
|
/// </summary>
|
||||||
|
/// <typeparam name="T">Type to be searched through the <see cref="IUniverse"/>.</typeparam>
|
||||||
|
/// <returns>The specified type if found; otherwise, throws <see cref="BehaviourNotFoundException"/>.</returns>
|
||||||
public static T FindRequiredBehaviour<T>(this IUniverse universe) where T : class
|
public static T FindRequiredBehaviour<T>(this IUniverse universe) where T : class
|
||||||
=> universe.FindBehaviour<T>() ?? throw new BehaviourNotFoundException($"{universe.GetType().FullName}({universe.Id}) does not contain any {nameof(IUniverseObject)} with {nameof(IBehaviour)} of type {typeof(T).FullName}");
|
=> universe.FindBehaviour<T>() ?? throw new BehaviourNotFoundException($"{universe.GetType().FullName}({universe.Id}) does not contain any {nameof(IUniverseObject)} with {nameof(IBehaviour)} of type {typeof(T).FullName}");
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Searches through all <see cref="IUniverseObject"/>s and <see cref="IBehaviours"/>s to find the specified instance of the type.
|
||||||
|
/// </summary>
|
||||||
|
/// <remarks>
|
||||||
|
/// WARNING: This is more expensive compared to <see cref="GetRequiredUniverseObject{T}(IUniverse)"/> or <see cref="FindRequiredBehaviour{T}(IUniverse)"/> as it combines the two. If you know whether the type is either a type that gets implemented on an <see cref="IBehaviour"/> or <see cref="IUniverseObject"/> use the method appropriate for it for performance.
|
||||||
|
/// </remarks>
|
||||||
|
/// <typeparam name="T">Type to be searched through the <see cref="IUniverse"/>.</typeparam>
|
||||||
|
/// <returns>The specified type if found; otherwise, throws <see cref="NotFoundException"/>.</returns>
|
||||||
|
public static T FindRequired<T>(this IUniverse universe) where T : class
|
||||||
|
=> universe.Find<T>() ?? throw new NotFoundException($"{universe.GetType().FullName}({universe.Id}) does not contain any {nameof(IUniverseObject)} or {nameof(IBehaviour)} of type {typeof(T).FullName}");
|
||||||
}
|
}
|
||||||
|
@@ -1,6 +1,8 @@
|
|||||||
using System.Collections.Generic;
|
using System.Collections.Generic;
|
||||||
using System.Diagnostics.CodeAnalysis;
|
using System.Diagnostics.CodeAnalysis;
|
||||||
|
|
||||||
|
using Syntriax.Engine.Core.Exceptions;
|
||||||
|
|
||||||
namespace Syntriax.Engine.Core;
|
namespace Syntriax.Engine.Core;
|
||||||
|
|
||||||
public static class UniverseObjectExtensions
|
public static class UniverseObjectExtensions
|
||||||
@@ -10,10 +12,17 @@ public static class UniverseObjectExtensions
|
|||||||
if (!string.IsNullOrWhiteSpace(name))
|
if (!string.IsNullOrWhiteSpace(name))
|
||||||
universeObject.Name = name;
|
universeObject.Name = name;
|
||||||
if (parent is not null)
|
if (parent is not null)
|
||||||
universeObject.SetParent(parent);
|
universeObject.Parent = parent;
|
||||||
return universeObject;
|
return universeObject;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
#region Universe Object Search
|
||||||
|
/// <summary>
|
||||||
|
/// Gets a <see cref="IUniverseObject"/> of the specified type.
|
||||||
|
/// </summary>
|
||||||
|
/// <typeparam name="T">The type of <see cref="IUniverseObject"/> to get.</typeparam>
|
||||||
|
/// <param name="universeObjects">The <see cref="IUniverseObject"/>s to search.</param>
|
||||||
|
/// <returns>The first found <see cref="IUniverseObject"/> of the specified type; otherwise, null.</returns>
|
||||||
public static T? GetUniverseObject<T>(this IEnumerable<IUniverseObject> universeObjects) where T : class
|
public static T? GetUniverseObject<T>(this IEnumerable<IUniverseObject> universeObjects) where T : class
|
||||||
{
|
{
|
||||||
foreach (IUniverseObject universeObject in universeObjects)
|
foreach (IUniverseObject universeObject in universeObjects)
|
||||||
@@ -23,17 +32,224 @@ public static class UniverseObjectExtensions
|
|||||||
return default;
|
return default;
|
||||||
}
|
}
|
||||||
|
|
||||||
public static bool TryGetUniverseObject<T>(this IEnumerable<IUniverseObject> universeObjects, [NotNullWhen(returnValue: true)] out T? behaviour) where T : class
|
/// <summary>
|
||||||
|
/// Tries to get a <see cref="IUniverseObject"/> of the specified type.
|
||||||
|
/// </summary>
|
||||||
|
/// <typeparam name="T">The type of <see cref="IUniverseObject"/> to get.</typeparam>
|
||||||
|
/// <param name="universeObjects">The <see cref="IUniverseObject"/>s to search.</param>
|
||||||
|
/// <returns><see cref="true"/> if a <see cref="IUniverseObject"/> of the specified type was found in the universe objects; otherwise, <see cref="false"/>.</returns>
|
||||||
|
public static bool TryGetUniverseObject<T>(this IEnumerable<IUniverseObject> universeObjects, [NotNullWhen(returnValue: true)] out T? universeObject) where T : class
|
||||||
{
|
{
|
||||||
behaviour = GetUniverseObject<T>(universeObjects);
|
universeObject = GetUniverseObject<T>(universeObjects);
|
||||||
|
return universeObject is not null;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Searches through the provided <see cref="IUniverseObject"/>s to collect a list of <see cref="IUniverseObject"/>s of the specified type.
|
||||||
|
/// </summary>
|
||||||
|
/// <typeparam name="T">The type of <see cref="IUniverseObject"/> to get.</typeparam>
|
||||||
|
/// <param name="universeObject">The <see cref="IUniverseObject"/> to search.</param>
|
||||||
|
/// <returns>The found <see cref="IUniverseObject"/>s of the specified types</returns>
|
||||||
|
public static void GetUniverseObjects<T>(this IEnumerable<IUniverseObject> universeObjects, IList<T> foundUniverseObjects) where T : class
|
||||||
|
{
|
||||||
|
foundUniverseObjects.Clear();
|
||||||
|
|
||||||
|
foreach (IUniverseObject universeObject in universeObjects)
|
||||||
|
if (universeObject is T @object)
|
||||||
|
foundUniverseObjects.Add(@object);
|
||||||
|
}
|
||||||
|
#endregion
|
||||||
|
|
||||||
|
#region Universe Object Search In Parent
|
||||||
|
/// <summary>
|
||||||
|
/// Tries to get a <see cref="IUniverseObject"/> of the specified type in it's parents recursively.
|
||||||
|
/// </summary>
|
||||||
|
/// <typeparam name="T">The type of <see cref="IUniverseObject"/> to get.</typeparam>
|
||||||
|
/// <param name="behaviour">When this method returns, contains the <see cref="IUniverseObject"/> of the specified type, if found; otherwise, null.</param>
|
||||||
|
/// <returns><see cref="true"/> if a <see cref="IUniverseObject"/> of the specified type was found in the parent universe objects; otherwise, <see cref="false"/>.</returns>
|
||||||
|
public static bool TryGetUniverseObjectInParent<T>(this IUniverseObject universeObject, [NotNullWhen(returnValue: true)] out T? behaviour) where T : class
|
||||||
|
{
|
||||||
|
behaviour = GetUniverseObjectInParent<T>(universeObject);
|
||||||
return behaviour is not null;
|
return behaviour is not null;
|
||||||
}
|
}
|
||||||
|
|
||||||
public static void GetUniverseObjects<T>(this IEnumerable<IUniverseObject> universeObjects, List<T> behaviours) where T : class
|
/// <summary>
|
||||||
|
/// Gets a <see cref="IUniverseObject"/> of the specified type in it's parents recursively.
|
||||||
|
/// </summary>
|
||||||
|
/// <typeparam name="T">The type of <see cref="IUniverseObject"/> to get.</typeparam>
|
||||||
|
/// <param name="universeObject">The <see cref="IUniverseObject"/> to start searching from.</param>
|
||||||
|
/// <returns>The <see cref="IUniverseObject"/> of the specified type if found; otherwise, null.</returns>
|
||||||
|
public static T? GetUniverseObjectInParent<T>(this IUniverseObject universeObject) where T : class
|
||||||
|
{
|
||||||
|
if (universeObject.Children.GetUniverseObject<T>() is T localUniverseObject)
|
||||||
|
return localUniverseObject;
|
||||||
|
|
||||||
|
IUniverseObject? parent = universeObject;
|
||||||
|
|
||||||
|
while (parent is not null)
|
||||||
|
{
|
||||||
|
if (parent is T behaviour)
|
||||||
|
return behaviour;
|
||||||
|
|
||||||
|
parent = universeObject.Parent;
|
||||||
|
}
|
||||||
|
|
||||||
|
return default;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Gets a <see cref="IUniverseObject"/> of the specified type in the parents recursively. Throws an error if not found.
|
||||||
|
/// </summary>
|
||||||
|
/// <typeparam name="T">The type of <see cref="IUniverseObject"/> to get.</typeparam>
|
||||||
|
/// <param name="universeObject">The <see cref="IUniverseObject"/> to start searching from.</param>
|
||||||
|
/// <returns>The <see cref="IUniverseObject"/> of the specified type if found; otherwise, throws <see cref="UniverseObjectNotFoundException"/>.</returns>
|
||||||
|
public static T GetRequiredUniverseObjectInParent<T>(this IUniverseObject universeObject) where T : class
|
||||||
|
=> universeObject.GetUniverseObjectInParent<T>() ?? throw new UniverseObjectNotFoundException($"{universeObject.Name}'s {nameof(IUniverseObject)} does not contain any {typeof(T).FullName} on any parent ");
|
||||||
|
|
||||||
|
#endregion
|
||||||
|
|
||||||
|
#region Universe Object Search In Children
|
||||||
|
/// <summary>
|
||||||
|
/// Tries to get a <see cref="IUniverseObject"/> of the specified type in it's children recursively.
|
||||||
|
/// </summary>
|
||||||
|
/// <typeparam name="T">The type of <see cref="IUniverseObject"/> to get.</typeparam>
|
||||||
|
/// <param name="behaviour">When this method returns, contains the <see cref="IUniverseObject"/> of the specified type, if found; otherwise, null.</param>
|
||||||
|
/// <returns><see cref="true"/> if a <see cref="IUniverseObject"/> of the specified type was found in the child universe objects; otherwise, <see cref="false"/>.</returns>
|
||||||
|
public static bool TryGetUniverseObjectInChildren<T>(this IUniverseObject universeObject, [NotNullWhen(returnValue: true)] out T? behaviour) where T : class
|
||||||
|
{
|
||||||
|
behaviour = GetUniverseObjectInChildren<T>(universeObject);
|
||||||
|
return behaviour is not null;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Gets a <see cref="IUniverseObject"/> of the specified type in it's children recursively.
|
||||||
|
/// </summary>
|
||||||
|
/// <typeparam name="T">The type of <see cref="IUniverseObject"/> to get.</typeparam>
|
||||||
|
/// <param name="universeObject">The <see cref="IUniverseObject"/> to start searching from.</param>
|
||||||
|
/// <returns>The <see cref="IUniverseObject"/> of the specified type if found; otherwise, null.</returns>
|
||||||
|
public static T? GetUniverseObjectInChildren<T>(this IUniverseObject universeObject) where T : class
|
||||||
|
{
|
||||||
|
if (universeObject.Children.GetUniverseObject<T>() is T localUniverseObject)
|
||||||
|
return localUniverseObject;
|
||||||
|
|
||||||
|
foreach (IUniverseObject child in universeObject.Children)
|
||||||
|
if (GetUniverseObjectInChildren<T>(child) is T behaviour)
|
||||||
|
return behaviour;
|
||||||
|
|
||||||
|
return default;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Gets a <see cref="IUniverseObject"/> of the specified type in the children recursively. Throws an error if not found.
|
||||||
|
/// </summary>
|
||||||
|
/// <typeparam name="T">The type of <see cref="IUniverseObject"/> to get.</typeparam>
|
||||||
|
/// <param name="universeObject">The <see cref="IUniverseObject"/> to start searching from.</param>
|
||||||
|
/// <returns>The <see cref="IUniverseObject"/> of the specified type if found; otherwise, throws <see cref="UniverseObjectNotFoundException"/>.</returns>
|
||||||
|
public static T GetRequiredUniverseObjectInChildren<T>(this IUniverseObject universeObject) where T : class
|
||||||
|
=> universeObject.GetUniverseObjectInChildren<T>() ?? throw new UniverseObjectNotFoundException($"{universeObject.Name}'s {nameof(IUniverseObject)} does not contain any {typeof(T).FullName} on any children ");
|
||||||
|
#endregion
|
||||||
|
|
||||||
|
#region Behaviour Search
|
||||||
|
/// <summary>
|
||||||
|
/// Finds a <see cref="IBehaviour"/> of the specified type in the provided <see cref="IUniverseObject"/>s.
|
||||||
|
/// </summary>
|
||||||
|
/// <typeparam name="T">The type of <see cref="IBehaviour"/> to find.</typeparam>
|
||||||
|
/// <returns>The first found <see cref="IBehaviour"/> of the specified type; otherwise, null.</returns>
|
||||||
|
public static T? FindBehaviour<T>(this IEnumerable<IUniverseObject> universeObjects) where T : class
|
||||||
|
{
|
||||||
|
foreach (IUniverseObject universeObject in universeObjects)
|
||||||
|
if (universeObject.BehaviourController.GetBehaviour<T>() is T behaviour)
|
||||||
|
return behaviour;
|
||||||
|
|
||||||
|
return default;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Tries to find a <see cref="IBehaviour"/> of the specified type in the provided <see cref="IUniverseObject"/>s.
|
||||||
|
/// </summary>
|
||||||
|
/// <typeparam name="T">The type of <see cref="IBehaviour"/> to find.</typeparam>
|
||||||
|
/// <param name="behaviour">When this method returns, contains the <see cref="IUniverseObject"/> of the specified type, if found; otherwise, null.</param>
|
||||||
|
/// <returns><see cref="true"/> if a <see cref="IBehaviour"/> of the specified type was found in the provided <see cref="IUniverseObject"/>s; otherwise, <see cref="false"/>.</returns>
|
||||||
|
public static bool TryFindBehaviour<T>(this IEnumerable<IUniverseObject> universeObjects, [NotNullWhen(returnValue: true)] out T? behaviour) where T : class
|
||||||
|
{
|
||||||
|
behaviour = FindBehaviour<T>(universeObjects);
|
||||||
|
return behaviour is not null;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Searches through the provided <see cref="IUniverseObject"/>s to collect a list of <see cref="IBehaviour"/>s of the specified type.
|
||||||
|
/// </summary>
|
||||||
|
/// <typeparam name="T">The type of <see cref="IBehaviour"/> to get.</typeparam>
|
||||||
|
/// <param name="universeObjects">The <see cref="IUniverseObject"/>s to search.</param>
|
||||||
|
public static void FindBehaviours<T>(this IEnumerable<IUniverseObject> universeObjects, IList<T> behaviours) where T : class
|
||||||
{
|
{
|
||||||
behaviours.Clear();
|
behaviours.Clear();
|
||||||
|
List<T> cache = [];
|
||||||
|
|
||||||
foreach (IUniverseObject universeObject in universeObjects)
|
foreach (IUniverseObject universeObject in universeObjects)
|
||||||
if (universeObject is T @object)
|
{
|
||||||
behaviours.Add(@object);
|
universeObject.BehaviourController.GetBehaviours(cache);
|
||||||
|
foreach (T behaviour in cache)
|
||||||
|
behaviours.Add(behaviour);
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
#endregion
|
||||||
|
|
||||||
|
#region General Search
|
||||||
|
/// <summary>
|
||||||
|
/// Finds an object of the specified type in the provided <see cref="IUniverseObject"/>s and their <see cref="IBehaviour"/>s.
|
||||||
|
/// </summary>
|
||||||
|
/// <remarks>
|
||||||
|
/// WARNING: This is more expensive compared to <see cref="GetUniverseObject{T}(IEnumerable{IUniverseObject})"/> or <see cref="FindBehaviour{T}(IEnumerable{IUniverseObject})"/> as it combines the two. If you know whether the type is either a type that gets implemented on an <see cref="IBehaviour"/> or <see cref="IUniverseObject"/> use the method appropriate for it for performance.
|
||||||
|
/// </remarks>
|
||||||
|
/// <typeparam name="T">The type of <see cref="IBehaviour"/> to find.</typeparam>
|
||||||
|
/// <returns>The first found instance of the specified type; otherwise, null.</returns>
|
||||||
|
public static T? Find<T>(this IEnumerable<IUniverseObject> universeObjects) where T : class
|
||||||
|
{
|
||||||
|
if (universeObjects.GetUniverseObject<T>() is T foundUniverseObject)
|
||||||
|
return foundUniverseObject;
|
||||||
|
|
||||||
|
if (universeObjects.FindBehaviour<T>() is T foundBehaviour)
|
||||||
|
return foundBehaviour;
|
||||||
|
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Tries to find an object of the specified type in the provided <see cref="IUniverseObject"/>s and their <see cref="IBehaviour"/>s.
|
||||||
|
/// </summary>
|
||||||
|
/// <remarks>
|
||||||
|
/// WARNING: This is more expensive compared to <see cref="TryGetUniverseObject{T}(IEnumerable{IUniverseObject}, out T?)"/> or <see cref="TryFindBehaviour{T}(IEnumerable{IUniverseObject}, out T?)"/> as it combines the two. If you know whether the type is either a type that gets implemented on an <see cref="IBehaviour"/> or <see cref="IUniverseObject"/> use the method appropriate for it for performance.
|
||||||
|
/// </remarks>
|
||||||
|
/// <typeparam name="T">The type of <see cref="IBehaviour"/> to find.</typeparam>
|
||||||
|
/// <param name="behaviour">When this method returns, contains the <see cref="IUniverseObject"/> of the specified type, if found; otherwise, null.</param>
|
||||||
|
/// <returns><see cref="true"/> if an object of the specified type was found in the provided <see cref="IUniverseObject"/>s; otherwise, <see cref="false"/>.</returns>
|
||||||
|
public static bool TryFind<T>(this IEnumerable<IUniverseObject> universeObjects, [NotNullWhen(returnValue: true)] out T? behaviour) where T : class
|
||||||
|
{
|
||||||
|
behaviour = Find<T>(universeObjects);
|
||||||
|
return behaviour is not null;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Searches through the provided <see cref="IUniverseObject"/>s and their <see cref="IBehaviour"/>s to collect a list of the specified type.
|
||||||
|
/// </summary>
|
||||||
|
/// <remarks>
|
||||||
|
/// WARNING: This is more expensive compared to <see cref="GetUniverseObjects{T}(IEnumerable{IUniverseObject}, IList{T})"/> or <see cref="FindBehaviours{T}(IEnumerable{IUniverseObject}, IList{T})"/> as it combines the two. If you know whether the type is either a type that gets implemented on an <see cref="IBehaviour"/> or <see cref="IUniverseObject"/> use the method appropriate for it for performance.
|
||||||
|
/// </remarks>
|
||||||
|
/// <typeparam name="T">The type of <see cref="IBehaviour"/> to get.</typeparam>
|
||||||
|
/// <param name="instances">List of objects found wit the specified type.</param>
|
||||||
|
/// <param name="universeObjects">The <see cref="IUniverseObject"/>s to search.</param>
|
||||||
|
public static void Find<T>(this IEnumerable<IUniverseObject> universeObjects, IList<T> instances) where T : class
|
||||||
|
{
|
||||||
|
instances.Clear();
|
||||||
|
List<T> cache = [];
|
||||||
|
|
||||||
|
foreach (IUniverseObject universeObject in universeObjects)
|
||||||
|
{
|
||||||
|
universeObject.Children.Find(cache);
|
||||||
|
foreach (T behaviour in cache)
|
||||||
|
instances.Add(behaviour);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
#endregion
|
||||||
}
|
}
|
||||||
|
@@ -4,10 +4,10 @@ namespace Syntriax.Engine.Core.Factory;
|
|||||||
|
|
||||||
public class BehaviourControllerFactory
|
public class BehaviourControllerFactory
|
||||||
{
|
{
|
||||||
public static IBehaviourController Instantiate(IUniverseObject universeObject)
|
public static IBehaviourController Instantiate(IUniverseObject universeObject, IStateEnable? stateEnable = null)
|
||||||
=> Instantiate<BehaviourController>(universeObject);
|
=> Instantiate<BehaviourController>(universeObject, stateEnable);
|
||||||
|
|
||||||
public static T Instantiate<T>(IUniverseObject universeObject, params object?[]? args)
|
public static T Instantiate<T>(IUniverseObject universeObject, IStateEnable? stateEnable = null, params object?[]? args)
|
||||||
where T : class, IBehaviourController
|
where T : class, IBehaviourController
|
||||||
{
|
{
|
||||||
T behaviourController = TypeFactory.Get<T>(args);
|
T behaviourController = TypeFactory.Get<T>(args);
|
||||||
@@ -18,6 +18,17 @@ public class BehaviourControllerFactory
|
|||||||
if (!behaviourController.Assign(universeObject))
|
if (!behaviourController.Assign(universeObject))
|
||||||
throw AssignFailedException.From(behaviourController, universeObject);
|
throw AssignFailedException.From(behaviourController, universeObject);
|
||||||
|
|
||||||
|
if (stateEnable is not null)
|
||||||
|
{
|
||||||
|
if (!stateEnable.Assign(behaviourController))
|
||||||
|
throw AssignFailedException.From(stateEnable, behaviourController);
|
||||||
|
|
||||||
|
if (!behaviourController.Assign(stateEnable))
|
||||||
|
throw AssignFailedException.From(behaviourController, stateEnable);
|
||||||
|
}
|
||||||
|
else
|
||||||
|
StateEnableFactory.Instantiate(behaviourController);
|
||||||
|
|
||||||
return behaviourController;
|
return behaviourController;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
@@ -4,22 +4,23 @@ namespace Syntriax.Engine.Core.Factory;
|
|||||||
|
|
||||||
public class BehaviourFactory
|
public class BehaviourFactory
|
||||||
{
|
{
|
||||||
public static T Instantiate<T>(IUniverseObject universeObject, params object?[]? args) where T : class, IBehaviour
|
public static T Instantiate<T>(params object?[]? args) where T : class, IBehaviour
|
||||||
=> Instantiate<T>(universeObject, stateEnable: null, args);
|
=> Instantiate<T>(stateEnable: null, args);
|
||||||
|
|
||||||
public static T Instantiate<T>(IUniverseObject universeObject, IStateEnable? stateEnable, params object?[]? args)
|
public static T Instantiate<T>(IStateEnable? stateEnable, params object?[]? args)
|
||||||
where T : class, IBehaviour
|
where T : class, IBehaviour
|
||||||
{
|
{
|
||||||
T behaviour = TypeFactory.Get<T>(args);
|
T behaviour = TypeFactory.Get<T>(args);
|
||||||
|
|
||||||
stateEnable ??= TypeFactory.Get<StateEnable>();
|
if (stateEnable is not null)
|
||||||
if (!stateEnable.Assign(behaviour))
|
{
|
||||||
throw AssignFailedException.From(stateEnable, behaviour);
|
if (!stateEnable.Assign(behaviour))
|
||||||
|
throw AssignFailedException.From(stateEnable, behaviour);
|
||||||
if (!behaviour.Assign(stateEnable))
|
if (!behaviour.Assign(stateEnable))
|
||||||
throw AssignFailedException.From(behaviour, stateEnable);
|
throw AssignFailedException.From(behaviour, stateEnable);
|
||||||
if (!behaviour.Assign(universeObject.BehaviourController))
|
}
|
||||||
throw AssignFailedException.From(behaviour, universeObject.BehaviourController);
|
else
|
||||||
|
StateEnableFactory.Instantiate(behaviour);
|
||||||
|
|
||||||
return behaviour;
|
return behaviour;
|
||||||
}
|
}
|
||||||
|
@@ -1,21 +1,59 @@
|
|||||||
using System;
|
using System;
|
||||||
|
using System.Collections.Concurrent;
|
||||||
|
using System.Collections.Generic;
|
||||||
|
using System.Linq;
|
||||||
|
|
||||||
namespace Syntriax.Engine.Core.Factory;
|
namespace Syntriax.Engine.Core.Factory;
|
||||||
|
|
||||||
public static class TypeFactory
|
public static class TypeFactory
|
||||||
{
|
{
|
||||||
public static T Get<T>(params object?[]? args) where T : class
|
private static readonly ConcurrentDictionary<string, Type> registeredTypes = [];
|
||||||
|
|
||||||
|
public static string GetTypeName(Type type) => type.FullName ?? throw new ArgumentException($"{type.Name} must be a resolvable type");
|
||||||
|
|
||||||
|
public static T Get<T>(params object?[]? args) where T : class => (T)Get(typeof(T), args);
|
||||||
|
public static object Get(string fullName, params object?[]? args) => Get(GetType(fullName), args);
|
||||||
|
public static object Get(Type type, params object?[]? args)
|
||||||
{
|
{
|
||||||
T? result;
|
object? result;
|
||||||
|
|
||||||
if (args is not null && args.Length != 0)
|
if (args is not null && args.Length != 0)
|
||||||
result = Activator.CreateInstance(typeof(T), args) as T;
|
result = Activator.CreateInstance(type, args);
|
||||||
else
|
else
|
||||||
result = Activator.CreateInstance(typeof(T)) as T;
|
result = Activator.CreateInstance(type);
|
||||||
|
|
||||||
if (result is null)
|
if (result is null)
|
||||||
throw new Exception($"{typeof(T).Name} of type {typeof(T).Name} could not be created.");
|
throw new Exception($"Type {type.Name} could not be created.");
|
||||||
|
|
||||||
return result;
|
return result;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
public static Type GetType(string fullName)
|
||||||
|
{
|
||||||
|
if (registeredTypes.TryGetValue(fullName, out Type? result))
|
||||||
|
return result;
|
||||||
|
|
||||||
|
ReloadTypes();
|
||||||
|
|
||||||
|
if (registeredTypes.TryGetValue(fullName, out Type? reloadedType))
|
||||||
|
return reloadedType;
|
||||||
|
|
||||||
|
throw new Exception($"Type {fullName} could not be found in the current domain.");
|
||||||
|
}
|
||||||
|
|
||||||
|
public static void ReloadTypes()
|
||||||
|
{
|
||||||
|
registeredTypes.Clear();
|
||||||
|
|
||||||
|
IEnumerable<Type> domainTypes = AppDomain.CurrentDomain
|
||||||
|
.GetAssemblies()
|
||||||
|
.SelectMany(a => a.GetTypes());
|
||||||
|
|
||||||
|
// TODO: Replace this
|
||||||
|
// There are some system & compiler generated types with duplicated names,
|
||||||
|
// it is ugly it will cause headaches in the future because it will not
|
||||||
|
// throw an error if there's a type with an unintended duplicate name
|
||||||
|
foreach (Type type in domainTypes)
|
||||||
|
registeredTypes.TryAdd(GetTypeName(type), type);
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
@@ -18,18 +18,25 @@ public class UniverseObjectFactory
|
|||||||
{
|
{
|
||||||
T universeObject = TypeFactory.Get<T>(args);
|
T universeObject = TypeFactory.Get<T>(args);
|
||||||
|
|
||||||
behaviourController ??= TypeFactory.Get<BehaviourController>();
|
if (behaviourController is not null)
|
||||||
stateEnable ??= TypeFactory.Get<StateEnable>();
|
{
|
||||||
|
if (!behaviourController.Assign(universeObject))
|
||||||
|
throw AssignFailedException.From(behaviourController, universeObject);
|
||||||
|
if (!universeObject.Assign(behaviourController))
|
||||||
|
throw AssignFailedException.From(universeObject, behaviourController);
|
||||||
|
}
|
||||||
|
else
|
||||||
|
BehaviourControllerFactory.Instantiate(universeObject);
|
||||||
|
|
||||||
if (!behaviourController.Assign(universeObject))
|
if (stateEnable is not null)
|
||||||
throw AssignFailedException.From(behaviourController, universeObject);
|
{
|
||||||
if (!stateEnable.Assign(universeObject))
|
if (!stateEnable.Assign(universeObject))
|
||||||
throw AssignFailedException.From(stateEnable, universeObject);
|
throw AssignFailedException.From(stateEnable, universeObject);
|
||||||
|
if (!universeObject.Assign(stateEnable))
|
||||||
if (!universeObject.Assign(behaviourController))
|
throw AssignFailedException.From(universeObject, stateEnable);
|
||||||
throw AssignFailedException.From(universeObject, behaviourController);
|
}
|
||||||
if (!universeObject.Assign(stateEnable))
|
else
|
||||||
throw AssignFailedException.From(universeObject, stateEnable);
|
StateEnableFactory.Instantiate(universeObject);
|
||||||
|
|
||||||
return universeObject;
|
return universeObject;
|
||||||
}
|
}
|
||||||
|
@@ -1,17 +0,0 @@
|
|||||||
using System;
|
|
||||||
|
|
||||||
namespace Syntriax.Engine.Core;
|
|
||||||
|
|
||||||
public static class DelegateHelpers
|
|
||||||
{
|
|
||||||
public static void InvokeSafe(this Delegate @delegate, params object?[] args)
|
|
||||||
{
|
|
||||||
foreach (Delegate invocation in @delegate.GetInvocationList())
|
|
||||||
try { invocation.DynamicInvoke(args); }
|
|
||||||
catch (Exception exception)
|
|
||||||
{
|
|
||||||
string methodCallRepresentation = $"{invocation.Method.DeclaringType?.FullName}.{invocation.Method.Name}({string.Join(", ", args)})";
|
|
||||||
Console.WriteLine($"Unexpected exception on invocation of method {methodCallRepresentation}:{Environment.NewLine}{exception.InnerException}");
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
500
Engine.Core/Helpers/Event.cs
Normal file
500
Engine.Core/Helpers/Event.cs
Normal file
@@ -0,0 +1,500 @@
|
|||||||
|
using System;
|
||||||
|
using System.Collections.Generic;
|
||||||
|
|
||||||
|
using Syntriax.Engine.Core.Debug;
|
||||||
|
|
||||||
|
namespace Syntriax.Engine.Core;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Represents a simple event with no parameters.
|
||||||
|
/// <para>Example usage:</para>
|
||||||
|
/// <code>
|
||||||
|
/// public class MyBehaviour : Behaviour, IUpdate
|
||||||
|
/// {
|
||||||
|
/// public readonly Event MyEvent = new();
|
||||||
|
///
|
||||||
|
/// public MyBehaviour()
|
||||||
|
/// {
|
||||||
|
/// MyEvent.AddListener(OnEventTriggered);
|
||||||
|
/// MyEvent.AddOneTimeListener(OnEventTriggeredOneTime);
|
||||||
|
/// }
|
||||||
|
///
|
||||||
|
/// public void Update()
|
||||||
|
/// {
|
||||||
|
/// MyEvent.Invoke();
|
||||||
|
/// }
|
||||||
|
///
|
||||||
|
/// private void OnEventTriggered()
|
||||||
|
/// {
|
||||||
|
/// Console.WriteLine($"Event occurred!");
|
||||||
|
/// }
|
||||||
|
///
|
||||||
|
/// private static void OnEventTriggeredOneTime()
|
||||||
|
/// {
|
||||||
|
/// Console.WriteLine($"Event called once!");
|
||||||
|
/// }
|
||||||
|
/// }
|
||||||
|
/// </code>
|
||||||
|
/// The output of the example code above would be:
|
||||||
|
/// <code>
|
||||||
|
/// Event occurred!
|
||||||
|
/// Event called once!
|
||||||
|
/// Event occurred!
|
||||||
|
/// Event occurred!
|
||||||
|
/// Event occurred!
|
||||||
|
/// ...
|
||||||
|
/// </code>
|
||||||
|
/// </summary>
|
||||||
|
public class Event
|
||||||
|
{
|
||||||
|
// We use Ascending order because draw calls are running from last to first
|
||||||
|
private static readonly Comparer<ListenerData> SortByAscendingPriority = Comparer<ListenerData>.Create((x, y) => x.Priority.CompareTo(y.Priority));
|
||||||
|
|
||||||
|
private ILogger _logger = ILogger.Shared;
|
||||||
|
public ILogger Logger { get => _logger; set => _logger = value ?? ILogger.Shared; }
|
||||||
|
|
||||||
|
private readonly List<ListenerData> listeners = null!;
|
||||||
|
private readonly List<ListenerData> onceListeners = null!;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Subscribes the callback to be invoked whenever the event is triggered.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="listener">The callback to be called when the event is triggered.</param>
|
||||||
|
/// <param name="priority">Priority of the callback.</param>
|
||||||
|
public void AddListener(EventHandler listener, int priority = 0)
|
||||||
|
{
|
||||||
|
ListenerData listenerData = new(listener, priority);
|
||||||
|
|
||||||
|
int insertIndex = listeners.BinarySearch(listenerData, SortByAscendingPriority);
|
||||||
|
if (insertIndex < 0)
|
||||||
|
insertIndex = ~insertIndex;
|
||||||
|
|
||||||
|
listeners.Insert(insertIndex, listenerData);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Subscribes the callback to be invoked the next time the event is triggered. The callback will be called only once.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="listener">The callback to be called the next time the event is triggered.</param>
|
||||||
|
/// <param name="priority">Priority of the callback.</param>
|
||||||
|
public void AddOneTimeListener(EventHandler listener, int priority = 0)
|
||||||
|
{
|
||||||
|
ListenerData listenerData = new(listener, priority);
|
||||||
|
|
||||||
|
int insertIndex = onceListeners.BinarySearch(listenerData, SortByAscendingPriority);
|
||||||
|
if (insertIndex < 0)
|
||||||
|
insertIndex = ~insertIndex;
|
||||||
|
|
||||||
|
onceListeners.Insert(insertIndex, listenerData);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Unsubscribes the callback that was previously registered by <see cref="AddListener(EventHandler)"/>.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="listener">The callback that was previously registered by <see cref="AddListener(EventHandler)"/></param>
|
||||||
|
public void RemoveListener(EventHandler listener)
|
||||||
|
{
|
||||||
|
for (int i = listeners.Count - 1; i >= 0; i--)
|
||||||
|
if (listeners[i].Callback == listener)
|
||||||
|
{
|
||||||
|
listeners.RemoveAt(i);
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Unsubscribes the callback that was previously registered by <see cref="AddOneTimeListener(EventHandler)"/>.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="listener">The callback that was previously registered by <see cref="AddOneTimeListener(EventHandler)"/></param>
|
||||||
|
public void RemoveOneTimeListener(EventHandler listener)
|
||||||
|
{
|
||||||
|
for (int i = 0; i < onceListeners.Count; i++)
|
||||||
|
if (onceListeners[i].Callback == listener)
|
||||||
|
{
|
||||||
|
onceListeners.RemoveAt(i);
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Unsubscribes all listeners that was previously registered by either <see cref="AddListener(EventHandler)"/> or <see cref="AddOneTimeListener(EventHandler)"/>.
|
||||||
|
/// </summary>
|
||||||
|
public void Clear() { listeners.Clear(); onceListeners.Clear(); }
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Triggers the event.
|
||||||
|
/// </summary>
|
||||||
|
public void Invoke()
|
||||||
|
{
|
||||||
|
for (int i = listeners.Count - 1; i >= 0; i--)
|
||||||
|
try { listeners[i].Callback.Invoke(); }
|
||||||
|
catch (Exception exception)
|
||||||
|
{
|
||||||
|
string methodCallRepresentation = $"{listeners[i].Callback.Method.DeclaringType?.FullName}.{listeners[i].Callback.Method.Name}()";
|
||||||
|
EventHelpers.LogInvocationException(listeners[i].Callback.Target ?? this, Logger, exception, methodCallRepresentation);
|
||||||
|
}
|
||||||
|
|
||||||
|
for (int i = onceListeners.Count - 1; i >= 0; i--)
|
||||||
|
{
|
||||||
|
try { onceListeners[i].Callback.Invoke(); }
|
||||||
|
catch (Exception exception)
|
||||||
|
{
|
||||||
|
string methodCallRepresentation = $"{onceListeners[i].Callback.Method.DeclaringType?.FullName}.{onceListeners[i].Callback.Method.Name}()";
|
||||||
|
EventHelpers.LogInvocationException(onceListeners[i].Callback.Target ?? this, Logger, exception, methodCallRepresentation);
|
||||||
|
}
|
||||||
|
onceListeners.RemoveAt(i);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public Event(int initialListenerCount = 4, int initialOnceListenerCount = 2)
|
||||||
|
{
|
||||||
|
listeners = new(initialListenerCount);
|
||||||
|
onceListeners = new(initialOnceListenerCount);
|
||||||
|
}
|
||||||
|
|
||||||
|
public Event()
|
||||||
|
{
|
||||||
|
listeners = new(4);
|
||||||
|
onceListeners = new(2);
|
||||||
|
}
|
||||||
|
|
||||||
|
public delegate void EventHandler();
|
||||||
|
private record struct ListenerData(EventHandler Callback, int Priority);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Represents an event with only sender parameters.
|
||||||
|
/// <para>Example usage:</para>
|
||||||
|
/// <code>
|
||||||
|
/// public class MyBehaviour : Behaviour, IUpdate
|
||||||
|
/// {
|
||||||
|
/// public readonly Event<MyBehaviour> MyEvent = new();
|
||||||
|
///
|
||||||
|
/// public MyBehaviour()
|
||||||
|
/// {
|
||||||
|
/// MyEvent.AddListener(OnEventTriggered);
|
||||||
|
/// MyEvent.AddOneTimeListener(OnEventTriggeredOneTime);
|
||||||
|
/// }
|
||||||
|
///
|
||||||
|
/// public void Update()
|
||||||
|
/// {
|
||||||
|
/// MyEvent.Invoke(this);
|
||||||
|
/// }
|
||||||
|
///
|
||||||
|
/// private void OnEventTriggered(MyBehaviour sender)
|
||||||
|
/// {
|
||||||
|
/// Console.WriteLine($"{sender.Id}'s event occurred!");
|
||||||
|
/// }
|
||||||
|
///
|
||||||
|
/// private static void OnEventTriggeredOneTime(MyBehaviour sender)
|
||||||
|
/// {
|
||||||
|
/// Console.WriteLine($"{sender.Id}'s event called once!");
|
||||||
|
/// }
|
||||||
|
/// }
|
||||||
|
/// </code>
|
||||||
|
/// The output of the example code above would be:
|
||||||
|
/// <code>
|
||||||
|
/// [Id]'s event occurred!
|
||||||
|
/// [Id]'s event called once!
|
||||||
|
/// [Id]'s event occurred!
|
||||||
|
/// [Id]'s event occurred!
|
||||||
|
/// [Id]'s event occurred!
|
||||||
|
/// ...
|
||||||
|
/// </code>
|
||||||
|
///
|
||||||
|
/// </summary>
|
||||||
|
/// <typeparam name="TSender">Sender type</typeparam>
|
||||||
|
public class Event<TSender> where TSender : class
|
||||||
|
{
|
||||||
|
// We use Ascending order because draw calls are running from last to first
|
||||||
|
private static readonly Comparer<ListenerData> SortByAscendingPriority = Comparer<ListenerData>.Create((x, y) => x.Priority.CompareTo(y.Priority));
|
||||||
|
|
||||||
|
private ILogger _logger = ILogger.Shared;
|
||||||
|
public ILogger Logger { get => _logger; set => _logger = value ?? ILogger.Shared; }
|
||||||
|
|
||||||
|
private readonly List<ListenerData> listeners = null!;
|
||||||
|
private readonly List<ListenerData> onceListeners = null!;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Subscribes the callback to be invoked whenever the event is triggered.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="listener">The callback to be called when the event is triggered.</param>
|
||||||
|
/// <param name="priority">Priority of the callback.</param>
|
||||||
|
public void AddListener(EventHandler listener, int priority = 0)
|
||||||
|
{
|
||||||
|
ListenerData listenerData = new(listener, priority);
|
||||||
|
|
||||||
|
int insertIndex = listeners.BinarySearch(listenerData, SortByAscendingPriority);
|
||||||
|
if (insertIndex < 0)
|
||||||
|
insertIndex = ~insertIndex;
|
||||||
|
|
||||||
|
listeners.Insert(insertIndex, listenerData);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Subscribes the callback to be invoked the next time the event is triggered. The callback will be called only once.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="listener">The callback to be called the next time the event is triggered.</param>
|
||||||
|
/// <param name="priority">Priority of the callback.</param>
|
||||||
|
public void AddOneTimeListener(EventHandler listener, int priority = 0)
|
||||||
|
{
|
||||||
|
ListenerData listenerData = new(listener, priority);
|
||||||
|
|
||||||
|
int insertIndex = onceListeners.BinarySearch(listenerData, SortByAscendingPriority);
|
||||||
|
if (insertIndex < 0)
|
||||||
|
insertIndex = ~insertIndex;
|
||||||
|
|
||||||
|
onceListeners.Insert(insertIndex, listenerData);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Unsubscribes the callback that was previously registered by <see cref="AddListener(EventHandler)"/>.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="listener">The callback that was previously registered by <see cref="AddListener(EventHandler)"/></param>
|
||||||
|
public void RemoveListener(EventHandler listener)
|
||||||
|
{
|
||||||
|
for (int i = listeners.Count - 1; i >= 0; i--)
|
||||||
|
if (listeners[i].Callback == listener)
|
||||||
|
{
|
||||||
|
listeners.RemoveAt(i);
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Unsubscribes the callback that was previously registered by <see cref="AddOneTimeListener(EventHandler)"/>.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="listener">The callback that was previously registered by <see cref="AddOneTimeListener(EventHandler)"/></param>
|
||||||
|
public void RemoveOneTimeListener(EventHandler listener)
|
||||||
|
{
|
||||||
|
for (int i = 0; i < onceListeners.Count; i++)
|
||||||
|
if (onceListeners[i].Callback == listener)
|
||||||
|
{
|
||||||
|
onceListeners.RemoveAt(i);
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Unsubscribes all listeners that was previously registered by either <see cref="AddListener(EventHandler)"/> or <see cref="AddOneTimeListener(EventHandler)"/>.
|
||||||
|
/// </summary>
|
||||||
|
public void Clear() { listeners.Clear(); onceListeners.Clear(); }
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Triggers the event.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="sender">The caller that's triggering this event.</param>
|
||||||
|
public void Invoke(TSender sender)
|
||||||
|
{
|
||||||
|
for (int i = listeners.Count - 1; i >= 0; i--)
|
||||||
|
try { listeners[i].Callback.Invoke(sender); }
|
||||||
|
catch (Exception exception)
|
||||||
|
{
|
||||||
|
string methodCallRepresentation = $"{listeners[i].Callback.Method.DeclaringType?.FullName}.{listeners[i].Callback.Method.Name}({sender})";
|
||||||
|
EventHelpers.LogInvocationException(listeners[i].Callback.Target ?? sender, Logger, exception, methodCallRepresentation);
|
||||||
|
}
|
||||||
|
|
||||||
|
for (int i = onceListeners.Count - 1; i >= 0; i--)
|
||||||
|
{
|
||||||
|
try { onceListeners[i].Callback.Invoke(sender); }
|
||||||
|
catch (Exception exception)
|
||||||
|
{
|
||||||
|
string methodCallRepresentation = $"{onceListeners[i].Callback.Method.DeclaringType?.FullName}.{onceListeners[i].Callback.Method.Name}({sender})";
|
||||||
|
EventHelpers.LogInvocationException(onceListeners[i].Callback.Target ?? sender, Logger, exception, methodCallRepresentation);
|
||||||
|
}
|
||||||
|
onceListeners.RemoveAt(i);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public Event(int initialListenerCount = 4, int initialOnceListenerCount = 2)
|
||||||
|
{
|
||||||
|
listeners = new(initialListenerCount);
|
||||||
|
onceListeners = new(initialOnceListenerCount);
|
||||||
|
}
|
||||||
|
|
||||||
|
public Event()
|
||||||
|
{
|
||||||
|
listeners = new(4);
|
||||||
|
onceListeners = new(2);
|
||||||
|
}
|
||||||
|
|
||||||
|
public delegate void EventHandler(TSender sender);
|
||||||
|
private record struct ListenerData(EventHandler Callback, int Priority);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Represents an event with sender and argument parameters.
|
||||||
|
/// <para>Example usage:</para>
|
||||||
|
/// <code>
|
||||||
|
/// public class MyBehaviour : Behaviour, IUpdate
|
||||||
|
/// {
|
||||||
|
/// public readonly Event<MyBehaviour, MyArguments> MyEvent = new();
|
||||||
|
///
|
||||||
|
/// private int myInt = 0;
|
||||||
|
/// private bool myBool = false;
|
||||||
|
///
|
||||||
|
/// public MyBehaviour()
|
||||||
|
/// {
|
||||||
|
/// MyEvent.AddOneTimeListener(OnEventTriggeredOneTime);
|
||||||
|
/// MyEvent.AddListener(OnEventTriggered);
|
||||||
|
/// }
|
||||||
|
///
|
||||||
|
/// public void Update()
|
||||||
|
/// {
|
||||||
|
/// MyEvent.Invoke(this, new MyArguments(myInt, myBool));
|
||||||
|
/// myInt++;
|
||||||
|
/// myBool = !myBool;
|
||||||
|
/// }
|
||||||
|
///
|
||||||
|
/// private void OnEventTriggered(MyBehaviour sender, MyArguments args)
|
||||||
|
/// {
|
||||||
|
/// Console.WriteLine($"{sender.Id}'s event occurred with MyInt: {args.MyInt} and MyBool {args.MyBool}!");
|
||||||
|
/// }
|
||||||
|
///
|
||||||
|
/// private static void OnEventTriggeredOneTime(MyBehaviour sender, MyArguments args)
|
||||||
|
/// {
|
||||||
|
/// Console.WriteLine($"{sender.Id}'s event called once with MyInt: {args.MyInt} and MyBool {args.MyBool}!");
|
||||||
|
/// }
|
||||||
|
///
|
||||||
|
/// public readonly record struct MyArguments(int MyInt, bool MyBool);
|
||||||
|
/// }
|
||||||
|
/// </code>
|
||||||
|
/// The output of the example code above would be:
|
||||||
|
/// <code>
|
||||||
|
/// [Id]'s event occurred with MyInt: 0 and MyBool False!
|
||||||
|
/// [Id]'s event called once with MyInt: 0 and MyBool False!
|
||||||
|
/// [Id]'s event occurred with MyInt: 1 and MyBool True!
|
||||||
|
/// [Id]'s event occurred with MyInt: 2 and MyBool False!
|
||||||
|
/// [Id]'s event occurred with MyInt: 3 and MyBool True!
|
||||||
|
/// ...
|
||||||
|
/// </code>
|
||||||
|
///
|
||||||
|
/// </summary>
|
||||||
|
/// <typeparam name="TSender">Sender type</typeparam>
|
||||||
|
public class Event<TSender, TArguments> where TSender : class
|
||||||
|
{
|
||||||
|
// We use Ascending order because draw calls are running from last to first
|
||||||
|
private static readonly Comparer<ListenerData> SortByAscendingPriority = Comparer<ListenerData>.Create((x, y) => x.Priority.CompareTo(y.Priority));
|
||||||
|
|
||||||
|
private ILogger _logger = ILogger.Shared;
|
||||||
|
public ILogger Logger { get => _logger; set => _logger = value ?? ILogger.Shared; }
|
||||||
|
|
||||||
|
private readonly List<ListenerData> listeners = null!;
|
||||||
|
private readonly List<ListenerData> onceListeners = null!;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Subscribes the callback to be invoked whenever the event is triggered.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="listener">The callback to be called when the event is triggered.</param>
|
||||||
|
/// <param name="priority">Priority of the callback.</param>
|
||||||
|
public void AddListener(EventHandler listener, int priority = 0)
|
||||||
|
{
|
||||||
|
ListenerData listenerData = new(listener, priority);
|
||||||
|
|
||||||
|
int insertIndex = listeners.BinarySearch(listenerData, SortByAscendingPriority);
|
||||||
|
if (insertIndex < 0)
|
||||||
|
insertIndex = ~insertIndex;
|
||||||
|
|
||||||
|
listeners.Insert(insertIndex, listenerData);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Subscribes the callback to be invoked the next time the event is triggered. The callback will be called only once.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="listener">The callback to be called the next time the event is triggered.</param>
|
||||||
|
/// <param name="priority">Priority of the callback.</param>
|
||||||
|
public void AddOneTimeListener(EventHandler listener, int priority = 0)
|
||||||
|
{
|
||||||
|
ListenerData listenerData = new(listener, priority);
|
||||||
|
|
||||||
|
int insertIndex = onceListeners.BinarySearch(listenerData, SortByAscendingPriority);
|
||||||
|
if (insertIndex < 0)
|
||||||
|
insertIndex = ~insertIndex;
|
||||||
|
|
||||||
|
onceListeners.Insert(insertIndex, listenerData);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Unsubscribes the callback that was previously registered by <see cref="AddListener(EventHandler)"/>.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="listener">The callback that was previously registered by <see cref="AddListener(EventHandler)"/></param>
|
||||||
|
public void RemoveListener(EventHandler listener)
|
||||||
|
{
|
||||||
|
for (int i = listeners.Count - 1; i >= 0; i--)
|
||||||
|
if (listeners[i].Callback == listener)
|
||||||
|
{
|
||||||
|
listeners.RemoveAt(i);
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Unsubscribes the callback that was previously registered by <see cref="AddOneTimeListener(EventHandler)"/>.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="listener">The callback that was previously registered by <see cref="AddOneTimeListener(EventHandler)"/></param>
|
||||||
|
public void RemoveOneTimeListener(EventHandler listener)
|
||||||
|
{
|
||||||
|
for (int i = 0; i < onceListeners.Count; i++)
|
||||||
|
if (onceListeners[i].Callback == listener)
|
||||||
|
{
|
||||||
|
onceListeners.RemoveAt(i);
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Unsubscribes all listeners that was previously registered by either <see cref="AddListener(EventHandler)"/> or <see cref="AddOneTimeListener(EventHandler)"/>.
|
||||||
|
/// </summary>
|
||||||
|
public void Clear() { listeners.Clear(); onceListeners.Clear(); }
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Triggers the event.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="sender">The caller that's triggering this event.</param>
|
||||||
|
/// <param name="args">The arguments provided for this event.</param>
|
||||||
|
public void Invoke(TSender sender, TArguments args)
|
||||||
|
{
|
||||||
|
for (int i = listeners.Count - 1; i >= 0; i--)
|
||||||
|
try { listeners[i].Callback.Invoke(sender, args); }
|
||||||
|
catch (Exception exception)
|
||||||
|
{
|
||||||
|
string methodCallRepresentation = $"{listeners[i].Callback.Method.DeclaringType?.FullName}.{listeners[i].Callback.Method.Name}({sender}, {args})";
|
||||||
|
EventHelpers.LogInvocationException(listeners[i].Callback.Target ?? sender, Logger, exception, methodCallRepresentation);
|
||||||
|
}
|
||||||
|
|
||||||
|
for (int i = onceListeners.Count - 1; i >= 0; i--)
|
||||||
|
{
|
||||||
|
try { onceListeners[i].Callback.Invoke(sender, args); }
|
||||||
|
catch (Exception exception)
|
||||||
|
{
|
||||||
|
string methodCallRepresentation = $"{onceListeners[i].Callback.Method.DeclaringType?.FullName}.{onceListeners[i].Callback.Method.Name}({sender}, {args})";
|
||||||
|
EventHelpers.LogInvocationException(onceListeners[i].Callback.Target ?? sender, Logger, exception, methodCallRepresentation);
|
||||||
|
}
|
||||||
|
onceListeners.RemoveAt(i);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public Event(int initialListenerCount = 4, int initialOnceListenerCount = 2)
|
||||||
|
{
|
||||||
|
listeners = new(initialListenerCount);
|
||||||
|
onceListeners = new(initialOnceListenerCount);
|
||||||
|
}
|
||||||
|
|
||||||
|
public Event()
|
||||||
|
{
|
||||||
|
listeners = new(4);
|
||||||
|
onceListeners = new(2);
|
||||||
|
}
|
||||||
|
|
||||||
|
public delegate void EventHandler(TSender sender, TArguments args);
|
||||||
|
private record struct ListenerData(EventHandler Callback, int Priority);
|
||||||
|
}
|
||||||
|
|
||||||
|
internal static class EventHelpers
|
||||||
|
{
|
||||||
|
public static void LogInvocationException(object sender, ILogger logger, Exception exception, string methodCallRepresentation)
|
||||||
|
{
|
||||||
|
logger.LogException(sender, exception);
|
||||||
|
logger.LogError(sender, $"Unexpected exception on invocation of method {methodCallRepresentation}");
|
||||||
|
}
|
||||||
|
}
|
10
Engine.Core/Helpers/IPool.cs
Normal file
10
Engine.Core/Helpers/IPool.cs
Normal file
@@ -0,0 +1,10 @@
|
|||||||
|
namespace Syntriax.Engine.Core;
|
||||||
|
|
||||||
|
public interface IPool<T>
|
||||||
|
{
|
||||||
|
Event<IPool<T>, T> OnRemoved { get; }
|
||||||
|
Event<IPool<T>, T> OnReturned { get; }
|
||||||
|
|
||||||
|
T Get();
|
||||||
|
void Return(T item);
|
||||||
|
}
|
40
Engine.Core/Helpers/ListPool.cs
Normal file
40
Engine.Core/Helpers/ListPool.cs
Normal file
@@ -0,0 +1,40 @@
|
|||||||
|
using System;
|
||||||
|
using System.Collections.Generic;
|
||||||
|
|
||||||
|
namespace Syntriax.Engine.Core;
|
||||||
|
|
||||||
|
public class ListPool<T> : IPool<List<T>>
|
||||||
|
{
|
||||||
|
public Event<IPool<List<T>>, List<T>> OnReturned { get; } = new();
|
||||||
|
public Event<IPool<List<T>>, List<T>> OnRemoved { get; } = new();
|
||||||
|
|
||||||
|
private readonly Func<List<T>> generator = null!;
|
||||||
|
private readonly Queue<List<T>> queue = new();
|
||||||
|
|
||||||
|
public List<T> Get()
|
||||||
|
{
|
||||||
|
if (!queue.TryDequeue(out List<T>? result))
|
||||||
|
result = generator();
|
||||||
|
|
||||||
|
result.Clear();
|
||||||
|
OnRemoved?.Invoke(this, result);
|
||||||
|
return result;
|
||||||
|
}
|
||||||
|
|
||||||
|
public void Return(List<T> list)
|
||||||
|
{
|
||||||
|
if (queue.Contains(list))
|
||||||
|
return;
|
||||||
|
|
||||||
|
list.Clear();
|
||||||
|
queue.Enqueue(list);
|
||||||
|
OnReturned?.Invoke(this, list);
|
||||||
|
}
|
||||||
|
|
||||||
|
public ListPool(int initialListCount = 1, int initialListCapacity = 32)
|
||||||
|
{
|
||||||
|
generator = () => new(initialListCapacity);
|
||||||
|
for (int i = 0; i < initialListCount; i++)
|
||||||
|
queue.Enqueue(generator());
|
||||||
|
}
|
||||||
|
}
|
38
Engine.Core/Helpers/Pool.cs
Normal file
38
Engine.Core/Helpers/Pool.cs
Normal file
@@ -0,0 +1,38 @@
|
|||||||
|
using System;
|
||||||
|
using System.Collections.Generic;
|
||||||
|
|
||||||
|
namespace Syntriax.Engine.Core;
|
||||||
|
|
||||||
|
public class Pool<T> : IPool<T>
|
||||||
|
{
|
||||||
|
public Event<IPool<T>, T> OnRemoved { get; } = new();
|
||||||
|
public Event<IPool<T>, T> OnReturned { get; } = new();
|
||||||
|
|
||||||
|
private readonly Func<T> generator = null!;
|
||||||
|
private readonly Queue<T> queue = new();
|
||||||
|
|
||||||
|
public T Get()
|
||||||
|
{
|
||||||
|
if (!queue.TryDequeue(out T? result))
|
||||||
|
result = generator();
|
||||||
|
|
||||||
|
OnRemoved?.Invoke(this, result);
|
||||||
|
return result;
|
||||||
|
}
|
||||||
|
|
||||||
|
public void Return(T item)
|
||||||
|
{
|
||||||
|
if (queue.Contains(item))
|
||||||
|
return;
|
||||||
|
|
||||||
|
queue.Enqueue(item);
|
||||||
|
OnReturned?.Invoke(this, item);
|
||||||
|
}
|
||||||
|
|
||||||
|
public Pool(Func<T> generator, int initialCapacity = 1)
|
||||||
|
{
|
||||||
|
this.generator = generator;
|
||||||
|
for (int i = 0; i < initialCapacity; i++)
|
||||||
|
queue.Enqueue(generator());
|
||||||
|
}
|
||||||
|
}
|
7
Engine.Core/Helpers/Progression/IProgressionTracker.cs
Normal file
7
Engine.Core/Helpers/Progression/IProgressionTracker.cs
Normal file
@@ -0,0 +1,7 @@
|
|||||||
|
namespace Syntriax.Engine.Core;
|
||||||
|
|
||||||
|
public interface IProgressionTracker : IReadOnlyProgressionTracker
|
||||||
|
{
|
||||||
|
void Set(float progression, string status);
|
||||||
|
void Reset();
|
||||||
|
}
|
@@ -0,0 +1,12 @@
|
|||||||
|
namespace Syntriax.Engine.Core;
|
||||||
|
|
||||||
|
public interface IReadOnlyProgressionTracker
|
||||||
|
{
|
||||||
|
Event<IReadOnlyProgressionTracker, ProgressionUpdatedArguments> OnUpdated { get; }
|
||||||
|
Event<IReadOnlyProgressionTracker> OnEnded { get; }
|
||||||
|
|
||||||
|
float Progression { get; }
|
||||||
|
string Status { get; }
|
||||||
|
|
||||||
|
readonly record struct ProgressionUpdatedArguments(float PreviousProgression, string PreviousStatus);
|
||||||
|
}
|
36
Engine.Core/Helpers/Progression/ProgressionTracker.cs
Normal file
36
Engine.Core/Helpers/Progression/ProgressionTracker.cs
Normal file
@@ -0,0 +1,36 @@
|
|||||||
|
namespace Syntriax.Engine.Core;
|
||||||
|
|
||||||
|
public class ProgressionTracker : IProgressionTracker
|
||||||
|
{
|
||||||
|
public Event<IReadOnlyProgressionTracker, IReadOnlyProgressionTracker.ProgressionUpdatedArguments> OnUpdated { get; } = new();
|
||||||
|
public Event<IReadOnlyProgressionTracker> OnEnded { get; } = new();
|
||||||
|
|
||||||
|
public float Progression { get; private set; } = 0f;
|
||||||
|
public string Status { get; private set; } = "Default";
|
||||||
|
|
||||||
|
void IProgressionTracker.Set(float progression, string status)
|
||||||
|
{
|
||||||
|
if (Progression >= 1f)
|
||||||
|
return;
|
||||||
|
|
||||||
|
float previousProgression = Progression;
|
||||||
|
string previousStatus = Status;
|
||||||
|
|
||||||
|
Progression = progression.Clamp(Progression, 1f);
|
||||||
|
Status = status;
|
||||||
|
|
||||||
|
OnUpdated?.Invoke(this, new(previousProgression, previousStatus));
|
||||||
|
|
||||||
|
if (progression >= 1f)
|
||||||
|
OnEnded?.Invoke(this);
|
||||||
|
}
|
||||||
|
|
||||||
|
void IProgressionTracker.Reset()
|
||||||
|
{
|
||||||
|
Progression = 0f;
|
||||||
|
Status = "Default";
|
||||||
|
|
||||||
|
OnUpdated.Clear();
|
||||||
|
OnEnded.Clear();
|
||||||
|
}
|
||||||
|
}
|
9
Engine.Core/Helpers/Progression/ProgressiveTask.cs
Normal file
9
Engine.Core/Helpers/Progression/ProgressiveTask.cs
Normal file
@@ -0,0 +1,9 @@
|
|||||||
|
using System.Threading.Tasks;
|
||||||
|
|
||||||
|
namespace Syntriax.Engine.Core;
|
||||||
|
|
||||||
|
public record struct ProgressiveTask<T>(IReadOnlyProgressionTracker ProgressionTracker, Task<T> Task)
|
||||||
|
{
|
||||||
|
public static implicit operator (IReadOnlyProgressionTracker progressionTracker, Task<T> task)(ProgressiveTask<T> value) => (value.ProgressionTracker, value.Task);
|
||||||
|
public static implicit operator ProgressiveTask<T>((IReadOnlyProgressionTracker progressionTracker, Task<T> task) value) => new(value.progressionTracker, value.task);
|
||||||
|
}
|
@@ -6,29 +6,87 @@ namespace Syntriax.Engine.Core;
|
|||||||
public static class Math
|
public static class Math
|
||||||
{
|
{
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// The value of Pi (π), a mathematical constant approximately equal to 3.14159.
|
/// The value of Pi (π).
|
||||||
/// </summary>
|
/// </summary>
|
||||||
public const float PI = 3.1415926535897932f;
|
public const float Pi = 3.1415926535897932f;
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// The value of Tau (τ), a mathematical constant equal to 2π, approximately equal to 6.28319.
|
/// The value of Tau (τ), mathematical constant equal to 2π.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
public const float Tau = 2f * PI;
|
public const float Tau = 2f * Pi;
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// The base of the natural logarithm, approximately equal to 2.71828.
|
/// The base of the natural logarithm.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
public const float E = 2.718281828459045f;
|
public const float E = 2.718281828459045f;
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// The conversion factor from radians to degrees.
|
/// The conversion factor from radians to degrees.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
public const float RadianToDegree = 180f / PI;
|
public const float RadianToDegree = 180f / Pi;
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// The conversion factor from degrees to radians.
|
/// The conversion factor from degrees to radians.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
public const float DegreeToRadian = PI / 180f;
|
public const float DegreeToRadian = Pi / 180f;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Gets one minus of given <see cref="T"/>.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="value">The value <see cref="T"/>.</param>
|
||||||
|
/// <returns>One minus of given <see cref="T"/>.</returns>
|
||||||
|
public static T OneMinus<T>(T value) where T : INumber<T> => T.One - value;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Adds two <see cref="T"/>s.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="left">The first <see cref="T"/>.</param>
|
||||||
|
/// <param name="value">The second <see cref="T"/>.</param>
|
||||||
|
/// <returns>The sum of the two <see cref="T"/>s.</returns>
|
||||||
|
public static T Add<T>(T left, T value) where T : INumber<T> => left + value;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Subtracts one <see cref="T"/> from another.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="left">The <see cref="T"/> to subtract from.</param>
|
||||||
|
/// <param name="value">The <see cref="T"/> to subtract.</param>
|
||||||
|
/// <returns>The result of subtracting the second <see cref="T"/> from the first.</returns>
|
||||||
|
public static T Subtract<T>(T left, T value) where T : INumber<T> => left - value;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Multiplies a <see cref="T"/> by a scalar value.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="left">The <see cref="T"/>.</param>
|
||||||
|
/// <param name="multiplier">The scalar value.</param>
|
||||||
|
/// <returns>The result of multiplying the <see cref="T"/> by the scalar value.</returns>
|
||||||
|
public static T Multiply<T>(T left, T multiplier) where T : INumber<T> => left * multiplier;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Divides a <see cref="T"/> by a scalar value.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="left">The <see cref="T"/>.</param>
|
||||||
|
/// <param name="divider">The scalar value.</param>
|
||||||
|
/// <returns>The result of dividing the <see cref="T"/> by the scalar value.</returns>
|
||||||
|
public static T Divide<T>(T left, T divider) where T : INumber<T> => left / divider;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Returns the true mathematical modulus of a <see cref="T"/> value.
|
||||||
|
/// Unlike the remainder operator (%), this result is always non-negative,
|
||||||
|
/// even when the <paramref name="value"/> operand is negative.
|
||||||
|
/// </summary>
|
||||||
|
/// <typeparam name="T">A numeric type that implements <see cref="INumber{T}"/>.</typeparam>
|
||||||
|
/// <param name="value">The dividend <see cref="T"/> value.</param>
|
||||||
|
/// <param name="modulus">The modulus <see cref="T"/> value (must be non-zero).</param>
|
||||||
|
/// <returns>
|
||||||
|
/// The non-negative remainder of <paramref name="value"/> divided by <paramref name="modulus"/>.
|
||||||
|
/// </returns>
|
||||||
|
public static T Mod<T>(T value, T modulus) where T : INumber<T>
|
||||||
|
{
|
||||||
|
T result = value % modulus;
|
||||||
|
if (result < T.Zero)
|
||||||
|
result += modulus;
|
||||||
|
return result;
|
||||||
|
}
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Returns the absolute value of a number.
|
/// Returns the absolute value of a number.
|
||||||
@@ -190,6 +248,15 @@ public static class Math
|
|||||||
/// <returns>The number <paramref name="x"/> rounded to <paramref name="digits"/> fractional digits.</returns>
|
/// <returns>The number <paramref name="x"/> rounded to <paramref name="digits"/> fractional digits.</returns>
|
||||||
public static float Round(float x, int digits, MidpointRounding mode) => MathF.Round(x, digits, mode);
|
public static float Round(float x, int digits, MidpointRounding mode) => MathF.Round(x, digits, mode);
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Rounds a number to an integer.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="x">The number to round.</param>
|
||||||
|
/// <param name="roundMode">Specification for how to round <paramref name="x"/> if it's midway between two numbers</param>
|
||||||
|
/// <returns></returns>
|
||||||
|
public static int RoundToInt(float x, RoundMode roundMode = RoundMode.Ceil) => (int)MathF.Round(x, 0, roundMode == RoundMode.Ceil ? MidpointRounding.ToPositiveInfinity : MidpointRounding.ToNegativeInfinity);
|
||||||
|
public enum RoundMode { Ceil, Floor };
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Returns the square of a number.
|
/// Returns the square of a number.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
|
@@ -5,6 +5,24 @@ namespace Syntriax.Engine.Core;
|
|||||||
|
|
||||||
public static class MathExtensions
|
public static class MathExtensions
|
||||||
{
|
{
|
||||||
|
/// <inheritdoc cref="Math.OneMinus{T}(T)" />
|
||||||
|
public static T OneMinus<T>(this T value) where T : INumber<T> => Math.OneMinus(value);
|
||||||
|
|
||||||
|
/// <inheritdoc cref="Math.Add{T}(T, T)" />
|
||||||
|
public static T Add<T>(this T left, T value) where T : INumber<T> => Math.Add(left, value);
|
||||||
|
|
||||||
|
/// <inheritdoc cref="Math.Subtract{T}(T, T)" />
|
||||||
|
public static T Subtract<T>(this T left, T value) where T : INumber<T> => Math.Subtract(left, value);
|
||||||
|
|
||||||
|
/// <inheritdoc cref="Math.Multiply{T}(T, T)" />
|
||||||
|
public static T Multiply<T>(this T left, T multiplier) where T : INumber<T> => Math.Multiply(left, multiplier);
|
||||||
|
|
||||||
|
/// <inheritdoc cref="Math.Divide{T}(T, T)" />
|
||||||
|
public static T Divide<T>(this T left, T divider) where T : INumber<T> => Math.Divide(left, divider);
|
||||||
|
|
||||||
|
/// <inheritdoc cref="Math.Mod{T}(T, T)" />
|
||||||
|
public static T Mod<T>(this T value, T modulus) where T : INumber<T> => Math.Mod(value, modulus);
|
||||||
|
|
||||||
/// <inheritdoc cref="Math.Abs{T}(T)" />
|
/// <inheritdoc cref="Math.Abs{T}(T)" />
|
||||||
public static T Abs<T>(this T x) where T : INumber<T> => Math.Abs(x);
|
public static T Abs<T>(this T x) where T : INumber<T> => Math.Abs(x);
|
||||||
|
|
||||||
@@ -65,6 +83,9 @@ public static class MathExtensions
|
|||||||
/// <inheritdoc cref="Math.Round(float, int, MidpointRounding)" />
|
/// <inheritdoc cref="Math.Round(float, int, MidpointRounding)" />
|
||||||
public static float Round(this float x, int digits, MidpointRounding mode) => Math.Round(x, digits, mode);
|
public static float Round(this float x, int digits, MidpointRounding mode) => Math.Round(x, digits, mode);
|
||||||
|
|
||||||
|
/// <inheritdoc cref="Math.RoundToInt(float, Math.RoundMode)" />
|
||||||
|
public static int RoundToInt(this float x, Math.RoundMode roundMode = Math.RoundMode.Ceil) => Math.RoundToInt(x, roundMode);
|
||||||
|
|
||||||
/// <inheritdoc cref="Math.Sqr{T}(T)" />
|
/// <inheritdoc cref="Math.Sqr{T}(T)" />
|
||||||
public static T Sqr<T>(this T x) where T : INumber<T> => Math.Sqr(x);
|
public static T Sqr<T>(this T x) where T : INumber<T> => Math.Sqr(x);
|
||||||
|
|
||||||
|
10
Engine.Core/Preserver.cs
Normal file
10
Engine.Core/Preserver.cs
Normal file
@@ -0,0 +1,10 @@
|
|||||||
|
namespace Syntriax.Engine.Core
|
||||||
|
{
|
||||||
|
// This is pretty much so the assembly gets loaded automatically because
|
||||||
|
// the builds include the assembly but sometimes doesn't link load it at startup.
|
||||||
|
// I will hopefully one day fix it and remove this.
|
||||||
|
public static class Preserver
|
||||||
|
{
|
||||||
|
public static void Preserve() { }
|
||||||
|
}
|
||||||
|
}
|
@@ -38,6 +38,9 @@ public readonly struct AABB(Vector2D lowerBoundary, Vector2D upperBoundary)
|
|||||||
/// </summary>
|
/// </summary>
|
||||||
public readonly Vector2D SizeHalf => Size * .5f;
|
public readonly Vector2D SizeHalf => Size * .5f;
|
||||||
|
|
||||||
|
public static bool operator ==(AABB left, AABB right) => left.UpperBoundary == right.UpperBoundary && left.LowerBoundary == right.LowerBoundary;
|
||||||
|
public static bool operator !=(AABB left, AABB right) => left.UpperBoundary != right.UpperBoundary || left.LowerBoundary != right.LowerBoundary;
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Creates an <see cref="AABB"/> from a collection of <see cref="Vector2D"/>s.
|
/// Creates an <see cref="AABB"/> from a collection of <see cref="Vector2D"/>s.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
@@ -63,12 +66,6 @@ public readonly struct AABB(Vector2D lowerBoundary, Vector2D upperBoundary)
|
|||||||
return new(lowerBoundary, upperBoundary);
|
return new(lowerBoundary, upperBoundary);
|
||||||
}
|
}
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Converts the <see cref="AABB"/> to its string representation.
|
|
||||||
/// </summary>
|
|
||||||
/// <returns>A string representation of the <see cref="AABB"/>.</returns>
|
|
||||||
public override string ToString() => $"{nameof(AABB)}({LowerBoundary}, {UpperBoundary})";
|
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Checks if two <see cref="AABB"/>s are approximately equal.
|
/// Checks if two <see cref="AABB"/>s are approximately equal.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
@@ -78,6 +75,25 @@ public readonly struct AABB(Vector2D lowerBoundary, Vector2D upperBoundary)
|
|||||||
/// <returns><see cref="true"/> if the <see cref="AABB"/>s are approximately equal; otherwise, <see cref="false"/>.</returns>
|
/// <returns><see cref="true"/> if the <see cref="AABB"/>s are approximately equal; otherwise, <see cref="false"/>.</returns>
|
||||||
public static bool ApproximatelyEquals(AABB left, AABB right, float epsilon = float.Epsilon)
|
public static bool ApproximatelyEquals(AABB left, AABB right, float epsilon = float.Epsilon)
|
||||||
=> left.LowerBoundary.ApproximatelyEquals(right.LowerBoundary, epsilon) && left.UpperBoundary.ApproximatelyEquals(right.UpperBoundary, epsilon);
|
=> left.LowerBoundary.ApproximatelyEquals(right.LowerBoundary, epsilon) && left.UpperBoundary.ApproximatelyEquals(right.UpperBoundary, epsilon);
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Determines whether the specified object is equal to the current <see cref="AABB"/>.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="obj">The object to compare with the current <see cref="AABB"/>.</param>
|
||||||
|
/// <returns><see cref="true"/> if the specified object is equal to the current <see cref="AABB"/>; otherwise, <see cref="false"/>.</returns>
|
||||||
|
public override bool Equals(object? obj) => obj is AABB aabb && this == aabb;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Generates a hash code for the <see cref="AABB"/>.
|
||||||
|
/// </summary>
|
||||||
|
/// <returns>A hash code for the <see cref="AABB"/>.</returns>
|
||||||
|
public override int GetHashCode() => System.HashCode.Combine(LowerBoundary, UpperBoundary);
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Converts the <see cref="AABB"/> to its string representation.
|
||||||
|
/// </summary>
|
||||||
|
/// <returns>A string representation of the <see cref="AABB"/>.</returns>
|
||||||
|
public override string ToString() => $"{nameof(AABB)}({LowerBoundary}, {UpperBoundary})";
|
||||||
}
|
}
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
|
@@ -38,6 +38,9 @@ public readonly struct Circle(Vector2D center, float radius)
|
|||||||
/// </summary>
|
/// </summary>
|
||||||
public static readonly Circle UnitCircle = new(Vector2D.Zero, 1f);
|
public static readonly Circle UnitCircle = new(Vector2D.Zero, 1f);
|
||||||
|
|
||||||
|
public static bool operator ==(Circle left, Circle right) => left.Center == right.Center && left.Radius == right.Radius;
|
||||||
|
public static bool operator !=(Circle left, Circle right) => left.Center != right.Center || left.Radius != right.Radius;
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Sets the center of the <see cref="Circle"/>.
|
/// Sets the center of the <see cref="Circle"/>.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
@@ -77,6 +80,25 @@ public readonly struct Circle(Vector2D center, float radius)
|
|||||||
/// <returns><see cref="true"/> if the <see cref="Circle"/>s are approximately equal; otherwise, <see cref="false"/>.</returns>
|
/// <returns><see cref="true"/> if the <see cref="Circle"/>s are approximately equal; otherwise, <see cref="false"/>.</returns>
|
||||||
public static bool ApproximatelyEquals(Circle left, Circle right, float epsilon = float.Epsilon)
|
public static bool ApproximatelyEquals(Circle left, Circle right, float epsilon = float.Epsilon)
|
||||||
=> left.Center.ApproximatelyEquals(right.Center, epsilon) && left.Radius.ApproximatelyEquals(right.Radius, epsilon);
|
=> left.Center.ApproximatelyEquals(right.Center, epsilon) && left.Radius.ApproximatelyEquals(right.Radius, epsilon);
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Determines whether the specified object is equal to the current <see cref="Circle"/>.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="obj">The object to compare with the current <see cref="Circle"/>.</param>
|
||||||
|
/// <returns><see cref="true"/> if the specified object is equal to the current <see cref="Circle"/>; otherwise, <see cref="false"/>.</returns>
|
||||||
|
public override bool Equals(object? obj) => obj is Circle circle && this == circle;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Generates a hash code for the <see cref="Circle"/>.
|
||||||
|
/// </summary>
|
||||||
|
/// <returns>A hash code for the <see cref="Circle"/>.</returns>
|
||||||
|
public override int GetHashCode() => System.HashCode.Combine(Center, Radius);
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Converts the <see cref="Circle"/> to its string representation.
|
||||||
|
/// </summary>
|
||||||
|
/// <returns>A string representation of the <see cref="Circle"/>.</returns>
|
||||||
|
public override string ToString() => $"{nameof(Circle)}({Center}, {Radius})";
|
||||||
}
|
}
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
|
151
Engine.Core/Primitives/ColorHSV.cs
Normal file
151
Engine.Core/Primitives/ColorHSV.cs
Normal file
@@ -0,0 +1,151 @@
|
|||||||
|
namespace Syntriax.Engine.Core;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Represents an HSV color.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="hue">Hue of the <see cref="ColorHSV"/>.</param>
|
||||||
|
/// <param name="saturation">Saturation of the <see cref="ColorHSV"/>.</param>
|
||||||
|
/// <param name="value">Value of the <see cref="ColorHSV"/>.</param>
|
||||||
|
/// <remarks>
|
||||||
|
/// Initializes a new instance of the <see cref="ColorHSV"/> struct with the specified values.
|
||||||
|
/// </remarks>
|
||||||
|
[System.Diagnostics.DebuggerDisplay("{ToString(),nq}")]
|
||||||
|
public readonly struct ColorHSV(float hue, float saturation, float value)
|
||||||
|
{
|
||||||
|
/// <summary>
|
||||||
|
/// The Hue value of the <see cref="ColorHSV"/>.
|
||||||
|
/// </summary>
|
||||||
|
public readonly float Hue = hue.Clamp(0f, 1f);
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// The Saturation value of the <see cref="ColorHSV"/>.
|
||||||
|
/// </summary>
|
||||||
|
public readonly float Saturation = saturation.Clamp(0f, 1f);
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// The Value value of the <see cref="ColorHSV"/>.
|
||||||
|
/// </summary>
|
||||||
|
public readonly float Value = value.Clamp(0f, 1f);
|
||||||
|
|
||||||
|
public static ColorHSV operator -(ColorHSV color) => new(color.Hue.OneMinus(), color.Saturation.OneMinus(), color.Value.OneMinus());
|
||||||
|
public static ColorHSV operator +(ColorHSV left, ColorHSV right) => new(left.Hue + right.Hue, left.Saturation + right.Saturation, left.Value + right.Value);
|
||||||
|
public static ColorHSV operator -(ColorHSV left, ColorHSV right) => new(left.Hue - right.Hue, left.Saturation - right.Saturation, left.Value - right.Value);
|
||||||
|
public static ColorHSV operator *(ColorHSV left, ColorHSV right) => new(left.Hue * right.Hue, left.Saturation * right.Saturation, left.Value * right.Value);
|
||||||
|
public static ColorHSV operator *(ColorHSV color, float value) => new(color.Hue * value, color.Saturation * value, color.Value * value);
|
||||||
|
public static ColorHSV operator *(float value, ColorHSV color) => new(color.Hue * value, color.Saturation * value, color.Value * value);
|
||||||
|
public static ColorHSV operator /(ColorHSV color, float value) => new(color.Hue / value, color.Saturation / value, color.Value / value);
|
||||||
|
public static bool operator ==(ColorHSV left, ColorHSV right) => left.Hue == right.Hue && left.Saturation == right.Saturation && left.Value == right.Value;
|
||||||
|
public static bool operator !=(ColorHSV left, ColorHSV right) => left.Hue != right.Hue || left.Saturation != right.Saturation || left.Value != right.Value;
|
||||||
|
|
||||||
|
public static implicit operator ColorHSV(ColorHSVA hsva) => new(hsva.Hue, hsva.Saturation, hsva.Value);
|
||||||
|
public static implicit operator ColorHSV(ColorRGBA rgba) => (ColorHSVA)rgba;
|
||||||
|
public static implicit operator ColorHSV(ColorRGB rgb) => (ColorHSVA)rgb;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Inverts the given <see cref="ColorHSV"/>.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="color">The <see cref="ColorHSV"/>.</param>
|
||||||
|
/// <returns>The inverted <see cref="ColorHSV"/>.</returns>
|
||||||
|
public static ColorHSV Invert(ColorHSV color) => -color;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Adds two <see cref="ColorHSV"/>s.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="left">The first <see cref="ColorHSV"/>.</param>
|
||||||
|
/// <param name="right">The second <see cref="ColorHSV"/>.</param>
|
||||||
|
/// <returns>The sum of the two <see cref="ColorHSV"/>s.</returns>
|
||||||
|
public static ColorHSV Add(ColorHSV left, ColorHSV right) => left + right;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Subtracts one <see cref="ColorHSV"/> from another.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="left">The <see cref="ColorHSV"/> to subtract from.</param>
|
||||||
|
/// <param name="right">The <see cref="ColorHSV"/> to subtract.</param>
|
||||||
|
/// <returns>The result of subtracting the second <see cref="ColorHSV"/> from the first.</returns>
|
||||||
|
public static ColorHSV Subtract(ColorHSV left, ColorHSV right) => left - right;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Multiplies a <see cref="ColorHSV"/> by a scalar value.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="color">The <see cref="ColorHSV"/>.</param>
|
||||||
|
/// <param name="value">The scalar value.</param>
|
||||||
|
/// <returns>The result of multiplying the <see cref="ColorHSV"/> by the scalar value.</returns>
|
||||||
|
public static ColorHSV Multiply(ColorHSV color, float value) => color * value;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Divides a <see cref="ColorHSV"/> by a scalar value.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="color">The <see cref="ColorHSV"/>.</param>
|
||||||
|
/// <param name="value">The scalar value.</param>
|
||||||
|
/// <returns>The result of dividing the <see cref="ColorHSV"/> by the scalar value.</returns>
|
||||||
|
public static ColorHSV Divide(ColorHSV color, float value) => color / value;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Performs linear interpolation between two <see cref="ColorHSV"/>s.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="from">The starting <see cref="ColorHSV"/> (t = 0).</param>
|
||||||
|
/// <param name="to">The ending <see cref="ColorHSV"/> (t = 1).</param>
|
||||||
|
/// <param name="t">The interpolation parameter.</param>
|
||||||
|
/// <returns>The interpolated <see cref="ColorHSV"/>.</returns>
|
||||||
|
public static ColorHSV Lerp(ColorHSV from, ColorHSV to, float t)
|
||||||
|
{
|
||||||
|
float hueDiff = to.Hue - from.Hue;
|
||||||
|
float saturationDiff = to.Saturation - from.Saturation;
|
||||||
|
float valueDiff = to.Value - from.Value;
|
||||||
|
|
||||||
|
return from + new ColorHSV(hueDiff * t, saturationDiff * t, valueDiff * t);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Checks if two <see cref="ColorHSV"/>s are approximately equal within a specified epsilon range.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="left">The first <see cref="ColorHSV"/>.</param>
|
||||||
|
/// <param name="right">The second <see cref="ColorHSV"/>.</param>
|
||||||
|
/// <param name="epsilon">The epsilon range.</param>
|
||||||
|
/// <returns><see cref="true"/> if the <see cref="ColorHSV"/>s are approximately equal; otherwise, <see cref="false"/>.</returns>
|
||||||
|
public static bool ApproximatelyEquals(ColorHSV left, ColorHSV right, float epsilon = float.Epsilon)
|
||||||
|
=> left.Hue.ApproximatelyEquals(right.Hue, epsilon) && left.Saturation.ApproximatelyEquals(right.Saturation, epsilon) && left.Value.ApproximatelyEquals(right.Value, epsilon);
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Determines whether the specified object is equal to the current <see cref="ColorHSV"/>.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="obj">The object to compare with the current <see cref="ColorHSV"/>.</param>
|
||||||
|
/// <returns><see cref="true"/> if the specified object is equal to the current <see cref="ColorHSV"/>; otherwise, <see cref="false"/>.</returns>
|
||||||
|
public override bool Equals(object? obj) => obj is ColorHSV colorHSV && this == colorHSV;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Generates a hash code for the <see cref="ColorHSV"/>.
|
||||||
|
/// </summary>
|
||||||
|
/// <returns>A hash code for the <see cref="ColorHSV"/>.</returns>
|
||||||
|
public override int GetHashCode() => System.HashCode.Combine(Hue, Saturation, Value);
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Converts the <see cref="ColorHSV"/> to its string representation.
|
||||||
|
/// </summary>
|
||||||
|
/// <returns>A string representation of the <see cref="ColorHSV"/>.</returns>
|
||||||
|
public override string ToString() => $"{nameof(ColorHSV)}({Hue}, {Saturation}, {Value})";
|
||||||
|
}
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Provides extension methods for <see cref="ColorHSV"/> type.
|
||||||
|
/// </summary>
|
||||||
|
public static class ColorHSVExtensions
|
||||||
|
{
|
||||||
|
/// <inheritdoc cref="ColorHSV.Add(ColorHSV, ColorHSV)" />
|
||||||
|
public static ColorHSV Add(this ColorHSV color, ColorHSV value) => ColorHSV.Add(color, value);
|
||||||
|
|
||||||
|
/// <inheritdoc cref="ColorHSV.Subtract(ColorHSV, ColorHSV)" />
|
||||||
|
public static ColorHSV Subtract(this ColorHSV color, ColorHSV value) => ColorHSV.Subtract(color, value);
|
||||||
|
|
||||||
|
/// <inheritdoc cref="ColorHSV.Multiply(ColorHSV, ColorHSV)" />
|
||||||
|
public static ColorHSV Multiply(this ColorHSV color, float value) => ColorHSV.Multiply(color, value);
|
||||||
|
|
||||||
|
/// <inheritdoc cref="ColorHSV.Divide(ColorHSV, ColorHSV)" />
|
||||||
|
public static ColorHSV Divide(this ColorHSV color, float value) => ColorHSV.Divide(color, value);
|
||||||
|
|
||||||
|
/// <inheritdoc cref="ColorHSV.Lerp(ColorHSV, ColorHSV, float)" />
|
||||||
|
public static ColorHSV Lerp(this ColorHSV from, ColorHSV to, float t) => ColorHSV.Lerp(from, to, t);
|
||||||
|
|
||||||
|
/// <inheritdoc cref="ColorHSV.ApproximatelyEquals(ColorHSV, ColorHSV, float) " />
|
||||||
|
public static bool ApproximatelyEquals(this ColorHSV left, ColorHSV right, float epsilon = float.Epsilon) => ColorHSV.ApproximatelyEquals(left, right, epsilon);
|
||||||
|
}
|
189
Engine.Core/Primitives/ColorHSVA.cs
Normal file
189
Engine.Core/Primitives/ColorHSVA.cs
Normal file
@@ -0,0 +1,189 @@
|
|||||||
|
namespace Syntriax.Engine.Core;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Represents an HSV color.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="hue">Hue of the <see cref="ColorHSVA"/>.</param>
|
||||||
|
/// <param name="saturation">Saturation of the <see cref="ColorHSVA"/>.</param>
|
||||||
|
/// <param name="value">Value of the <see cref="ColorHSVA"/>.</param>
|
||||||
|
/// <param name="alpha">Alpha of the <see cref="ColorHSVA"/>.</param>
|
||||||
|
/// <remarks>
|
||||||
|
/// Initializes a new instance of the <see cref="ColorHSVA"/> struct with the specified values.
|
||||||
|
/// </remarks>
|
||||||
|
[System.Diagnostics.DebuggerDisplay("{ToString(),nq}")]
|
||||||
|
public readonly struct ColorHSVA(float hue, float saturation, float value, float alpha = 1)
|
||||||
|
{
|
||||||
|
/// <summary>
|
||||||
|
/// The Hue value of the <see cref="ColorHSVA"/>.
|
||||||
|
/// </summary>
|
||||||
|
public readonly float Hue = hue.Clamp(0f, 1f);
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// The Saturation value of the <see cref="ColorHSVA"/>.
|
||||||
|
/// </summary>
|
||||||
|
public readonly float Saturation = saturation.Clamp(0f, 1f);
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// The Value value of the <see cref="ColorHSVA"/>.
|
||||||
|
/// </summary>
|
||||||
|
public readonly float Value = value.Clamp(0f, 1f);
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// The Alpha value of the <see cref="ColorHSVA"/>.
|
||||||
|
/// </summary>
|
||||||
|
public readonly float Alpha = alpha;
|
||||||
|
|
||||||
|
public static ColorHSVA operator -(ColorHSVA color) => new(color.Hue.OneMinus(), color.Saturation.OneMinus(), color.Value.OneMinus(), color.Alpha);
|
||||||
|
public static ColorHSVA operator +(ColorHSVA left, ColorHSVA right) => new(left.Hue + right.Hue, left.Saturation + right.Saturation, left.Value + right.Value, left.Alpha + right.Alpha);
|
||||||
|
public static ColorHSVA operator -(ColorHSVA left, ColorHSVA right) => new(left.Hue - right.Hue, left.Saturation - right.Saturation, left.Value - right.Value, left.Alpha - right.Alpha);
|
||||||
|
public static ColorHSVA operator *(ColorHSVA left, ColorHSVA right) => new(left.Hue * right.Hue, left.Saturation * right.Saturation, left.Value * right.Value, left.Alpha * right.Alpha);
|
||||||
|
public static ColorHSVA operator *(ColorHSVA color, float value) => new(color.Hue * value, color.Saturation * value, color.Value * value, color.Alpha * value);
|
||||||
|
public static ColorHSVA operator *(float value, ColorHSVA color) => new(color.Hue * value, color.Saturation * value, color.Value * value, color.Alpha * value);
|
||||||
|
public static ColorHSVA operator /(ColorHSVA color, float value) => new(color.Hue / value, color.Saturation / value, color.Value / value, color.Alpha / value);
|
||||||
|
public static bool operator ==(ColorHSVA left, ColorHSVA right) => left.Hue == right.Hue && left.Saturation == right.Saturation && left.Value == right.Value;
|
||||||
|
public static bool operator !=(ColorHSVA left, ColorHSVA right) => left.Hue != right.Hue || left.Saturation != right.Saturation || left.Value != right.Value;
|
||||||
|
|
||||||
|
public static implicit operator ColorHSVA(ColorHSV hsv) => new(hsv.Hue, hsv.Saturation, hsv.Value, 1f);
|
||||||
|
public static implicit operator ColorHSVA(ColorRGB rgb) => (ColorRGBA)rgb;
|
||||||
|
public static implicit operator ColorHSVA(ColorRGBA rgba)
|
||||||
|
{
|
||||||
|
float hue;
|
||||||
|
float saturation;
|
||||||
|
float value;
|
||||||
|
|
||||||
|
float rd = rgba.R / 255f;
|
||||||
|
float gd = rgba.G / 255f;
|
||||||
|
float bd = rgba.B / 255f;
|
||||||
|
|
||||||
|
float max = Math.Max(rd, Math.Max(gd, bd));
|
||||||
|
float min = Math.Min(rd, Math.Min(gd, bd));
|
||||||
|
float delta = max - min;
|
||||||
|
|
||||||
|
if (delta.ApproximatelyEquals(0))
|
||||||
|
hue = 0f;
|
||||||
|
else if (max.ApproximatelyEquals(rd))
|
||||||
|
hue = 60f * ((gd - bd) / delta % 6f);
|
||||||
|
else if (max.ApproximatelyEquals(gd))
|
||||||
|
hue = 60f * (((bd - rd) / delta) + 2f);
|
||||||
|
else
|
||||||
|
hue = 60f * (((rd - gd) / delta) + 4f);
|
||||||
|
|
||||||
|
if (hue < 0f)
|
||||||
|
hue += 360f;
|
||||||
|
|
||||||
|
hue /= 360f;
|
||||||
|
saturation = max.ApproximatelyEquals(0f) ? 0f : delta / max;
|
||||||
|
value = max;
|
||||||
|
|
||||||
|
return new(hue, saturation, value, rgba.A / 255f);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Inverts the given <see cref="ColorHSVA"/>.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="color">The <see cref="ColorHSVA"/>.</param>
|
||||||
|
/// <returns>The inverted <see cref="ColorHSVA"/>.</returns>
|
||||||
|
public static ColorHSVA Invert(ColorHSVA color) => -color;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Adds two <see cref="ColorHSVA"/>s.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="left">The first <see cref="ColorHSVA"/>.</param>
|
||||||
|
/// <param name="right">The second <see cref="ColorHSVA"/>.</param>
|
||||||
|
/// <returns>The sum of the two <see cref="ColorHSVA"/>s.</returns>
|
||||||
|
public static ColorHSVA Add(ColorHSVA left, ColorHSVA right) => left + right;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Subtracts one <see cref="ColorHSVA"/> from another.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="left">The <see cref="ColorHSVA"/> to subtract from.</param>
|
||||||
|
/// <param name="right">The <see cref="ColorHSVA"/> to subtract.</param>
|
||||||
|
/// <returns>The result of subtracting the second <see cref="ColorHSVA"/> from the first.</returns>
|
||||||
|
public static ColorHSVA Subtract(ColorHSVA left, ColorHSVA right) => left - right;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Multiplies a <see cref="ColorHSVA"/> by a scalar value.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="color">The <see cref="ColorHSVA"/>.</param>
|
||||||
|
/// <param name="value">The scalar value.</param>
|
||||||
|
/// <returns>The result of multiplying the <see cref="ColorHSVA"/> by the scalar value.</returns>
|
||||||
|
public static ColorHSVA Multiply(ColorHSVA color, float value) => color * value;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Divides a <see cref="ColorHSVA"/> by a scalar value.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="color">The <see cref="ColorHSVA"/>.</param>
|
||||||
|
/// <param name="value">The scalar value.</param>
|
||||||
|
/// <returns>The result of dividing the <see cref="ColorHSVA"/> by the scalar value.</returns>
|
||||||
|
public static ColorHSVA Divide(ColorHSVA color, float value) => color / value;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Performs linear interpolation between two <see cref="ColorHSVA"/>s.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="from">The starting <see cref="ColorHSVA"/> (t = 0).</param>
|
||||||
|
/// <param name="to">The ending <see cref="ColorHSVA"/> (t = 1).</param>
|
||||||
|
/// <param name="t">The interpolation parameter.</param>
|
||||||
|
/// <returns>The interpolated <see cref="ColorHSVA"/>.</returns>
|
||||||
|
public static ColorHSVA Lerp(ColorHSVA from, ColorHSVA to, float t)
|
||||||
|
{
|
||||||
|
float hueDiff = to.Hue - from.Hue;
|
||||||
|
float saturationDiff = to.Saturation - from.Saturation;
|
||||||
|
float valueDiff = to.Value - from.Value;
|
||||||
|
float alphaDiff = to.Alpha - from.Alpha;
|
||||||
|
|
||||||
|
return from + new ColorHSVA(hueDiff * t, saturationDiff * t, valueDiff * t, alphaDiff * t);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Checks if two <see cref="ColorHSVA"/>s are approximately equal within a specified epsilon range.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="left">The first <see cref="ColorHSVA"/>.</param>
|
||||||
|
/// <param name="right">The second <see cref="ColorHSVA"/>.</param>
|
||||||
|
/// <param name="epsilon">The epsilon range.</param>
|
||||||
|
/// <returns><see cref="true"/> if the <see cref="ColorHSVA"/>s are approximately equal; otherwise, <see cref="false"/>.</returns>
|
||||||
|
public static bool ApproximatelyEquals(ColorHSVA left, ColorHSVA right, float epsilon = float.Epsilon)
|
||||||
|
=> left.Hue.ApproximatelyEquals(right.Hue, epsilon) && left.Saturation.ApproximatelyEquals(right.Saturation, epsilon) && left.Value.ApproximatelyEquals(right.Value, epsilon);
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Determines whether the specified object is equal to the current <see cref="ColorHSVA"/>.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="obj">The object to compare with the current <see cref="ColorHSVA"/>.</param>
|
||||||
|
/// <returns><see cref="true"/> if the specified object is equal to the current <see cref="ColorHSVA"/>; otherwise, <see cref="false"/>.</returns>
|
||||||
|
public override bool Equals(object? obj) => obj is ColorHSVA colorHSVA && this == colorHSVA;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Generates a hash code for the <see cref="ColorHSVA"/>.
|
||||||
|
/// </summary>
|
||||||
|
/// <returns>A hash code for the <see cref="ColorHSVA"/>.</returns>
|
||||||
|
public override int GetHashCode() => System.HashCode.Combine(Hue, Saturation, Value);
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Converts the <see cref="ColorHSVA"/> to its string representation.
|
||||||
|
/// </summary>
|
||||||
|
/// <returns>A string representation of the <see cref="ColorHSVA"/>.</returns>
|
||||||
|
public override string ToString() => $"{nameof(ColorHSVA)}({Hue}, {Saturation}, {Value})";
|
||||||
|
}
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Provides extension methods for <see cref="ColorHSVA"/> type.
|
||||||
|
/// </summary>
|
||||||
|
public static class ColorHSVAExtensions
|
||||||
|
{
|
||||||
|
/// <inheritdoc cref="ColorHSVA.Add(ColorHSVA, ColorHSVA)" />
|
||||||
|
public static ColorHSVA Add(this ColorHSVA color, ColorHSVA value) => ColorHSVA.Add(color, value);
|
||||||
|
|
||||||
|
/// <inheritdoc cref="ColorHSVA.Subtract(ColorHSVA, ColorHSVA)" />
|
||||||
|
public static ColorHSVA Subtract(this ColorHSVA color, ColorHSVA value) => ColorHSVA.Subtract(color, value);
|
||||||
|
|
||||||
|
/// <inheritdoc cref="ColorHSVA.Multiply(ColorHSVA, ColorHSVA)" />
|
||||||
|
public static ColorHSVA Multiply(this ColorHSVA color, float value) => ColorHSVA.Multiply(color, value);
|
||||||
|
|
||||||
|
/// <inheritdoc cref="ColorHSVA.Divide(ColorHSVA, ColorHSVA)" />
|
||||||
|
public static ColorHSVA Divide(this ColorHSVA color, float value) => ColorHSVA.Divide(color, value);
|
||||||
|
|
||||||
|
/// <inheritdoc cref="ColorHSVA.Lerp(ColorHSVA, ColorHSVA, float)" />
|
||||||
|
public static ColorHSVA Lerp(this ColorHSVA from, ColorHSVA to, float t) => ColorHSVA.Lerp(from, to, t);
|
||||||
|
|
||||||
|
/// <inheritdoc cref="ColorHSVA.ApproximatelyEquals(ColorHSVA, ColorHSVA, float) " />
|
||||||
|
public static bool ApproximatelyEquals(this ColorHSVA left, ColorHSVA right, float epsilon = float.Epsilon) => ColorHSVA.ApproximatelyEquals(left, right, epsilon);
|
||||||
|
}
|
138
Engine.Core/Primitives/ColorRGB.cs
Normal file
138
Engine.Core/Primitives/ColorRGB.cs
Normal file
@@ -0,0 +1,138 @@
|
|||||||
|
namespace Syntriax.Engine.Core;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Represents an RGB color.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="r">Red value of the <see cref="ColorRGB"/>.</param>
|
||||||
|
/// <param name="g">Green value of the <see cref="ColorRGB"/>.</param>
|
||||||
|
/// <param name="b">Blue value of the <see cref="ColorRGB"/>.</param>
|
||||||
|
/// <remarks>
|
||||||
|
/// Initializes a new instance of the <see cref="ColorRGB"/> struct with the specified values.
|
||||||
|
/// </remarks>
|
||||||
|
[System.Diagnostics.DebuggerDisplay("{ToString(),nq}")]
|
||||||
|
public readonly struct ColorRGB(byte r, byte g, byte b)
|
||||||
|
{
|
||||||
|
/// <summary>
|
||||||
|
/// The Red value of the <see cref="ColorRGB"/>.
|
||||||
|
/// </summary>
|
||||||
|
public readonly byte R = r;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// The Green value of the <see cref="ColorRGB"/>.
|
||||||
|
/// </summary>
|
||||||
|
public readonly byte G = g;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// The Blue value of the <see cref="ColorRGB"/>.
|
||||||
|
/// </summary>
|
||||||
|
public readonly byte B = b;
|
||||||
|
|
||||||
|
public static ColorRGB operator -(ColorRGB color) => new((byte)(255 - color.R), (byte)(255 - color.G), (byte)(255 - color.B));
|
||||||
|
public static ColorRGB operator +(ColorRGB left, ColorRGB right) => new((byte)(left.R + right.R).Clamp(0, 255), (byte)(left.G + right.G).Clamp(0, 255), (byte)(left.B + right.B).Clamp(0, 255));
|
||||||
|
public static ColorRGB operator -(ColorRGB left, ColorRGB right) => new((byte)(left.R - right.R).Clamp(0, 255), (byte)(left.G - right.G).Clamp(0, 255), (byte)(left.B - right.B).Clamp(0, 255));
|
||||||
|
public static ColorRGB operator *(ColorRGB left, ColorRGB right) => new((byte)(left.R * right.R).Clamp(0, 255), (byte)(left.G * right.G).Clamp(0, 255), (byte)(left.B * right.B).Clamp(0, 255));
|
||||||
|
public static ColorRGB operator *(ColorRGB color, float value) => new((byte)(color.R * value).Clamp(0, 255), (byte)(color.G * value).Clamp(0, 255), (byte)(color.B * value).Clamp(0, 255));
|
||||||
|
public static ColorRGB operator *(float value, ColorRGB color) => new((byte)(color.R * value).Clamp(0, 255), (byte)(color.G * value).Clamp(0, 255), (byte)(color.B * value).Clamp(0, 255));
|
||||||
|
public static ColorRGB operator /(ColorRGB color, float value) => new((byte)(color.R / value).Clamp(0, 255), (byte)(color.G / value).Clamp(0, 255), (byte)(color.B / value).Clamp(0, 255));
|
||||||
|
public static bool operator ==(ColorRGB left, ColorRGB right) => left.R == right.R && left.G == right.G && left.B == right.B;
|
||||||
|
public static bool operator !=(ColorRGB left, ColorRGB right) => left.R != right.R || left.G != right.G || left.B != right.B;
|
||||||
|
|
||||||
|
public static implicit operator ColorRGB(ColorRGBA rgba) => new(rgba.R, rgba.G, rgba.B);
|
||||||
|
public static implicit operator ColorRGB(ColorHSVA hsva) => (ColorRGBA)hsva;
|
||||||
|
public static implicit operator ColorRGB(ColorHSV hsv) => (ColorRGBA)hsv;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Inverts the given <see cref="ColorRGB"/>.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="color">The <see cref="ColorRGB"/>.</param>
|
||||||
|
/// <returns>The inverted <see cref="ColorRGB"/>.</returns>
|
||||||
|
public static ColorRGB Invert(ColorRGB color) => -color;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Adds two <see cref="ColorRGB"/>s.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="left">The first <see cref="ColorRGB"/>.</param>
|
||||||
|
/// <param name="right">The second <see cref="ColorRGB"/>.</param>
|
||||||
|
/// <returns>The sum of the two <see cref="ColorRGB"/>s.</returns>
|
||||||
|
public static ColorRGB Add(ColorRGB left, ColorRGB right) => left + right;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Subtracts one <see cref="ColorRGB"/> from another.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="left">The <see cref="ColorRGB"/> to subtract from.</param>
|
||||||
|
/// <param name="right">The <see cref="ColorRGB"/> to subtract.</param>
|
||||||
|
/// <returns>The result of subtracting the second <see cref="ColorRGB"/> from the first.</returns>
|
||||||
|
public static ColorRGB Subtract(ColorRGB left, ColorRGB right) => left - right;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Multiplies a <see cref="ColorRGB"/> by a scalar value.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="color">The <see cref="ColorRGB"/>.</param>
|
||||||
|
/// <param name="value">The scalar value.</param>
|
||||||
|
/// <returns>The result of multiplying the <see cref="ColorRGB"/> by the scalar value.</returns>
|
||||||
|
public static ColorRGB Multiply(ColorRGB color, float value) => color * value;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Divides a <see cref="ColorRGB"/> by a scalar value.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="color">The <see cref="ColorRGB"/>.</param>
|
||||||
|
/// <param name="value">The scalar value.</param>
|
||||||
|
/// <returns>The result of dividing the <see cref="ColorRGB"/> by the scalar value.</returns>
|
||||||
|
public static ColorRGB Divide(ColorRGB color, float value) => color / value;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Performs linear interpolation between two <see cref="ColorRGB"/>s.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="from">The starting <see cref="ColorRGB"/> (t = 0).</param>
|
||||||
|
/// <param name="to">The ending <see cref="ColorRGB"/> (t = 1).</param>
|
||||||
|
/// <param name="t">The interpolation parameter.</param>
|
||||||
|
/// <returns>The interpolated <see cref="ColorRGB"/>.</returns>
|
||||||
|
public static ColorRGB Lerp(ColorRGB from, ColorRGB to, float t)
|
||||||
|
{
|
||||||
|
int redDiff = to.R - from.R;
|
||||||
|
int greenDiff = to.G - from.G;
|
||||||
|
int blueDiff = to.B - from.B;
|
||||||
|
|
||||||
|
return from + new ColorRGB((byte)(redDiff * t), (byte)(greenDiff * t), (byte)(blueDiff * t));
|
||||||
|
}
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Determines whether the specified object is equal to the current <see cref="ColorRGB"/>.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="obj">The object to compare with the current <see cref="ColorRGB"/>.</param>
|
||||||
|
/// <returns><see cref="true"/> if the specified object is equal to the current <see cref="ColorRGB"/>; otherwise, <see cref="false"/>.</returns>
|
||||||
|
public override bool Equals(object? obj) => obj is ColorRGB colorRGB && this == colorRGB;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Generates a hash code for the <see cref="ColorRGB"/>.
|
||||||
|
/// </summary>
|
||||||
|
/// <returns>A hash code for the <see cref="ColorRGB"/>.</returns>
|
||||||
|
public override int GetHashCode() => System.HashCode.Combine(R, G, B);
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Converts the <see cref="ColorRGB"/> to its string representation.
|
||||||
|
/// </summary>
|
||||||
|
/// <returns>A string representation of the <see cref="ColorRGB"/>.</returns>
|
||||||
|
public override string ToString() => $"{nameof(ColorRGB)}({R}, {G}, {B})";
|
||||||
|
}
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Provides extension methods for <see cref="ColorRGB"/> type.
|
||||||
|
/// </summary>
|
||||||
|
public static class ColorRGBExtensions
|
||||||
|
{
|
||||||
|
/// <inheritdoc cref="ColorRGB.Add(ColorRGB, ColorRGB)" />
|
||||||
|
public static ColorRGB Add(this ColorRGB color, ColorRGB value) => ColorRGB.Add(color, value);
|
||||||
|
|
||||||
|
/// <inheritdoc cref="ColorRGB.Subtract(ColorRGB, ColorRGB)" />
|
||||||
|
public static ColorRGB Subtract(this ColorRGB color, ColorRGB value) => ColorRGB.Subtract(color, value);
|
||||||
|
|
||||||
|
/// <inheritdoc cref="ColorRGB.Multiply(ColorRGB, ColorRGB)" />
|
||||||
|
public static ColorRGB Multiply(this ColorRGB color, float value) => ColorRGB.Multiply(color, value);
|
||||||
|
|
||||||
|
/// <inheritdoc cref="ColorRGB.Divide(ColorRGB, ColorRGB)" />
|
||||||
|
public static ColorRGB Divide(this ColorRGB color, float value) => ColorRGB.Divide(color, value);
|
||||||
|
|
||||||
|
/// <inheritdoc cref="ColorRGB.Lerp(ColorRGB, ColorRGB, float)" />
|
||||||
|
public static ColorRGB Lerp(this ColorRGB from, ColorRGB to, float t) => ColorRGB.Lerp(from, to, t);
|
||||||
|
}
|
168
Engine.Core/Primitives/ColorRGBA.cs
Normal file
168
Engine.Core/Primitives/ColorRGBA.cs
Normal file
@@ -0,0 +1,168 @@
|
|||||||
|
namespace Syntriax.Engine.Core;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Represents an RGBA color.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="r">Red value of the <see cref="ColorRGBA"/>.</param>
|
||||||
|
/// <param name="g">Green value of the <see cref="ColorRGBA"/>.</param>
|
||||||
|
/// <param name="b">Blue value of the <see cref="ColorRGBA"/>.</param>
|
||||||
|
/// <param name="a">Alpha value of the <see cref="ColorRGBA"/>.</param>
|
||||||
|
/// <remarks>
|
||||||
|
/// Initializes a new instance of the <see cref="ColorRGBA"/> struct with the specified values.
|
||||||
|
/// </remarks>
|
||||||
|
[System.Diagnostics.DebuggerDisplay("{ToString(),nq}")]
|
||||||
|
public readonly struct ColorRGBA(byte r, byte g, byte b, byte a = 255)
|
||||||
|
{
|
||||||
|
/// <summary>
|
||||||
|
/// The Red value of the <see cref="ColorRGBA"/>.
|
||||||
|
/// </summary>
|
||||||
|
public readonly byte R = r;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// The Green value of the <see cref="ColorRGBA"/>.
|
||||||
|
/// </summary>
|
||||||
|
public readonly byte G = g;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// The Blue value of the <see cref="ColorRGBA"/>.
|
||||||
|
/// </summary>
|
||||||
|
public readonly byte B = b;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// The Alpha value of the <see cref="ColorRGBA"/>.
|
||||||
|
/// </summary>
|
||||||
|
public readonly byte A = a;
|
||||||
|
|
||||||
|
public static ColorRGBA operator -(ColorRGBA color) => new((byte)(255 - color.R), (byte)(255 - color.G), (byte)(255 - color.B), color.A);
|
||||||
|
public static ColorRGBA operator +(ColorRGBA left, ColorRGBA right) => new((byte)(left.R + right.R).Clamp(0, 255), (byte)(left.G + right.G).Clamp(0, 255), (byte)(left.B + right.B).Clamp(0, 255), (byte)(left.A + right.A).Clamp(0, 255));
|
||||||
|
public static ColorRGBA operator -(ColorRGBA left, ColorRGBA right) => new((byte)(left.R - right.R).Clamp(0, 255), (byte)(left.G - right.G).Clamp(0, 255), (byte)(left.B - right.B).Clamp(0, 255), (byte)(left.A - right.A).Clamp(0, 255));
|
||||||
|
public static ColorRGBA operator *(ColorRGBA left, ColorRGBA right) => new((byte)(left.R * right.R).Clamp(0, 255), (byte)(left.G * right.G).Clamp(0, 255), (byte)(left.B * right.B).Clamp(0, 255), (byte)(left.A * right.A).Clamp(0, 255));
|
||||||
|
public static ColorRGBA operator *(ColorRGBA color, float value) => new((byte)(color.R * value).Clamp(0, 255), (byte)(color.G * value).Clamp(0, 255), (byte)(color.B * value).Clamp(0, 255), (byte)(color.A * value).Clamp(0, 255));
|
||||||
|
public static ColorRGBA operator *(float value, ColorRGBA color) => new((byte)(color.R * value).Clamp(0, 255), (byte)(color.G * value).Clamp(0, 255), (byte)(color.B * value).Clamp(0, 255), (byte)(color.A * value).Clamp(0, 255));
|
||||||
|
public static ColorRGBA operator /(ColorRGBA color, float value) => new((byte)(color.R / value).Clamp(0, 255), (byte)(color.G / value).Clamp(0, 255), (byte)(color.B / value).Clamp(0, 255), (byte)(color.A / value).Clamp(0, 255));
|
||||||
|
public static bool operator ==(ColorRGBA left, ColorRGBA right) => left.R == right.R && left.G == right.G && left.B == right.B && left.A == right.A;
|
||||||
|
public static bool operator !=(ColorRGBA left, ColorRGBA right) => left.R != right.R || left.G != right.G || left.B != right.B || left.A != right.A;
|
||||||
|
|
||||||
|
public static implicit operator ColorRGBA(ColorRGB rgb) => new(rgb.R, rgb.G, rgb.B, 255);
|
||||||
|
public static implicit operator ColorRGBA(ColorHSV hsv) => (ColorHSVA)hsv;
|
||||||
|
public static implicit operator ColorRGBA(ColorHSVA hsva)
|
||||||
|
{
|
||||||
|
float hue = hsva.Hue * 360f;
|
||||||
|
float chroma = hsva.Value * hsva.Saturation;
|
||||||
|
float x = chroma * (1f - Math.Abs(hue / 60f % 2f - 1f));
|
||||||
|
float m = hsva.Value - chroma;
|
||||||
|
|
||||||
|
float r1 = 0f;
|
||||||
|
float g1 = 0f;
|
||||||
|
float b1 = 0f;
|
||||||
|
|
||||||
|
if (hue < 60) { r1 = chroma; g1 = x; b1 = 0; }
|
||||||
|
else if (hue < 120) { r1 = x; g1 = chroma; b1 = 0; }
|
||||||
|
else if (hue < 180) { r1 = 0; g1 = chroma; b1 = x; }
|
||||||
|
else if (hue < 240) { r1 = 0; g1 = x; b1 = chroma; }
|
||||||
|
else if (hue < 300) { r1 = x; g1 = 0; b1 = chroma; }
|
||||||
|
else if (hue <= 360) { r1 = chroma; g1 = 0; b1 = x; }
|
||||||
|
|
||||||
|
byte r = (byte)Math.RoundToInt((r1 + m) * 255);
|
||||||
|
byte g = (byte)Math.RoundToInt((g1 + m) * 255);
|
||||||
|
byte b = (byte)Math.RoundToInt((b1 + m) * 255);
|
||||||
|
|
||||||
|
return new(r, g, b, (byte)(hsva.Alpha * 255));
|
||||||
|
}
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Inverts the given <see cref="ColorRGBA"/>.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="color">The <see cref="ColorRGBA"/>.</param>
|
||||||
|
/// <returns>The inverted <see cref="ColorRGBA"/>.</returns>
|
||||||
|
public static ColorRGBA Invert(ColorRGBA color) => -color;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Adds two <see cref="ColorRGBA"/>s.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="left">The first <see cref="ColorRGBA"/>.</param>
|
||||||
|
/// <param name="right">The second <see cref="ColorRGBA"/>.</param>
|
||||||
|
/// <returns>The sum of the two <see cref="ColorRGBA"/>s.</returns>
|
||||||
|
public static ColorRGBA Add(ColorRGBA left, ColorRGBA right) => left + right;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Subtracts one <see cref="ColorRGBA"/> from another.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="left">The <see cref="ColorRGBA"/> to subtract from.</param>
|
||||||
|
/// <param name="right">The <see cref="ColorRGBA"/> to subtract.</param>
|
||||||
|
/// <returns>The result of subtracting the second <see cref="ColorRGBA"/> from the first.</returns>
|
||||||
|
public static ColorRGBA Subtract(ColorRGBA left, ColorRGBA right) => left - right;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Multiplies a <see cref="ColorRGBA"/> by a scalar value.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="color">The <see cref="ColorRGBA"/>.</param>
|
||||||
|
/// <param name="value">The scalar value.</param>
|
||||||
|
/// <returns>The result of multiplying the <see cref="ColorRGBA"/> by the scalar value.</returns>
|
||||||
|
public static ColorRGBA Multiply(ColorRGBA color, float value) => color * value;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Divides a <see cref="ColorRGBA"/> by a scalar value.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="color">The <see cref="ColorRGBA"/>.</param>
|
||||||
|
/// <param name="value">The scalar value.</param>
|
||||||
|
/// <returns>The result of dividing the <see cref="ColorRGBA"/> by the scalar value.</returns>
|
||||||
|
public static ColorRGBA Divide(ColorRGBA color, float value) => color / value;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Performs linear interpolation between two <see cref="ColorRGBA"/>s.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="from">The starting <see cref="ColorRGBA"/> (t = 0).</param>
|
||||||
|
/// <param name="to">The ending <see cref="ColorRGBA"/> (t = 1).</param>
|
||||||
|
/// <param name="t">The interpolation parameter.</param>
|
||||||
|
/// <returns>The interpolated <see cref="ColorRGBA"/>.</returns>
|
||||||
|
public static ColorRGBA Lerp(ColorRGBA from, ColorRGBA to, float t)
|
||||||
|
{
|
||||||
|
int redDiff = to.R - from.R;
|
||||||
|
int greenDiff = to.G - from.G;
|
||||||
|
int blueDiff = to.B - from.B;
|
||||||
|
int alphaDiff = to.A - from.A;
|
||||||
|
|
||||||
|
return from + new ColorRGBA((byte)(redDiff * t), (byte)(greenDiff * t), (byte)(blueDiff * t), (byte)(alphaDiff * t));
|
||||||
|
}
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Determines whether the specified object is equal to the current <see cref="ColorRGBA"/>.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="obj">The object to compare with the current <see cref="ColorRGBA"/>.</param>
|
||||||
|
/// <returns><see cref="true"/> if the specified object is equal to the current <see cref="ColorRGBA"/>; otherwise, <see cref="false"/>.</returns>
|
||||||
|
public override bool Equals(object? obj) => obj is ColorRGBA colorRGBA && this == colorRGBA;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Generates a hash code for the <see cref="ColorRGBA"/>.
|
||||||
|
/// </summary>
|
||||||
|
/// <returns>A hash code for the <see cref="ColorRGBA"/>.</returns>
|
||||||
|
public override int GetHashCode() => System.HashCode.Combine(R, G, B, A);
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Converts the <see cref="ColorRGBA"/> to its string representation.
|
||||||
|
/// </summary>
|
||||||
|
/// <returns>A string representation of the <see cref="ColorRGBA"/>.</returns>
|
||||||
|
public override string ToString() => $"{nameof(ColorRGBA)}({R}, {G}, {B}, {A})";
|
||||||
|
}
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Provides extension methods for <see cref="ColorRGBA"/> type.
|
||||||
|
/// </summary>
|
||||||
|
public static class ColorRGBAExtensions
|
||||||
|
{
|
||||||
|
/// <inheritdoc cref="ColorRGBA.Add(ColorRGBA, ColorRGBA)" />
|
||||||
|
public static ColorRGBA Add(this ColorRGBA color, ColorRGBA value) => ColorRGBA.Add(color, value);
|
||||||
|
|
||||||
|
/// <inheritdoc cref="ColorRGBA.Subtract(ColorRGBA, ColorRGBA)" />
|
||||||
|
public static ColorRGBA Subtract(this ColorRGBA color, ColorRGBA value) => ColorRGBA.Subtract(color, value);
|
||||||
|
|
||||||
|
/// <inheritdoc cref="ColorRGBA.Multiply(ColorRGBA, ColorRGBA)" />
|
||||||
|
public static ColorRGBA Multiply(this ColorRGBA color, float value) => ColorRGBA.Multiply(color, value);
|
||||||
|
|
||||||
|
/// <inheritdoc cref="ColorRGBA.Divide(ColorRGBA, ColorRGBA)" />
|
||||||
|
public static ColorRGBA Divide(this ColorRGBA color, float value) => ColorRGBA.Divide(color, value);
|
||||||
|
|
||||||
|
/// <inheritdoc cref="ColorRGBA.Lerp(ColorRGBA, ColorRGBA, float)" />
|
||||||
|
public static ColorRGBA Lerp(this ColorRGBA from, ColorRGBA to, float t) => ColorRGBA.Lerp(from, to, t);
|
||||||
|
}
|
@@ -1,4 +1,3 @@
|
|||||||
using System;
|
|
||||||
using System.Diagnostics.CodeAnalysis;
|
using System.Diagnostics.CodeAnalysis;
|
||||||
|
|
||||||
namespace Syntriax.Engine.Core;
|
namespace Syntriax.Engine.Core;
|
||||||
@@ -44,6 +43,9 @@ public readonly struct Line2D(Vector2D from, Vector2D to)
|
|||||||
/// </summary>
|
/// </summary>
|
||||||
public readonly float LengthSquared => From.FromTo(To).LengthSquared();
|
public readonly float LengthSquared => From.FromTo(To).LengthSquared();
|
||||||
|
|
||||||
|
public static bool operator ==(Line2D left, Line2D right) => left.From == right.From && left.To == right.To;
|
||||||
|
public static bool operator !=(Line2D left, Line2D right) => left.From != right.From || left.To != right.To;
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// The equation of the <see cref="Line2D"/> defined by this <see cref="Line2D"/> segment.
|
/// The equation of the <see cref="Line2D"/> defined by this <see cref="Line2D"/> segment.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
@@ -68,12 +70,12 @@ public readonly struct Line2D(Vector2D from, Vector2D to)
|
|||||||
/// </summary>
|
/// </summary>
|
||||||
public static float GetT(Line2D line, Vector2D point)
|
public static float GetT(Line2D line, Vector2D point)
|
||||||
{
|
{
|
||||||
float fromX = MathF.Abs(line.From.X);
|
float fromX = Math.Abs(line.From.X);
|
||||||
float toX = MathF.Abs(line.To.X);
|
float toX = Math.Abs(line.To.X);
|
||||||
float pointX = MathF.Abs(point.X);
|
float pointX = Math.Abs(point.X);
|
||||||
|
|
||||||
float min = MathF.Min(fromX, toX);
|
float min = Math.Min(fromX, toX);
|
||||||
float max = MathF.Max(fromX, toX) - min;
|
float max = Math.Max(fromX, toX) - min;
|
||||||
|
|
||||||
pointX -= min;
|
pointX -= min;
|
||||||
|
|
||||||
@@ -114,8 +116,8 @@ public readonly struct Line2D(Vector2D from, Vector2D to)
|
|||||||
/// </summary>
|
/// </summary>
|
||||||
public static bool OnSegment(Line2D line, Vector2D point)
|
public static bool OnSegment(Line2D line, Vector2D point)
|
||||||
{
|
{
|
||||||
if (point.X <= MathF.Max(line.From.X, line.To.X) && point.X >= MathF.Min(line.From.X, line.To.X) &&
|
if (point.X <= Math.Max(line.From.X, line.To.X) && point.X >= Math.Min(line.From.X, line.To.X) &&
|
||||||
point.Y <= MathF.Max(line.From.Y, line.To.Y) && point.Y >= MathF.Min(line.From.Y, line.To.Y))
|
point.Y <= Math.Max(line.From.Y, line.To.Y) && point.Y >= Math.Min(line.From.Y, line.To.Y))
|
||||||
return true;
|
return true;
|
||||||
|
|
||||||
return false;
|
return false;
|
||||||
@@ -168,17 +170,14 @@ public readonly struct Line2D(Vector2D from, Vector2D to)
|
|||||||
/// </summary>
|
/// </summary>
|
||||||
public static Vector2D ClosestPointTo(Line2D line, Vector2D point)
|
public static Vector2D ClosestPointTo(Line2D line, Vector2D point)
|
||||||
{
|
{
|
||||||
Vector2D edgeVector = line.From.FromTo(line.To);
|
Vector2D lineRelativeVector = line.From.FromTo(line.To);
|
||||||
Vector2D pointVector = point - line.From;
|
|
||||||
|
|
||||||
float t = (pointVector.X * edgeVector.X + pointVector.Y * edgeVector.Y) / (edgeVector.X * edgeVector.X + edgeVector.Y * edgeVector.Y);
|
Vector2D lineDirection = lineRelativeVector.Normalized;
|
||||||
|
Vector2D pointVector = line.From.FromTo(point);
|
||||||
|
|
||||||
t = MathF.Max(0, MathF.Min(1, t));
|
float dot = lineDirection.Dot(pointVector).Clamp(0f, lineRelativeVector.Magnitude);
|
||||||
|
|
||||||
float closestX = line.From.X + t * edgeVector.X;
|
return lineDirection * dot;
|
||||||
float closestY = line.From.Y + t * edgeVector.Y;
|
|
||||||
|
|
||||||
return new Vector2D((float)closestX, (float)closestY);
|
|
||||||
}
|
}
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
@@ -190,6 +189,25 @@ public readonly struct Line2D(Vector2D from, Vector2D to)
|
|||||||
/// <returns><see cref="true"/> if the <see cref="Line2D"/>s are approximately equal; otherwise, <see cref="false"/>.</returns>
|
/// <returns><see cref="true"/> if the <see cref="Line2D"/>s are approximately equal; otherwise, <see cref="false"/>.</returns>
|
||||||
public static bool ApproximatelyEquals(Line2D left, Line2D right, float epsilon = float.Epsilon)
|
public static bool ApproximatelyEquals(Line2D left, Line2D right, float epsilon = float.Epsilon)
|
||||||
=> left.From.ApproximatelyEquals(right.From, epsilon) && left.To.ApproximatelyEquals(right.To, epsilon);
|
=> left.From.ApproximatelyEquals(right.From, epsilon) && left.To.ApproximatelyEquals(right.To, epsilon);
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Determines whether the specified object is equal to the current <see cref="Line2D"/>.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="obj">The object to compare with the current <see cref="Line2D"/>.</param>
|
||||||
|
/// <returns><see cref="true"/> if the specified object is equal to the current <see cref="Line2D"/>; otherwise, <see cref="false"/>.</returns>
|
||||||
|
public override bool Equals(object? obj) => obj is Line2D line2D && this == line2D;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Generates a hash code for the <see cref="Line2D"/>.
|
||||||
|
/// </summary>
|
||||||
|
/// <returns>A hash code for the <see cref="Line2D"/>.</returns>
|
||||||
|
public override int GetHashCode() => System.HashCode.Combine(From, To);
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Converts the <see cref="Line2D"/> to its string representation.
|
||||||
|
/// </summary>
|
||||||
|
/// <returns>A string representation of the <see cref="Line2D"/>.</returns>
|
||||||
|
public override string ToString() => $"{nameof(Line2D)}({From}, {To})";
|
||||||
}
|
}
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
@@ -206,6 +224,9 @@ public static class Line2DExtensions
|
|||||||
/// <inheritdoc cref="Line2D.Intersects(Line2D, Vector2D)" />
|
/// <inheritdoc cref="Line2D.Intersects(Line2D, Vector2D)" />
|
||||||
public static bool Intersects(this Line2D line, Vector2D point) => Line2D.Intersects(line, point);
|
public static bool Intersects(this Line2D line, Vector2D point) => Line2D.Intersects(line, point);
|
||||||
|
|
||||||
|
/// <inheritdoc cref="Line2D.IntersectionPoint(Line2D, Line2D)" />
|
||||||
|
public static Vector2D IntersectionPoint(this Line2D left, Line2D right) => Line2D.IntersectionPoint(left, right);
|
||||||
|
|
||||||
/// <inheritdoc cref="Line2D.GetT(Line2D, Vector2D)" />
|
/// <inheritdoc cref="Line2D.GetT(Line2D, Vector2D)" />
|
||||||
public static float GetT(this Line2D line, Vector2D point) => Line2D.GetT(line, point);
|
public static float GetT(this Line2D line, Vector2D point) => Line2D.GetT(line, point);
|
||||||
|
|
||||||
@@ -215,6 +236,9 @@ public static class Line2DExtensions
|
|||||||
/// <inheritdoc cref="Line2D.Intersects(Line2D, Line2D, out Vector2D?)" />
|
/// <inheritdoc cref="Line2D.Intersects(Line2D, Line2D, out Vector2D?)" />
|
||||||
public static bool Intersects(this Line2D left, Line2D right, [NotNullWhen(returnValue: true)] out Vector2D? point) => Line2D.Intersects(left, right, out point);
|
public static bool Intersects(this Line2D left, Line2D right, [NotNullWhen(returnValue: true)] out Vector2D? point) => Line2D.Intersects(left, right, out point);
|
||||||
|
|
||||||
|
/// <inheritdoc cref="Line2D.ClosestPointTo(Line2D, Vector2D)" />
|
||||||
|
public static Vector2D ClosestPointTo(this Line2D line, Vector2D point) => Line2D.ClosestPointTo(line, point);
|
||||||
|
|
||||||
/// <inheritdoc cref="Line2D.ApproximatelyEquals(Line2D, Line2D, float)" />
|
/// <inheritdoc cref="Line2D.ApproximatelyEquals(Line2D, Line2D, float)" />
|
||||||
public static bool ApproximatelyEquals(this Line2D left, Line2D right, float epsilon = float.Epsilon) => Line2D.ApproximatelyEquals(left, right, epsilon);
|
public static bool ApproximatelyEquals(this Line2D left, Line2D right, float epsilon = float.Epsilon) => Line2D.ApproximatelyEquals(left, right, epsilon);
|
||||||
}
|
}
|
||||||
|
@@ -1,47 +1,69 @@
|
|||||||
namespace Syntriax.Engine.Core;
|
namespace Syntriax.Engine.Core;
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Represents a line equation in the form y = mx + b.
|
/// Represents a <see cref="Line2DEquation"/> in the form y = mx + b.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
/// <param name="slope">The slope of the line.</param>
|
/// <param name="slope">The slope of the line.</param>
|
||||||
/// <param name="offsetY">The y-intercept of the line.</param>
|
/// <param name="offsetY">The Y intercept of the line.</param>
|
||||||
/// <remarks>
|
/// <remarks>
|
||||||
/// Initializes a new instance of the <see cref="Line2DEquation"/> struct with the specified slope and y-intercept.
|
/// Initializes a new instance of the <see cref="Line2DEquation"/> struct with the specified slope and Y intercept.
|
||||||
/// </remarks>
|
/// </remarks>
|
||||||
[System.Diagnostics.DebuggerDisplay("y = {Slope}x + {OffsetY}")]
|
[System.Diagnostics.DebuggerDisplay("y = {Slope}x + {OffsetY}")]
|
||||||
public readonly struct Line2DEquation(float slope, float offsetY)
|
public readonly struct Line2DEquation(float slope, float offsetY)
|
||||||
{
|
{
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// The slope of the line equation.
|
/// The slope of the <see cref="Line2DEquation"/>.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
public readonly float Slope = slope;
|
public readonly float Slope = slope;
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// The y-intercept of the line equation.
|
/// The Y intercept of the <see cref="Line2DEquation"/>.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
public readonly float OffsetY = offsetY;
|
public readonly float OffsetY = offsetY;
|
||||||
|
|
||||||
|
public static bool operator ==(Line2DEquation left, Line2DEquation right) => left.Slope == right.Slope && left.OffsetY == right.OffsetY;
|
||||||
|
public static bool operator !=(Line2DEquation left, Line2DEquation right) => left.Slope != right.Slope || left.OffsetY != right.OffsetY;
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Resolves the y-coordinate for a given x-coordinate using the line equation.
|
/// Resolves the Y coordinate for a given X coordinate using the <see cref="Line2DEquation"/>.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
/// <param name="lineEquation">The line equation to resolve.</param>
|
/// <param name="lineEquation">The <see cref="Line2DEquation"/> to resolve.</param>
|
||||||
/// <param name="x">The x-coordinate for which to resolve the y-coordinate.</param>
|
/// <param name="x">The X coordinate for which to resolve the Y coordinate.</param>
|
||||||
/// <returns>The y-coordinate resolved using the line equation.</returns>
|
/// <returns>The Y coordinate resolved using the <see cref="Line2DEquation"/>.</returns>
|
||||||
public static float Resolve(Line2DEquation lineEquation, float x) => lineEquation.Slope * x + lineEquation.OffsetY; // y = mx + b
|
public static float Resolve(Line2DEquation lineEquation, float x) => lineEquation.Slope * x + lineEquation.OffsetY; // y = mx + b
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Checks if two line equations are approximately equal.
|
/// Checks if two <see cref="Line2DEquation"/> are approximately equal.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
/// <param name="left">The first line equation to compare.</param>
|
/// <param name="left">The first <see cref="Line2DEquation"/> to compare.</param>
|
||||||
/// <param name="right">The second line equation to compare.</param>
|
/// <param name="right">The second <see cref="Line2DEquation"/> to compare.</param>
|
||||||
/// <param name="epsilon">The epsilon range.</param>
|
/// <param name="epsilon">The epsilon range.</param>
|
||||||
/// <returns>True if the line equations are approximately equal; otherwise, false.</returns>
|
/// <returns>True if the <see cref="Line2DEquation"/> are approximately equal; otherwise, false.</returns>
|
||||||
public static bool ApproximatelyEquals(Line2DEquation left, Line2DEquation right, float epsilon = float.Epsilon)
|
public static bool ApproximatelyEquals(Line2DEquation left, Line2DEquation right, float epsilon = float.Epsilon)
|
||||||
=> left.Slope.ApproximatelyEquals(right.Slope, epsilon) && left.OffsetY.ApproximatelyEquals(right.OffsetY, epsilon);
|
=> left.Slope.ApproximatelyEquals(right.Slope, epsilon) && left.OffsetY.ApproximatelyEquals(right.OffsetY, epsilon);
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Determines whether the specified object is equal to the current <see cref="Line2DEquation"/>.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="obj">The object to compare with the current <see cref="Line2DEquation"/>.</param>
|
||||||
|
/// <returns><see cref="true"/> if the specified object is equal to the current <see cref="Line2DEquation"/>; otherwise, <see cref="false"/>.</returns>
|
||||||
|
public override bool Equals(object? obj) => obj is Line2DEquation lineEquation && this == lineEquation;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Generates a hash code for the <see cref="Line2DEquation"/>.
|
||||||
|
/// </summary>
|
||||||
|
/// <returns>A hash code for the <see cref="Line2DEquation"/>.</returns>
|
||||||
|
public override int GetHashCode() => System.HashCode.Combine(Slope, OffsetY);
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Converts the <see cref="Line2DEquation"/> to its string representation.
|
||||||
|
/// </summary>
|
||||||
|
/// <returns>A string representation of the <see cref="Line2DEquation"/>.</returns>
|
||||||
|
public override string ToString() => $"{nameof(Line2DEquation)}({Slope}, {OffsetY})";
|
||||||
}
|
}
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Provides extension methods for the LineEquation struct.
|
/// Provides extension methods for the <see cref="Line2DEquation"/> struct.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
public static class Line2DEquationExtensions
|
public static class Line2DEquationExtensions
|
||||||
{
|
{
|
||||||
|
@@ -21,6 +21,9 @@ public readonly struct Projection1D(float min, float max)
|
|||||||
/// </summary>
|
/// </summary>
|
||||||
public readonly float Max = max;
|
public readonly float Max = max;
|
||||||
|
|
||||||
|
public static bool operator ==(Projection1D left, Projection1D right) => left.Min == right.Min && left.Max == right.Max;
|
||||||
|
public static bool operator !=(Projection1D left, Projection1D right) => left.Min != right.Min || left.Max != right.Max;
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Checks if two projections overlap.
|
/// Checks if two projections overlap.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
@@ -70,6 +73,35 @@ public readonly struct Projection1D(float min, float max)
|
|||||||
depth = 0f;
|
depth = 0f;
|
||||||
return false;
|
return false;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Checks if two <see cref="Projection1D"/>s are approximately equal within a specified epsilon range.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="left">The first <see cref="Projection1D"/>.</param>
|
||||||
|
/// <param name="right">The second <see cref="Projection1D"/>.</param>
|
||||||
|
/// <param name="epsilon">The epsilon range.</param>
|
||||||
|
/// <returns><see cref="true"/> if the <see cref="Projection1D"/>s are approximately equal; otherwise, <see cref="false"/>.</returns>
|
||||||
|
public static bool ApproximatelyEquals(Projection1D left, Projection1D right, float epsilon = float.Epsilon)
|
||||||
|
=> left.Min.ApproximatelyEquals(right.Min, epsilon) && left.Max.ApproximatelyEquals(right.Max, epsilon);
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Determines whether the specified object is equal to the current <see cref="Projection1D"/>.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="obj">The object to compare with the current <see cref="Projection1D"/>.</param>
|
||||||
|
/// <returns><see cref="true"/> if the specified object is equal to the current <see cref="Projection1D"/>; otherwise, <see cref="false"/>.</returns>
|
||||||
|
public override bool Equals(object? obj) => obj is Projection1D projection1D && this == projection1D;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Generates a hash code for the <see cref="Projection1D"/>.
|
||||||
|
/// </summary>
|
||||||
|
/// <returns>A hash code for the <see cref="Projection1D"/>.</returns>
|
||||||
|
public override int GetHashCode() => System.HashCode.Combine(Min, Max);
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Converts the <see cref="Projection1D"/> to its string representation.
|
||||||
|
/// </summary>
|
||||||
|
/// <returns>A string representation of the <see cref="Projection1D"/>.</returns>
|
||||||
|
public override string ToString() => $"{nameof(Projection1D)}({Min}, {Max})";
|
||||||
}
|
}
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
@@ -82,4 +114,7 @@ public static class Projection1DExtensions
|
|||||||
|
|
||||||
/// <inheritdoc cref="Projection1D.Overlaps(Projection1D, Projection1D, out float)" />
|
/// <inheritdoc cref="Projection1D.Overlaps(Projection1D, Projection1D, out float)" />
|
||||||
public static bool Overlaps(this Projection1D left, Projection1D right, out float depth) => Projection1D.Overlaps(left, right, out depth);
|
public static bool Overlaps(this Projection1D left, Projection1D right, out float depth) => Projection1D.Overlaps(left, right, out depth);
|
||||||
|
|
||||||
|
/// <inheritdoc cref="Projection1D.ApproximatelyEquals(Projection1D, Projection1D, float)" />
|
||||||
|
public static bool ApproximatelyEquals(this Projection1D left, Projection1D right, float epsilon = float.Epsilon) => Projection1D.ApproximatelyEquals(left, right, epsilon);
|
||||||
}
|
}
|
||||||
|
@@ -1,5 +1,3 @@
|
|||||||
using System;
|
|
||||||
|
|
||||||
namespace Syntriax.Engine.Core;
|
namespace Syntriax.Engine.Core;
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
@@ -178,11 +176,11 @@ public readonly struct Quaternion(float x, float y, float z, float w)
|
|||||||
if (dot > 0.9995f)
|
if (dot > 0.9995f)
|
||||||
return Lerp(from, to, t);
|
return Lerp(from, to, t);
|
||||||
|
|
||||||
float angle = MathF.Acos(dot);
|
float angle = Math.Acos(dot);
|
||||||
float sinAngle = MathF.Sin(angle);
|
float sinAngle = Math.Sin(angle);
|
||||||
|
|
||||||
float fromWeight = MathF.Sin((1f - t) * angle) / sinAngle;
|
float fromWeight = Math.Sin((1f - t) * angle) / sinAngle;
|
||||||
float toWeight = MathF.Sin(t * angle) / sinAngle;
|
float toWeight = Math.Sin(t * angle) / sinAngle;
|
||||||
|
|
||||||
return from * fromWeight + to * toWeight;
|
return from * fromWeight + to * toWeight;
|
||||||
}
|
}
|
||||||
@@ -213,8 +211,8 @@ public readonly struct Quaternion(float x, float y, float z, float w)
|
|||||||
public static Quaternion FromAxisAngle(Vector3D axis, float angle)
|
public static Quaternion FromAxisAngle(Vector3D axis, float angle)
|
||||||
{
|
{
|
||||||
float halfAngle = angle * .5f;
|
float halfAngle = angle * .5f;
|
||||||
float sinHalf = MathF.Sin(halfAngle);
|
float sinHalf = Math.Sin(halfAngle);
|
||||||
return new Quaternion(axis.X * sinHalf, axis.Y * sinHalf, axis.Z * sinHalf, MathF.Cos(halfAngle));
|
return new Quaternion(axis.X * sinHalf, axis.Y * sinHalf, axis.Z * sinHalf, Math.Cos(halfAngle));
|
||||||
}
|
}
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
@@ -284,24 +282,24 @@ public readonly struct Quaternion(float x, float y, float z, float w)
|
|||||||
public static bool ApproximatelyEquals(Quaternion left, Quaternion right, float epsilon = float.Epsilon)
|
public static bool ApproximatelyEquals(Quaternion left, Quaternion right, float epsilon = float.Epsilon)
|
||||||
=> left.X.ApproximatelyEquals(right.X, epsilon) && left.Y.ApproximatelyEquals(right.Y, epsilon) && left.Z.ApproximatelyEquals(right.Z, epsilon) && left.W.ApproximatelyEquals(right.W, epsilon);
|
=> left.X.ApproximatelyEquals(right.X, epsilon) && left.Y.ApproximatelyEquals(right.Y, epsilon) && left.Z.ApproximatelyEquals(right.Z, epsilon) && left.W.ApproximatelyEquals(right.W, epsilon);
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Converts the <see cref="Quaternion"/> to its string representation.
|
|
||||||
/// </summary>
|
|
||||||
/// <returns>A string representation of the <see cref="Quaternion"/>.</returns>
|
|
||||||
public override string ToString() => $"{nameof(Quaternion)}({W}, {X}, {Y}, {Z})";
|
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Determines whether the specified object is equal to the current <see cref="Quaternion"/>.
|
/// Determines whether the specified object is equal to the current <see cref="Quaternion"/>.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
/// <param name="obj">The object to compare with the current <see cref="Quaternion"/>.</param>
|
/// <param name="obj">The object to compare with the current <see cref="Quaternion"/>.</param>
|
||||||
/// <returns><see cref="true"/> if the specified object is equal to the current <see cref="Quaternion"/>; otherwise, <see cref="false"/>.</returns>
|
/// <returns><see cref="true"/> if the specified object is equal to the current <see cref="Quaternion"/>; otherwise, <see cref="false"/>.</returns>
|
||||||
public override bool Equals(object? obj) => obj is Quaternion objVec && X.Equals(objVec.X) && Y.Equals(objVec.Y) && Z.Equals(objVec.Z) && W.Equals(objVec.W);
|
public override bool Equals(object? obj) => obj is Quaternion quaternion && this == quaternion;
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Generates a hash code for the <see cref="Quaternion"/>.
|
/// Generates a hash code for the <see cref="Quaternion"/>.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
/// <returns>A hash code for the <see cref="Quaternion"/>.</returns>
|
/// <returns>A hash code for the <see cref="Quaternion"/>.</returns>
|
||||||
public override int GetHashCode() => HashCode.Combine(X, Y, Z);
|
public override int GetHashCode() => System.HashCode.Combine(W, X, Y, Z);
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Converts the <see cref="Quaternion"/> to its string representation.
|
||||||
|
/// </summary>
|
||||||
|
/// <returns>A string representation of the <see cref="Quaternion"/>.</returns>
|
||||||
|
public override string ToString() => $"{nameof(Quaternion)}({W}, {X}, {Y}, {Z})";
|
||||||
}
|
}
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
|
105
Engine.Core/Primitives/Ray2D.cs
Normal file
105
Engine.Core/Primitives/Ray2D.cs
Normal file
@@ -0,0 +1,105 @@
|
|||||||
|
namespace Syntriax.Engine.Core;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Represents an infinite ray in 2D space.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="Origin">The <see cref="Vector2D"/> in 2D space where the ray starts from.</param>
|
||||||
|
/// <param name="Direction">Normalized <see cref="Vector2D"/> indicating the ray's is direction.</param>
|
||||||
|
public readonly struct Ray2D(Vector2D Origin, Vector2D Direction)
|
||||||
|
{
|
||||||
|
/// <summary>
|
||||||
|
/// The starting point of the <see cref="Ray2D"/>.
|
||||||
|
/// </summary>
|
||||||
|
public readonly Vector2D Origin = Origin;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// The direction in which the <see cref="Ray2D"/> points. Should be a normalized vector.
|
||||||
|
/// </summary>
|
||||||
|
public readonly Vector2D Direction = Direction;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Gets a <see cref="Ray2D"/> with the same origin but with the direction reversed.
|
||||||
|
/// </summary>
|
||||||
|
public readonly Ray2D Reversed => new(Origin, -Direction);
|
||||||
|
|
||||||
|
public static bool operator ==(Ray2D left, Ray2D right) => left.Origin == right.Origin && left.Direction == right.Direction;
|
||||||
|
public static bool operator !=(Ray2D left, Ray2D right) => left.Origin != right.Origin || left.Direction != right.Direction;
|
||||||
|
public static implicit operator Ray2D(Line2D line) => new(line.From, line.From.FromTo(line.To).Normalized);
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Constructs a <see cref="Line2D"/> from a <see cref="Ray2D"/>, extending from its origin in the <see cref="Ray2D"/>'s direction for a given distance.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="ray">The source <see cref="Ray2D"/>.</param>
|
||||||
|
/// <param name="distance">The length of the line segment to create from the <see cref="Ray2D"/>.</param>
|
||||||
|
/// <returns>A <see cref="Line2D"/> representing the segment of the <see cref="Ray2D"/>.</returns>
|
||||||
|
public static Line2D GetLine(Ray2D ray, float distance)
|
||||||
|
=> new(ray.Origin, ray.Origin + ray.Direction * distance);
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Evaluates the point on the <see cref="Ray2D"/> at a specified distance from its origin.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="ray">The <see cref="Ray2D"/> to evaluate.</param>
|
||||||
|
/// <param name="distanceFromOrigin">The distance from the origin along the <see cref="Ray2D"/>'s direction.</param>
|
||||||
|
/// <returns>A <see cref="Vector2D"/> representing the point at the given distance on the <see cref="Ray2D"/>.</returns>
|
||||||
|
public static Vector2D Evaluate(Ray2D ray, float distanceFromOrigin)
|
||||||
|
=> ray.Origin + ray.Direction * distanceFromOrigin;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Calculates the closest point on the <see cref="Ray2D"/> to the specified point.
|
||||||
|
/// </summary>
|
||||||
|
public static Vector2D ClosestPointTo(Ray2D ray, Vector2D point)
|
||||||
|
{
|
||||||
|
Vector2D originToPoint = ray.Origin.FromTo(point);
|
||||||
|
|
||||||
|
float dot = ray.Direction.Dot(originToPoint);
|
||||||
|
|
||||||
|
return ray.Origin + ray.Direction * dot;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Checks if two <see cref="Ray2D"/>s are approximately equal within a specified epsilon range.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="left">The first <see cref="Ray2D"/>.</param>
|
||||||
|
/// <param name="right">The second <see cref="Ray2D"/>.</param>
|
||||||
|
/// <param name="epsilon">The epsilon range.</param>
|
||||||
|
/// <returns><see cref="true"/> if the <see cref="Ray2D"/>s are approximately equal; otherwise, <see cref="false"/>.</returns>
|
||||||
|
public static bool ApproximatelyEquals(Ray2D left, Ray2D right, float epsilon = float.Epsilon)
|
||||||
|
=> left.Origin.ApproximatelyEquals(right.Origin, epsilon) && left.Direction.ApproximatelyEquals(right.Direction, epsilon);
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Determines whether the specified object is equal to the current <see cref="Ray2D"/>.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="obj">The object to compare with the current <see cref="Ray2D"/>.</param>
|
||||||
|
/// <returns><see cref="true"/> if the specified object is equal to the current <see cref="Ray2D"/>; otherwise, <see cref="false"/>.</returns>
|
||||||
|
public override bool Equals(object? obj) => obj is Ray2D ray2D && this == ray2D;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Generates a hash code for the <see cref="Ray2D"/>.
|
||||||
|
/// </summary>
|
||||||
|
/// <returns>A hash code for the <see cref="Ray2D"/>.</returns>
|
||||||
|
public override int GetHashCode() => System.HashCode.Combine(Origin, Direction);
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Converts the <see cref="Ray2D"/> to its string representation.
|
||||||
|
/// </summary>
|
||||||
|
/// <returns>A string representation of the <see cref="Ray2D"/>.</returns>
|
||||||
|
public override string ToString() => $"{nameof(Ray2D)}({Origin}, {Direction})";
|
||||||
|
}
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Provides extension methods for the <see cref="Ray2D"/> struct.
|
||||||
|
/// </summary>
|
||||||
|
public static class Ray2DExtensions
|
||||||
|
{
|
||||||
|
/// <inheritdoc cref="Ray2D.GetLine(Ray2D, float) />
|
||||||
|
public static Line2D ToLine(this Ray2D ray, float distance) => Ray2D.GetLine(ray, distance);
|
||||||
|
|
||||||
|
/// <inheritdoc cref="Ray2D.Evaluate(Ray2D, float) />
|
||||||
|
public static Vector2D Evaluate(this Ray2D ray, float distanceFromOrigin) => Ray2D.Evaluate(ray, distanceFromOrigin);
|
||||||
|
|
||||||
|
/// <inheritdoc cref="Ray2D.ClosestPointTo(Ray2D, Vector2D) />
|
||||||
|
public static Vector2D ClosestPointTo(this Ray2D ray, Vector2D point) => Ray2D.ClosestPointTo(ray, point);
|
||||||
|
|
||||||
|
/// <inheritdoc cref="Ray2D.ApproximatelyEquals(Ray2D, Ray2D, float)" />
|
||||||
|
public static bool ApproximatelyEquals(this Ray2D left, Ray2D right, float epsilon = float.Epsilon) => Ray2D.ApproximatelyEquals(left, right, epsilon);
|
||||||
|
}
|
@@ -11,19 +11,33 @@ namespace Syntriax.Engine.Core;
|
|||||||
/// Initializes a new instance of a <see cref="Shape2D"/> struct with the specified vertices.
|
/// Initializes a new instance of a <see cref="Shape2D"/> struct with the specified vertices.
|
||||||
/// </remarks>
|
/// </remarks>
|
||||||
[System.Diagnostics.DebuggerDisplay("Vertices Count: {Vertices.Count}")]
|
[System.Diagnostics.DebuggerDisplay("Vertices Count: {Vertices.Count}")]
|
||||||
public readonly struct Shape2D(List<Vector2D> vertices) : IEnumerable<Vector2D>
|
public class Shape2D(List<Vector2D> vertices) : IEnumerable<Vector2D>
|
||||||
{
|
{
|
||||||
public static readonly Shape2D Triangle = CreateNgon(3, Vector2D.Up);
|
public static Shape2D Triangle => CreateNgon(3, Vector2D.Up);
|
||||||
public static readonly Shape2D Square = CreateNgon(4, Vector2D.One);
|
public static Shape2D Square => CreateNgon(4, Vector2D.One);
|
||||||
public static readonly Shape2D Pentagon = CreateNgon(5, Vector2D.Up);
|
public static Shape2D Pentagon => CreateNgon(5, Vector2D.Up);
|
||||||
public static readonly Shape2D Hexagon = CreateNgon(6, Vector2D.Right);
|
public static Shape2D Hexagon => CreateNgon(6, Vector2D.Right);
|
||||||
|
|
||||||
private readonly List<Vector2D> _verticesList = vertices;
|
public Event<Shape2D> OnShapeUpdated { get; } = new();
|
||||||
|
|
||||||
|
private List<Vector2D> _vertices = vertices;
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Gets the vertices of the <see cref="Shape2D"/>.
|
/// Gets the vertices of the <see cref="Shape2D"/>.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
public IReadOnlyList<Vector2D> Vertices => _verticesList;
|
public IReadOnlyList<Vector2D> Vertices
|
||||||
|
{
|
||||||
|
get => _vertices;
|
||||||
|
set
|
||||||
|
{
|
||||||
|
_vertices.Clear();
|
||||||
|
|
||||||
|
foreach (Vector2D vertex in value)
|
||||||
|
_vertices.Add(vertex);
|
||||||
|
|
||||||
|
OnShapeUpdated?.Invoke(this);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// The vertex at the specified index.
|
/// The vertex at the specified index.
|
||||||
@@ -108,7 +122,7 @@ public readonly struct Shape2D(List<Vector2D> vertices) : IEnumerable<Vector2D>
|
|||||||
triangles.Clear();
|
triangles.Clear();
|
||||||
|
|
||||||
for (int i = 2; i < shape.Vertices.Count; i++)
|
for (int i = 2; i < shape.Vertices.Count; i++)
|
||||||
triangles.Add(new Triangle(shape[0], shape[i - 1], shape[i]));
|
triangles.Add(new Triangle(shape[0], shape[i], shape[i - 1]));
|
||||||
}
|
}
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
@@ -207,13 +221,15 @@ public readonly struct Shape2D(List<Vector2D> vertices) : IEnumerable<Vector2D>
|
|||||||
/// <param name="from">The <see cref="Shape2D"/> to transform.</param>
|
/// <param name="from">The <see cref="Shape2D"/> to transform.</param>
|
||||||
/// <param name="transform">The <see cref="ITransform2D"/> to apply.</param>
|
/// <param name="transform">The <see cref="ITransform2D"/> to apply.</param>
|
||||||
/// <param name="to">The transformed <see cref="Shape2D"/>.</param>
|
/// <param name="to">The transformed <see cref="Shape2D"/>.</param>
|
||||||
public static void Transform(Shape2D from, ITransform2D transform, ref Shape2D to)
|
public static void Transform(Shape2D from, ITransform2D transform, Shape2D to)
|
||||||
{
|
{
|
||||||
to._verticesList.Clear();
|
to._vertices.Clear();
|
||||||
|
|
||||||
int count = from._verticesList.Count;
|
int count = from._vertices.Count;
|
||||||
for (int i = 0; i < count; i++)
|
for (int i = 0; i < count; i++)
|
||||||
to._verticesList.Add(transform.Transform(from[i]));
|
to._vertices.Add(transform.Transform(from[i]));
|
||||||
|
|
||||||
|
to.OnShapeUpdated?.Invoke(to);
|
||||||
}
|
}
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
@@ -235,6 +251,34 @@ public readonly struct Shape2D(List<Vector2D> vertices) : IEnumerable<Vector2D>
|
|||||||
return true;
|
return true;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Determines whether the specified object is equal to the current <see cref="Shape2D"/>.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="obj">The object to compare with the current <see cref="Shape2D"/>.</param>
|
||||||
|
/// <returns><see cref="true"/> if the specified object is equal to the current <see cref="Shape2D"/>; otherwise, <see cref="false"/>.</returns>
|
||||||
|
public override bool Equals(object? obj) => obj is Shape2D shape2D && _vertices.Equals(shape2D._vertices);
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Generates a hash code for the <see cref="Shape2D"/>.
|
||||||
|
/// </summary>
|
||||||
|
/// <returns>A hash code for the <see cref="Shape2D"/>.</returns>
|
||||||
|
public override int GetHashCode() => System.HashCode.Combine(Vertices);
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Converts the <see cref="Shape2D"/> to its string representation.
|
||||||
|
/// </summary>
|
||||||
|
/// <returns>A string representation of the <see cref="Shape2D"/>.</returns>
|
||||||
|
public override string ToString()
|
||||||
|
{
|
||||||
|
System.Text.StringBuilder stringBuilder = new(Vertices[0].ToString());
|
||||||
|
for (int i = 1; i < Vertices.Count; i++)
|
||||||
|
{
|
||||||
|
stringBuilder.Append(", ");
|
||||||
|
stringBuilder.Append(Vertices[i].ToString());
|
||||||
|
}
|
||||||
|
return $"{nameof(Shape2D)}({stringBuilder})";
|
||||||
|
}
|
||||||
|
|
||||||
/// <inheritdoc/>
|
/// <inheritdoc/>
|
||||||
public IEnumerator<Vector2D> GetEnumerator() => Vertices.GetEnumerator();
|
public IEnumerator<Vector2D> GetEnumerator() => Vertices.GetEnumerator();
|
||||||
|
|
||||||
@@ -254,7 +298,7 @@ public static class Shape2DExtensions
|
|||||||
public static Triangle ToSuperTriangle(this Shape2D shape) => Shape2D.GetSuperTriangle(shape);
|
public static Triangle ToSuperTriangle(this Shape2D shape) => Shape2D.GetSuperTriangle(shape);
|
||||||
|
|
||||||
/// <inheritdoc cref="Shape2D.TriangulateConvex(Shape2D, IList{Triangle})" />
|
/// <inheritdoc cref="Shape2D.TriangulateConvex(Shape2D, IList{Triangle})" />
|
||||||
public static void ToTrianglesConvex(this Shape2D shape, IList<Triangle> lines) => Shape2D.TriangulateConvex(shape, lines);
|
public static void ToTrianglesConvex(this Shape2D shape, IList<Triangle> triangles) => Shape2D.TriangulateConvex(shape, triangles);
|
||||||
|
|
||||||
/// <inheritdoc cref="Shape2D.TriangulateConvex(Shape2D)" />
|
/// <inheritdoc cref="Shape2D.TriangulateConvex(Shape2D)" />
|
||||||
public static List<Triangle> ToTrianglesConvex(this Shape2D shape) => Shape2D.TriangulateConvex(shape);
|
public static List<Triangle> ToTrianglesConvex(this Shape2D shape) => Shape2D.TriangulateConvex(shape);
|
||||||
@@ -275,13 +319,13 @@ public static class Shape2DExtensions
|
|||||||
public static Shape2D Transform(this ITransform2D transform, Shape2D shape) => Shape2D.Transform(shape, transform);
|
public static Shape2D Transform(this ITransform2D transform, Shape2D shape) => Shape2D.Transform(shape, transform);
|
||||||
|
|
||||||
/// <inheritdoc cref="Shape2D.Transform(Shape2D, ITransform2D, Shape2D)" />
|
/// <inheritdoc cref="Shape2D.Transform(Shape2D, ITransform2D, Shape2D)" />
|
||||||
public static void Transform(this ITransform2D transform, Shape2D from, ref Shape2D to) => Shape2D.Transform(from, transform, ref to);
|
public static void Transform(this ITransform2D transform, Shape2D from, Shape2D to) => Shape2D.Transform(from, transform, to);
|
||||||
|
|
||||||
/// <inheritdoc cref="Shape2D.Transform(Shape2D, ITransform2D)" />
|
/// <inheritdoc cref="Shape2D.Transform(Shape2D, ITransform2D)" />
|
||||||
public static Shape2D Transform(this Shape2D shape, ITransform2D transform) => Shape2D.Transform(shape, transform);
|
public static Shape2D Transform(this Shape2D shape, ITransform2D transform) => Shape2D.Transform(shape, transform);
|
||||||
|
|
||||||
/// <inheritdoc cref="Shape2D.Transform(Shape2D, ITransform2D, ref Shape2D)" />
|
/// <inheritdoc cref="Shape2D.Transform(Shape2D, ITransform2D,Shape2D)" />
|
||||||
public static void Transform(this Shape2D from, ITransform2D transform, ref Shape2D to) => Shape2D.Transform(from, transform, ref to);
|
public static void Transform(this Shape2D from, ITransform2D transform, Shape2D to) => Shape2D.Transform(from, transform, to);
|
||||||
|
|
||||||
/// <inheritdoc cref="Shape2D.ApproximatelyEquals(Shape2D, Shape2D, float)" />
|
/// <inheritdoc cref="Shape2D.ApproximatelyEquals(Shape2D, Shape2D, float)" />
|
||||||
public static bool ApproximatelyEquals(this Shape2D left, Shape2D right, float epsilon = float.Epsilon) => Shape2D.ApproximatelyEquals(left, right, epsilon);
|
public static bool ApproximatelyEquals(this Shape2D left, Shape2D right, float epsilon = float.Epsilon) => Shape2D.ApproximatelyEquals(left, right, epsilon);
|
||||||
|
@@ -1,5 +1,3 @@
|
|||||||
using System;
|
|
||||||
|
|
||||||
namespace Syntriax.Engine.Core;
|
namespace Syntriax.Engine.Core;
|
||||||
|
|
||||||
[System.Diagnostics.DebuggerDisplay("A: {A.ToString(), nq}, B: {B.ToString(), nq}, B: {C.ToString(), nq}")]
|
[System.Diagnostics.DebuggerDisplay("A: {A.ToString(), nq}, B: {B.ToString(), nq}, B: {C.ToString(), nq}")]
|
||||||
@@ -9,8 +7,11 @@ public readonly struct Triangle(Vector2D A, Vector2D B, Vector2D C)
|
|||||||
public readonly Vector2D B { get; init; } = B;
|
public readonly Vector2D B { get; init; } = B;
|
||||||
public readonly Vector2D C { get; init; } = C;
|
public readonly Vector2D C { get; init; } = C;
|
||||||
|
|
||||||
|
public static bool operator ==(Triangle left, Triangle right) => left.A == right.A && left.B == right.B && left.C == right.C;
|
||||||
|
public static bool operator !=(Triangle left, Triangle right) => left.A != right.A || left.B != right.B || left.C != right.C;
|
||||||
|
|
||||||
public readonly float Area
|
public readonly float Area
|
||||||
=> .5f * MathF.Abs(
|
=> .5f * Math.Abs(
|
||||||
A.X * (B.Y - C.Y) +
|
A.X * (B.Y - C.Y) +
|
||||||
B.X * (C.Y - A.Y) +
|
B.X * (C.Y - A.Y) +
|
||||||
C.X * (A.Y - B.Y)
|
C.X * (A.Y - B.Y)
|
||||||
@@ -25,7 +26,7 @@ public readonly struct Triangle(Vector2D A, Vector2D B, Vector2D C)
|
|||||||
float slopeBC = (triangle.C.Y - triangle.B.Y) / (triangle.C.X - triangle.B.X);
|
float slopeBC = (triangle.C.Y - triangle.B.Y) / (triangle.C.X - triangle.B.X);
|
||||||
|
|
||||||
Vector2D center;
|
Vector2D center;
|
||||||
if (MathF.Abs(slopeAB - slopeBC) > float.Epsilon)
|
if (Math.Abs(slopeAB - slopeBC) > float.Epsilon)
|
||||||
{
|
{
|
||||||
float x = (slopeAB * slopeBC * (triangle.A.Y - triangle.C.Y) + slopeBC * (triangle.A.X + triangle.B.X) - slopeAB * (triangle.B.X + triangle.C.X)) / (2f * (slopeBC - slopeAB));
|
float x = (slopeAB * slopeBC * (triangle.A.Y - triangle.C.Y) + slopeBC * (triangle.A.X + triangle.B.X) - slopeAB * (triangle.B.X + triangle.C.X)) / (2f * (slopeBC - slopeAB));
|
||||||
float y = -(x - (triangle.A.X + triangle.B.X) / 2f) / slopeAB + (triangle.A.Y + triangle.B.Y) / 2f;
|
float y = -(x - (triangle.A.X + triangle.B.X) / 2f) / slopeAB + (triangle.A.Y + triangle.B.Y) / 2f;
|
||||||
@@ -46,6 +47,25 @@ public readonly struct Triangle(Vector2D A, Vector2D B, Vector2D C)
|
|||||||
/// <returns><c>true</c> if the <see cref="Triangle"/>s are approximately equal; otherwise, <c>false</c>.</returns>
|
/// <returns><c>true</c> if the <see cref="Triangle"/>s are approximately equal; otherwise, <c>false</c>.</returns>
|
||||||
public static bool ApproximatelyEquals(Triangle left, Triangle right, float epsilon = float.Epsilon)
|
public static bool ApproximatelyEquals(Triangle left, Triangle right, float epsilon = float.Epsilon)
|
||||||
=> left.A.ApproximatelyEquals(right.A, epsilon) && left.B.ApproximatelyEquals(right.B, epsilon) && left.C.ApproximatelyEquals(right.C, epsilon);
|
=> left.A.ApproximatelyEquals(right.A, epsilon) && left.B.ApproximatelyEquals(right.B, epsilon) && left.C.ApproximatelyEquals(right.C, epsilon);
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Determines whether the specified object is equal to the current <see cref="Triangle"/>.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="obj">The object to compare with the current <see cref="Triangle"/>.</param>
|
||||||
|
/// <returns><see cref="true"/> if the specified object is equal to the current <see cref="Triangle"/>; otherwise, <see cref="false"/>.</returns>
|
||||||
|
public override bool Equals(object? obj) => obj is Triangle triangle && this == triangle;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Generates a hash code for the <see cref="Triangle"/>.
|
||||||
|
/// </summary>
|
||||||
|
/// <returns>A hash code for the <see cref="Triangle"/>.</returns>
|
||||||
|
public override int GetHashCode() => System.HashCode.Combine(A, B, C);
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Converts the <see cref="Triangle"/> to its string representation.
|
||||||
|
/// </summary>
|
||||||
|
/// <returns>A string representation of the <see cref="Triangle"/>.</returns>
|
||||||
|
public override string ToString() => $"{nameof(Triangle)}({A}, {B}, {C})";
|
||||||
}
|
}
|
||||||
|
|
||||||
public static class TriangleExtensions
|
public static class TriangleExtensions
|
||||||
|
@@ -1,5 +1,3 @@
|
|||||||
using System;
|
|
||||||
|
|
||||||
namespace Syntriax.Engine.Core;
|
namespace Syntriax.Engine.Core;
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
@@ -33,6 +31,11 @@ public readonly struct Vector2D(float x, float y)
|
|||||||
/// </summary>
|
/// </summary>
|
||||||
public float MagnitudeSquared => LengthSquared(this);
|
public float MagnitudeSquared => LengthSquared(this);
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Gets a <see cref="Vector2D"/> with the direction reversed.
|
||||||
|
/// </summary>
|
||||||
|
public readonly Vector2D Reversed => -this;
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// The normalized form of the <see cref="Vector2D"/> (a <see cref="Vector2D"/> with the same direction and a magnitude of 1).
|
/// The normalized form of the <see cref="Vector2D"/> (a <see cref="Vector2D"/> with the same direction and a magnitude of 1).
|
||||||
/// </summary>
|
/// </summary>
|
||||||
@@ -299,24 +302,24 @@ public readonly struct Vector2D(float x, float y)
|
|||||||
public static bool ApproximatelyEquals(Vector2D left, Vector2D right, float epsilon = float.Epsilon)
|
public static bool ApproximatelyEquals(Vector2D left, Vector2D right, float epsilon = float.Epsilon)
|
||||||
=> left.X.ApproximatelyEquals(right.X, epsilon) && left.Y.ApproximatelyEquals(right.Y, epsilon);
|
=> left.X.ApproximatelyEquals(right.X, epsilon) && left.Y.ApproximatelyEquals(right.Y, epsilon);
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Converts the <see cref="Vector2D"/> to its string representation.
|
|
||||||
/// </summary>
|
|
||||||
/// <returns>A string representation of the <see cref="Vector2D"/>.</returns>
|
|
||||||
public override string ToString() => $"{nameof(Vector2D)}({X}, {Y})";
|
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Determines whether the specified object is equal to the current <see cref="Vector2D"/>.
|
/// Determines whether the specified object is equal to the current <see cref="Vector2D"/>.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
/// <param name="obj">The object to compare with the current <see cref="Vector2D"/>.</param>
|
/// <param name="obj">The object to compare with the current <see cref="Vector2D"/>.</param>
|
||||||
/// <returns><see cref="true"/> if the specified object is equal to the current <see cref="Vector2D"/>; otherwise, <see cref="false"/>.</returns>
|
/// <returns><see cref="true"/> if the specified object is equal to the current <see cref="Vector2D"/>; otherwise, <see cref="false"/>.</returns>
|
||||||
public override bool Equals(object? obj) => obj is Vector2D objVec && X.Equals(objVec.X) && Y.Equals(objVec.Y);
|
public override bool Equals(object? obj) => obj is Vector2D vector2D && this == vector2D;
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Generates a hash code for the <see cref="Vector2D"/>.
|
/// Generates a hash code for the <see cref="Vector2D"/>.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
/// <returns>A hash code for the <see cref="Vector2D"/>.</returns>
|
/// <returns>A hash code for the <see cref="Vector2D"/>.</returns>
|
||||||
public override int GetHashCode() => HashCode.Combine(X, Y);
|
public override int GetHashCode() => System.HashCode.Combine(X, Y);
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Converts the <see cref="Vector2D"/> to its string representation.
|
||||||
|
/// </summary>
|
||||||
|
/// <returns>A string representation of the <see cref="Vector2D"/>.</returns>
|
||||||
|
public override string ToString() => $"{nameof(Vector2D)}({X}, {Y})";
|
||||||
}
|
}
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
|
@@ -1,5 +1,3 @@
|
|||||||
using System;
|
|
||||||
|
|
||||||
namespace Syntriax.Engine.Core;
|
namespace Syntriax.Engine.Core;
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
@@ -273,24 +271,24 @@ public readonly struct Vector3D(float x, float y, float z)
|
|||||||
public static bool ApproximatelyEquals(Vector3D left, Vector3D right, float epsilon = float.Epsilon)
|
public static bool ApproximatelyEquals(Vector3D left, Vector3D right, float epsilon = float.Epsilon)
|
||||||
=> left.X.ApproximatelyEquals(right.X, epsilon) && left.Y.ApproximatelyEquals(right.Y, epsilon) && left.Z.ApproximatelyEquals(right.Z, epsilon);
|
=> left.X.ApproximatelyEquals(right.X, epsilon) && left.Y.ApproximatelyEquals(right.Y, epsilon) && left.Z.ApproximatelyEquals(right.Z, epsilon);
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Converts the <see cref="Vector3D"/> to its string representation.
|
|
||||||
/// </summary>
|
|
||||||
/// <returns>A string representation of the <see cref="Vector3D"/>.</returns>
|
|
||||||
public override string ToString() => $"{nameof(Vector3D)}({X}, {Y}, {Z})";
|
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Determines whether the specified object is equal to the current <see cref="Vector3D"/>.
|
/// Determines whether the specified object is equal to the current <see cref="Vector3D"/>.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
/// <param name="obj">The object to compare with the current <see cref="Vector3D"/>.</param>
|
/// <param name="obj">The object to compare with the current <see cref="Vector3D"/>.</param>
|
||||||
/// <returns><see cref="true"/> if the specified object is equal to the current <see cref="Vector3D"/>; otherwise, <see cref="false"/>.</returns>
|
/// <returns><see cref="true"/> if the specified object is equal to the current <see cref="Vector3D"/>; otherwise, <see cref="false"/>.</returns>
|
||||||
public override bool Equals(object? obj) => obj is Vector3D objVec && X.Equals(objVec.X) && Y.Equals(objVec.Y) && Z.Equals(objVec.Z);
|
public override bool Equals(object? obj) => obj is Vector3D vector3D && this == vector3D;
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Generates a hash code for the <see cref="Vector3D"/>.
|
/// Generates a hash code for the <see cref="Vector3D"/>.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
/// <returns>A hash code for the <see cref="Vector3D"/>.</returns>
|
/// <returns>A hash code for the <see cref="Vector3D"/>.</returns>
|
||||||
public override int GetHashCode() => HashCode.Combine(X, Y, Z);
|
public override int GetHashCode() => System.HashCode.Combine(X, Y, Z);
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Converts the <see cref="Vector3D"/> to its string representation.
|
||||||
|
/// </summary>
|
||||||
|
/// <returns>A string representation of the <see cref="Vector3D"/>.</returns>
|
||||||
|
public override string ToString() => $"{nameof(Vector3D)}({X}, {Y}, {Z})";
|
||||||
}
|
}
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
|
@@ -0,0 +1,6 @@
|
|||||||
|
using System;
|
||||||
|
|
||||||
|
namespace Syntriax.Engine.Core.Serialization;
|
||||||
|
|
||||||
|
[AttributeUsage(AttributeTargets.Property | AttributeTargets.Field | AttributeTargets.Class)]
|
||||||
|
public class IgnoreSerializationAttribute : Attribute;
|
@@ -0,0 +1,6 @@
|
|||||||
|
using System;
|
||||||
|
|
||||||
|
namespace Syntriax.Engine.Core.Serialization;
|
||||||
|
|
||||||
|
[AttributeUsage(AttributeTargets.Class | AttributeTargets.Struct)]
|
||||||
|
public class SerializeAllAttribute : Attribute;
|
@@ -0,0 +1,6 @@
|
|||||||
|
using System;
|
||||||
|
|
||||||
|
namespace Syntriax.Engine.Core.Serialization;
|
||||||
|
|
||||||
|
[AttributeUsage(AttributeTargets.Field | AttributeTargets.Property)]
|
||||||
|
public class SerializeAttribute : Attribute;
|
3
Engine.Core/Serialization/EntityReference.cs
Normal file
3
Engine.Core/Serialization/EntityReference.cs
Normal file
@@ -0,0 +1,3 @@
|
|||||||
|
namespace Syntriax.Engine.Core.Serialization;
|
||||||
|
|
||||||
|
public record class EntityReference(string? Id = null);
|
39
Engine.Core/Serialization/EntityRegistry.cs
Normal file
39
Engine.Core/Serialization/EntityRegistry.cs
Normal file
@@ -0,0 +1,39 @@
|
|||||||
|
using System;
|
||||||
|
using System.Collections.Generic;
|
||||||
|
|
||||||
|
namespace Syntriax.Engine.Core.Serialization;
|
||||||
|
|
||||||
|
public class EntityRegistry
|
||||||
|
{
|
||||||
|
public Event<EntityRegistry, EntityRegisteredArguments> OnEntityRegistered = null!;
|
||||||
|
|
||||||
|
private readonly Dictionary<string, Action<IEntity>?> assignCallbacks = [];
|
||||||
|
private readonly Dictionary<string, IEntity> registeredEntities = [];
|
||||||
|
public IReadOnlyDictionary<string, IEntity> RegisteredEntities => registeredEntities;
|
||||||
|
|
||||||
|
public void Add(IEntity entity)
|
||||||
|
{
|
||||||
|
if (registeredEntities.TryAdd(entity.Id, entity))
|
||||||
|
OnEntityRegistered?.Invoke(this, new(entity));
|
||||||
|
}
|
||||||
|
|
||||||
|
public void QueueAssign(string id, Action<IEntity> setMethod)
|
||||||
|
{
|
||||||
|
assignCallbacks.TryAdd(id, null);
|
||||||
|
assignCallbacks[id] = assignCallbacks[id] + setMethod;
|
||||||
|
}
|
||||||
|
|
||||||
|
public void AssignAll()
|
||||||
|
{
|
||||||
|
foreach ((string id, Action<IEntity>? action) in assignCallbacks)
|
||||||
|
action?.Invoke(registeredEntities[id]);
|
||||||
|
}
|
||||||
|
|
||||||
|
public void Reset()
|
||||||
|
{
|
||||||
|
assignCallbacks.Clear();
|
||||||
|
registeredEntities.Clear();
|
||||||
|
}
|
||||||
|
|
||||||
|
public readonly record struct EntityRegisteredArguments(IEntity Entity);
|
||||||
|
}
|
18
Engine.Core/Serialization/ISerializer.cs
Normal file
18
Engine.Core/Serialization/ISerializer.cs
Normal file
@@ -0,0 +1,18 @@
|
|||||||
|
using System;
|
||||||
|
|
||||||
|
namespace Syntriax.Engine.Core.Serialization;
|
||||||
|
|
||||||
|
public interface ISerializer
|
||||||
|
{
|
||||||
|
object Deserialize(string configuration);
|
||||||
|
object Deserialize(string configuration, Type type);
|
||||||
|
T Deserialize<T>(string configuration);
|
||||||
|
|
||||||
|
string Serialize(object instance);
|
||||||
|
|
||||||
|
ProgressiveTask<object> DeserializeAsync(string configuration);
|
||||||
|
ProgressiveTask<object> DeserializeAsync(string configuration, Type type);
|
||||||
|
ProgressiveTask<T> DeserializeAsync<T>(string configuration);
|
||||||
|
|
||||||
|
ProgressiveTask<string> SerializeAsync(object instance);
|
||||||
|
}
|
157
Engine.Core/Serialization/SerializedClass.cs
Normal file
157
Engine.Core/Serialization/SerializedClass.cs
Normal file
@@ -0,0 +1,157 @@
|
|||||||
|
using System;
|
||||||
|
using System.Collections.Generic;
|
||||||
|
using System.Reflection;
|
||||||
|
|
||||||
|
using Syntriax.Engine.Core.Factory;
|
||||||
|
|
||||||
|
namespace Syntriax.Engine.Core.Serialization;
|
||||||
|
|
||||||
|
public class SerializedClass
|
||||||
|
{
|
||||||
|
private const BindingFlags PRIVATE_BINDING_FLAGS = BindingFlags.Instance | BindingFlags.NonPublic;
|
||||||
|
private const BindingFlags PUBLIC_BINDING_FLAGS = BindingFlags.Instance | BindingFlags.Public;
|
||||||
|
|
||||||
|
public string Type { get; set; } = string.Empty;
|
||||||
|
public Dictionary<string, object?> Public { get; set; } = [];
|
||||||
|
public Dictionary<string, object?> Private { get; set; } = [];
|
||||||
|
|
||||||
|
public SerializedClass() { }
|
||||||
|
public SerializedClass(object @class)
|
||||||
|
{
|
||||||
|
UpdateClass(@class);
|
||||||
|
}
|
||||||
|
|
||||||
|
private void UpdateClass(object @class)
|
||||||
|
{
|
||||||
|
Type type = @class.GetType();
|
||||||
|
Type = type.FullName ?? type.Name;
|
||||||
|
|
||||||
|
bool shouldSerializeAll = type.HasAttribute<SerializeAllAttribute>();
|
||||||
|
|
||||||
|
Public.Clear();
|
||||||
|
Private.Clear();
|
||||||
|
|
||||||
|
foreach (PropertyInfo privatePropertyInfo in Utils.GetPropertyInfosIncludingBaseClasses(type, PRIVATE_BINDING_FLAGS))
|
||||||
|
{
|
||||||
|
if (privatePropertyInfo.HasAttribute<IgnoreSerializationAttribute>())
|
||||||
|
continue;
|
||||||
|
|
||||||
|
if (privatePropertyInfo.SetMethod is null)
|
||||||
|
continue;
|
||||||
|
|
||||||
|
if (!shouldSerializeAll && !privatePropertyInfo.HasAttribute<SerializeAttribute>())
|
||||||
|
continue;
|
||||||
|
|
||||||
|
object? value = privatePropertyInfo.GetValue(@class);
|
||||||
|
if (value is IEntity entity)
|
||||||
|
Private.Add(privatePropertyInfo.Name, entity.Id);
|
||||||
|
else
|
||||||
|
Private.Add(privatePropertyInfo.Name, value);
|
||||||
|
}
|
||||||
|
|
||||||
|
foreach (PropertyInfo publicPropertyInfo in Utils.GetPropertyInfosIncludingBaseClasses(type, PUBLIC_BINDING_FLAGS))
|
||||||
|
{
|
||||||
|
if (publicPropertyInfo.HasAttribute<IgnoreSerializationAttribute>())
|
||||||
|
continue;
|
||||||
|
|
||||||
|
if (publicPropertyInfo.SetMethod is null)
|
||||||
|
continue;
|
||||||
|
|
||||||
|
if (!shouldSerializeAll && !publicPropertyInfo.HasAttribute<SerializeAttribute>())
|
||||||
|
continue;
|
||||||
|
|
||||||
|
object? value = publicPropertyInfo.GetValue(@class);
|
||||||
|
if (value is IEntity entity)
|
||||||
|
Public.Add(publicPropertyInfo.Name, entity.Id);
|
||||||
|
else
|
||||||
|
Public.Add(publicPropertyInfo.Name, value);
|
||||||
|
}
|
||||||
|
|
||||||
|
foreach (FieldInfo privateFieldInfo in Utils.GetFieldInfosIncludingBaseClasses(type, PRIVATE_BINDING_FLAGS))
|
||||||
|
{
|
||||||
|
if (privateFieldInfo.HasAttribute<System.Runtime.CompilerServices.CompilerGeneratedAttribute>())
|
||||||
|
continue;
|
||||||
|
|
||||||
|
if (!shouldSerializeAll && !privateFieldInfo.HasAttribute<SerializeAttribute>())
|
||||||
|
continue;
|
||||||
|
|
||||||
|
object? value = privateFieldInfo.GetValue(@class);
|
||||||
|
if (value is IEntity entity)
|
||||||
|
Private.Add(privateFieldInfo.Name, entity.Id);
|
||||||
|
else
|
||||||
|
Private.Add(privateFieldInfo.Name, value);
|
||||||
|
}
|
||||||
|
|
||||||
|
foreach (FieldInfo publicFieldInfo in Utils.GetFieldInfosIncludingBaseClasses(type, PUBLIC_BINDING_FLAGS))
|
||||||
|
{
|
||||||
|
if (publicFieldInfo.HasAttribute<System.Runtime.CompilerServices.CompilerGeneratedAttribute>())
|
||||||
|
continue;
|
||||||
|
|
||||||
|
if (!shouldSerializeAll && !publicFieldInfo.HasAttribute<SerializeAttribute>())
|
||||||
|
continue;
|
||||||
|
|
||||||
|
object? value = publicFieldInfo.GetValue(@class);
|
||||||
|
if (value is IEntity entity)
|
||||||
|
Public.Add(publicFieldInfo.Name, entity.Id);
|
||||||
|
else
|
||||||
|
Public.Add(publicFieldInfo.Name, value);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public object CreateInstance()
|
||||||
|
{
|
||||||
|
Type type = TypeFactory.GetType(Type);
|
||||||
|
object instance = TypeFactory.Get(type);
|
||||||
|
|
||||||
|
foreach ((string key, object? value) in Private)
|
||||||
|
AssignVariable(key, type, instance, value, PRIVATE_BINDING_FLAGS);
|
||||||
|
|
||||||
|
foreach ((string key, object? value) in Public)
|
||||||
|
AssignVariable(key, type, instance, value, PUBLIC_BINDING_FLAGS);
|
||||||
|
|
||||||
|
return instance;
|
||||||
|
}
|
||||||
|
|
||||||
|
public object CreateInstance(EntityRegistry? entityRegistry)
|
||||||
|
{
|
||||||
|
if (entityRegistry is null)
|
||||||
|
return CreateInstance();
|
||||||
|
|
||||||
|
Type type = TypeFactory.GetType(Type);
|
||||||
|
object instance = TypeFactory.Get(type);
|
||||||
|
|
||||||
|
foreach ((string key, object? value) in Private)
|
||||||
|
AssignVariable(key, type, instance, value, PRIVATE_BINDING_FLAGS, entityRegistry);
|
||||||
|
|
||||||
|
foreach ((string key, object? value) in Public)
|
||||||
|
AssignVariable(key, type, instance, value, PUBLIC_BINDING_FLAGS, entityRegistry);
|
||||||
|
|
||||||
|
return instance;
|
||||||
|
}
|
||||||
|
|
||||||
|
private static void AssignVariable(string key, Type type, object instance, object? value, BindingFlags bindingFlags, EntityRegistry entityRegistry)
|
||||||
|
{
|
||||||
|
if (type.GetField(key, bindingFlags) is FieldInfo fieldInfo)
|
||||||
|
{
|
||||||
|
if (typeof(IEntity).IsAssignableFrom(fieldInfo.FieldType))
|
||||||
|
entityRegistry.QueueAssign(value?.ToString() ?? "", (entity) => fieldInfo.SetValue(instance, entity));
|
||||||
|
else
|
||||||
|
fieldInfo.SetValue(instance, value);
|
||||||
|
}
|
||||||
|
else if (type.GetProperty(key, bindingFlags) is PropertyInfo propertyInfo)
|
||||||
|
{
|
||||||
|
if (typeof(IEntity).IsAssignableFrom(propertyInfo.PropertyType))
|
||||||
|
entityRegistry.QueueAssign(value?.ToString() ?? "", (entity) => propertyInfo.SetValue(instance, entity));
|
||||||
|
else
|
||||||
|
propertyInfo.SetValue(instance, value);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private static void AssignVariable(string key, Type type, object instance, object? value, BindingFlags bindingFlags)
|
||||||
|
{
|
||||||
|
if (type.GetField(key, bindingFlags) is FieldInfo fieldInfo)
|
||||||
|
fieldInfo.SetValue(instance, value);
|
||||||
|
else if (type.GetProperty(key, bindingFlags) is PropertyInfo propertyInfo)
|
||||||
|
propertyInfo.SetValue(instance, value);
|
||||||
|
}
|
||||||
|
}
|
13
Engine.Core/Serialization/TypeContainer.cs
Normal file
13
Engine.Core/Serialization/TypeContainer.cs
Normal file
@@ -0,0 +1,13 @@
|
|||||||
|
using System;
|
||||||
|
|
||||||
|
namespace Syntriax.Engine.Core.Serialization;
|
||||||
|
|
||||||
|
public class TypeContainer
|
||||||
|
{
|
||||||
|
public object? Value { get; set; } = string.Empty;
|
||||||
|
public string Type { get; set; } = string.Empty;
|
||||||
|
|
||||||
|
public TypeContainer() { }
|
||||||
|
public TypeContainer(Type type) { Type = type.FullName ?? string.Empty; }
|
||||||
|
public TypeContainer(object? value) { Value = value; Type = value?.GetType().FullName ?? string.Empty; }
|
||||||
|
}
|
82
Engine.Core/Serialization/Utils.cs
Normal file
82
Engine.Core/Serialization/Utils.cs
Normal file
@@ -0,0 +1,82 @@
|
|||||||
|
using System;
|
||||||
|
using System.Collections.Generic;
|
||||||
|
using System.Linq;
|
||||||
|
using System.Reflection;
|
||||||
|
|
||||||
|
namespace Syntriax.Engine.Core.Serialization;
|
||||||
|
|
||||||
|
public static class Utils
|
||||||
|
{
|
||||||
|
public static bool HasAttribute<T>(this MemberInfo memberInfo) where T : Attribute => memberInfo.GetCustomAttribute<T>() is not null;
|
||||||
|
public static bool IsEnumerable(this Type type) => typeof(System.Collections.IEnumerable).IsAssignableFrom(type) && type != typeof(string);
|
||||||
|
|
||||||
|
public static TypeData GetTypeData(this Type objectType)
|
||||||
|
{
|
||||||
|
List<EventInfo> eventInfos = objectType.GetEvents(BindingFlags.Instance | BindingFlags.NonPublic | BindingFlags.Public)
|
||||||
|
.OrderBy(ei => ei.Name)
|
||||||
|
.ToList();
|
||||||
|
|
||||||
|
List<FieldInfo> fieldInfos = GetFieldInfosIncludingBaseClasses(objectType, BindingFlags.Instance | BindingFlags.FlattenHierarchy | BindingFlags.NonPublic | BindingFlags.Public)
|
||||||
|
.Where(pi => !eventInfos.Any(ei => pi.Name.CompareTo(ei.Name) == 0)).ToList();
|
||||||
|
|
||||||
|
List<PropertyInfo> propertyInfos = GetPropertyInfosIncludingBaseClasses(objectType, BindingFlags.Instance | BindingFlags.FlattenHierarchy | BindingFlags.Public)
|
||||||
|
.Where(pi => pi.SetMethod is not null && !eventInfos.Any(ei => pi.Name.CompareTo(ei.Name) == 0))
|
||||||
|
.ToList();
|
||||||
|
|
||||||
|
return new TypeData(fieldInfos, propertyInfos);
|
||||||
|
}
|
||||||
|
|
||||||
|
public static List<FieldInfo> GetFieldInfosIncludingBaseClasses(Type type, BindingFlags bindingFlags)
|
||||||
|
{
|
||||||
|
if (type.BaseType is null)
|
||||||
|
return [.. type.GetFields(bindingFlags)];
|
||||||
|
|
||||||
|
Type currentType = type;
|
||||||
|
FieldInfoComparer fieldComparer = new();
|
||||||
|
HashSet<FieldInfo> fieldInfoList = new(type.GetFields(bindingFlags), fieldComparer);
|
||||||
|
|
||||||
|
while (currentType.BaseType is Type baseType)
|
||||||
|
{
|
||||||
|
currentType = baseType;
|
||||||
|
fieldInfoList.UnionWith(currentType!.GetFields(bindingFlags));
|
||||||
|
}
|
||||||
|
|
||||||
|
return [.. fieldInfoList.OrderBy(fi => fi.Name)];
|
||||||
|
}
|
||||||
|
|
||||||
|
public static List<PropertyInfo> GetPropertyInfosIncludingBaseClasses(Type type, BindingFlags bindingFlags)
|
||||||
|
{
|
||||||
|
if (type.BaseType is null)
|
||||||
|
return [.. type.GetProperties(bindingFlags)];
|
||||||
|
|
||||||
|
Type currentType = type;
|
||||||
|
PropertyInfoComparer propertyComparer = new();
|
||||||
|
HashSet<PropertyInfo> propertyInfoList = new(type.GetProperties(bindingFlags), propertyComparer);
|
||||||
|
|
||||||
|
while (currentType.BaseType is Type baseType)
|
||||||
|
{
|
||||||
|
currentType = baseType;
|
||||||
|
propertyInfoList.UnionWith(currentType.GetProperties(bindingFlags));
|
||||||
|
}
|
||||||
|
|
||||||
|
return [.. propertyInfoList.OrderBy(pi => pi.Name)];
|
||||||
|
}
|
||||||
|
|
||||||
|
private class FieldInfoComparer : IEqualityComparer<FieldInfo>
|
||||||
|
{
|
||||||
|
public bool Equals(FieldInfo? x, FieldInfo? y) => x?.DeclaringType == y?.DeclaringType && x?.Name == y?.Name;
|
||||||
|
public int GetHashCode(FieldInfo obj) => obj.Name.GetHashCode() ^ obj.DeclaringType!.GetHashCode();
|
||||||
|
}
|
||||||
|
|
||||||
|
private class PropertyInfoComparer : IEqualityComparer<PropertyInfo>
|
||||||
|
{
|
||||||
|
public bool Equals(PropertyInfo? x, PropertyInfo? y) => x?.DeclaringType == y?.DeclaringType && x?.Name == y?.Name;
|
||||||
|
public int GetHashCode(PropertyInfo obj) => obj.Name.GetHashCode() ^ obj.DeclaringType!.GetHashCode();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public record struct TypeData(IEnumerable<FieldInfo> Fields, IEnumerable<PropertyInfo> Properties)
|
||||||
|
{
|
||||||
|
public static implicit operator (IEnumerable<FieldInfo> fields, IEnumerable<PropertyInfo> properties)(TypeData value) => (value.Fields, value.Properties);
|
||||||
|
public static implicit operator TypeData((IEnumerable<FieldInfo> fields, IEnumerable<PropertyInfo> properties) value) => new(value.fields, value.properties);
|
||||||
|
}
|
@@ -2,9 +2,9 @@ namespace Syntriax.Engine.Core;
|
|||||||
|
|
||||||
public class StateEnable : IStateEnable
|
public class StateEnable : IStateEnable
|
||||||
{
|
{
|
||||||
public event IAssignable.UnassignEventHandler? OnUnassigned = null;
|
public Event<IStateEnable, IStateEnable.EnabledChangedArguments> OnEnabledChanged { get; } = new();
|
||||||
public event IHasEntity.EntityAssignedEventHandler? OnEntityAssigned = null;
|
public Event<IHasEntity> OnEntityAssigned { get; } = new();
|
||||||
public event IStateEnable.EnabledChangedEventHandler? OnEnabledChanged = null;
|
public Event<IAssignable>? OnUnassigned { get; } = new();
|
||||||
|
|
||||||
private bool _enabled = true;
|
private bool _enabled = true;
|
||||||
private IEntity _entity = null!;
|
private IEntity _entity = null!;
|
||||||
@@ -21,7 +21,7 @@ public class StateEnable : IStateEnable
|
|||||||
|
|
||||||
bool previousState = _enabled;
|
bool previousState = _enabled;
|
||||||
_enabled = value;
|
_enabled = value;
|
||||||
OnEnabledChanged?.InvokeSafe(this, previousState);
|
OnEnabledChanged?.Invoke(this, new(previousState));
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -33,7 +33,7 @@ public class StateEnable : IStateEnable
|
|||||||
|
|
||||||
_entity = entity;
|
_entity = entity;
|
||||||
OnAssign(entity);
|
OnAssign(entity);
|
||||||
OnEntityAssigned?.InvokeSafe(this);
|
OnEntityAssigned?.Invoke(this);
|
||||||
return true;
|
return true;
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -43,7 +43,7 @@ public class StateEnable : IStateEnable
|
|||||||
return false;
|
return false;
|
||||||
|
|
||||||
_entity = null!;
|
_entity = null!;
|
||||||
OnUnassigned?.InvokeSafe(this);
|
OnUnassigned?.Invoke(this);
|
||||||
return true;
|
return true;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
12
Engine.Core/Systems/Abstract/IDraw.cs
Normal file
12
Engine.Core/Systems/Abstract/IDraw.cs
Normal file
@@ -0,0 +1,12 @@
|
|||||||
|
namespace Syntriax.Engine.Core;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Represents a <see cref="IBehaviour"/> to be notified when the draw phase of the <see cref="IUniverse"/> occurs.
|
||||||
|
/// </summary>
|
||||||
|
public interface IDraw : IBehaviour
|
||||||
|
{
|
||||||
|
/// <summary>
|
||||||
|
/// Calls draw logic for the <see cref="IBehaviour"/> to be displayed visually.
|
||||||
|
/// </summary>
|
||||||
|
void Draw();
|
||||||
|
}
|
6
Engine.Core/Systems/Abstract/IEnterUniverse.cs
Normal file
6
Engine.Core/Systems/Abstract/IEnterUniverse.cs
Normal file
@@ -0,0 +1,6 @@
|
|||||||
|
namespace Syntriax.Engine.Core;
|
||||||
|
|
||||||
|
public interface IEnterUniverse : IBehaviour
|
||||||
|
{
|
||||||
|
void EnterUniverse(IUniverse universe);
|
||||||
|
}
|
6
Engine.Core/Systems/Abstract/IExitUniverse.cs
Normal file
6
Engine.Core/Systems/Abstract/IExitUniverse.cs
Normal file
@@ -0,0 +1,6 @@
|
|||||||
|
namespace Syntriax.Engine.Core;
|
||||||
|
|
||||||
|
public interface IExitUniverse : IBehaviour
|
||||||
|
{
|
||||||
|
void ExitUniverse(IUniverse universe);
|
||||||
|
}
|
6
Engine.Core/Systems/Abstract/IFirstFrameUpdate.cs
Normal file
6
Engine.Core/Systems/Abstract/IFirstFrameUpdate.cs
Normal file
@@ -0,0 +1,6 @@
|
|||||||
|
namespace Syntriax.Engine.Core;
|
||||||
|
|
||||||
|
public interface IFirstFrameUpdate : IBehaviour
|
||||||
|
{
|
||||||
|
void FirstActiveFrame();
|
||||||
|
}
|
6
Engine.Core/Systems/Abstract/ILastFrameUpdate.cs
Normal file
6
Engine.Core/Systems/Abstract/ILastFrameUpdate.cs
Normal file
@@ -0,0 +1,6 @@
|
|||||||
|
namespace Syntriax.Engine.Core;
|
||||||
|
|
||||||
|
public interface ILastFrameUpdate : IBehaviour
|
||||||
|
{
|
||||||
|
void LastActiveFrame();
|
||||||
|
}
|
12
Engine.Core/Systems/Abstract/IPostDraw.cs
Normal file
12
Engine.Core/Systems/Abstract/IPostDraw.cs
Normal file
@@ -0,0 +1,12 @@
|
|||||||
|
namespace Syntriax.Engine.Core;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Represents a <see cref="IBehaviour"/> to be notified after the draw phase of the <see cref="IUniverse"/> occurs.
|
||||||
|
/// </summary>
|
||||||
|
public interface IPostDraw : IBehaviour
|
||||||
|
{
|
||||||
|
/// <summary>
|
||||||
|
/// Updates the state of the <see cref="IBehaviour"/> after the main draw phase happens.
|
||||||
|
/// </summary>
|
||||||
|
void PostDraw();
|
||||||
|
}
|
12
Engine.Core/Systems/Abstract/IPostUpdate.cs
Normal file
12
Engine.Core/Systems/Abstract/IPostUpdate.cs
Normal file
@@ -0,0 +1,12 @@
|
|||||||
|
namespace Syntriax.Engine.Core;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Represents a <see cref="IBehaviour"/> to be notified after the update phase of the <see cref="IUniverse"/> occurs.
|
||||||
|
/// </summary>
|
||||||
|
public interface IPostUpdate : IBehaviour
|
||||||
|
{
|
||||||
|
/// <summary>
|
||||||
|
/// Updates the state of the <see cref="IBehaviour"/> after the main update phase happens.
|
||||||
|
/// </summary>
|
||||||
|
void PostUpdate();
|
||||||
|
}
|
12
Engine.Core/Systems/Abstract/IPreDraw.cs
Normal file
12
Engine.Core/Systems/Abstract/IPreDraw.cs
Normal file
@@ -0,0 +1,12 @@
|
|||||||
|
namespace Syntriax.Engine.Core;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Represents a <see cref="IBehaviour"/> to be notified before the draw phase of the <see cref="IUniverse"/> occurs.
|
||||||
|
/// </summary>
|
||||||
|
public interface IPreDraw : IBehaviour
|
||||||
|
{
|
||||||
|
/// <summary>
|
||||||
|
/// Updates the state of the <see cref="IBehaviour"/> before the main draw phase happens.
|
||||||
|
/// </summary>
|
||||||
|
void PreDraw();
|
||||||
|
}
|
12
Engine.Core/Systems/Abstract/IPreUpdate.cs
Normal file
12
Engine.Core/Systems/Abstract/IPreUpdate.cs
Normal file
@@ -0,0 +1,12 @@
|
|||||||
|
namespace Syntriax.Engine.Core;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Represents a <see cref="IBehaviour"/> to be notified before the update phase of the <see cref="IUniverse"/> occurs.
|
||||||
|
/// </summary>
|
||||||
|
public interface IPreUpdate : IBehaviour
|
||||||
|
{
|
||||||
|
/// <summary>
|
||||||
|
/// Updates the state of the <see cref="IBehaviour"/> before the main update phase happens.
|
||||||
|
/// </summary>
|
||||||
|
void PreUpdate();
|
||||||
|
}
|
12
Engine.Core/Systems/Abstract/IUpdate.cs
Normal file
12
Engine.Core/Systems/Abstract/IUpdate.cs
Normal file
@@ -0,0 +1,12 @@
|
|||||||
|
namespace Syntriax.Engine.Core;
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Represents a <see cref="IBehaviour"/> to be notified when the update phase of the <see cref="IUniverse"/> occurs.
|
||||||
|
/// </summary>
|
||||||
|
public interface IUpdate : IBehaviour
|
||||||
|
{
|
||||||
|
/// <summary>
|
||||||
|
/// Updates the state of the <see cref="IBehaviour"/>.
|
||||||
|
/// </summary>
|
||||||
|
void Update();
|
||||||
|
}
|
53
Engine.Core/Systems/DrawManager.cs
Normal file
53
Engine.Core/Systems/DrawManager.cs
Normal file
@@ -0,0 +1,53 @@
|
|||||||
|
using System.Collections.Generic;
|
||||||
|
|
||||||
|
namespace Syntriax.Engine.Core;
|
||||||
|
|
||||||
|
public class DrawManager : Behaviour
|
||||||
|
{
|
||||||
|
// We use Descending order because draw calls are running from last to first
|
||||||
|
private static Comparer<IBehaviour> SortByDescendingPriority() => Comparer<IBehaviour>.Create((x, y) => y.Priority.CompareTo(x.Priority));
|
||||||
|
|
||||||
|
private readonly ActiveBehaviourCollectorSorted<IPreDraw> preDrawEntities = new() { SortBy = SortByDescendingPriority() };
|
||||||
|
private readonly ActiveBehaviourCollectorSorted<IDraw> drawEntities = new() { SortBy = SortByDescendingPriority() };
|
||||||
|
private readonly ActiveBehaviourCollectorSorted<IPostDraw> postDrawEntities = new() { SortBy = SortByDescendingPriority() };
|
||||||
|
|
||||||
|
private void OnPreDraw(IUniverse sender)
|
||||||
|
{
|
||||||
|
for (int i = preDrawEntities.Count - 1; i >= 0; i--)
|
||||||
|
preDrawEntities[i].PreDraw();
|
||||||
|
}
|
||||||
|
|
||||||
|
private void OnDraw(IUniverse sender)
|
||||||
|
{
|
||||||
|
for (int i = drawEntities.Count - 1; i >= 0; i--)
|
||||||
|
drawEntities[i].Draw();
|
||||||
|
}
|
||||||
|
|
||||||
|
private void OnPostDraw(IUniverse sender)
|
||||||
|
{
|
||||||
|
for (int i = postDrawEntities.Count - 1; i >= 0; i--)
|
||||||
|
postDrawEntities[i].PostDraw();
|
||||||
|
}
|
||||||
|
|
||||||
|
protected override void OnEnteredUniverse(IUniverse universe)
|
||||||
|
{
|
||||||
|
preDrawEntities.Assign(universe);
|
||||||
|
drawEntities.Assign(universe);
|
||||||
|
postDrawEntities.Assign(universe);
|
||||||
|
|
||||||
|
universe.OnPreDraw.AddListener(OnPreDraw);
|
||||||
|
universe.OnDraw.AddListener(OnDraw);
|
||||||
|
universe.OnPostDraw.AddListener(OnPostDraw);
|
||||||
|
}
|
||||||
|
|
||||||
|
protected override void OnExitedUniverse(IUniverse universe)
|
||||||
|
{
|
||||||
|
preDrawEntities.Unassign();
|
||||||
|
drawEntities.Unassign();
|
||||||
|
postDrawEntities.Unassign();
|
||||||
|
|
||||||
|
universe.OnPreDraw.RemoveListener(OnPreDraw);
|
||||||
|
universe.OnDraw.RemoveListener(OnDraw);
|
||||||
|
universe.OnPostDraw.RemoveListener(OnPostDraw);
|
||||||
|
}
|
||||||
|
}
|
71
Engine.Core/Systems/UniverseEntranceManager.cs
Normal file
71
Engine.Core/Systems/UniverseEntranceManager.cs
Normal file
@@ -0,0 +1,71 @@
|
|||||||
|
using System.Collections.Generic;
|
||||||
|
|
||||||
|
namespace Syntriax.Engine.Core;
|
||||||
|
|
||||||
|
public class UniverseEntranceManager : Behaviour
|
||||||
|
{
|
||||||
|
// We use Ascending order because we are using reverse for loop to call them
|
||||||
|
private static Comparer<IBehaviour> SortByAscendingPriority() => Comparer<IBehaviour>.Create((x, y) => x.Priority.CompareTo(y.Priority));
|
||||||
|
|
||||||
|
private readonly ActiveBehaviourCollectorSorted<IEnterUniverse> enterUniverses = new() { SortBy = SortByAscendingPriority() };
|
||||||
|
private readonly ActiveBehaviourCollectorSorted<IExitUniverse> exitUniverses = new() { SortBy = SortByAscendingPriority() };
|
||||||
|
|
||||||
|
private readonly List<IEnterUniverse> toCallEnterUniverses = new(32);
|
||||||
|
private readonly List<IExitUniverse> toCallExitUniverses = new(32);
|
||||||
|
|
||||||
|
protected override void OnEnteredUniverse(IUniverse universe)
|
||||||
|
{
|
||||||
|
enterUniverses.Assign(universe);
|
||||||
|
|
||||||
|
foreach (IUniverseObject universeObject in Universe.UniverseObjects)
|
||||||
|
OnUniverseObjectRegistered(Universe, new(universeObject));
|
||||||
|
|
||||||
|
universe.OnUniverseObjectRegistered.AddListener(OnUniverseObjectRegistered);
|
||||||
|
universe.OnUniverseObjectUnRegistered.AddListener(OnUniverseObjectUnRegistered);
|
||||||
|
}
|
||||||
|
|
||||||
|
protected override void OnExitedUniverse(IUniverse universe)
|
||||||
|
{
|
||||||
|
enterUniverses.Unassign();
|
||||||
|
|
||||||
|
foreach (IUniverseObject universeObject in Universe.UniverseObjects)
|
||||||
|
OnUniverseObjectUnRegistered(Universe, new(universeObject));
|
||||||
|
|
||||||
|
universe.OnUniverseObjectRegistered.RemoveListener(OnUniverseObjectRegistered);
|
||||||
|
universe.OnUniverseObjectUnRegistered.RemoveListener(OnUniverseObjectUnRegistered);
|
||||||
|
}
|
||||||
|
|
||||||
|
private void OnUniverseObjectUnRegistered(IUniverse sender, IUniverse.UniverseObjectUnRegisteredArguments args)
|
||||||
|
{
|
||||||
|
for (int i = toCallExitUniverses.Count - 1; i >= 0; i--)
|
||||||
|
{
|
||||||
|
toCallExitUniverses[i].ExitUniverse(Universe);
|
||||||
|
toCallExitUniverses.RemoveAt(i);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private void OnUniverseObjectRegistered(IUniverse sender, IUniverse.UniverseObjectRegisteredArguments args)
|
||||||
|
{
|
||||||
|
for (int i = toCallEnterUniverses.Count - 1; i >= 0; i--)
|
||||||
|
{
|
||||||
|
toCallEnterUniverses[i].EnterUniverse(Universe);
|
||||||
|
toCallEnterUniverses.RemoveAt(i);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private void OnEnterUniverseCollected(IBehaviourCollector<IEnterUniverse> sender, IBehaviourCollector<IEnterUniverse>.BehaviourCollectedArguments args)
|
||||||
|
{
|
||||||
|
toCallEnterUniverses.Add(args.BehaviourCollected);
|
||||||
|
}
|
||||||
|
|
||||||
|
private void OnExitUniverseCollected(IBehaviourCollector<IExitUniverse> sender, IBehaviourCollector<IExitUniverse>.BehaviourCollectedArguments args)
|
||||||
|
{
|
||||||
|
toCallExitUniverses.Add(args.BehaviourCollected);
|
||||||
|
}
|
||||||
|
|
||||||
|
public UniverseEntranceManager()
|
||||||
|
{
|
||||||
|
enterUniverses.OnCollected.AddListener(OnEnterUniverseCollected);
|
||||||
|
exitUniverses.OnCollected.AddListener(OnExitUniverseCollected);
|
||||||
|
}
|
||||||
|
}
|
83
Engine.Core/Systems/UpdateManager.cs
Normal file
83
Engine.Core/Systems/UpdateManager.cs
Normal file
@@ -0,0 +1,83 @@
|
|||||||
|
using System.Collections.Generic;
|
||||||
|
|
||||||
|
namespace Syntriax.Engine.Core;
|
||||||
|
|
||||||
|
public class UpdateManager : Behaviour
|
||||||
|
{
|
||||||
|
// We use Ascending order because we are using reverse for loop to call them
|
||||||
|
private static Comparer<IBehaviour> SortByAscendingPriority() => Comparer<IBehaviour>.Create((x, y) => x.Priority.CompareTo(y.Priority));
|
||||||
|
|
||||||
|
private readonly ActiveBehaviourCollectorSorted<IFirstFrameUpdate> firstFrameUpdates = new() { SortBy = SortByAscendingPriority() };
|
||||||
|
private readonly ActiveBehaviourCollector<ILastFrameUpdate> lastFrameUpdates = new();
|
||||||
|
private readonly ActiveBehaviourCollectorSorted<IPreUpdate> preUpdateEntities = new() { SortBy = SortByAscendingPriority() };
|
||||||
|
private readonly ActiveBehaviourCollectorSorted<IUpdate> updateEntities = new() { SortBy = SortByAscendingPriority() };
|
||||||
|
private readonly ActiveBehaviourCollectorSorted<IPostUpdate> postUpdateEntities = new() { SortBy = SortByAscendingPriority() };
|
||||||
|
|
||||||
|
private readonly List<IFirstFrameUpdate> toCallFirstFrameUpdates = new(32);
|
||||||
|
|
||||||
|
protected override void OnEnteredUniverse(IUniverse universe)
|
||||||
|
{
|
||||||
|
firstFrameUpdates.Assign(universe);
|
||||||
|
lastFrameUpdates.Assign(universe);
|
||||||
|
preUpdateEntities.Assign(universe);
|
||||||
|
updateEntities.Assign(universe);
|
||||||
|
postUpdateEntities.Assign(universe);
|
||||||
|
|
||||||
|
universe.OnPreUpdate.AddListener(OnPreUpdate);
|
||||||
|
universe.OnUpdate.AddListener(OnUpdate);
|
||||||
|
universe.OnPostUpdate.AddListener(OnPostUpdate);
|
||||||
|
}
|
||||||
|
|
||||||
|
protected override void OnExitedUniverse(IUniverse universe)
|
||||||
|
{
|
||||||
|
firstFrameUpdates.Unassign();
|
||||||
|
lastFrameUpdates.Unassign();
|
||||||
|
preUpdateEntities.Unassign();
|
||||||
|
updateEntities.Unassign();
|
||||||
|
postUpdateEntities.Unassign();
|
||||||
|
|
||||||
|
universe.OnPreUpdate.RemoveListener(OnPreUpdate);
|
||||||
|
universe.OnUpdate.RemoveListener(OnUpdate);
|
||||||
|
universe.OnPostUpdate.RemoveListener(OnPostUpdate);
|
||||||
|
}
|
||||||
|
|
||||||
|
private void OnPreUpdate(IUniverse sender, IUniverse.UpdateArguments args)
|
||||||
|
{
|
||||||
|
for (int i = toCallFirstFrameUpdates.Count - 1; i >= 0; i--)
|
||||||
|
{
|
||||||
|
toCallFirstFrameUpdates[i].FirstActiveFrame();
|
||||||
|
toCallFirstFrameUpdates.RemoveAt(i);
|
||||||
|
}
|
||||||
|
|
||||||
|
for (int i = preUpdateEntities.Count - 1; i >= 0; i--)
|
||||||
|
preUpdateEntities[i].PreUpdate();
|
||||||
|
}
|
||||||
|
|
||||||
|
private void OnUpdate(IUniverse sender, IUniverse.UpdateArguments args)
|
||||||
|
{
|
||||||
|
for (int i = updateEntities.Count - 1; i >= 0; i--)
|
||||||
|
updateEntities[i].Update();
|
||||||
|
}
|
||||||
|
|
||||||
|
private void OnPostUpdate(IUniverse sender, IUniverse.UpdateArguments args)
|
||||||
|
{
|
||||||
|
for (int i = postUpdateEntities.Count - 1; i >= 0; i--)
|
||||||
|
postUpdateEntities[i].PostUpdate();
|
||||||
|
}
|
||||||
|
|
||||||
|
private void OnFirstFrameCollected(IBehaviourCollector<IFirstFrameUpdate> sender, IBehaviourCollector<IFirstFrameUpdate>.BehaviourCollectedArguments args)
|
||||||
|
{
|
||||||
|
toCallFirstFrameUpdates.Add(args.BehaviourCollected);
|
||||||
|
}
|
||||||
|
|
||||||
|
private void OnLastFrameRemoved(IBehaviourCollector<ILastFrameUpdate> sender, IBehaviourCollector<ILastFrameUpdate>.BehaviourRemovedArguments args)
|
||||||
|
{
|
||||||
|
args.BehaviourRemoved.LastActiveFrame();
|
||||||
|
}
|
||||||
|
|
||||||
|
public UpdateManager()
|
||||||
|
{
|
||||||
|
firstFrameUpdates.OnCollected.AddListener(OnFirstFrameCollected);
|
||||||
|
lastFrameUpdates.OnRemoved.AddListener(OnLastFrameRemoved);
|
||||||
|
}
|
||||||
|
}
|
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user