Documentation for module 'NDK'

Former-commit-id: 7d8a51d8ad14bfb16a76b8d77c92c776bfb694ab [formerly 1dac8450f2eddf175b3eb2b6675621ea0b2a0df7] [formerly bb4300770d267df0eed5c509ec748c6866f36376 [formerly d15a100319ffc8805c7f93c9bcd936e204dad40b]]
Former-commit-id: 83a4715ed2a3220b7ef4718401d50ce584d275fc [formerly a941a150d510a51daed4322723795d90b6d56724]
Former-commit-id: f46308abb0bc577d73447f6a574ec091a50a9cca

tests/SDK/NDK/Entity.cpp

@@ -0,0 +1,101 @@
+#include <NDK/World.hpp>
+#include <NDK/Component.hpp>
+#include <Catch/catch.hpp>
+
+namespace
+{
+	class UpdatableComponent : public Ndk::Component<UpdatableComponent>
+	{
+		public:
+			bool IsUpdated()
+			{
+				return m_updated;
+			}
+
+			void SetUpdated()
+			{
+				m_updated = true;
+			}
+
+			static Ndk::ComponentIndex componentIndex;
+
+		private:
+			bool m_updated = false;
+	};
+
+	Ndk::ComponentIndex UpdatableComponent::componentIndex;
+
+	class UpdateSystem : public Ndk::System<UpdateSystem>
+	{
+		public:
+			UpdateSystem()
+			{
+				Requires<UpdatableComponent>();
+			}
+
+			~UpdateSystem() = default;
+
+			static Ndk::SystemIndex systemIndex;
+
+		private:
+			void OnUpdate(float elapsedTime) override
+			{
+				for (const Ndk::EntityHandle& entity : GetEntities())
+				{
+					UpdatableComponent& updatable = entity->GetComponent<UpdatableComponent>();
+					updatable.SetUpdated();
+				}
+			}
+	};
+
+	Ndk::SystemIndex UpdateSystem::systemIndex;
+}
+
+SCENARIO("Entity", "[NDK][ENTITY]")
+{
+	GIVEN("A world & an entity")
+	{
+		Ndk::World world;
+		Ndk::BaseSystem& system = world.AddSystem<UpdateSystem>();
+		const Ndk::EntityHandle& entity = world.CreateEntity();
+
+		WHEN("We add our UpdateComponent")
+		{
+			UpdatableComponent& updatableComponent = entity->AddComponent<UpdatableComponent>();
+			REQUIRE(!updatableComponent.IsUpdated());
+
+			THEN("Update the world should update the entity's component")
+			{
+				world.Update(1.f);
+				UpdatableComponent& updatableComponentGet = entity->GetComponent<UpdatableComponent>();
+				REQUIRE(updatableComponentGet.IsUpdated());
+			}
+
+			THEN("Update the world should not update the entity's component if it's disabled")
+			{
+				entity->Enable(false);
+				world.Update(1.f);
+				UpdatableComponent& updatableComponentGet = entity->GetComponent<UpdatableComponent>();
+				REQUIRE(!updatableComponentGet.IsUpdated());
+			}
+
+			THEN("We can remove its component")
+			{
+				entity->RemoveComponent(Ndk::GetComponentIndex<UpdatableComponent>());
+				world.Update(1.f);
+				REQUIRE(!entity->HasComponent<UpdatableComponent>());
+			}
+		}
+
+		WHEN("We kill our entity")
+		{
+			entity->Kill();
+			world.Update(1.f);
+
+			THEN("It's no more valid")
+			{
+				REQUIRE(!world.IsEntityValid(entity));
+			}
+		}
+	}
+}