Entity Component System

.gitignore

@@ -7,6 +7,9 @@
 /target/
 /expand.rs
 
+# Logs
+/logs/
+
 # IDEs
 .idea/
 .vs/

.workspaces/engine.code-workspace

@@ -22,7 +22,7 @@
 			"--preview"
 		],
 		"editor.codeActionsOnSave": {
-			"source.fixAll.eslint": true
+			"source.fixAll.eslint": "explicit"
 		},
 		"eslint.format.enable": true,
 		"Lua.completion.callSnippet": "Disable",

.workspaces/script.code-workspace

@@ -12,9 +12,17 @@
 			"path": "../engine/lib/phx/script",
 			"name": "Engine Scripts"
 		},
+		{
+			"path": "../engine/lib/phx/src",
+			"name": "Engine Src"
+		},
 		{
 			"path": "../script",
 			"name": "LTR Scripts"
+		},
+		{
+			"path": "../",
+			"name": "full"
 		}
 	],
 	"settings": {
@@ -30,7 +38,7 @@
 			"--preview"
 		],
 		"editor.codeActionsOnSave": {
-			"source.fixAll.eslint": true
+			"source.fixAll.eslint": "explicit"
 		},
 		"eslint.format.enable": true,
 		"Lua.completion.callSnippet": "Disable",

engine/lib/phx/src/math/clip_rect.rs

@@ -55,23 +55,27 @@ unsafe extern "C" fn TransformRect(x: &mut f32, y: &mut f32, sx: &mut f32, sy: &
 pub extern "C" fn ClipRect_Activate(this: Option<&mut ClipRect>) {
     match this {
         Some(this) => {
-            let mut vpSize: IVec2 = IVec2::ZERO;
-
-            unsafe { Viewport_GetSize(&mut vpSize) };
-            glcheck!(gl::Enable(gl::SCISSOR_TEST));
-
-            let mut x: f32 = this.x;
-            let mut y: f32 = this.y;
-            let mut sx: f32 = this.sx;
-            let mut sy: f32 = this.sy;
-
-            unsafe { TransformRect(&mut x, &mut y, &mut sx, &mut sy) };
-            glcheck!(gl::Scissor(
-                x as i32,
-                vpSize.y - (y + sy) as i32,
-                sx as i32,
-                sy as i32
-            ));
+            if this.enabled {
+                let mut vpSize: IVec2 = IVec2::ZERO;
+
+                unsafe { Viewport_GetSize(&mut vpSize) };
+                glcheck!(gl::Enable(gl::SCISSOR_TEST));
+
+                let mut x: f32 = this.x;
+                let mut y: f32 = this.y;
+                let mut sx: f32 = this.sx;
+                let mut sy: f32 = this.sy;
+
+                unsafe { TransformRect(&mut x, &mut y, &mut sx, &mut sy) };
+                glcheck!(gl::Scissor(
+                    x as i32,
+                    vpSize.y - (y + sy) as i32,
+                    sx as i32,
+                    sy as i32
+                ));
+            } else {
+                glcheck!(gl::Disable(gl::SCISSOR_TEST));
+            }
         }
         None => glcheck!(gl::Disable(gl::SCISSOR_TEST)),
     }

engine/lib/phx/src/system/time_stamp.rs

@@ -49,12 +49,16 @@ impl TimeStamp {
 
     /// Get difference between 2 timestamps in double seconds.
     pub fn get_difference(&self, end_time: &TimeStamp) -> f64 {
-        let difference = end_time
-            .value
-            .duration_since(self.value)
-            .expect("Cannot get timestamp difference");
-
-        difference.as_secs_f64()
+        match end_time.value.duration_since(self.value) {
+            Ok(difference) => difference.as_secs_f64(),
+            Err(_e) => {
+                let difference = self
+                    .value
+                    .duration_since(end_time.value)
+                    .expect("Time overflow");
+                -difference.as_secs_f64()
+            }
+        }
     }
 
     /// Number of seconds elapsed since this timestamp.

script/Config/Render/CameraConfig.lua

@@ -0,0 +1,7 @@
+-- Render Settings Moved from 'Render/RenderPipeline' --
+Config.render.camera = {
+    fov                 = 70,   -- Float: 50 - 100
+    -- Both zNear/zFar potentially duplicated in 'Config/genConfig'
+    zNear               = 0.1,  -- default: 0.1 -- for NDC Coordinate System
+    zFar                = 1e6,  -- default: 1e6 -- for NDC Coordinate System
+}

script/Config/Render/PostFxConfig.lua

@@ -0,0 +1,31 @@
+-- Render Settings Moved from 'Render/RenderPipeline' --
+--[[
+Given that all these Settings are by default already Disabled
+render.postfx is potentially fully depricated.
+--]]
+Config.PostFx = {
+    abberation  = {
+        enable      = false,
+        strength    = 1             -- Float: 0 - 1      
+    },
+    bloom       = {
+        enable      = false,
+        radius      = 48            -- Float: 4 - 64
+    },
+    radialblur  = {
+        enable      = false,
+        strength    = 1,            -- Float: 0 - 1
+        scanlines   = 1             -- Float: 0 - 1
+    },
+    sharpen     = false,            -- 
+    tonemap     = false,            -- Potentially Depricated
+    --[[
+    Vignette is currently unused in RenderPipeline
+    TODO: Decide on removal of renderPipeline:Vignette
+    vignette    = {
+        enable      = false,
+        strength    = 0.25,         -- Float: 0 - 1
+        hardness    = 20.0          -- Float: 2 - 32
+    }
+    --]]
+}

script/Config/Render/RenderConfig.lua

@@ -1,12 +1,33 @@
-Config.render = {
-    defaultResX         = 1920,
-    defaultResY         = 1080,
+-- Render Settings Moved from 'Render/RenderPipeline' --
+Config.render.general = {
+    superSampleRate       = 1,            -- 1: 1x, 2: 2x, 3: 4x
+    downSampleRate        = 4,
+    thrusterLights      = false,
+    pulseLights         = false,
     fullscreen          = false,
     fullscreenExclusive = false,
     presentMode         = PresentMode.Vsync,
-    fov                 = 70,
-    zNear               = 0.1, -- default: 0.1
-    zFar                = 1e6, -- default: 1e6
-    thrusterLights      = false,
-    pulseLights         = false,
 }
+
+Config.render.window = {
+    defaultResX         = 1920,
+    defaultResY         = 1080,
+}
+
+--[[
+Both showBuffers and cullFace potentially Depricated
+]]--
+Config.render.debug = {
+    showBuffers         = false,        -- Used Once in Rendering Pipeline, "Show Deferred Buffers"
+}
+Config.render.renderState = {
+    cullFace            = false,        -- Used Once in Rendering Pipeline, "Backface Culling"
+}
+
+-- Settings Removed --
+--[[
+- render.lodScale       -- Unused
+- render.wireframe      -- Currently in Config.debug.physics
+- render.logZNear       -- Unused
+- render.logZFar        -- Unused
+]]

script/Core/LuaExtensions/TypeEx.lua

@@ -0,0 +1,10 @@
+local rawtype = type
+
+type = function(value)
+    local mt = getmetatable(value)
+    if mt and mt.__type then
+        return mt.__type
+    else
+        return rawtype(value)
+    end
+end

script/Core/Structures/Class.lua

@@ -6,7 +6,7 @@
 
   Example:
 
-    local Ship = class(function (self, name, hp)
+    local Ship = Class("Ship", function (self, name, hp)
       self.name = name
       self.health = hp
       self.healthMax = hp
@@ -15,7 +15,7 @@
     function Ship:addHangar (unit) assert(false, "No hangar!") end
     function Ship:getHangar () return {} end
 
-    local Carrier = subclass(Ship, function (self)
+    local Carrier = Subclass("Carrier", Ship, function (self)
       self.hanger = {}
     end)
 
@@ -24,29 +24,70 @@
 ----------------------------------------------------------------------------]]
 --
 
-function class(ctor)
+-- This function takes the class instance `self` and generates a string representation of it in
+-- the form: ClassName{field1: 0, field2: 0}.
+local function defaulttostring(self)
+    local result = {}
+    for key, value in pairs(self) do
+        local keyStr = tostring(key)
+        local valueStr = tostring(value)
+        table.insert(result, keyStr .. ": " .. valueStr)
+    end
+    return tostring(type(self)) .. "{" .. table.concat(result, ", ") .. "}"
+end
+
+function Class(name, ctor)
+    -- Define the class.
     local cls = {}
     cls.__index = cls
+    cls.__type = cls
+    cls.__tostring = defaulttostring
+
+    -- Define the default constructor
+    -- This just invokes ctor if it is not nil.
+    function cls.new(...)
+        local self = {}
+        setmetatable(self, cls)
+        if ctor then ctor(self, ...) end
+        return self
+    end
+
+    -- Set up the class metatable.
     setmetatable(cls, {
         __call = function(T, ...)
-            local self = {}
-            setmetatable(self, cls)
-            if ctor then ctor(self, ...) end
-            return self
+            return cls.new(...)
+        end,
+        __tostring = function()
+            return name
         end
     })
+
     return cls
 end
 
-function subclass(base, ctor)
+function Subclass(name, base, ctor)
+    -- Define the class.
     local cls = {}
     cls.__index = cls
+    cls.__type = cls
+    cls.__tostring = defaulttostring
+
+    -- Define the default constructor.
+    -- This just invokes ctor on an instance of base() if it is not nil.
+    function cls.new(...)
+        local self = base()
+        setmetatable(self, cls)
+        if ctor then ctor(self, ...) end
+        return self
+    end
+
+    -- Set up the class metatable.
     setmetatable(cls, {
         __call = function(T, ...)
-            local self = base()
-            setmetatable(self, cls)
-            if ctor then ctor(self, ...) end
-            return self
+            return cls.new(...)
+        end,
+        __tostring = function()
+            return name
         end,
         __index = base,
     })

script/Core/Structures/List.lua

@@ -3,7 +3,7 @@
   Includes some useful generic algorithms for common linear list operations.
 ----------------------------------------------------------------------------]]
 --
-local List = class(function(self, ...)
+local List = Class("List", function(self, ...)
     local args = { ... }
     for i = 1, #args do
         self[i] = args[i]

script/Core/Structures/Map.lua

@@ -1,4 +1,4 @@
-local Map = class(function(self, ctor)
+local Map = Class("Map", function(self, ctor)
     self.__ctor = ctor
 end)
 

script/Core/Util/Clone.lua

@@ -0,0 +1,32 @@
+function ShallowClone(obj)
+    local copy = {}
+    for key, value in pairs(obj) do
+        copy[key] = value
+    end
+
+    -- Preserve the metatable
+    setmetatable(copy, getmetatable(obj))
+
+    return copy
+end
+
+function DeepClone(obj, seen)
+    if type(obj) ~= "table" then
+        return obj
+    end
+
+    if seen and seen[obj] then
+        return seen[obj] -- Handle circular references
+    end
+
+    local copy = {}
+    seen = seen or {}
+    seen[obj] = copy
+
+    for key, value in pairs(obj) do
+        copy[DeepClone(key, seen)] = DeepClone(value, seen)
+    end
+
+    setmetatable(copy, getmetatable(obj)) -- Preserve metatable
+    return copy
+end

script/Core/Util/Distribution.lua

@@ -8,7 +8,7 @@
   TODO : Implement Alias Method for O(1) sampling. Sampling is currently O(n).
 ----------------------------------------------------------------------------]]
 
-local Distribution = class(function(self)
+local Distribution = Class("Distribution", function(self)
     self.values = {}
     self.weights = {}
 end)

script/Core/Util/Inspect.lua

@@ -3,7 +3,7 @@ local _tl_compat; if (tonumber((_VERSION or ''):match('[%d.]*$')) or 0) < 5.3 th
 end
 ; local math = _tl_compat and _tl_compat.math or math; local string = _tl_compat and _tl_compat.string or string; local table =
     _tl_compat and _tl_compat.table or table
-local inspect = { Options = {}, }
+    local inspect = { Options = {}, }