Struct simple_pixels::Context

pub struct Context { /* private fields */ }

An object that holds the app’s global state.

Implementations

impl Context

pub fn load_file<F>(&self, path: impl AsRef<str>, on_loaded: F)

where F: Fn(Result<Vec<u8>, FsError>) + 'static,

Load file from the path and block until its loaded. Will use filesystem on PC and do a HTTP request on web.

pub async fn load_file_async( &self, path: impl AsRef<str> ) -> Result<Vec<u8>, FsError>

Load file from the path and block until its loaded. Will use filesystem on PC and do a HTTP request on web.

pub fn display_width(&self) -> f32

Display width.

Accounts for dpi scale.

pub fn display_height(&self) -> f32

Display height.

Accounts for dpi scale.

pub fn buffer_width(&self) -> u32

Draw buffer width.

pub fn buffer_height(&self) -> u32

Draw buffer height.

pub fn dpi_scale(&self) -> f32

The dpi scaling factor (window pixels to framebuffer pixels). See https://docs.rs/miniquad/0.3.16/miniquad/conf/index.html#high-dpi-rendering for details.

Always 1.0 if high_dpi in Config is set to false.

pub fn delta_time_secs(&self) -> f64

Time passed between previous and current frame (in seconds).

pub fn delta_time(&self) -> Duration

Time passed between previous and current frame (as std::time::Duration).

pub fn clear_color(&mut self, color: RGBA8)

Set clear/background color.

The buffer isn’t cleared automatically, use Context::clear() for that.

pub fn get_key_state(&self, key: KeyCode) -> Option<InputState>

Returns current input state of a key or None if it isn’t held.

Note that InputState::Released means that the key has just been released, not that it isn’t held.

pub fn is_key_down(&self, key: KeyCode) -> bool

Returns true if a key is down.

pub fn is_key_pressed(&self, key: KeyCode) -> bool

Returns true if a key has just been pressed.

pub fn is_key_released(&self, key: KeyCode) -> bool

Returns true if a key has just been released.

pub fn get_key_mods(&self) -> KeyMods

Returns currently held key modifiers.

pub fn get_real_mouse_pos(&self) -> (i32, i32)

Returns current mouse position in the window.

pub fn get_buffer_mouse_pos(&self) -> (i32, i32)

Returns the point of the buffer where the mouse is. Differs from get_real_mouse_pos() when the window and the buffer have different sizes.

pub fn get_mouse_wheel(&self) -> (f32, f32)

Get current mouse wheel movement.

pub fn get_mouse_button_state(&self, button: MouseButton) -> Option<InputState>

Returns current input state of a mouse button or None if it isn’t held.

Note that InputState::Released means that the key has just been released, not that it isn’t held.

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

Returns true if a mouse button is down.

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

Returns true if a mouse button has just been pressed.

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

Returns true if a mouse button has just been released.

pub fn quit(&self)

Quit the application.

pub fn show_mouse(&self, shown: bool)

Show or hide the mouse cursor.

pub fn show_keyboard(&self, shown: bool)

Show or hide onscreen keyboard.

pub fn set_mouse_cursor(&self, cursor_icon: CursorIcon)

Set the mouse cursor icon.

pub fn set_fullscreen(&self, fullscreen: bool)

Set window to fullscreen or not.

pub fn get_clipboard(&self) -> Option<String>

Get current OS clipboard value.

pub fn set_clipboard(&self, data: impl AsRef<str>)

Save value to OS clipboard.

pub fn set_window_size(&mut self, new_width: u32, new_height: u32)

Set the application’s window size.

Note: resizing the window does not resize the drawing buffer. It will be scaled to the whole window. You can use Context::set_buffer_size() for resizing the buffer.

pub fn set_buffer_size(&mut self, new_width: u32, new_height: u32)

Set the drawing buffer size. The buffer will be cleared.

This doesn’t change the window size. The buffer will be scaled to the whole window.

pub fn clear(&mut self)

Clear the screen buffer with the current Context::clear_color().

pub fn draw_pixel(&mut self, x: i32, y: i32, color: RGBA8)

Draw a pixels at (x, y).

Does nothing if the position is outside the screen.

pub fn draw_rect( &mut self, x: i32, y: i32, width: u32, height: u32, color: RGBA8 )

Draw a colored rectangle.

Does not panic if a part of the rectangle isn’t on screen, just draws the part that is.

pub fn draw_pixels( &mut self, x: i32, y: i32, width: u32, height: u32, pixels: &[RGBA8] )

Fills a rectangle with provided pixels (row-major order).

Does not panic if a part of the rectangle isn’t on screen, just draws the part that is.

pub fn draw_screen(&mut self, pixels: &[RGBA8])

Fills the entire screen buffer at once.

Does not panic if a part of the rectangle isn’t on screen, just draws the part that is.

pub fn get_draw_buffer(&self) -> &[RGBA8]

Returns the screen buffer.

pub fn get_mut_draw_buffer(&mut self) -> &mut [RGBA8]

Returns the screen buffer.

Can be used for drawing.

pub fn as_surface(&self) -> GenericSurface<&[RGBA8], RGBA8>

Get the draw buffer as a simple_blit::GenericSurface.

pub fn as_mut_surface(&mut self) -> GenericSurface<&mut [RGBA8], RGBA8>

Get the draw buffer as a mutable simple_blit::GenericSurface.

pub fn set_texture_filter(&mut self, filter: FilterMode)

Set the filter for the texture that is used for rendering.