Struct SceneVM 

pub struct SceneVM {
    pub vm: VM,
    /* private fields */
}

Fields

vm: VM

Implementations

impl SceneVM

pub fn set_rgba_overlay( &mut self, width: u32, height: u32, rgba: Vec<u8>, rect: [f32; 4], )

pub fn set_rgba_overlay_bytes( &mut self, width: u32, height: u32, rgba: &[u8], rect: [f32; 4], )

pub fn clear_rgba_overlay(&mut self)

pub fn vm_layer_count(&self) -> usize

Total number of VM layers (base + overlays).

pub fn add_vm_layer(&mut self) -> usize

Append a new VM layer that will render on top of the existing ones. Returns its layer index.

pub fn remove_vm_layer(&mut self, index: usize) -> Option<VM>

Remove a VM layer by index (cannot remove the base layer at index 0).

pub fn set_active_vm(&mut self, index: usize) -> bool

Switch the VM layer targeted by execute. Returns true if the index existed.

pub fn active_vm_index(&self) -> usize

Index of the currently active VM used by execute.

pub fn atlas_sdf_uv4(&self, id: &Uuid, anim_frame: u32) -> Option<[f32; 4]>

Normalized atlas rect (ofs.x, ofs.y, scale.x, scale.y) for a tile/frame, useful for SDF packing.

pub fn atlas_dims(&self) -> (u32, u32)

pub fn set_layer_enabled(&mut self, index: usize, enabled: bool) -> bool

Enable or disable drawing for a VM layer. Disabled layers still receive commands.

pub fn is_layer_enabled(&self, index: usize) -> Option<bool>

Returns whether a VM layer is enabled.

pub fn set_layer_activity_logging(&mut self, enabled: bool)

Toggle verbose per-layer logging for uploads/atlas/grid events.

pub fn active_vm(&self) -> &VM

Borrow the currently active VM immutably.

pub fn active_vm_mut(&mut self) -> &mut VM

Borrow the currently active VM mutably.

pub fn pick_geo_id_at_uv( &self, fb_w: u32, fb_h: u32, screen_uv: [f32; 2], include_hidden: bool, include_billboards: bool, ) -> Option<(GeoId, Vec3<f32>, f32)>

Ray-pick against the active VM layer using normalized screen UVs.

pub fn ray_from_uv_with_size( &self, fb_w: u32, fb_h: u32, screen_uv: [f32; 2], ) -> Option<(Vec3<f32>, Vec3<f32>)>

Build a world-space ray from screen uv (0..1) using the active VM’s camera and a provided framebuffer size.

pub fn ray_from_uv(&self, screen_uv: [f32; 2]) -> Option<(Vec3<f32>, Vec3<f32>)>

Build a world-space ray from screen uv (0..1) using the active VM’s camera and the current SceneVM size.

pub fn print_geometry_stats(&self)

Prints statistics about 2D and 3D polygons currently loaded in all chunks.

pub fn execute(&mut self, atom: Atom)

Executes a single atom on the currently active VM layer.

pub fn is_gpu_ready(&self) -> bool

Is the GPU initialized and ready?

pub fn frame_in_flight(&self) -> bool

Is a GPU readback currently in flight (WASM only)? Always false on native.

pub fn new(initial_width: u32, initial_height: u32) -> Self

Create a new SceneVM. Always uses GPU backend.

pub fn new_with_window(window: &Window) -> Self

Create a SceneVM that is configured to present directly into a winit window surface.

pub async fn init_async(&mut self)

Initialize GPU backend asynchronously on WASM. On native, this will initialize synchronously if not already.

pub fn blit_texture( &mut self, tex: &mut Texture, _cpu_pixels: &mut [u8], _buf_w: u32, _buf_h: u32, )

Blit a Texture via GPU to the main surface texture, if GPU is ready.

pub fn resize_window_surface(&mut self, width: u32, height: u32)

Update the window surface size and internal storage texture (native only).

pub fn render_to_window(&mut self) -> SceneVMResult<RenderResult>

Render directly into the configured window surface (native only, no CPU readback).

pub async fn render_frame_async( &mut self, out_pixels: &mut [u8], out_w: u32, out_h: u32, )

Single cross-platform async entrypoint for rendering a frame.

pub fn render_frame( &mut self, out_pixels: &mut [u8], out_w: u32, out_h: u32, ) -> RenderResult

Cross-platform synchronous render entrypoint (one function for Native & WASM). Returns a RenderResult. Native: blocks until pixels are ready. WASM: presents the last completed frame and kicks off a new GPU frame if none is in flight. Call this every frame. On WASM, you must call init_async().await once before rendering.

pub fn load_image_rgba<I: IntoDataInput>( &self, input: I, ) -> Option<(Vec<u8>, u32, u32)>

Load an image from various inputs (file path on native, raw bytes, &str) and decode to RGBA8.

pub fn compile_shader_2d( &mut self, body_source: &str, ) -> ShaderCompilationResult

Compile a 2D body shader with the header and return detailed diagnostics. If compilation succeeds (only warnings), the shader is automatically set as active.

pub fn compile_shader_3d( &mut self, body_source: &str, ) -> ShaderCompilationResult

Compile a 3D body shader with the header and return detailed diagnostics. If compilation succeeds (only warnings), the shader is automatically set as active.

pub fn compile_shader_sdf( &mut self, body_source: &str, ) -> ShaderCompilationResult

Compile an SDF body shader with the header and return detailed diagnostics. If compilation succeeds (only warnings), the shader is automatically set as active.

pub fn default_shader_source(kind: &str) -> Option<String>

Fetch the source of a built-in shader body by name (e.g. “ui”, “2d”, “3d”, “sdf”, “noise”).

Trait Implementations

impl Default for SceneVM

Available on crate feature gpu only.

fn default() -> Self

Returns the “default value” for a type.