Struct Graphics 

pub struct Graphics {
    pub canvas: Canvas<Window>,
    pub sdl_context: Sdl,
    pub texture_creator: Rc<TextureCreator<WindowContext>>,
    pub ttf_context: Sdl3TtfContext,
    /* private fields */
}

Owned SDL variables used for rendering

• canvas: the drawing surface for the window
• sdl_context: the SDL context

Fields

canvas: Canvas<Window>

The SDL3 canvas, required to draw

sdl_context: Sdl

SDL3 contaxt

texture_creator: Rc<TextureCreator<WindowContext>>

SDL3 texture creator

ttf_context: Sdl3TtfContext

SDL3 TTF context required for text rendering

Implementations

impl Graphics

pub fn new<F>( name: String, dimensions: (u32, u32), resource_manager: Arc<Mutex<ResourceManager>>, resource_initialization: F, config: WindowConfig, ) -> Result<Graphics, Box<dyn Error>>

where F: Fn(&mut Graphics),

Initialize SDL3, create a centered, resizable window and return a Graphics container with the canvas and SDL context.

Parameters

• name: Window title.
• dimensions: (width, height) in pixels (u32).

Returns

• Ok(Graphics) on success.
• Err(Box<dyn std::error::Error>) on failure (window/canvas build error).

Example

let graphics = graphics::new(String::from("my cool game"), (500, 500), resource_manager, |_| {}, config)?;

pub fn draw_image(&mut self, path: String, position: (f32, f32)) -> Result<()>

Cache an image if it isn’t cached and draw it on the canvas

Parameters

• path: Path to the image
• position: Where to draw the image in the window (x,y) in pixels (f32).

Returns

• Ok(()) on success.
• Err(Box<dyn std::error::Error>) on failure

Example

graphics.draw_image(String::from("examples/example.png"), (0.0, 0.0)).await;

Examples found in repository

examples/hello.rs (line 23)

    fn draw(&mut self, window: &mut Window) -> anyhow::Result<()> {
        window.graphics.canvas.set_draw_color(Color::RGB(0, 0, 0));
        window.graphics.canvas.clear();
        window
            .graphics
            .draw_image("assets/example.png".to_string(), (0.0, 0.0))
            .expect("failed to draw an image");
        window.graphics.draw_text(
            String::from("hi"),
            (64.0, 64.0),
            String::from("Terminus"),
            Color::RGBA(255, 0, 0, 0),
            16.0,
        )?;
        window.graphics.draw_text(
            String::from("hi"),
            (64.0, 64.0),
            String::from("Terminus"),
            Color::RGBA(255, 0, 0, 0),
            64.0,
        )?;
        window.graphics.canvas.present();
        Ok(())
    }

pub fn draw_text( &mut self, text: String, position: (f32, f32), font: String, color: Color, size: f32, ) -> Result<()>

Create a texture from font + text and render it on the canvas

Examples found in repository

examples/hello.rs (lines 25-31)

    fn draw(&mut self, window: &mut Window) -> anyhow::Result<()> {
        window.graphics.canvas.set_draw_color(Color::RGB(0, 0, 0));
        window.graphics.canvas.clear();
        window
            .graphics
            .draw_image("assets/example.png".to_string(), (0.0, 0.0))
            .expect("failed to draw an image");
        window.graphics.draw_text(
            String::from("hi"),
            (64.0, 64.0),
            String::from("Terminus"),
            Color::RGBA(255, 0, 0, 0),
            16.0,
        )?;
        window.graphics.draw_text(
            String::from("hi"),
            (64.0, 64.0),
            String::from("Terminus"),
            Color::RGBA(255, 0, 0, 0),
            64.0,
        )?;
        window.graphics.canvas.present();
        Ok(())
    }