Separated concerns for decoding and loading resources as well as switched to immutable record structs for descriptions.

Author: Mathew O'Dwyer

src/Documentation/v0.1.0/README.md

@@ -0,0 +1,259 @@
+<div align="center">
+  
+  # ✅ Engine MVP Design Document (v0.1.0)
+  
+</div>
+
+## ⚙️ Engine
+
+- **OS:** Windows 10+
+- **Framework:** .NET 9.0+
+
+### 🧱 Architecture
+
+- Clean/onion-based architecture with clear separation between core logic and platform-specific layers.
+- Modular package structure optimized for testability and maintainability.
+- Visual Studio templates included to streamline project creation and setup.
+
+---
+
+## ✨ Core Engine Features
+
+## 🖼️ Rendering
+
+### 🎨 Rendering Pipeline
+
+- Abstracted rendering system using **OpenGL 4.6** backend
+- Forward rendering pipeline for direct and efficient lighting
+
+---
+
+### 🧩 Geometry and Models
+
+- **Mesh Rendering** for 3D geometry
+- **Model Loading** using **Assimp** for importing complex models
+- **2D Sprite Batching** to optimize multiple sprite draws into single calls
+
+---
+
+### 🎥 Camera and View
+
+- **Camera System** for scene viewing and transformation
+
+---
+
+### 🧱 Material and Shading
+
+- **Material System** supporting:
+  - Diffuse mapping
+  - Specular mapping
+  - Normal mapping
+  - Emissive mapping
+  - Parallax mapping
+
+---
+
+### 💡 Lighting
+
+- **Lighting System** implementing:
+  - Blinn-Phong lighting model for realistic shading
+- **Light Sources**:
+  - Directional lights
+  - Point lights
+  - Spot lights
+- **Global Illumination** via ambient lighting to simulate indirect light
+
+---
+
+### ✨ Visual Effects
+
+- **Skyboxes** for immersive environmental backgrounds
+- **Blending** support for transparency and visual composition effects
+
+---
+
+### 🖌️ Post-Processing
+
+- **Post-Processing Framework** including:
+  - Gamma correction for accurate color output
+  - High Dynamic Range (HDR) rendering for improved lighting realism
+  - Anti-aliasing to reduce jagged edges
+  - Fog effects:
+    - Linear fog
+    - Exponential fog
+    - Exponential squared fog
+
+---
+
+### 🎮 Input
+
+- Keyboard and mouse input with:
+  - Event-based device layer
+  - Polling-based high-level layer
+- Input mapping system with simple action bindings:
+  - Bind named actions to keys or buttons (e.g., `"Attack"` → `Space`, `A`, `MouseLeft`)
+
+### 🔊 Audio
+
+- Core audio abstraction with:
+  - Play, stop, pause, volume, and loop control
+  - Positional audio (2D simulation via stereo panning and distance attenuation)
+- Global/master volume control
+
+### 🧠 Entity Component System (ECS)
+
+- Custom ECS architecture with:
+  - Support for user-defined components and systems
+  - Event hooking:
+    - `Initialize`, `LoadContent`, `Update`, `Render`, `UnloadContent`
+    - Includes custom event firing
+- Built-in systems:
+  - Sprite rendering
+  - Text/GUI rendering
+  - Audio emitters and listeners
+  - Orthographic camera rendering
+  - WASD camera movement
+
+### 🌍 Screen Management
+
+- Scene-based structure with:
+  - Scene loading and unloading
+  - Support for switching between scenes
+  - Each scene maintains its own local resource manager
+
+### 📚 Resource Management
+
+- Dual-scope resource handling:
+  - Global and screen-specific resource managers
+- Reference-counting system to manage lifetime and unloading
+- Loader registration system to support multiple resource formats
+
+### 🖋️ GUI System
+
+- Basic text-based rendering for GUI
+- Features include:
+  - Font scaling
+  - Text alignment
+  - Color customization
+- No interactive components (e.g., buttons, sliders) in MVP
+
+### 🎞️ Animation
+
+- Sprite sheet animation support
+  - Adjustable frame speed per animation
+- Integration with ECS (e.g., animated sprite components)
+
+### ➗ Math Utilities
+
+- Uses `System.Numerics` for vector and matrix manipulation.
+- Included `MathHelper` for common operations.
+
+---
+
+## 🌐 System Features
+
+### 🪟 Windowing
+
+- Abstracted window system
+- Support for:
+  - Windowed and fullscreen modes
+  - Title, size, visibility, and window state management
+
+### 🧾 Configuration
+
+- Environment-based configuration system
+  - Supports standard `appsettings.{Environment}.json` pattern
+  - Engine auto-detects and applies correct environment settings
+
+### 🪵 Logging
+
+- Built-in structured logging system using `Microsoft.Extensions.Logging`
+  - Integration with application-level configuration
+  - Logging levels configurable per category
+
+### ⚠️ Error Handling
+
+- Localized exception handling within individual engine systems
+- No global error handler or crash recovery in MVP
+
+---
+
+## 📦 Supported File Formats
+
+- **Texture/Image Formats:**
+  - Bmp
+  - Gif
+  - Jpeg
+  - Pbm
+  - Png
+  - Tiff
+  - Tga
+  - WebP
+  - Qoi
+
+- **Audio Formats:**  
+  - .Ogg
+  - .Mp3
+
+---
+
+<div align="center">
+  
+  # ✅ Editor MVP Design Document (v0.1.0)
+  
+</div>
+
+## 🎯 Target Platform
+
+- **OS:** Windows 10+
+- **Framework:** .NET 9.0+
+
+### 🧱 Architecture
+
+- MVVM-based **Windows Forms** application
+- Modular layout with docking/resizable panels
+
+---
+
+## ✨ Core Editor Features
+
+### 🧩 Scene Hierarchy
+
+- Entity listing with **no** parent-child structure
+- Simple right-click actions (rename, delete)
+
+### 🧱 Entity & Component Editing
+
+- Add/edit/remove components from entities
+- Create/rename/delete entities
+- Modify translation, rotation and scale via gizmos.
+- Supports editing common types:
+  - Integers, strings, booleans, tec
+  - Vectors
+  - Enumerations
+  - Colors
+
+### 📁 Resource Management
+
+- Displays all project resources (textures, fonts, audio)
+- Assign resources to components via drag-and-drop
+- Uses shared `IResourceManager`
+- Synchronous loading and display
+- Supported asset previews (e.g., texture thumbnails)
+
+### 🪵 Logging & Console
+
+- Displays logs from runtime and editor
+- Filter by severity (info, warning, error)
+- Scrollable with auto-scroll toggle
+
+### ⚙️ ECS Management
+
+- ECS system listing
+- On/off toggle for built-in systems
+- Modification of system properties
+
+### ↩️ Undo/Redo
+
+- Basic command pattern with undo stack
+- Linear undo/redo (Ctrl+Z / Ctrl+Y)

src/FinalEngine.Audio.CASL/CaslSound.cs

@@ -6,6 +6,7 @@ namespace FinalEngine.Audio;
 
 using System;
 using CASL;
+using FinalEngine.Audio.Sounds;
 
 internal sealed class CaslSound : ISound
 {

src/FinalEngine.Audio.CASL/Loaders/CaslSoundResourceLoader.cs

@@ -8,6 +8,7 @@ namespace FinalEngine.Audio.Loaders;
 using System.IO;
 using System.IO.Abstractions;
 using FinalEngine.Audio.Factories;
+using FinalEngine.Audio.Sounds;
 using FinalEngine.Resources;
 
 internal sealed class CaslSoundResourceLoader : ResourceLoaderBase<ISound>

src/FinalEngine.Decoding.Imaging.ImageSharp/FinalEngine.Decoding.Imaging.ImageSharp.csproj

@@ -0,0 +1,15 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <RootNamespace>FinalEngine.Decoding.Imaging</RootNamespace>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="SixLabors.ImageSharp" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\FinalEngine\FinalEngine.csproj" />
+  </ItemGroup>
+
+</Project>

src/FinalEngine.Decoding.Imaging.ImageSharp/ImageSharpImageDecoder.cs

@@ -0,0 +1,48 @@
+// <copyright file="ImageSharpImageDecoder.cs" company="Software Antics">
+//   Copyright (c) Software Antics. All rights reserved.
+// </copyright>
+
+namespace FinalEngine.Decoding.Imaging;
+
+using System.IO.Abstractions;
+using SixLabors.ImageSharp;
+using SixLabors.ImageSharp.PixelFormats;
+
+internal sealed class ImageSharpImageDecoder : IImageDecoder
+{
+    private readonly IFileSystem fileSystem;
+
+    public ImageSharpImageDecoder(IFileSystem fileSystem)
+    {
+        this.fileSystem = fileSystem ?? throw new ArgumentNullException(nameof(fileSystem));
+    }
+
+    public DecodedImage Decode(string filePath)
+    {
+        ArgumentException.ThrowIfNullOrWhiteSpace(filePath);
+
+        if (!this.fileSystem.File.Exists(filePath))
+        {
+            throw new FileNotFoundException($"The file '{filePath}' does not exist.", filePath);
+        }
+
+        using (var stream = this.fileSystem.File.OpenRead(filePath))
+        {
+            var image = Image.Load<Rgba32>(stream);
+
+            int width = image.Width;
+            int height = image.Height;
+
+            byte[] pixels = new byte[width * height * 4];
+            image.CopyPixelDataTo(pixels);
+
+            return new DecodedImage(
+                Width: width,
+                Height: height,
+                Format: PixelFormat.Rgba,
+                InternalFormat: SizedFormat.Rgba8,
+                PixelType: PixelType.Byte,
+                Data: pixels);
+        }
+    }
+}

src/FinalEngine.Rendering.OpenGL/OpenGLRenderResourceFactory.cs

@@ -2,6 +2,8 @@
 //     Copyright (c) Software Antics. All rights reserved.
 // </copyright>
 
+using FinalEngine.Decoding.Imaging;
+
 namespace FinalEngine.Rendering;
 
 using System;
@@ -13,7 +15,7 @@ namespace FinalEngine.Rendering;
 using FinalEngine.Rendering.Invocation;
 using FinalEngine.Rendering.Pipeline;
 using FinalEngine.Rendering.Textures;
-using PixelFormat = Textures.PixelFormat;
+using PixelFormat = PixelFormat;
 
 internal sealed class OpenGLRenderResourceFactory : IRenderResourceFactory
 {

src/FinalEngine.Rendering.OpenGL/Profiles/OpenTKProfile.cs

@@ -6,6 +6,7 @@ namespace FinalEngine.Rendering.Profiles;
 
 using AutoMapper;
 using AutoMapper.Extensions.EnumMapping;
+using FinalEngine.Decoding.Imaging;
 using FinalEngine.Rendering.Buffers;
 using FinalEngine.Rendering.Pipeline;
 using FinalEngine.Rendering.States;

src/FinalEngine.Rendering.OpenGL/Textures/OpenGLTexture2D.cs

@@ -6,6 +6,7 @@ namespace FinalEngine.Rendering.Textures;
 
 using System;
 using AutoMapper;
+using FinalEngine.Decoding.Imaging;
 using FinalEngine.Rendering.Invocation;
 using TKPixelForamt = OpenTK.Graphics.OpenGL4.PixelFormat;
 using TKPixelType = OpenTK.Graphics.OpenGL4.PixelType;