derin's Introduction

Derin - Derivable User Interface

A UI library for Rust that makes creating a GUI as simple as declaring a struct.

Setting up

[dependencies]

# The core library and APIs, used for creating and displaying widgets.
derin = "0.1"

# Adds #[derive(WidgetContainer)]. Is used to help create widget trees.
derin_macros = "0.1"

Examples

Beyond looking at the API docs, you're encouraged to look at one of the provided examples, to see more complex examples of how to use Derin. Those can be found in the derin/examples directory.

// A simple application that shows a click-able button to the user.
extern crate derin;

use derin::{Window, WindowConfig, LoopFlow};
use derin::widgets::{Button, Contents};
use derin::geometry::DimsBox;

fn main() {
    let print_string = "Prints to the console.";

    // Create a new window that displays a GUI on the desktop.
    let mut window = unsafe{ Window::new(
        // Set the attributes with which we'll create the window.
        WindowConfig {
            dimensions: Some(DimsBox::new2(400, 50)),
            title: "Derin's Hello World".to_string(),
            ..WindowConfig::default()
        },
        // Create a button that displays "Hello World" to the user, and passes `print_string`
        // to the UI's action loop.
        Button::new(Contents::Text("Hello, World!".to_string()), Some(print_string)),
        // Set the theme to the default theme.
        derin::theme::Theme::default()
    ).unwrap() };

    let _: Option<()> = window.run_forever(
        // Whenever an action is recieved from a widget, this function is called.
        |print_string, _, _| {
            // Print out strings passed to the action function.
            println!("{}", print_string);
            LoopFlow::Continue
        },
        |_, _| None
    );
}

License

Derin is made available under the Mozilla Public License, 2.0, viewable in this repository or on the Mozilla Website.

Contribution

Unless explicitly stated otherwise, any contributions intentionally submitted for inclusion within Derin will be licensed under the MPL-2.0 license, without any additional terms or conditions.

Recommend Projects