perf: eliminate 8MB-per-call allocation in text rendering swap

TextRenderer::new() was used as a throwaway placeholder in the
std::mem::replace borrow-split pattern for draw_text/draw_text_ex.
Each call allocated two 1024x1024x4 atlas buffers (~8MB) plus parsed
the default font, only to be immediately discarded.

Add TextRenderer::empty() that allocates nothing, and use it as the
swap placeholder across all platforms (macOS, iOS, tvOS, Android,
Linux, Windows). This drops draw time from ~150ms to <1ms on Android.

Also includes tvOS platform support and misc Cargo.lock updates.

Author: proggeramlug

native/android/Cargo.lock

@@ -353,7 +353,7 @@ pub extern "C" fn bloom_draw_poly(cx: f64, cy: f64, sides: f64, radius: f64, rot
 pub extern "C" fn bloom_draw_text(text_ptr: *const u8, x: f64, y: f64, size: f64, r: f64, g: f64, b: f64, a: f64) {
     let text = str_from_header(text_ptr);
     let eng = engine();
-    let mut text_renderer = std::mem::replace(&mut eng.text, bloom_shared::text_renderer::TextRenderer::new());
+    let mut text_renderer = std::mem::replace(&mut eng.text, bloom_shared::text_renderer::TextRenderer::empty());
     text_renderer.draw_text(&mut eng.renderer, text, x, y, size as u32, r, g, b, a);
     eng.text = text_renderer;
 }
@@ -379,7 +379,7 @@ pub extern "C" fn bloom_unload_font(font_handle: f64) {
 pub extern "C" fn bloom_draw_text_ex(font_handle: f64, text_ptr: *const u8, x: f64, y: f64, size: f64, spacing: f64, r: f64, g: f64, b: f64, a: f64) {
     let text = str_from_header(text_ptr);
     let eng = engine();
-    let mut text_renderer = std::mem::replace(&mut eng.text, bloom_shared::text_renderer::TextRenderer::new());
+    let mut text_renderer = std::mem::replace(&mut eng.text, bloom_shared::text_renderer::TextRenderer::empty());
     text_renderer.draw_text_ex(&mut eng.renderer, font_handle as usize, text, x, y, size as u32, spacing as f32, r, g, b, a);
     eng.text = text_renderer;
 }
@@ -1028,7 +1028,7 @@ pub extern "C" fn Java_com_bloomengine_game_BloomGameBridge_nativeOnDestroy(
 #[no_mangle]
 pub extern "C" fn bloom_stage_texture(path_ptr: *const u8) -> f64 {
     let path = str_from_header(path_ptr);
-    match std::fs::read(path) {
+    match std::fs::read(resolve_path(path)) {
         Ok(data) => bloom_shared::staging::decode_and_stage_texture(&data),
         Err(_) => 0.0,
     }
@@ -1037,7 +1037,7 @@ pub extern "C" fn bloom_stage_texture(path_ptr: *const u8) -> f64 {
 #[no_mangle]
 pub extern "C" fn bloom_stage_model(path_ptr: *const u8) -> f64 {
     let path = str_from_header(path_ptr);
-    let data = match std::fs::read(path) {
+    let data = match std::fs::read(resolve_path(path)) {
         Ok(d) => d,
         Err(_) => return 0.0,
     };
@@ -1050,7 +1050,7 @@ pub extern "C" fn bloom_stage_model(path_ptr: *const u8) -> f64 {
 #[no_mangle]
 pub extern "C" fn bloom_stage_sound(path_ptr: *const u8) -> f64 {
     let path = str_from_header(path_ptr);
-    let data = match std::fs::read(path) {
+    let data = match std::fs::read(resolve_path(path)) {
         Ok(d) => d,
         Err(_) => return 0.0,
     };

native/android/src/lib.rs

@@ -690,7 +690,7 @@ pub extern "C" fn bloom_draw_poly(cx: f64, cy: f64, sides: f64, radius: f64, rot
 pub extern "C" fn bloom_draw_text(text_ptr: *const u8, x: f64, y: f64, size: f64, r: f64, g: f64, b: f64, a: f64) {
     let text = str_from_header(text_ptr);
     let eng = engine();
-    let mut text_renderer = std::mem::replace(&mut eng.text, bloom_shared::text_renderer::TextRenderer::new());
+    let mut text_renderer = std::mem::replace(&mut eng.text, bloom_shared::text_renderer::TextRenderer::empty());
     text_renderer.draw_text(&mut eng.renderer, text, x, y, size as u32, r, g, b, a);
     eng.text = text_renderer;
 }
@@ -716,7 +716,7 @@ pub extern "C" fn bloom_unload_font(font_handle: f64) {
 pub extern "C" fn bloom_draw_text_ex(font_handle: f64, text_ptr: *const u8, x: f64, y: f64, size: f64, spacing: f64, r: f64, g: f64, b: f64, a: f64) {
     let text = str_from_header(text_ptr);
     let eng = engine();
-    let mut text_renderer = std::mem::replace(&mut eng.text, bloom_shared::text_renderer::TextRenderer::new());
+    let mut text_renderer = std::mem::replace(&mut eng.text, bloom_shared::text_renderer::TextRenderer::empty());
     text_renderer.draw_text_ex(&mut eng.renderer, font_handle as usize, text, x, y, size as u32, spacing as f32, r, g, b, a);
     eng.text = text_renderer;
 }
@@ -1484,7 +1484,7 @@ pub extern "C" fn bloom_is_any_input_pressed() -> f64 {
 #[no_mangle]
 pub extern "C" fn bloom_stage_texture(path_ptr: *const u8) -> f64 {
     let path = str_from_header(path_ptr);
-    match std::fs::read(path) {
+    match std::fs::read(resolve_path(path)) {
         Ok(data) => bloom_shared::staging::decode_and_stage_texture(&data),
         Err(_) => 0.0,
     }
@@ -1493,7 +1493,7 @@ pub extern "C" fn bloom_stage_texture(path_ptr: *const u8) -> f64 {
 #[no_mangle]
 pub extern "C" fn bloom_stage_model(path_ptr: *const u8) -> f64 {
     let path = str_from_header(path_ptr);
-    let data = match std::fs::read(path) {
+    let data = match std::fs::read(resolve_path(path)) {
         Ok(d) => d,
         Err(_) => return 0.0,
     };
@@ -1506,7 +1506,7 @@ pub extern "C" fn bloom_stage_model(path_ptr: *const u8) -> f64 {
 #[no_mangle]
 pub extern "C" fn bloom_stage_sound(path_ptr: *const u8) -> f64 {
     let path = str_from_header(path_ptr);
-    let data = match std::fs::read(path) {
+    let data = match std::fs::read(resolve_path(path)) {
         Ok(d) => d,
         Err(_) => return 0.0,
     };

native/ios/Cargo.lock

@@ -398,7 +398,7 @@ pub extern "C" fn bloom_draw_poly(cx: f64, cy: f64, sides: f64, radius: f64, rot
 pub extern "C" fn bloom_draw_text(text_ptr: *const u8, x: f64, y: f64, size: f64, r: f64, g: f64, b: f64, a: f64) {
     let text = str_from_header(text_ptr);
     let eng = engine();
-    let mut text_renderer = std::mem::replace(&mut eng.text, bloom_shared::text_renderer::TextRenderer::new());
+    let mut text_renderer = std::mem::replace(&mut eng.text, bloom_shared::text_renderer::TextRenderer::empty());
     text_renderer.draw_text(&mut eng.renderer, text, x, y, size as u32, r, g, b, a);
     eng.text = text_renderer;
 }
@@ -424,7 +424,7 @@ pub extern "C" fn bloom_unload_font(font_handle: f64) {
 pub extern "C" fn bloom_draw_text_ex(font_handle: f64, text_ptr: *const u8, x: f64, y: f64, size: f64, spacing: f64, r: f64, g: f64, b: f64, a: f64) {
     let text = str_from_header(text_ptr);
     let eng = engine();
-    let mut text_renderer = std::mem::replace(&mut eng.text, bloom_shared::text_renderer::TextRenderer::new());
+    let mut text_renderer = std::mem::replace(&mut eng.text, bloom_shared::text_renderer::TextRenderer::empty());
     text_renderer.draw_text_ex(&mut eng.renderer, font_handle as usize, text, x, y, size as u32, spacing as f32, r, g, b, a);
     eng.text = text_renderer;
 }

native/ios/src/lib.rs

@@ -15,3 +15,4 @@ objc2-app-kit = { version = "0.3", features = ["NSWindow", "NSView", "NSEvent",
 objc2-quartz-core = { version = "0.3", features = ["CAMetalLayer"] }
 raw-window-handle = "0.6"
 wgpu = "24"
+libc = "0.2"

native/linux/src/lib.rs

@@ -631,7 +631,7 @@ pub extern "C" fn bloom_draw_text(text_ptr: *const u8, x: f64, y: f64, size: f64
     let text = str_from_header(text_ptr);
     let eng = engine();
     // Need to split borrow: take text out temporarily
-    let mut text_renderer = std::mem::replace(&mut eng.text, bloom_shared::text_renderer::TextRenderer::new());
+    let mut text_renderer = std::mem::replace(&mut eng.text, bloom_shared::text_renderer::TextRenderer::empty());
     text_renderer.draw_text(&mut eng.renderer, text, x, y, size as u32, r, g, b, a);
     eng.text = text_renderer;
 }
@@ -660,7 +660,7 @@ pub extern "C" fn bloom_unload_font(font_handle: f64) {
 pub extern "C" fn bloom_draw_text_ex(font_handle: f64, text_ptr: *const u8, x: f64, y: f64, size: f64, spacing: f64, r: f64, g: f64, b: f64, a: f64) {
     let text = str_from_header(text_ptr);
     let eng = engine();
-    let mut text_renderer = std::mem::replace(&mut eng.text, bloom_shared::text_renderer::TextRenderer::new());
+    let mut text_renderer = std::mem::replace(&mut eng.text, bloom_shared::text_renderer::TextRenderer::empty());
     text_renderer.draw_text_ex(&mut eng.renderer, font_handle as usize, text, x, y, size as u32, spacing as f32, r, g, b, a);
     eng.text = text_renderer;
 }

native/macos/Cargo.lock

@@ -18,6 +18,7 @@ pub struct EngineState {
     pub scene: SceneGraph,
     pub frame_callbacks: FrameCallbackSystem,
     pub postfx: Option<PostFxPipeline>,
+    pub screenshot_pending: bool,
 
     // Timing
     pub target_fps: f64,
@@ -45,6 +46,7 @@ impl EngineState {
             scene: SceneGraph::new(),
             frame_callbacks: FrameCallbackSystem::new(),
             postfx: None,
+            screenshot_pending: false,
             target_fps: 60.0,
             delta_time: 0.0,
             last_frame_time: now,
@@ -79,7 +81,7 @@ impl EngineState {
     }
 
     pub fn end_frame(&mut self) {
-        // Prepare scene graph GPU resources before rendering
+        // Prepare and render with scene graph
         self.scene.prepare(
             &self.renderer.device,
             &self.renderer.queue,

native/macos/Cargo.toml

@@ -85,6 +85,30 @@ pub struct TextRenderer {
 }
 
 impl TextRenderer {
+    /// Cheap placeholder that allocates nothing. Used as a temporary swap target
+    /// when we need to split borrows on EngineState (text + renderer).
+    pub fn empty() -> Self {
+        Self {
+            fonts: Vec::new(),
+            glyph_cache: HashMap::new(),
+            atlas_data: Vec::new(),
+            atlas_width: 0,
+            atlas_height: 0,
+            atlas_cursor_x: 0,
+            atlas_cursor_y: 0,
+            atlas_row_height: 0,
+            atlas_bind_group_idx: None,
+            atlas_dirty: false,
+            sdf_glyph_cache: HashMap::new(),
+            sdf_atlas_data: Vec::new(),
+            sdf_atlas_cursor_x: 0,
+            sdf_atlas_cursor_y: 0,
+            sdf_atlas_row_height: 0,
+            sdf_atlas_bind_group_idx: None,
+            sdf_atlas_dirty: false,
+        }
+    }
+
     pub fn new() -> Self {
         let default_font = Font::from_bytes(DEFAULT_FONT_DATA, FontSettings::default())
             .expect("Failed to load default font");