Add NativeEncoding plugin

Apps/Playground/CMakeLists.txt

@@ -138,6 +138,7 @@ target_link_libraries(Playground
     PRIVATE Window
     PRIVATE XMLHttpRequest
     PRIVATE TestUtils
+    PRIVATE NativeEncoding
     ${ADDITIONAL_LIBRARIES}
     ${BABYLON_NATIVE_PLAYGROUND_EXTENSION_LIBRARIES})
 

Apps/Playground/Win32/App.cpp

@@ -19,6 +19,7 @@
 #include <Babylon/Plugins/NativeOptimizations.h>
 #include <Babylon/Plugins/NativeCamera.h>
 #include <Babylon/Plugins/NativeInput.h>
+#include <Babylon/Plugins/NativeEncoding.h>
 #include <Babylon/Plugins/TestUtils.h>
 #include <Babylon/Polyfills/Console.h>
 #include <Babylon/Polyfills/Window.h>
@@ -192,6 +193,8 @@ namespace
 
             nativeInput = &Babylon::Plugins::NativeInput::CreateForJavaScript(env);
 
+            Babylon::Plugins::NativeEncoding::Initialize(env);
+
             Babylon::Plugins::TestUtils::Initialize(env, hWnd);
         });
 

CMakeLists.txt

@@ -101,6 +101,7 @@ option(BABYLON_NATIVE_PLUGIN_NATIVEOPTIMIZATIONS "Include Babylon Native Plugin
 option(BABYLON_NATIVE_PLUGIN_NATIVETRACING "Include Babylon Native Plugin NativeTracing." ON)
 option(BABYLON_NATIVE_PLUGIN_NATIVEXR "Include Babylon Native Plugin XR." ON)
 option(BABYLON_NATIVE_PLUGIN_TESTUTILS "Include Babylon Native Plugin TestUtils." ON)
+option(BABYLON_NATIVE_PLUGIN_NATIVEENCODING "Include Babylon Native Plugin NativeEncoding." ON)
 
 # Polyfills
 option(BABYLON_NATIVE_POLYFILL_WINDOW "Include Babylon Native Polyfill Window." ON)

Install/Install.cmake

@@ -159,6 +159,11 @@ if(TARGET NativeXr)
     install_include_for_targets(NativeXr)
 endif()
 
+if(TARGET NativeEncoding)
+    install_targets(NativeEncoding)
+    install_include_for_targets(NativeEncoding)
+endif()
+
 # ----------------
 # Polyfills
 # ----------------

Plugins/CMakeLists.txt

@@ -33,3 +33,7 @@ endif()
 if(BABYLON_NATIVE_PLUGIN_NATIVEXR AND (ANDROID OR IOS))
     add_subdirectory(NativeXr)
 endif()
+
+if(BABYLON_NATIVE_PLUGIN_NATIVEENCODING)
+    add_subdirectory(NativeEncoding)
+endif()

Plugins/NativeEncoding/CMakeLists.txt

@@ -0,0 +1,18 @@
+set(SOURCES
+    "Include/Babylon/Plugins/NativeEncoding.h"
+    "Source/NativeEncoding.cpp")
+
+add_library(NativeEncoding ${SOURCES})
+warnings_as_errors(NativeEncoding)
+
+target_include_directories(NativeEncoding
+    PUBLIC "Include")
+
+target_link_libraries(NativeEncoding
+    PUBLIC napi
+    PRIVATE GraphicsDevice
+    PRIVATE GraphicsDeviceContext
+    PRIVATE JsRuntimeInternal)
+
+set_property(TARGET NativeEncoding PROPERTY FOLDER Plugins)
+source_group(TREE ${CMAKE_CURRENT_SOURCE_DIR} FILES ${SOURCES})

Plugins/NativeEncoding/Include/Babylon/Plugins/NativeEncoding.h

@@ -0,0 +1,9 @@
+#pragma once
+
+#include <napi/env.h>
+#include <Babylon/Api.h>
+
+namespace Babylon::Plugins::NativeEncoding
+{
+    void BABYLON_API Initialize(Napi::Env env);
+}

Plugins/NativeEncoding/README.md

@@ -0,0 +1,28 @@
+# NativeEncoding
+
+> ⚠️ **This plugin is experimental and subject to change.**
+
+The NativeEncoding plugin provides native image encoding capabilities to Babylon, allowing raw pixel data to be encoded into standard image formats (PNG, JPEG, WebP, etc.).
+
+## Design 
+
+Unlike a traditional polyfill which would implement Canvas's `toBlob()` or `toDataURL()` methods, NativeEncoding exists as a plugin because:
+1. **No standard Web API exists** for general-purpose image encoding separate from Canvas
+2. **Simplicity** - Exposes only what Babylon actually needs: direct pixel-to-bytes encoding
+3. **Efficiency** - Avoids extra routing through the Canvas API via intermediate data structures
+4. **Modularity** - Image encoding is a separate concern from 2D canvas rendering
+5. **Extensibility** - New codecs can be added in the future without bloating other components
+
+An encoding function is exposed on the `_native` global object, similar to NativeOptimizations. 
+
+```typescript
+interface INative {
+    EncodeImage: (pixelData: Uint8Array, width: number, height: number, mimeType: string, invertY: boolean) => ArrayBuffer;
+}
+```
+
+It should be wrapped by higher-level Babylon.js APIs (e.g., DumpTools) for common workflows like asset exports and screenshots.
+
+## Limitations
+
+Currently, **only PNG encoding** is supported.

Plugins/NativeEncoding/Source/NativeEncoding.cpp

@@ -0,0 +1,58 @@
+#include <Babylon/Plugins/NativeEncoding.h>
+#include <Babylon/JsRuntime.h>
+
+#include <napi/napi.h>
+#include <Babylon/JsRuntime.h>
+#include <Babylon/Graphics/DeviceContext.h>
+#include <bimg/encode.h>
+#include <bx/readerwriter.h>
+
+namespace Babylon::Plugins
+{
+    namespace
+    {
+        Napi::ArrayBuffer EncodePNG(Napi::Env env, const uint8_t* pixelData, uint32_t width, uint32_t height, bool invertY)
+        {
+            bx::MemoryBlock memoryBlock(&Graphics::DeviceContext::GetDefaultAllocator());
+            bx::MemoryWriter writer(&memoryBlock);
+
+            bimg::imageWritePng(&writer, width, height, width * 4, pixelData, bimg::TextureFormat::RGBA8, invertY);
+
+            auto byteLength = memoryBlock.getSize();
+            auto result = Napi::ArrayBuffer::New(env, byteLength);
+            std::memcpy(result.Data(), memoryBlock.more(0), byteLength);
+
+            return result;
+        }
+
+        Napi::Value EncodeImage(const Napi::CallbackInfo& info)
+        {
+            const auto buffer = info[0].As<Napi::Uint8Array>();
+            const auto width = info[1].As<Napi::Number>().Uint32Value();
+            const auto height = info[2].As<Napi::Number>().Uint32Value();
+            const auto mimeType = info[3].As<Napi::String>().Utf8Value();
+            const auto invertY = info[4].As<Napi::Boolean>().Value();
+
+            if (buffer.ByteLength() != width * height * 4)
+            {
+                throw Napi::RangeError::New(info.Env(), "Buffer byte length is insufficient for RGBA8 image of provided dimensions.");
+            }
+
+            if (mimeType == "image/png")
+            {
+                return EncodePNG(info.Env(), buffer.Data(), width, height, invertY);
+            }
+
+            throw Napi::Error::New(info.Env(), "Unsupported mime type: " + mimeType + ". Only image/png is currently supported.");
+        }
+    }
+}
+
+namespace Babylon::Plugins::NativeEncoding
+{
+    void BABYLON_API Initialize(Napi::Env env)
+    {
+        auto native = JsRuntime::NativeObject::GetFromJavaScript(env);
+        native.Set("EncodeImage", Napi::Function::New(env, EncodeImage, "EncodeImage"));
+    }
+}