#window #graphics #winapi #api #input #user #color

bin+lib GraphicsEngine

This is my try at making an api to use for Graphics in Rust. It uses the winapi crate and focuses on making it easy to create and modify Windows

12 releases

new 0.2.2 Nov 11, 2024
0.2.1 Nov 8, 2024
0.1.9 Nov 1, 2024
0.1.5 Oct 31, 2024

#114 in Graphics APIs

Download history 214/week @ 2024-10-25 490/week @ 2024-11-01 199/week @ 2024-11-08

631 downloads per month

MIT license

20KB
315 lines

GraphicsEngine

This Library is the right thing for you if you want to make a rust application which needs easy control over one or multiple windows. The API that I am writing will have the most important functions for drawing on a window.

Usage

The most simple program would be a blank window which registers inputs that the user gives. use GraphicsEngine:🪟:Window;

use GraphicsEngine::window::Window;

fn main() {
    let window: Window = Window::new("WindowName".to_string(), "WindowClass".to_string(), 0, 0, 500, 500);
    unsafe {
        window.show();
        loop {
            window.receive_message();
        }
    }
}

Or maybe something a little bit more elaborate, like a Window that automatically fills in the Background Red and has a Blue Rectangle in the left upper corner

use GraphicsEngine::window::{Color, Window};
use GraphicsEngine::window::Point;

fn main() {
    let window: Window = Window::new("WindowName".to_string(), "WindowClass".to_string(), 0, 0, 500, 500);
    unsafe {
        window.show();
        loop {
            window.change_pencil(0, Color { r: 255, g: 0, b: 0, });
            window.fill();
            window.change_pencil(0, Color { r: 0, g: 0, b: 255, });
            window.draw_rectangle(Point { x: 0, y: 0 }, 50, 50);
            window.receive_message();
        }
    }
}

Keep in mind that the code above has a flaw. There will be flickering occuring as soon as the user does something with the window. To remove this nasty flaw there are two simple functions to call { create_buffer() and use_buffer() }

use GraphicsEngine::window::{Color, Window};
use GraphicsEngine::window::Point;

fn main() {
    let mut window: Window = Window::new("WindowName".to_string(), "WindowClass".to_string(), 0, 0, 500, 500);
    unsafe {
        window.show();
        loop {
            window.create_buffer();

            window.change_pencil(0, Color { r: 255, g: 0, b: 0, });
            window.fill();
            window.change_pencil(0, Color { r: 0, g: 0, b: 255, });
            window.draw_rectangle(Point { x: 0, y: 0 }, 50, 50);

            window.use_buffer();
            window.receive_message();
        }
    }
}

If you want to update the window you just have to call the { update() } function

Functionality

In this section the most important Functions and the use cases for them will be elaborated

Key / Mouse Input

To check if a Key is pressed you can get the input_handler from the Window object using
get_input_handler() Once you have the input handler you have access to three methods

key_down() mouse_down() and mouse_position()

the first two have only one paramater which is the c_int of the key that is searched.
The return value is bool (true if the key / mouse button is down)

Example:

if input_handler.unwrap().mouse_down(VK_LBUTTON) {
    window.change_pencil(1, Color { r: 0, g: 255, b: 0, });
}else{
    window.change_pencil(1, Color { r: 0, g: 0, b: 255, });
}

Things that will follow

I want to add...

..documentation to every function so that everybody has a better time using this library
.. support for displaying images
.. fill functions for all of the draw functions
.. settings for the window so that style can be edited

Any other thing I'm working on is visible as an Issue in this Github Project

Dependencies

~225KB