foundation for physics plugin interface

include/NovelRT/NovelRT.h

@@ -94,6 +94,9 @@
   // Persistence types
 #include <NovelRT/Persistence/Persistence.h>
 
+  // Physics types
+  #include <NovelRT/Physics/Physics.hpp>
+
   //Misc types
   #include <NovelRT/LoggingService.h>
   #include <NovelRT/Timing/StepTimer.h>

include/NovelRT/Physics/2D/BodyDefinition2D.hpp

@@ -0,0 +1,30 @@
+// Copyright © Matt Jones and Contributors. Licensed under the MIT Licence (MIT). See LICENCE.md in the repository root
+// for more information.
+
+#pragma once
+
+#ifndef NOVELRT_PHYSICS_HPP
+#error NovelRT does not support including types explicitly by default. Please include Physics.h instead for the Physics namespace subset.
+#endif
+
+namespace NovelRT::Physics::Physics2D
+{
+    struct BodyDefinition2D final
+    {
+        std::optional<OnCollisionEnterCallbackDelegate2D> OnCollisionEnter;
+        std::optional<OnCollisionExitCallbackDelegate2D> OnCollisionExit;
+        std::optional<OnTriggerEnterCallbackDelegate2D> OnTriggerEnter;
+        std::optional<OnTriggerExitCallbackDelegate2D> OnTriggerExit;
+        NovelRT::Maths::GeoVector2F Position;
+        NovelRT::Maths::GeoVector2F LinearVelocity;
+        NovelRT::Maths::GeoVector2F AngularVelocity;
+        NovelRT::Maths::GeoVector2F Gravity;
+        float RotationAngle;
+        float LinearDamping;
+        float AngularDamping;
+        RigidBodyFlags2D Flags;
+    };
+}
+
+// TODO: when implementing box2d, instead of relying on gravity scale, set it to 1 or 0 (depending on
+// BodyFlags::UseWorldGravity) and apply a constant force during the world step.

include/NovelRT/Physics/2D/BoxCollisionFixture2D.hpp

@@ -0,0 +1,16 @@
+#pragma once
+
+#ifndef NOVELRT_PHYSICS_HPP
+#error NovelRT does not support including types explicitly by default. Please include Physics.h instead for the Physics namespace subset.
+#endif
+
+namespace NovelRT::Physics::Physics2D
+{
+    class BoxCollisionFixture2D : public CollisionFixture2D
+    {
+    public:
+        [[nodiscard]] virtual NovelRT::Maths::GeoVector2F GetHalfSize() = 0;
+
+        virtual void SetHalfSize(NovelRT::Maths::GeoVector2F halfSize) = 0;
+    };
+}

include/NovelRT/Physics/2D/BoxCollisionFixtureDefinition2D.hpp

@@ -0,0 +1,15 @@
+#pragma once
+
+#ifndef NOVELRT_PHYSICS_HPP
+#error NovelRT does not support including types explicitly by default. Please include Physics.h instead for the Physics namespace subset.
+#endif
+
+namespace NovelRT::Physics::Physics2D
+{
+    struct BoxCollisionFixtureDefinition2D final : public CollisionFixtureDefinition2D
+    {
+        NovelRT::Maths::GeoVector2F HalfSize;
+
+        ~BoxCollisionFixtureDefinition2D() = default;
+    };
+}

include/NovelRT/Physics/2D/CapsuleCollisionFixture2D.hpp

@@ -0,0 +1,20 @@
+#pragma once
+
+#ifndef NOVELRT_PHYSICS_HPP
+#error NovelRT does not support including types explicitly by default. Please include Physics.h instead for the Physics namespace subset.
+#endif
+
+namespace NovelRT::Physics::Physics2D
+{
+    class CapsuleCollisionFixture2D : public CollisionFixture2D
+    {
+    public:
+        [[nodiscard]] virtual float GetHeight() = 0;
+
+        [[nodiscard]] virtual float GetRadius() = 0;
+
+        virtual void SetHeight(float height) = 0;
+
+        virtual void SetRadius(float radius) = 0;
+    };
+}

include/NovelRT/Physics/2D/CapsuleCollisionFixtureDefinition2D.hpp

@@ -0,0 +1,16 @@
+#pragma once
+
+#ifndef NOVELRT_PHYSICS_HPP
+#error NovelRT does not support including types explicitly by default. Please include Physics.h instead for the Physics namespace subset.
+#endif
+
+namespace NovelRT::Physics::Physics2D
+{
+    struct CapsuleCollisionFixtureDefinition2D final : public CollisionFixtureDefinition2D
+    {
+        float Height;
+        float Radius;
+
+        ~CapsuleCollisionFixtureDefinition2D() = default;
+    };
+}

include/NovelRT/Physics/2D/CircleCollisionFixture2D.hpp

@@ -0,0 +1,16 @@
+#pragma once
+
+#ifndef NOVELRT_PHYSICS_HPP
+#error NovelRT does not support including types explicitly by default. Please include Physics.h instead for the Physics namespace subset.
+#endif
+
+namespace NovelRT::Physics::Physics2D
+{
+    class CircleCollisionFixture2D : public CollisionFixture2D
+    {
+        [[nodiscard]] virtual float GetRadius() = 0;
+
+        virtual void SetRadius() = 0;
+    };
+
+} // namespace NovelRT::Physics::Physics2D

include/NovelRT/Physics/2D/CircleCollisionFixtureDefinition2D.hpp

@@ -0,0 +1,16 @@
+#pragma once
+
+#ifndef NOVELRT_PHYSICS_HPP
+#error NovelRT does not support including types explicitly by default. Please include Physics.h instead for the Physics namespace subset.
+#endif
+
+namespace NovelRT::Physics::Physics2D
+{
+    struct CircleCollisionFixtureDefinition2D final : public CollisionFixtureDefinition2D
+    {
+        float Radius;
+
+        ~CircleCollisionFixtureDefinition2D() = default;
+    };
+
+} // namespace NovelRT::Physics::Physics2D

include/NovelRT/Physics/2D/CollisionCallbackArgument2D.hpp

@@ -0,0 +1,15 @@
+#pragma once
+
+#ifndef NOVELRT_PHYSICS_HPP
+#error NovelRT does not support including types explicitly by default. Please include Physics.h instead for the Physics namespace subset.
+#endif
+
+namespace NovelRT::Physics::Physics2D
+{
+    struct CollisionCallBackArgument2D final
+    {
+        const RigidBody2D* const RigidBody;
+        const CollisionFixture2D* const CollisionFixture;
+    };
+
+} // namespace NovelRT::Physics::Physics2D

include/NovelRT/Physics/2D/CollisionFixture2D.hpp

@@ -0,0 +1,37 @@
+#pragma once
+
+#ifndef NOVELRT_PHYSICS_HPP
+#error NovelRT does not support including types explicitly by default. Please include Physics.h instead for the Physics namespace subset.
+#endif
+
+namespace NovelRT::Physics::Physics2D
+{
+    class CollisionFixture2D
+    {
+    public:
+        [[nodiscard]] virtual NovelRT::Maths::GeoVector2F GetOffset() = 0;
+
+        [[nodiscard]] virtual float GetFriction() = 0;
+
+        [[nodiscard]] virtual float GetRestitution() = 0;
+
+        [[nodiscard]] virtual float GetRestitutionThreshold() = 0;
+
+        [[nodiscard]] virtual float GetDensity() = 0;
+
+        [[nodiscard]] virtual bool IsSensor() = 0;
+
+        virtual void SetOffset(NovelRT::Maths::GeoVector2F offset) = 0;
+
+        virtual void SetFriction(float friction) = 0;
+
+        virtual void SetRestitution(float restitution) = 0;
+
+        virtual void SetRestitutionThreshold(float restitutionThreshold) = 0;
+
+        virtual void SetDensity(float density) = 0;
+
+        virtual void SetIsSensor(bool isSensor) = 0;
+    };
+
+} // namespace NovelRT::Physics::Physics2D

include/NovelRT/Physics/2D/CollisionFixtureDefinition2D.hpp

@@ -0,0 +1,21 @@
+#pragma once
+
+#ifndef NOVELRT_PHYSICS_HPP
+#error NovelRT does not support including types explicitly by default. Please include Physics.h instead for the Physics namespace subset.
+#endif
+
+namespace NovelRT::Physics::Physics2D
+{
+    struct CollisionFixtureDefinition2D
+    {
+        NovelRT::Maths::GeoVector2F Offset;
+        float Friction;
+        float Restitution;
+        float RestitutionThreshold;
+        float Density;
+        bool IsSensor;
+
+        virtual ~CollisionFixtureDefinition2D() = 0;
+    };
+
+} // namespace NovelRT::Physics::Physics2D

include/NovelRT/Physics/2D/DistanceJoint2D.hpp

@@ -0,0 +1,45 @@
+// Copyright © Matt Jones and Contributors. Licensed under the MIT Licence (MIT). See LICENCE.md in the repository root
+// for more information.
+
+#pragma once
+
+#ifndef NOVELRT_PHYSICS_HPP
+#error NovelRT does not support including types explicitly by default. Please include Physics.h instead for the Physics namespace subset.
+#endif
+
+namespace NovelRT::Physics::Physics2D
+{
+    /**
+     * @brief
+     * A joint that keeps the anchors of the attached bodies within a certain range of distance.
+     */
+    class DistanceJoint2D : public Joint2D
+    {
+    protected:
+        float _minLength;
+        float _maxLength;
+        float _restLength;
+
+    public:
+        [[nodiscard]] inline float GetMinLength() const noexcept
+        {
+            return _minLength;
+        }
+
+        [[nodiscard]] inline float GetMaxLength() const noexcept
+        {
+            return _minLength;
+        }
+
+        [[nodiscard]] inline float GetRestLength() const noexcept
+        {
+            return _minLength;
+        }
+
+        virtual void SetMinLength(float minLength) = 0;
+
+        virtual void SetMaxLength(float maxLength) = 0;
+
+        virtual void SetRestLength(float restLength) = 0;
+    };
+}

include/NovelRT/Physics/2D/DistanceJointDefinition2D.hpp

@@ -0,0 +1,20 @@
+// Copyright © Matt Jones and Contributors. Licensed under the MIT Licence (MIT). See LICENCE.md in the repository root
+// for more information.
+
+#pragma once
+
+#ifndef NOVELRT_PHYSICS_HPP
+#error NovelRT does not support including types explicitly by default. Please include Physics.h instead for the Physics namespace subset.
+#endif
+
+namespace NovelRT::Physics::Physics2D
+{
+    struct DistanceJointDefinition2D final : public JointDefinition2D
+    {
+        float MinLength;
+        float MaxLength;
+        float RestLength;
+
+        ~DistanceJointDefinition2D() = default;
+    };
+}

include/NovelRT/Physics/2D/EdgeCollisionFixture2D.hpp

@@ -0,0 +1,17 @@
+#pragma once
+
+#ifndef NOVELRT_PHYSICS_HPP
+#error NovelRT does not support including types explicitly by default. Please include Physics.h instead for the Physics namespace subset.
+#endif
+
+namespace NovelRT::Physics::Physics2D
+{
+    class EdgeCollisionFixture2D : public CollisionFixture2D
+    {
+    public:
+        [[nodiscard]] virtual NovelRT::Utilities::Misc::Span<const NovelRT::Maths::GeoVector2F> GetVertices() = 0;
+
+        virtual void SetVertices(NovelRT::Utilities::Misc::Span<const NovelRT::Maths::GeoVector2F> vertices) = 0;
+    };
+
+} // namespace NovelRT::Physics::Physics2D

include/NovelRT/Physics/2D/EdgeCollisionFixtureDefinition2D.hpp

@@ -0,0 +1,16 @@
+#pragma once
+
+#ifndef NOVELRT_PHYSICS_HPP
+#error NovelRT does not support including types explicitly by default. Please include Physics.h instead for the Physics namespace subset.
+#endif
+
+namespace NovelRT::Physics::Physics2D
+{
+    struct EdgeCollisionFixtureDefinition2D final : public CollisionFixtureDefinition2D
+    {
+        std::vector<NovelRT::Maths::GeoVector2F> Vertices;
+
+        ~EdgeCollisionFixtureDefinition2D() = default;
+    };
+
+} // namespace NovelRT::Physics::Physics2D

include/NovelRT/Physics/2D/FixedDistanceJoint2D.hpp

@@ -0,0 +1,37 @@
+// Copyright © Matt Jones and Contributors. Licensed under the MIT Licence (MIT). See LICENCE.md in the repository root
+// for more information.
+
+#pragma once
+
+#ifndef NOVELRT_PHYSICS_HPP
+#error NovelRT does not support including types explicitly by default. Please include Physics.h instead for the Physics namespace subset.
+#endif
+
+namespace NovelRT::Physics::Physics2D
+{
+    /**
+     * @brief
+     * A joint that keeps the anchors of the attached bodies at a set distance.
+     */
+    class FixedDistanceJoint2D : public Joint2D
+    {
+    protected:
+        float _restLength;
+        bool _isOnlyMaxLengthEnforced;
+
+    public:
+        [[nodiscard]] inline float GetRestLength() const noexcept
+        {
+            return _restLength;
+        }
+
+        [[nodiscard]] inline bool GetIsOnlyMaxLengthEnforced() const noexcept
+        {
+            return _isOnlyMaxLengthEnforced;
+        }
+
+        virtual void SetRestLength(float restLength) = 0;
+
+        virtual void SetIsOnlyMaxLengthEnforced(bool isOnlyMaxLengthEnforced) = 0;
+    };
+}

include/NovelRT/Physics/2D/FixedDistanceJointDefinition2D.hpp

@@ -0,0 +1,19 @@
+// Copyright © Matt Jones and Contributors. Licensed under the MIT Licence (MIT). See LICENCE.md in the repository root
+// for more information.
+
+#pragma once
+
+#ifndef NOVELRT_PHYSICS_HPP
+#error NovelRT does not support including types explicitly by default. Please include Physics.h instead for the Physics namespace subset.
+#endif
+
+namespace NovelRT::Physics::Physics2D
+{
+    struct FixedJointDefinition2D final : public JointDefinition2D
+    {
+        float RestLength;
+        bool IsOnlyMaxLengthEnforced;
+
+        ~FixedJointDefinition2D() = default;
+    };
+}