ReyeMe · seven-shades · Jul 28, 2026 · Dec 2, 2025 · Dec 2, 2025 · Dec 5, 2025
diff --git a/.gitignore b/.gitignore
@@ -7,13 +7,18 @@
 /[Dd]ocumentation/*
 !/[Dd]ocumentation/resources
 
+/[Mm]odules_extra/**
+!/[Mm]odules_extra/Put_extra_modules_here.txt
+!/[Mm]odules_extra/samplemodule/**
+
 /[Mm]odules/[Ss][Gg][Ll]/[Dd]ocumentation/*
 !/[Mm]odules/[Ss][Gg][Ll]/[Dd]ocumentation/resources
 /[Mm]odules/[Ss][Gg][Ll]/[Ii][Pp]/[Bb]uild[Dd]rop/**
 
 /[Mm]odules/[Ss][Gg][Ll]/[Ss][Rr][Cc]/*.o
 /[Mm]odules/[Tt][Ll][Ss][Ff]/*.o
 
+/[Ss]amples/**/imgui.ini
 /[Ss]amples/**/*.o
 /[Ss]amples/**/[Bb]uild[Dd]rop/**
 /[Cc]ompiler/msys2/tmp/*
@@ -46,7 +51,10 @@
 
 /[Tt]ests/**/[Bb]uild[Dd]rop/**
 /[Tt]ests/**/*.o
+/[Tt]ests/**/imgui.ini
 /[Tt]ests/**/*.log
+/[Tt]ests/uts.json
+/[Tt]ests/uts.xml
 
 /Projects/**
 !/Projects/Put_your_projects_here.txt
@@ -55,3 +63,8 @@
 # Compiler folder
 /[Cc]ompiler/**
 Compiler/
+
+# Python bytecode
+**/__pycache__/
+**/*.pyc
+
diff --git a/Documentation/resources/doc_img/slPerspective.png b/Documentation/resources/doc_img/slPerspective.png
diff --git a/Doxyfile b/Doxyfile
@@ -48,7 +48,7 @@ PROJECT_NAME           = SaturnRingLibrary
 # could be handy for archiving the generated documentation or if some version
 # control system is used.
 
-PROJECT_NUMBER         = 0.9.1
+PROJECT_NUMBER         = 0.9.2
 
 # Using the PROJECT_BRIEF tag one can provide an optional one line description
 # for a project that appears at the top of each page and should give viewer a

diff --git a/Samples/Debug - Print/run_on_saturn.bat b/Samples/Debug - Print/run_on_saturn.bat
@@ -0,0 +1,3 @@
+:; "../../tools/scripts/run.sh" USBGamers; exit;
+@ECHO Off
+"../../tools/scripts/run.bat" USBGamers
diff --git a/Samples/Input - Gun/run_on_saturn.bat b/Samples/Input - Gun/run_on_saturn.bat
@@ -0,0 +1,3 @@
+:; "../../tools/scripts/run.sh" USBGamers; exit;
+@ECHO Off
+"../../tools/scripts/run.bat" USBGamers
diff --git a/Samples/Logs/run_on_saturn.bat b/Samples/Logs/run_on_saturn.bat
@@ -0,0 +1,3 @@
+:; "../../tools/scripts/run.sh" USBGamers; exit;
+@ECHO Off
+"../../tools/scripts/run.bat" USBGamers
diff --git a/Samples/Makefile - pre and post build/run_on_saturn.bat b/Samples/Makefile - pre and post build/run_on_saturn.bat
@@ -0,0 +1,3 @@
+:; "../../tools/scripts/run.sh" USBGamers; exit;
+@ECHO Off
+"../../tools/scripts/run.bat" USBGamers
diff --git a/Samples/Math - Random image/run_on_saturn.bat b/Samples/Math - Random image/run_on_saturn.bat
@@ -0,0 +1,3 @@
+:; "../../tools/scripts/run.sh" USBGamers; exit;
+@ECHO Off
+"../../tools/scripts/run.bat" USBGamers
diff --git a/Samples/Math - Random/run_on_saturn.bat b/Samples/Math - Random/run_on_saturn.bat
@@ -0,0 +1,3 @@
+:; "../../tools/scripts/run.sh" USBGamers; exit;
+@ECHO Off
+"../../tools/scripts/run.bat" USBGamers
diff --git a/Samples/SH2 - Slave/run_on_saturn.bat b/Samples/SH2 - Slave/run_on_saturn.bat
@@ -0,0 +1,3 @@
+:; "../../tools/scripts/run.sh" USBGamers; exit;
+@ECHO Off
+"../../tools/scripts/run.bat" USBGamers
diff --git a/Samples/SMPC - Clock/run_on_saturn.bat b/Samples/SMPC - Clock/run_on_saturn.bat
@@ -0,0 +1,3 @@
+:; "../../tools/scripts/run.sh" USBGamers; exit;
+@ECHO Off
+"../../tools/scripts/run.bat" USBGamers
diff --git a/Samples/SRL - Event/run_on_saturn.bat b/Samples/SRL - Event/run_on_saturn.bat
@@ -0,0 +1,3 @@
+:; "../../tools/scripts/run.sh" USBGamers; exit;
+@ECHO Off
+"../../tools/scripts/run.bat" USBGamers
diff --git a/Samples/SRL - Modules/Readme.md b/Samples/SRL - Modules/Readme.md
@@ -0,0 +1,93 @@
+# SampleModule – SRL Module Example
+SampleModule is an example of an **SRL** extra module using the `modules_extra` system. 
+
+It demonstrates how to structure a module, integrate it into a project, and distribute assets and build logic.
+
+## This module shows how to:
+- Add external modules via a project Makefile
+- Organize module files for SRL
+- Use module.mk for custom build behavior
+- Automatically copy module data into a project
+- Chain multiple modules together
+- Write header-only modules (recommended)
+
+## 1) Adding a Module to Your Project
+To include a module in your project, add this line to your project’s Makefile:
+```
+MODULES_EXTRA = samplemodule
+```
+Replace SampleModule with the name of your module.
+
+To include multiple modules, separate them with spaces:
+```
+MODULES_EXTRA = SampleModule AnotherModule MyModule
+```
+## 2) Module Location
+Place your module inside the SRL modules_extra directory:
+```
+saturnringlib/
+└── modules_extra/
+    └── SampleModule/
+```
+## 3) Module Structure (SRL Style)
+A typical SRL module layout:
+```
+SampleModule/
+├── INC/
+│   └── samplemodule.hpp
+├── cd/
+│   └── data/
+│       └── example.bin
+└── module.mk
+```
+### INC Folder (Important)
+All module source files go in **INC**.
+Header-only modules (.hpp) are highly encouraged.
+If you place .c or .cpp files in **INC**, SRL will automatically compile them.
+This allows modules to be simple, portable, and easy to integrate.
+
+### Example:
+```
+#include <samplemodule.hpp>
+SampleModule::HelloWorld::ShowMessage();
+```
+### cd/data Folder (Automatic Copy)
+If your module needs to provide files to the project (e.g. binaries, assets, drivers), place them in:
+```
+SampleModule/cd/data/
+```
+During the build, these files are automatically copied to the project’s:
+```
+project_root/cd/data/
+```
+### Typical use cases:
+- Sound drivers (e.g. SDRV.BIN)
+- Binary assets
+- Textures, maps, fonts, etc.
+
+## 4) Custom Build Logic (module.mk)
+Each module can define a **module.mk** file to extend the build process.
+
+You can use module.mk to:
+- Add compiler flags
+- Add include paths
+- Define custom copy rules
+- Add build steps or dependencies
+- Customize how the module integrates with SRL
+
+## 5) Using Multiple Modules (Module Chaining)
+Modules can be combined freely.
+To use multiple modules, list them in the project Makefile:
+```
+MODULES_EXTRA = samplemodule dependencymodule anothermodule
+```
+Don't forget to include dependencies in your module:
+```
+#include <dependencymodule.hpp>
+```
+There is no special syntax required—modules are resolved through the same mechanism.
+A module can depend on another module as long as it is listed in `MODULES_EXTRA`.
+
+## 6) Design Philosophy
+Modules should be lightweight and header-focused, making them portable and easy to drop into projects.
+
diff --git a/Samples/SRL - Modules/cd/data/ABS.TXT b/Samples/SRL - Modules/cd/data/ABS.TXT
@@ -0,0 +1 @@
+NOT Abstracted by SEGA
diff --git a/Samples/SRL - Modules/cd/data/BIB.TXT b/Samples/SRL - Modules/cd/data/BIB.TXT
@@ -0,0 +1 @@
+NOT Bibliographiced by SEGA
diff --git a/Samples/SRL - Modules/cd/data/CPY.TXT b/Samples/SRL - Modules/cd/data/CPY.TXT
diff --git a/Samples/SRL - Modules/clean.bat b/Samples/SRL - Modules/clean.bat
@@ -0,0 +1,3 @@
+:; "../../tools/scripts/make.sh" clean; exit;
+@ECHO Off
+"../../tools/scripts/make.bat" clean
diff --git a/Samples/SRL - Modules/compile.bat b/Samples/SRL - Modules/compile.bat
@@ -0,0 +1,3 @@
+:; "../../tools/scripts/make.sh" $1; exit;
+@ECHO Off
+"../../tools/scripts/make.bat" %1
diff --git a/Samples/SRL - Modules/makefile b/Samples/SRL - Modules/makefile
@@ -0,0 +1,39 @@
+# Configuration
+SRL_MAX_TEXTURES = 100          # Number of VDP1 texture slots
+SRL_MODE = NTSC                 # Valid options are PAL or NTSC
+SRL_HIGH_RES = 0                # 480i mode
+SRL_FRAMERATE = 1               # Framerate control (0=dynamic, 1=< 60/value)
+SRL_MAX_CD_BACKGROUND_JOBS = 1  # Maximum number of files GFS can open at once
+SRL_MAX_CD_FILES = 256          # Maximum number of files on a CD
+SRL_MAX_CD_RETRIES = 5          # Number of times to retry on unsuccessful read
+SRL_MALLOC_METHOD = TLSF        # Allocation method: TLSF or SIMPLE are supported.
+
+# Sound driver specific configuration
+SRL_USE_SGL_SOUND_DRIVER = 0    # Set to 1 if you want to use SGL sound driver, this will copy necessary files into the CD folder
+SRL_ENABLE_FREQ_ANALYSIS = 0    # Set to 1 if you want to enable frequency analysis for CD audio, this will load a DSP program into effect slot 1, SGL sound driver must be enabled
+
+# SGL configuration
+SGL_MAX_VERTICES = 2500         # Number of vertices that can be used
+SGL_MAX_POLYGONS = 1500         # Number of polygons that can be used
+SGL_MAX_EVENTS = 1             # Number of events that can be used
+SGL_MAX_WORKS = 1             # Number of works that can be used 
+
+# include extra modules
+MODULES_EXTRA = samplemodule
+
+# Disk name
+CD_NAME = SRL-Modules
+
+# Directory build will be placed into
+BUILD_DROP = ./BuildDrop
+
+# SRL installation directory
+SRL_INSTALL_ROOT ?= ../..
+
+# Find all .c and .cxx files
+SOURCES = $(patsubst ./%,%,$(shell find src/ -name '*.c')) 
+SOURCES += $(patsubst ./%,%,$(shell find src/ -name '*.cxx'))
+
+# Include shared makefile
+SDK_ROOT = $(SRL_INSTALL_ROOT)/saturnringlib
+include $(SDK_ROOT)/shared.mk
diff --git a/Samples/SRL - Modules/run_on_saturn.bat b/Samples/SRL - Modules/run_on_saturn.bat
@@ -0,0 +1,3 @@
+:; "../../tools/scripts/run.sh" USBGamers; exit;
+@ECHO Off
+"../../tools/scripts/run.bat" USBGamers
diff --git a/Samples/SRL - Modules/run_with_Ymir.bat b/Samples/SRL - Modules/run_with_Ymir.bat
@@ -0,0 +1,3 @@
+:; "../../tools/scripts/run.sh" ymir; exit;
+@ECHO Off
+"../../tools/scripts/run.bat" ymir
diff --git a/Samples/SRL - Modules/run_with_kronos.bat b/Samples/SRL - Modules/run_with_kronos.bat
@@ -0,0 +1,3 @@
+:; "../../tools/scripts/run.sh" kronos; exit;
+@ECHO Off
+"../../tools/scripts/run.bat" kronos
diff --git a/Samples/SRL - Modules/run_with_mednafen.bat b/Samples/SRL - Modules/run_with_mednafen.bat
@@ -0,0 +1,3 @@
+:; "../../tools/scripts/run.sh" mednafen; exit;
+@ECHO Off
+"../../tools/scripts/run.bat" mednafen
diff --git a/Samples/SRL - Modules/src/main.cxx b/Samples/SRL - Modules/src/main.cxx
@@ -0,0 +1,25 @@
+#include <srl.hpp>
+#include <samplemodule.hpp>
+
+using namespace SampleModule;
+
+int main()
+{
+	SRL::Core::Initialize(SRL::Types::HighColor::Colors::Black);
+
+    Digital port0(0);
+
+    HelloWorld::ShowMessage();
+
+	while(1)
+	{
+	    if (port0.WasPressed(Digital::Button::A))
+        {
+            HelloWorld::ShowMessage(true);
+        }
+
+        SRL::Core::Synchronize();
+	}
+
+	return 0;
+}
diff --git a/Samples/STL/run_on_saturn.bat b/Samples/STL/run_on_saturn.bat
@@ -0,0 +1,3 @@
+:; "../../tools/scripts/run.sh" USBGamers; exit;
+@ECHO Off
+"../../tools/scripts/run.bat" USBGamers
diff --git a/Samples/VDP1 - 3D - Animation/src/modelObject.hpp b/Samples/VDP1 - 3D - Animation/src/modelObject.hpp
@@ -134,9 +134,13 @@ class ModelObject
          */
         uint8_t IsWireframe : 1;
 
+        /** @brief Render faces without any light applied
+         */
+        uint8_t NoLight : 1;
+
         /** @brief Reserved for future use
          */
-        uint8_t Reserved : 7;
+        uint8_t Reserved : 6;
 
         /** @brief This field is set if HasTexture field is false
          */
@@ -218,7 +222,7 @@ class ModelObject
                     (attributeHeader->HasTransparency != 0 ? CL_Trans : 0) |
                     (attributeHeader->HasHalfBrightness != 0 ? CL_Half : 0),
                 (attributeHeader->IsWireframe != 0 ? sprPolyLine : (attributeHeader->HasTexture != 0 ? sprNoflip : sprPolygon)),
-                UseLight);
+                (attributeHeader->NoLight != 0 ? No_Option : UseLight));
             #pragma GCC diagnostic pop
         }
 
@@ -273,7 +277,7 @@ class ModelObject
                     (attributeHeader->HasTransparency != 0 ? CL_Trans : 0) |
                     (attributeHeader->HasHalfBrightness != 0 ? CL_Half : 0),
                 (attributeHeader->IsWireframe != 0 ? sprPolyLine : (attributeHeader->HasTexture != 0 ? sprNoflip : sprPolygon)),
-                (attributeHeader->HasFlatShading != 0 ? UseLight : UseGouraud));
+                (attributeHeader->NoLight != 0 ? No_Option : (attributeHeader->HasFlatShading != 0 ? UseLight : UseGouraud)));
             #pragma GCC diagnostic pop
 
             *gouraudIterator += 1;

diff --git a/Samples/VDP1 - 3D - Flat teapot/src/main.cxx b/Samples/VDP1 - 3D - Flat teapot/src/main.cxx
@@ -15,7 +15,7 @@ int main()
 
     // Load teapot
     // Original model file can be found in the models folder in root of the sample
-    // Model was converted with ModelConverter (see https://github.com/ReyeMe/ModelConverter-linux), command parameters were: ModelConverter -i "D:\teapot.obj" -o "D:\FPOT.NYA" -s 1.0
+    // Model was converted with ModelConverter (see https://github.com/ReyeMe/ModelConverter-linux), command parameters were: ModelConverter -i "D:\teapot.obj" -o "D:\FPOT.NYA" -t Flat -s 1.0
     ModelObject teapot = ModelObject("FPOT.NYA");
 
     // Setup camera location