many changes

Author: Slushi-Github

README.md

@@ -6,7 +6,7 @@
 Leafy Engine is an engine inspired by [HaxeFlixel](https://haxeflixel.com/) for making 2D games for the Wii U using Haxe, yes, Haxe!
 
 > [!IMPORTANT]
-> The engine is still in development, so there may be some bugs and many changes constantly!
+> The engine is still in development, so there may be some bugs, instability and many changes constantly!
 
 [Leafy Engine Docs](https://github.com/Slushi-Github/leafyEngine/blob/main/docs/wiki/README.md)
 
@@ -30,6 +30,12 @@ class PlayState extends LfState {
         sprite.createGraphic(200, 200, [255, 0, 0]);
         sprite.center();
         addObject(sprite);
+
+		var textSprite:LfText = new LfText(0, 0, "Hello World!", 32, "LeafyGame/font.ttf");
+		textSprite.center();
+		textSprite.y -= 120;
+		textSprite.setColor(0, 0, 255);
+		addObject(textSprite);
     }
 
 	// Update the sprite position
@@ -52,7 +58,7 @@ class PlayState extends LfState {
 }
 ```
 
-A code probably similar to one from [HaxeFlixel](https://haxeflixel.com/) right?
+A code probably similar to one from [HaxeFlixel](https://haxeflixel.com) right?
 
 ## Current status of the engine:
 - [x] Wii U Gamepad support
@@ -74,29 +80,33 @@ A code probably similar to one from [HaxeFlixel](https://haxeflixel.com/) right?
 - [x] States 
 - [ ] Substates
 - [x] Collisions
-- [x] Sprites basic physics 
+- [x] Sprites basic physics
 - [x] Tweens and easing functions
 - [x] JSONs file support (Only decoding)
 - [x] Timers (Using [``haxe.Timer``](https://api.haxe.org/haxe/Timer.html))
-- [x] HTTP requests (Via Curl)
-- [x] Multiple renders mode (``DRC``, ``TV`` and ``UNIQUE``)
+- [x] HTTP requests (Via CURL)
+- Engine rendering modes
+	- [x] Only on the Wii U Gamepad (-> ``DRC``)
+	- [x] Only on the TV (-> ``TV``)
+	- [x] Both (-> ``UNIQUE``)
+	- [ ] Separate rendering (Wii U Gamepad and TV independent at the same time)
 - [x] FileSystem manipulation
 - [ ] Engine cameras
 
 ## How?
-This engine uses [SDL2 (For the Wii U)](https://github.com/devkitPro/SDL/tree/wiiu-sdl2-2.28) as a base, along with other WUT functions. All the libraries are ported to Haxe to work through the ``@:native`` feature, to finally use [Reflaxe/C++](https://github.com/SomeRanDev/reflaxe.CPP) to generate the code in C++ and compile it through the [DevKitPPC](https://wiibrew.org/wiki/DevkitPPC) tools, although due to this mode, there are things that change and have more care in how the engine is used when you want to make a project with it. 
+This engine uses [SDL2 (For the Wii U)](https://github.com/devkitPro/SDL/tree/wiiu-sdl2-2.28) as a base, along with other [WUT](https://github.com/devkitPro/wut) functions. All the libraries are ported to Haxe to work through the ``@:native`` feature, to finally use [Reflaxe/C++](https://github.com/SomeRanDev/reflaxe.CPP) to generate the code in C++ and compile it through the [DevKitPPC](https://wiibrew.org/wiki/DevkitPPC) tools, although due to this mode, there are things that change and have more care in how the engine is used when you want to make a project with it. 
 
 ## Why?
-Haxe has always fascinated me since I met him modifying [Friday Night Funkin'](https://github.com/FunkinCrew/Funkin) from 2022 (The result of that was the [Slushi Engine](https://github.com/Slushi-Github/Slushi-Engine)). And there was a time when I was really interested in getting a Nintendo Wii U, I knew it was a console that was not very popular and that kind of thing... But my interest was highly elevated by wanting to make my own homebrew for the console, and I wanted to try Haxe, unfortunately, although there was [an attempt to bring Haxe to the Wii U](https://www.fortressofdoors.com/openfl-for-home-game-consoles), it was forgotten, besides needing to be registered in the Nintendo Developer, a lot of problems right?.
+Haxe has always fascinated me since I met him modifying [Friday Night Funkin'](https://github.com/FunkinCrew/Funkin) from 2022 (The result of that was the [Slushi Engine](https://github.com/Slushi-Github/Slushi-Engine)). And there was a time when I was really interested in getting a Nintendo Wii U, I knew it was a console that was not very popular and that kind of thing... But my interest was highly elevated by wanting to make my own homebrew for the console, and I wanted to try Haxe, unfortunately, although there was [an attempt to bring Haxe to the Wii U](https://www.fortressofdoors.com/openfl-for-home-game-consoles), it was forgotten (Or I think it is only maintained for Nintendo Switch at the moment), besides needing to be registered in the Nintendo Developer Portal, a lot of problems right?.
 
-After months and months, after having managed to make the [HxCompileU project](https://github.com/Slushi-Github/hxCompileU) stable and viable, I now present, this, Leafy Engine, an engine that will try to be like HaxeFlixel, and create your games on this underrated console. 
+After months and months, after having managed to make the [HxCompileU project](https://github.com/Slushi-Github/hxCompileU) stable and viable, I now present, this, Leafy Engine, an engine that will try to be like [HaxeFlixel](https://haxeflixel.com), and create your games on this underrated console. 
 
 ## Using the engine
 
 Read the [Getting Started](https://github.com/Slushi-Github/leafyEngine/blob/main/docs/wiki/Getting-Started.md) page
 
 ## Contributing
-If you want to contribute to this project, you can do it by creating a pull request on this repository, test that your changes work both in [Cemu](https://github.com/cemu-project/Cemu) and on the real hardware, I would recommend attaching images if it is a change that can be shown.
+If you want to contribute to this project, you can do it by creating a pull request on this repository, test that your changes work both in [Cemu](https://github.com/cemu-project/Cemu) __**and on the real hardware**__, I would recommend attaching images if it is a change that can be shown.
 
 ## Credits
 - [DevkitPro](https://devkitpro.org): The base of the homebrew development on Wii U

docs/wiki/Getting-Started.md

@@ -1,5 +1,5 @@
 # Installation
-Assuming you already have Haxe, create a new folder where you want your project to be, then open a terminal in that folder and do the first command:
+Assuming you already have Haxe, And a Wii U with Aroma installed (Or an emulator, like [Cemu](https://github.com/cemu-project/Cemu)), create a new folder where you want your project to be, then open a terminal in that folder and do the first command:
 
 ```bash
 haxelib newrepo
@@ -36,7 +36,17 @@ When you have everything, install the following:
 
 (include the ``dkp-`` if you're on Linux or MacOS)
 ```bash
-(dkp-)pacman -Syu --needed wiiu-dev wiiu-curl wiiu-sdl2 wiiu-sdl2-image wiiu-sdl2-mixer wiiu-sdl2-ttf wiiu-sdl2_gfx ppc-jansson ppc-zlib ppc-libvorbis ppc-libopus ppc-libogg ppc-libjpeg-turbo ppc-freetype ppc-bzip2 ppc-libpng
+# Install the Wii U dependencies
+(dkp-)pacman -Syu --needed wiiu-dev
+
+# Install the Wii U SDL2 libraries
+(dkp-)pacman -Syu wiiu-sdl2 wiiu-sdl2_gfx wiiu-sdl2_image wiiu-sdl2_mixer wiiu-sdl2_ttf
+
+# Install the PowerPC libraries
+(dkp-)pacman -Syu ppc-jansson ppc-zlib ppc-libvorbis ppc-libopus ppc-libogg ppc-libjpeg-turbo ppc-freetype ppc-bzip2 ppc-libpng
+
+# And finally the Wii U CURL library
+(dkp-)pacman -Syu wiiu-curl
 ```
 
 Now you're ready to start coding!
@@ -56,9 +66,11 @@ import leafy.LfEngine;
 class Main {
     public static function main() {
         /*
+            "YOUR_GAME" = The name of your game, this will be the name of the folder where you'll find your assets
             DRC = Display the game on the Wii U Gamepad
             TV = Display the game on the TV
             UNIQUE = Display the game on a unique screen (Gamepad and TV)
+            ``YOUR_STATE()`` = The class of the state (LfState) you want to start the game in
         */
         LfEngine.initEngine("YOUR_GAME", DRC, new YOUR_STATE());
     }
@@ -67,6 +79,6 @@ class Main {
 
 That ``YOUR_STATE()`` is the class of the state (``LfState``) you want to start the game in.
 
-it's like when you start a Flixel game (``addChild(new FlxGame(800, 600, new PlayState, ...));``)
+it's like when you start a HaxeFlixel game (``addChild(new FlxGame(800, 600, new PlayState, ...));``)
 
 Then, run ``haxeCompileU --compile`` and you're ready to go!

docs/wiki/sections/FolderSections/Audio.md

@@ -2,7 +2,11 @@
 
 Leafy Engine uses a audio engine that uses the [Vorbis](https://github.com/Haxe-WiiU/HxU_Vorbis) library and SDL_Audio to play audio OGG files in the engine.
 
-Unfortunately, there is a major limitation in this audio engine, I can't get more than one audio to play at a time without slowing down the sound reproduction or even getting a crash, so I will only use one audio at a time.
+Unfortunately, there is a major limitation in this audio engine, I can't get more than one audio to play at a time without slowing down the sound reproduction or even getting a console crash, so I will only use one audio at a time.
+
+#### **As a recommendation**, SDL_Audio by default is started to expect audio that is on frequency *``44100``* and has __2__ audio channels. While the audio engine is able to detect if the audio being loaded has any difference in those 2 values, what it will do is reopen the entire audio device, causing there to be a significant lag when that happens. For that reason I recommend to verify if your audio (sound, music) is in the frequency *``44100``* and that it has __2__ audio channels, otherwise you can convert it using some web page or a tool that allows you to do that.
+
+--------
 
 To use it is easy, here is an example:
 ```haxe
@@ -37,7 +41,7 @@ var currentTime:Float = Leafy.audio.getCurrentTime();
 var duration:Float = Leafy.audio.getDuration();
 ```
 
-----
+--------
 
 See [``LfAudioEngine``](https://github.com/Slushi-Github/leafyEngine/blob/main/leafy/audio/LfAudioEngine.hx)
 

docs/wiki/sections/FolderSections/Sprites.md

@@ -15,7 +15,7 @@ var sprite:LfSprite = new LfSprite(100, 100);
 
 // create a graphic
 // The ``createGraphic`` function takes 3 parameters, the width, height and the color of the graphic.
-sprite.createGraphic(200, 200, [255, 0, 0, 255]);
+sprite.createGraphic(200, 200, [255, 0, 0]);
 
 // Load an image
 sprite.loadImage("GAME_PATH/image.png");
@@ -24,7 +24,7 @@ sprite.loadImage("GAME_PATH/image.png");
 addObject(sprite);
 ```
 
------
+--------
 
 ## LfText
 
@@ -41,7 +41,8 @@ var text:LfText = new LfText(100, 100, "Hello World!", 32, "GAME_PATH/FONT.ttf")
 addObject(text);
 ```
 
------
+--------
+
 See [``LfSprite``](https://github.com/Slushi-Github/leafyEngine/blob/main/leafy/objects/LfSprite.hx)
 
 See [``LfText``](https://github.com/Slushi-Github/leafyEngine/blob/main/leafy/objects/LfText.hx)

docs/wiki/sections/FolderSections/Tweens.md

@@ -15,5 +15,6 @@ var tween:LfTween = new LfTween(sprite, LfTweenProperty.X, sprite.x, 200, 3, LfT
 LfTween.cancelTween(tween);
 ```
 
------
+--------
+
 See [``LfTween``](https://github.com/Slushi-Github/leafyEngine/blob/main/leafy/tweens/LfTween.hx)

docs/wiki/sections/FolderSections/WiiU_Gamepad.md

@@ -67,6 +67,8 @@ var touchPos:LfVector2D = Leafy.wiiuGamepad.getTouch();
 var isTouchObject:Bool = Leafy.wiiuGamepad.isTouchingAObject(object:LfObject);
 ```
 
+--------
+
 You can use the gyroscope and accelerometer:
 ```haxe
 // import the Leafy class
@@ -86,15 +88,15 @@ For use the rumble, it would be done in this way:
 // import the Leafy class
 import leafy.Leafy;
 
-// start the rumble
+// start the vibration of the Wii U Gamepad
 /*
-    The first parameter is the intensity of the rumble, from 0 to 1
-    The second parameter is the duration of the rumble, in seconds, -1 for infinite
+    The first parameter is the intensity of the vibration, from 0 to 1
+    The second parameter is the duration of the vibration, in seconds, -1 for infinite
 */
-Leafy.wiiuGamepad.startRumble(1, -1);
+Leafy.wiiuGamepad.vibrate(1, -1);
 
-// stop the rumble
-Leafy.wiiuGamepad.stopRumble();
+// stop the vibration
+Leafy.wiiuGamepad.stopVibration();
 ```
 
 <!-- --------

leafy/LfEngine.hx

@@ -30,7 +30,7 @@ class LfEngine {
     /**
      * The current version of the engine
      */
-    public static var version:String = "1.4.3";
+    public static var VERSION:String = "1.4.6";
 
     /**
      * Function to be called when the engine exits
@@ -61,7 +61,7 @@ class LfEngine {
         Proc.WHBProcInit();
         Crash.WHBInitCrashHandler(); // This really works?
 
-        Sys.println("[Leafy Engine initial state - no logger started] Starting Leafy Engine " + version);
+        Sys.println("[Leafy Engine initial state - no logger started] Starting Leafy Engine [" + VERSION + "]");
 
         if (renderMode == null) {
             Sys.println("[Leafy Engine initial state - no logger started -> WARNING] Render mode cannot be null, defaulting to DRC mode");
@@ -86,7 +86,7 @@ class LfEngine {
         // Initialize the Wii U Gamepad
         LfGamepadInternal.initDRC();
 
-        LeafyDebug.log("Leafy Engine [" + version + "] initialized", INFO);
+        LeafyDebug.log("Leafy Engine [" + VERSION + "] initialized", INFO);
 
         // Set and initialize the initial state
         LfStateHandler.initFirstState(state);
@@ -108,7 +108,7 @@ class LfEngine {
             onEngineExit();
         }
 
-        LeafyDebug.log("Shutting down Leafy Engine " + version, INFO);
+        LeafyDebug.log("Shutting down Leafy Engine [" + VERSION + "]", INFO);
 
         LfStateHandler.destroyCurrentState();
         SubEngines.shutdownSDL();

leafy/audio/LfAudio.hx

@@ -72,7 +72,7 @@ class LfAudio {
         var correctPath:String = LfSystemPaths.getConsolePath() + path;
 
         if (!LfSystemPaths.exists(correctPath)) {
-            LeafyDebug.log("Failed to load OGG [" + path + "]: File not found", INFO);
+            LeafyDebug.log("Failed to load OGG [" + path + "]: File not found", ERROR);
             return;
         }
 
@@ -81,13 +81,13 @@ class LfAudio {
         file = new OggVorbis_File();
         // SDL_Stdinc.SDL_zero(currentFile.ref);
         if (VorbisFile.ov_fopen(ConstCharPtr.fromString(correctPath), file) != 0) {
-            LeafyDebug.log("Failed to load OGG [" + path + "]: " + SDL_Error.SDL_GetError().toString(), INFO);
+            LeafyDebug.log("Failed to load OGG [" + path + "]: " + SDL_Error.SDL_GetError().toString(), ERROR);
             return;
         }
 
         info = untyped __cpp__("ov_info(leafy::audio::LfAudio::file, -1)");
         if (info == null) {
-            LeafyDebug.log("Failed to get OGG info for [" + path + "]: " + SDL_Error.SDL_GetError().toString(), INFO);
+            LeafyDebug.log("Failed to get OGG info for [" + path + "]: " + SDL_Error.SDL_GetError().toString(), ERROR);
             return;
         }
 
@@ -97,7 +97,7 @@ class LfAudio {
         paused = false;
         this.loop = loop;
 
-        LeafyDebug.log("Loaded OGG: [" + path + "] with duration: " + duration + " seconds" , INFO);
+        LeafyDebug.log("Loaded OGG: [" + path + "] with duration: " + duration + " seconds" , DEBUG);
         return;
     }
 
@@ -131,17 +131,6 @@ class LfAudio {
         return playing;
     }
 
-    // /**
-    //  * 
-    //  */
-    // public function fadeOut(duration:Float, onComplete:Void->Void):Void {
-    //     if (fadeTween != null) LfTween.cancelTween(this.fadeTween);
-    //     fadeTween = LfTween.tweenNumber(this.);
-    // }
-
-    // public function update():Void {
-    // }
-
     /**
      * Destroys the OGG and frees memory
      */

leafy/backend/LeafyDebug.hx

@@ -24,7 +24,6 @@ enum LogLevel {
     WARNING;
     ERROR;
     DEBUG;
-    CRITICAL;
 }
 
 @:cppFileCode("
@@ -94,13 +93,29 @@ class LeafyDebug {
      * @param level The log level
      */
     @:include("haxe_PosInfos.h")
-    public static function log(msg:String, level:LogLevel, ?pos:PosInfos):Void {
-        if (level == LogLevel.CRITICAL) {
+    public static function log(msg:String = "", level:LogLevel = LogLevel.INFO, ?pos:PosInfos):Void {
+        #if !debug
+        if (level == LogLevel.DEBUG) {
             return;
         }
+        #end
 
         var formattedMessage:String = prepareText(msg, level, pos);
 
+        // Log to the Wii U console debug output (Maybe "/storage_slc/sys/logs"?)
+        switch (level) {
+            case LogLevel.INFO:
+                Debug.OSReportInfo(ConstCharPtr.fromString(formattedMessage));
+            case LogLevel.WARNING:
+                Debug.OSReportWarn(ConstCharPtr.fromString(formattedMessage));
+            case LogLevel.ERROR:
+                Debug.OSReportWarn(ConstCharPtr.fromString(formattedMessage));
+            case LogLevel.DEBUG:
+                Debug.OSReportVerbose(ConstCharPtr.fromString(formattedMessage));
+            default:
+                Debug.OSReportInfo(ConstCharPtr.fromString(formattedMessage));
+        }
+
         if (!started) {
             Sys.println("[Leafy Engine - no logger started] | " + formattedMessage);
             return;
@@ -145,7 +160,7 @@ class LeafyDebug {
             var logFile = logsDir + "leafyLog_" + currentTimeMod + "-" + currentDateMod + ".txt";
 
             if (!LfSystemPaths.exists(logFile)) {
-                LfFile.writeFile(logFile, "Leafy Engine [" + LfEngine.version + "] Log File\n" + " - " + currentDateStr + " | " + currentTimeStr + "\n-------------------\n\n");
+                LfFile.writeFile(logFile, "Leafy Engine [" + LfEngine.VERSION + "] Log File\n" + " - " + currentDateStr + " | " + currentTimeStr + "\n-------------------\n\n");
             }
 
             currentLogFile = logFile;
@@ -182,7 +197,7 @@ class LeafyDebug {
      */
     private static function getHaxeFilePos(pos:PosInfos):String {
         if (pos == null) {
-        return "UnknownLocation";
+        return "UnknownPosition";
         }
 
 		return pos.className + "/" + pos.methodName + ":" + pos.lineNumber;
@@ -195,7 +210,7 @@ class LeafyDebug {
      */
     private static function getHaxeFilePosForCrash(pos:PosInfos):String {
         if (pos == null) {
-        return "UnknownLocation";
+        return "UnknownPosition";
         }
 
 		return pos.fileName + ":\n\t" + pos.className + "." + pos.methodName + ":" + pos.lineNumber;
@@ -221,8 +236,6 @@ class LeafyDebug {
                 levelStr = "ERROR";
             case LogLevel.DEBUG:
                 levelStr = "DEBUG";
-            case LogLevel.CRITICAL:
-                levelStr = "CRITICAL";
         }
 
         str += "[" + getCurrentTime() + " (" + elapsedTime + ") | " + levelStr + " - " + getHaxeFilePos(pos) + "] " + text + "\n";
@@ -235,13 +248,14 @@ class LeafyDebug {
      * @param pos 
      */
     private static function crashConsole(crashError:String, ?pos:PosInfos):Void {
-        var strPtr:ConstCharPtr = ConstCharPtr.fromString("[Leafy Engine " + LfEngine.version + " logger - " + getCurrentTime()
+        var strPtr:ConstCharPtr = ConstCharPtr.fromString("[Leafy Engine " + LfEngine.VERSION + " logger - " + getCurrentTime()
         + " - CRASH]\n\nCall stack:\n" + getHaxeFilePosForCrash(pos) + "\n\nError: " + crashError
 		+ "\n\n\n\t\t    Please reset the console.");
 
         LfFile.appendToFile(currentLogFile, "---------------------");
         log("CRASH: " + crashError, ERROR, pos);
-        log("Stopping the engine and console due to crash...", ERROR, pos);
+        log("Call stack:\n\t" + getHaxeFilePosForCrash(pos), ERROR, pos);
+        log("Executing WUT OSFatal call for crash...", ERROR, pos);
 
         Debug.OSFatal(strPtr);
     }