Struct RaylibRender 

pub struct RaylibRender {
    pub background_color: Color,
    /* private fields */
}

Primary raylib-backed renderer for Cotis applications.

Owns the window handle (behind a mutex), the raylib drawing thread, loaded fonts, and a path-keyed texture cache. Implements CotisRenderer for crate::drawables::RaylibDrawable streams and Cotis context traits in crate::cotis.

Construction

• RaylibRender::auto_start — gray transparent background, 1000×1000 resizable window.
• RaylibRender::new — custom clear color, same window defaults.
• RaylibRender::new_custom — full control via RaylibBuilder.

Fields

background_color: Color

Clear color used at the start of each frame.

Implementations

impl RaylibRender

pub fn auto_start() -> Self

Creates a renderer with a gray transparent background and a default 1000×1000 resizable window.

pub fn new(background_color: Color) -> Self

Creates a renderer with the given background clear color and a default 1000×1000 resizable window.

pub fn new_custom( raylib_builder: RaylibBuilder<'_>, background_color: Color, ) -> Self

Creates a renderer from a custom RaylibBuilder.

pub fn get_handle(&mut self) -> MutexGuard<'_, RayRenderHandle>

Locks and returns the raylib handle.

Panics

Panics if the mutex is poisoned.

pub fn lock_handle(&self) -> MutexGuard<'_, RayRenderHandle>

Locks and returns the raylib handle (immutable receiver).

Panics

Panics if the mutex is poisoned.

pub fn get_thread(&self) -> &RaylibThread

Returns the raylib drawing thread.

Must be passed to drawing calls on the thread that created the window.

pub fn thread(&self) -> &RaylibThread

Returns the raylib drawing thread.

Alias for Self::get_thread.

pub fn get_raylib( &mut self, ) -> (MutexGuard<'_, RayRenderHandle>, &mut RaylibThread)

Returns the locked handle and drawing thread together for low-level drawing.

Panics

Panics if the mutex is poisoned.

pub fn window_should_close(&self) -> bool

Returns whether the window close flag is set.

Panics

Panics if the mutex is poisoned.

pub fn load_font_and_keep( &mut self, file_name: &str, ) -> Result<usize, RaylibError>

Loads a font at size 16 and registers it in the font table.

Returns a font ID to store in TextConfig::font_id. IDs are assigned in load order starting at 0 and are never reused.

Errors

Returns RaylibError if raylib cannot load the font file.

pub fn load_font_ex_and_keep( &mut self, file_name: &str, font_size: i32, chars: Option<&str>, filter: Option<TextureFilter>, ) -> Result<usize, RaylibError>

Loads a font with custom size, optional character subset, and texture filter.

Returns a font ID (0-based, monotonic) for use in TextConfig::font_id. Additional pixel sizes requested during drawing are queued and loaded at the start of the next frame.

Errors

Returns RaylibError if raylib cannot load the font file.

pub fn delta_time(&self) -> f32

Returns the elapsed time between the previous and current frame, in seconds.

Panics

Panics if the mutex is poisoned.

pub fn get_shared_handle(&self) -> SharedRaylibHandle

Returns a clone of the shared raylib handle for cross-thread input polling.

Pair with Self::thread when calling raylib drawing APIs from the owning thread.

pub fn shared_handle(&self) -> SharedRaylibHandle

Returns a clone of the shared raylib handle.

Alias for Self::get_shared_handle.

pub fn image_cache(&self) -> &HashMap<String, Arc<Texture2D>>

Returns the path-keyed texture cache populated by translate_generic_image.

pub fn image_cache_mut(&mut self) -> &mut HashMap<String, Arc<Texture2D>>

Returns a mutable reference to the texture cache for manual preload or inspection.

pub fn fonts(&self) -> Arc<Mutex<HashMap<usize, ScalableFont>>>

Returns the shared font table used during drawing and text measurement.

impl RaylibRender

pub fn translate_generic_image( &mut self, image: &dyn RaylibLoadableImage, ) -> Box<dyn Texture2DHolder>

Loads a texture from a path-based image, caching the result by file path.

On cache hit, returns the existing texture. On miss, loads via raylib with TextureFilter::TEXTURE_FILTER_POINT filtering.

Panics

Panics if raylib cannot load the file at the given path.

Trait Implementations

impl CotisFrameContext for RaylibRender

fn get_delta_time(&self) -> f32

Returns delta time in seconds since the previous frame.

impl<'b> CotisRenderer<Box<dyn RaylibDrawable + 'b>> for RaylibRender

fn draw_frame( &mut self, render_commands: impl Iterator<Item = Box<dyn RaylibDrawable + 'b>>, )

impl<T: RaylibDrawable> CotisRenderer<RenderTList<T, ()>> for RaylibRender

fn draw_frame( &mut self, render_commands: impl Iterator<Item = RenderTList<T, ()>>, )

impl<T: RaylibDrawable, L: RaylibDrawable + IsRenderList> CotisRenderer<RenderTList<T, L>> for RaylibRender

fn draw_frame( &mut self, render_commands: impl Iterator<Item = RenderTList<T, L>>, )

impl<'b> CotisRendererAsync<Box<dyn RaylibDrawable + 'b>> for RaylibRender

async fn draw_frame( &mut self, render_commands: impl Iterator<Item = Box<dyn RaylibDrawable + 'b>>, )

impl<T: RaylibDrawable> CotisRendererAsync<RenderTList<T, ()>> for RaylibRender

async fn draw_frame( &mut self, render_commands: impl Iterator<Item = RenderTList<T, ()>>, )

impl<T: RaylibDrawable, L: RaylibDrawable + IsRenderList> CotisRendererAsync<RenderTList<T, L>> for RaylibRender

async fn draw_frame( &mut self, render_commands: impl Iterator<Item = RenderTList<T, L>>, )

impl CotisWindowContext for RaylibRender

fn window_dimensions(&self) -> Dimensions

Returns the current drawable window dimensions.

impl MouseProvider for RaylibRender

fn get_mouse_position(&self) -> Vector2

Returns mouse position in pixel coordinates.

fn mouse_button_down(&self, button: MouseButton) -> bool

Returns whether the button is currently down.

fn get_mouse_wheel_move_v(&self) -> Vector2

Returns mouse wheel delta for the current frame.

impl<Manager> RenderCompatibleWith<Manager> for RaylibRender

fn init(&mut self, _layout_manager: &mut Manager)

impl RendererTextMeasuringProvider<TextConfig> for RaylibRender

fn provide_measurer(&mut self) -> Box<TextMeasurer<'_, TextConfig>>

Returns a measuring function used by layout code.

impl SimpleKeyboardProvider for RaylibRender

fn get_pressed_keys(&self) -> IndexSet<KeyboardKey>

Returns keys currently pressed.

impl SimpleTextProvider for RaylibRender

fn get_pressed_chars(&self) -> Vec<char>

Returns entered characters in backend-provided order.