Trait Widget 

pub trait Widget {
    // Required methods
    fn as_any(&mut self) -> &mut dyn Any;
    fn get_config(&mut self) -> &mut WidgetConfig;
    fn get_system_properties(&mut self) -> &mut HashMap<i32, String>;
    fn get_callbacks(&mut self) -> &mut CallbackRegistry;

    // Provided methods
    fn draw(
        &mut self,
        _c: &mut Canvas<Window>,
        _t: &mut TextureCache,
    ) -> Option<&Texture> { ... }
    fn mouse_entered(
        &mut self,
        _widgets: &[WidgetContainer],
        _layouts: &[LayoutContainer],
    ) { ... }
    fn mouse_exited(
        &mut self,
        _widgets: &[WidgetContainer],
        _layouts: &[LayoutContainer],
    ) { ... }
    fn mouse_moved(
        &mut self,
        _widgets: &[WidgetContainer],
        _layouts: &[LayoutContainer],
        _points: Points,
    ) { ... }
    fn mouse_scrolled(
        &mut self,
        _widgets: &[WidgetContainer],
        _layouts: &[LayoutContainer],
        _points: Points,
    ) { ... }
    fn button_clicked(
        &mut self,
        _widgets: &[WidgetContainer],
        _layouts: &[LayoutContainer],
        _button: u8,
        _clicks: u8,
        _state: bool,
    ) { ... }
    fn tick(
        &mut self,
        _widgets: &[WidgetContainer],
        _layouts: &[LayoutContainer],
    ) { ... }
    fn other_event(
        &mut self,
        _widgets: &[WidgetContainer],
        _layouts: &[LayoutContainer],
        _event: Event,
    ) { ... }
    fn tick_callback(
        &mut self,
        _widgets: &[WidgetContainer],
        _layouts: &[LayoutContainer],
    ) { ... }
    fn mouse_entered_callback(
        &mut self,
        _widgets: &[WidgetContainer],
        _layouts: &[LayoutContainer],
    ) { ... }
    fn mouse_exited_callback(
        &mut self,
        _widgets: &[WidgetContainer],
        _layouts: &[LayoutContainer],
    ) { ... }
    fn mouse_moved_callback(
        &mut self,
        _widgets: &[WidgetContainer],
        _layouts: &[LayoutContainer],
        _points: Points,
    ) { ... }
    fn mouse_scrolled_callback(
        &mut self,
        _widgets: &[WidgetContainer],
        _layouts: &[LayoutContainer],
        _points: Points,
    ) { ... }
    fn button_clicked_callback(
        &mut self,
        _widgets: &[WidgetContainer],
        _layouts: &[LayoutContainer],
        _button: u8,
        _clicks: u8,
        _state: bool,
    ) { ... }
    fn on_config_changed(&mut self, _k: u8, _v: Config) { ... }
    fn set_point(&mut self, config: u8, x: i32, y: i32) { ... }
    fn set_color(&mut self, config: u8, color: Color) { ... }
    fn set_numeric(&mut self, config: u8, value: i32) { ... }
    fn set_text(&mut self, config: u8, text: String) { ... }
    fn set_toggle(&mut self, config: u8, flag: bool) { ... }
    fn set_compass(&mut self, config: u8, value: CompassPosition) { ... }
    fn get_point(&mut self, k: u8) -> Points { ... }
    fn get_size(&mut self, k: u8) -> Size { ... }
    fn get_color(&mut self, k: u8) -> Color { ... }
    fn get_numeric(&mut self, k: u8) -> i32 { ... }
    fn get_text(&mut self, k: u8) -> String { ... }
    fn get_toggle(&mut self, k: u8) -> bool { ... }
    fn get_compass(&mut self, k: u8) -> CompassPosition { ... }
    fn set_origin(&mut self, _origin: Points) { ... }
    fn set_size(&mut self, _size: Vec<u32>) { ... }
    fn get_drawing_area(&mut self) -> Rect { ... }
    fn is_invalidated(&mut self) -> bool { ... }
    fn set_invalidated(&mut self, flag: bool) { ... }
}

This trait is shared by all Widget objects that have a presence on the screen. Functions that must be implemented are documented in the trait.

Implementation Notes

If no custom get_config function is defined, and no custom get_system_properties function is defined, you can omit the definition of both, and use the default_widget_properties!() macro to auto-generate this code in your impl of this trait. Keep in mind, however, that these automatically generated implementation details could change in future releases of this library, so it is best to use the default implementation if possible.

Required Methods

fn as_any(&mut self) -> &mut dyn Any

Retrieves this Widget as an Any object so that it can be downcast using downcast_ref to a struct that implements the Widget trait.

fn get_config(&mut self) -> &mut WidgetConfig

Retrieves the WidgetConfig object for this Widget.

fn get_system_properties(&mut self) -> &mut HashMap<i32, String>

Retrieves a HashMap containing system properties used by the Pushrod event engine.

fn get_callbacks(&mut self) -> &mut CallbackRegistry

Retrieves a Callback registry for this Widget.

Provided Methods

fn draw( &mut self, _c: &mut Canvas<Window>, _t: &mut TextureCache, ) -> Option<&Texture>

Draws the widget. If you wish to modify the canvas object, you must declare it as mut in your implementation (ie fn draw(&mut self, mut canvas: Canvas<Window>)). The _canvas is the currently active drawing canvas at the time this function is called. This called during the draw loop of the Engine. This returns a reference to the stored Texture object within the Widget. It is then copied to the canvas, and displayed in the display loop. In this function, you can just return a reference to the Texture if no invalidation state was set, otherwise, the draw can be re-performed, and the Texture returned. If the drawing function returns no texture, return a None, and it will not be rendered during the display loop, but it will still be called. A TextureCache is provided in case your Widget needs to cache an image or a font store.

So, why not just call draw each time, if the Engine already handles the calling of the draw for you when an object needs invalidation? This is to avoid excess CPU usage. You can call the draw method each time: all it will do is return the reference to the already drawn Texture if you do this. It’s only at the time the contents needs to be redrawn will the logic for the draw take place (so long the invalidated state is obeyed)

fn mouse_entered( &mut self, _widgets: &[WidgetContainer], _layouts: &[LayoutContainer], )

When a mouse enters the bounds of the Widget, this function is triggered. This function implementation is optional.

fn mouse_exited( &mut self, _widgets: &[WidgetContainer], _layouts: &[LayoutContainer], )

When a mouse exits the bounds of the Widget, this function is triggered. This function implementation is optional.

fn mouse_moved( &mut self, _widgets: &[WidgetContainer], _layouts: &[LayoutContainer], _points: Points, )

When a mouse moves within the bounds of the Widget, this function is triggered. It contains the X and Y coordinates relative to the bounds of the Widget. The points start at 0x0. This function implementation is optional.

fn mouse_scrolled( &mut self, _widgets: &[WidgetContainer], _layouts: &[LayoutContainer], _points: Points, )

When a mouse scroll is triggered within the bounds of the Widget, this function is triggered. Movement along the X axis indicate horizontal movement, where the Y axis indicates vertical movement. Positive movement means to the right or down, respectively. Negative movement means to the left or up, respectively. This function implementation is optional.

fn button_clicked( &mut self, _widgets: &[WidgetContainer], _layouts: &[LayoutContainer], _button: u8, _clicks: u8, _state: bool, )

When a mouse button is clicked within (or outside of) the bounds of the Widget, this function is called. If a mouse button is clicked, and the mouse leaves the bounds of the Widget, the mouse release event will still be triggered for the last Widget which received the mouse down state. This prevents Widgets from becoming confused. This behavior is tracked by the main loop, not by the Widget code. Therefore, when a mouse button is released outside of the bounds of this Widget, you must adjust your state accordingly, if you pay attention to the button_clicked function. This function implementation is optional.

fn tick(&mut self, _widgets: &[WidgetContainer], _layouts: &[LayoutContainer])

When a timer tick goes by (ie. a frame is displayed on the screen), this function is called. This function implementation is optional.

fn other_event( &mut self, _widgets: &[WidgetContainer], _layouts: &[LayoutContainer], _event: Event, )

When an Event is sent to the application that is not handled by the Engine::run loop, this method is called, sending the unhandled Event to the currently active Widget. This behavior is subject to change as the Engine::run loop is modified to handle more Events.

fn tick_callback( &mut self, _widgets: &[WidgetContainer], _layouts: &[LayoutContainer], )

This calls the on_tick callback. This is implemented by the default_widget_callbacks! macro, so you do not need to implement it. However, you need to call this function if you wish to honor an on_tick callback.

fn mouse_entered_callback( &mut self, _widgets: &[WidgetContainer], _layouts: &[LayoutContainer], )

This calls the on_mouse_entered callback. This is implemented by the default_widget_callbacks! macro, so you do not need to implement it. However, you need to call this function if you wish to honor an on_mouse_entered callback.

fn mouse_exited_callback( &mut self, _widgets: &[WidgetContainer], _layouts: &[LayoutContainer], )

This calls the on_mouse_exited callback. This is implemented by the default_widget_callbacks! macro, so you do not need to implement it. However, you need to call this function if you wish to honor an on_mouse_exited callback.

fn mouse_moved_callback( &mut self, _widgets: &[WidgetContainer], _layouts: &[LayoutContainer], _points: Points, )

This calls the on_mouse_moved callback. This is implemented by the default_widget_callbacks! macro, so you do not need to implement it. However, you need to call this function if you wish to honor an on_mouse_moved callback.

fn mouse_scrolled_callback( &mut self, _widgets: &[WidgetContainer], _layouts: &[LayoutContainer], _points: Points, )

This calls the on_mouse_scrolled callback. This is implemented by the default_widget_callbacks! macro, so you do not need to implement it. However, you need to call this function if you wish to honor an on_mouse_scrolled callback.

fn button_clicked_callback( &mut self, _widgets: &[WidgetContainer], _layouts: &[LayoutContainer], _button: u8, _clicks: u8, _state: bool, )

This calls the on_button_clicked callback. This is implemented by the default_widget_callbacks! macro, so you do not need to implement it. However, you need to call this function if you wish to honor an on_button_clicked callback.

fn on_config_changed(&mut self, _k: u8, _v: Config)

This callback is called when a setter is used to configure a value. It is not called when a call to get_config() using the setter is called, so it is best to use the top-level setters and getters for the configuration values - at least, until the get_config() call can be made private.

fn set_point(&mut self, config: u8, x: i32, y: i32)

Sets a point for a configuration key.

fn set_color(&mut self, config: u8, color: Color)

Sets a color for a configuration key.

Examples found in repository

examples/push_button.rs (line 33)

pub fn main() {
    let sdl_context = sdl2::init().unwrap();
    let video_subsystem = sdl_context.video().unwrap();
    let window = video_subsystem
        .window("pushrod-render push button demo", 400, 100)
        .position_centered()
        .opengl()
        .build()
        .unwrap();
    let mut engine = Engine::new(400, 100, 30);
    let mut button1 = PushButtonWidget::new(
        make_points(20, 20),
        make_size(360, 60),
        String::from("Click me!"),
        40,
    );

    button1.set_color(CONFIG_COLOR_BORDER, Color::RGB(0, 0, 0));
    button1.set_numeric(CONFIG_BORDER_WIDTH, 2);
    button1.on_click(|_x, _widgets, _layouts| {
        eprintln!("Click me clicked!");
    });

    engine.add_widget(Box::new(button1), String::from("button1"));

    engine.run(sdl_context, window);
}

examples/tab_bar.rs (line 35)

pub fn main() {
    let sdl_context = sdl2::init().unwrap();
    let video_subsystem = sdl_context.video().unwrap();
    let window = video_subsystem
        .window("pushrod-render tab bar demo", 400, 300)
        .position_centered()
        .opengl()
        .build()
        .unwrap();
    let mut engine = Engine::new(400, 300, 60);
    let mut widget1 = TabBarWidget::new(
        make_points(20, 20),
        make_size(360, 30),
        vec![
            String::from("First"),
            String::from("Second"),
            String::from("Third"),
        ],
    );

    widget1.set_color(CONFIG_COLOR_BASE, Color::RGB(255, 255, 255));
    widget1.set_color(CONFIG_COLOR_HOVER, Color::RGB(192, 192, 255));
    widget1.on_tab_selected(|_, _, _, selected_tab| {
        eprintln!("Selected tab: {}", selected_tab);
    });

    engine.add_widget(Box::new(widget1), String::from("widget1"));

    engine.run(sdl_context, window);
}

examples/progress.rs (line 23)

pub fn main() {
    let sdl_context = sdl2::init().unwrap();
    let video_subsystem = sdl_context.video().unwrap();
    let window = video_subsystem
        .window("pushrod-render progress demo", 400, 180)
        .position_centered()
        .opengl()
        .build()
        .unwrap();
    let mut engine = Engine::new(400, 180, 60);
    let mut widget1 = ProgressWidget::new(make_points(20, 20), make_size(360, 40), 25);

    widget1.set_color(CONFIG_COLOR_SECONDARY, Color::RGB(255, 0, 0));

    let mut widget2 = ProgressWidget::new(make_points(20, 70), make_size(360, 40), 50);

    widget2.set_color(CONFIG_COLOR_SECONDARY, Color::RGB(255, 0, 0));

    let mut widget3 = ProgressWidget::new(make_points(20, 120), make_size(360, 40), 75);

    widget3.set_color(CONFIG_COLOR_SECONDARY, Color::RGB(255, 0, 0));

    engine.add_widget(Box::new(widget1), String::from("widget1"));
    engine.add_widget(Box::new(widget2), String::from("widget2"));
    engine.add_widget(Box::new(widget3), String::from("widget3"));

    engine.run(sdl_context, window);
}

examples/list.rs (line 26)

pub fn main() {
    let sdl_context = sdl2::init().unwrap();
    let video_subsystem = sdl_context.video().unwrap();
    let window = video_subsystem
        .window("pushrod-render list demo", 400, 300)
        .position_centered()
        .opengl()
        .build()
        .unwrap();
    let mut engine = Engine::new(400, 300, 60);
    let mut widget1 = ListWidget::new(make_points(20, 20), make_size(200, 260));

    widget1.set_color(CONFIG_COLOR_BASE, Color::RGB(255, 255, 255));
    widget1.set_color(CONFIG_COLOR_BORDER, Color::RGB(0, 0, 0));
    widget1.set_color(CONFIG_COLOR_HOVER, Color::RGB(0x90, 0x90, 0xFF));
    widget1.set_numeric(CONFIG_BORDER_WIDTH, 1);

    widget1.add_item(String::from("Item 1"));
    widget1.add_item(String::from("Item 2"));
    widget1.add_item(String::from("Item 3"));
    widget1.add_item(String::from("Item 4"));
    widget1.add_item(String::from("Item 5"));

    widget1.on_selected(|x, _widgets, _layout, selected_item| {
        eprintln!("Selected: {}", selected_item);
    });

    engine.add_widget(Box::new(widget1), String::from("widget1"));

    engine.run(sdl_context, window);
}

examples/toggle_button.rs (line 34)

pub fn main() {
    let sdl_context = sdl2::init().unwrap();
    let video_subsystem = sdl_context.video().unwrap();
    let window = video_subsystem
        .window("pushrod-render toggle button demo", 400, 100)
        .position_centered()
        .opengl()
        .build()
        .unwrap();
    let mut engine = Engine::new(400, 100, 60);
    let mut button1 = ToggleButtonWidget::new(
        make_points(20, 20),
        make_size(170, 60),
        String::from("1"),
        40,
        false,
    );

    button1.set_color(CONFIG_COLOR_BORDER, Color::RGB(0, 0, 0));
    button1.set_numeric(CONFIG_BORDER_WIDTH, 2);
    button1.on_toggle(|_, _widgets, _layouts, _state| {
        eprintln!("1 Toggled: {}", _state);
    });

    let mut button2 = ToggleButtonWidget::new(
        make_points(210, 20),
        make_size(170, 60),
        String::from("2"),
        40,
        true,
    );

    button2.set_color(CONFIG_COLOR_BORDER, Color::RGB(0, 0, 0));
    button2.set_numeric(CONFIG_BORDER_WIDTH, 2);
    button2.on_toggle(|_, _widgets, _layouts, _state| {
        eprintln!("2 Toggled: {}", _state);
    });

    engine.add_widget(Box::new(button1), String::from("button1"));
    engine.add_widget(Box::new(button2), String::from("button2"));

    engine.run(sdl_context, window);
}

examples/timer.rs (line 37)

pub fn main() {
    let sdl_context = sdl2::init().unwrap();
    let video_subsystem = sdl_context.video().unwrap();
    let window = video_subsystem
        .window("pushrod-render timer demo", 400, 180)
        .position_centered()
        .opengl()
        .build()
        .unwrap();
    let mut engine = Engine::new(400, 180, 30);
    let mut widget1 = ProgressWidget::new(make_points(20, 20), make_size(360, 40), 25);

    widget1.set_color(CONFIG_COLOR_SECONDARY, Color::RGB(255, 0, 0));
    widget1.set_color(CONFIG_COLOR_BORDER, Color::RGB(0, 0, 255));

    let mut widget2 = ProgressWidget::new(make_points(20, 70), make_size(360, 40), 50);

    widget2.set_color(CONFIG_COLOR_SECONDARY, Color::RGB(255, 0, 0));
    widget2.set_color(CONFIG_COLOR_BORDER, Color::RGB(0, 255, 0));

    let mut widget3 = ProgressWidget::new(make_points(20, 120), make_size(360, 40), 75);

    widget3.set_color(CONFIG_COLOR_SECONDARY, Color::RGB(255, 0, 0));
    widget3.set_color(CONFIG_COLOR_BORDER, Color::RGB(0, 255, 255));

    let mut timer = TimerWidget::new(100, true);
    timer.on_timeout(|_, _widgets, _layouts| {
        let widget1_id = widget_id_for_name(_widgets, String::from("widget1"));
        let widget2_id = widget_id_for_name(_widgets, String::from("widget2"));
        let widget3_id = widget_id_for_name(_widgets, String::from("widget3"));
        let progress1_value: u8 =
            (cast!(_widgets, widget1_id, ProgressWidget).get_progress() + 1) % 100;
        let progress2_value: u8 =
            (cast!(_widgets, widget2_id, ProgressWidget).get_progress() + 1) % 100;
        let progress3_value: u8 =
            (cast!(_widgets, widget3_id, ProgressWidget).get_progress() + 1) % 100;

        cast!(_widgets, widget1_id, ProgressWidget).set_progress(progress1_value);
        cast!(_widgets, widget2_id, ProgressWidget).set_progress(progress2_value);
        cast!(_widgets, widget3_id, ProgressWidget).set_progress(progress3_value);
    });

    engine.add_widget(Box::new(widget1), String::from("widget1"));
    engine.add_widget(Box::new(widget2), String::from("widget2"));
    engine.add_widget(Box::new(widget3), String::from("widget3"));
    engine.add_widget(Box::new(timer), String::from("timer1"));

    engine.run(sdl_context, window);
}

Additional examples can be found in:

• examples/tile.rs
• examples/image.rs
• examples/layout.rs

fn set_numeric(&mut self, config: u8, value: i32)

Sets a numeric value for a configuration key.

Examples found in repository

examples/push_button.rs (line 34)

pub fn main() {
    let sdl_context = sdl2::init().unwrap();
    let video_subsystem = sdl_context.video().unwrap();
    let window = video_subsystem
        .window("pushrod-render push button demo", 400, 100)
        .position_centered()
        .opengl()
        .build()
        .unwrap();
    let mut engine = Engine::new(400, 100, 30);
    let mut button1 = PushButtonWidget::new(
        make_points(20, 20),
        make_size(360, 60),
        String::from("Click me!"),
        40,
    );

    button1.set_color(CONFIG_COLOR_BORDER, Color::RGB(0, 0, 0));
    button1.set_numeric(CONFIG_BORDER_WIDTH, 2);
    button1.on_click(|_x, _widgets, _layouts| {
        eprintln!("Click me clicked!");
    });

    engine.add_widget(Box::new(button1), String::from("button1"));

    engine.run(sdl_context, window);
}

examples/list.rs (line 29)

pub fn main() {
    let sdl_context = sdl2::init().unwrap();
    let video_subsystem = sdl_context.video().unwrap();
    let window = video_subsystem
        .window("pushrod-render list demo", 400, 300)
        .position_centered()
        .opengl()
        .build()
        .unwrap();
    let mut engine = Engine::new(400, 300, 60);
    let mut widget1 = ListWidget::new(make_points(20, 20), make_size(200, 260));

    widget1.set_color(CONFIG_COLOR_BASE, Color::RGB(255, 255, 255));
    widget1.set_color(CONFIG_COLOR_BORDER, Color::RGB(0, 0, 0));
    widget1.set_color(CONFIG_COLOR_HOVER, Color::RGB(0x90, 0x90, 0xFF));
    widget1.set_numeric(CONFIG_BORDER_WIDTH, 1);

    widget1.add_item(String::from("Item 1"));
    widget1.add_item(String::from("Item 2"));
    widget1.add_item(String::from("Item 3"));
    widget1.add_item(String::from("Item 4"));
    widget1.add_item(String::from("Item 5"));

    widget1.on_selected(|x, _widgets, _layout, selected_item| {
        eprintln!("Selected: {}", selected_item);
    });

    engine.add_widget(Box::new(widget1), String::from("widget1"));

    engine.run(sdl_context, window);
}

examples/toggle_button.rs (line 35)

pub fn main() {
    let sdl_context = sdl2::init().unwrap();
    let video_subsystem = sdl_context.video().unwrap();
    let window = video_subsystem
        .window("pushrod-render toggle button demo", 400, 100)
        .position_centered()
        .opengl()
        .build()
        .unwrap();
    let mut engine = Engine::new(400, 100, 60);
    let mut button1 = ToggleButtonWidget::new(
        make_points(20, 20),
        make_size(170, 60),
        String::from("1"),
        40,
        false,
    );

    button1.set_color(CONFIG_COLOR_BORDER, Color::RGB(0, 0, 0));
    button1.set_numeric(CONFIG_BORDER_WIDTH, 2);
    button1.on_toggle(|_, _widgets, _layouts, _state| {
        eprintln!("1 Toggled: {}", _state);
    });

    let mut button2 = ToggleButtonWidget::new(
        make_points(210, 20),
        make_size(170, 60),
        String::from("2"),
        40,
        true,
    );

    button2.set_color(CONFIG_COLOR_BORDER, Color::RGB(0, 0, 0));
    button2.set_numeric(CONFIG_BORDER_WIDTH, 2);
    button2.on_toggle(|_, _widgets, _layouts, _state| {
        eprintln!("2 Toggled: {}", _state);
    });

    engine.add_widget(Box::new(button1), String::from("button1"));
    engine.add_widget(Box::new(button2), String::from("button2"));

    engine.run(sdl_context, window);
}

examples/layout.rs (line 122)

pub fn main() {
    let sdl_context = sdl2::init().unwrap();
    let video_subsystem = sdl_context.video().unwrap();
    let window = video_subsystem
        .window("pushrod-render horizontal layout demo", 400, 300)
        .position_centered()
        .opengl()
        .build()
        .unwrap();
    let mut engine = Engine::new(400, 300, 60);
    let mut layout = HorizontalLayout::new(20, 20, 360, 80, PaddingConstraint::new(0, 0, 0, 0, 1));
    let mut layout2 =
        VerticalLayout::new(250, 120, 130, 160, PaddingConstraint::new(0, 0, 0, 0, 1));
    let mut widget1 = BaseWidget::new(make_points_origin(), make_size(0, 0));

    widget1
        .get_config()
        .set_color(CONFIG_COLOR_BORDER, Color::RGB(0, 0, 0));
    widget1.get_config().set_numeric(CONFIG_BORDER_WIDTH, 2);

    let mut widget2 = BaseWidget::new(make_points_origin(), make_size(0, 0));

    widget2
        .get_config()
        .set_color(CONFIG_COLOR_BORDER, Color::RGB(0, 0, 0));
    widget2.get_config().set_numeric(CONFIG_BORDER_WIDTH, 2);

    let mut widget3 = BaseWidget::new(make_points_origin(), make_size(0, 0));

    widget3
        .get_config()
        .set_color(CONFIG_COLOR_BORDER, Color::RGB(0, 0, 0));
    widget3.get_config().set_numeric(CONFIG_BORDER_WIDTH, 2);

    let mut widget4 = BaseWidget::new(make_points_origin(), make_size(0, 0));

    widget4
        .get_config()
        .set_color(CONFIG_COLOR_BORDER, Color::RGB(0, 0, 0));
    widget4.get_config().set_numeric(CONFIG_BORDER_WIDTH, 2);

    let widget1_id = engine.add_widget(Box::new(widget1), String::from("widget1"));
    let widget2_id = engine.add_widget(Box::new(widget2), String::from("widget2"));
    let widget3_id = engine.add_widget(Box::new(widget3), String::from("widget3"));
    let widget4_id = engine.add_widget(Box::new(widget4), String::from("widget4"));

    layout.append_widget(widget1_id);
    layout.append_widget(widget2_id);
    layout2.append_widget(widget3_id);
    layout2.append_widget(widget4_id);
    engine.add_layout(Box::new(layout));
    engine.add_layout(Box::new(layout2));

    let mut text_widget1 = TextWidget::new(
        String::from("assets/OpenSans-Regular.ttf"),
        sdl2::ttf::FontStyle::NORMAL,
        16,
        TextJustify::Right,
        String::from("Spacing:"),
        make_points(20, 116),
        make_size(70, 22),
    );

    text_widget1
        .get_config()
        .set_color(CONFIG_COLOR_TEXT, Color::RGB(0, 0, 0));

    let mut text_widget2 = TextWidget::new(
        String::from("assets/OpenSans-Regular.ttf"),
        sdl2::ttf::FontStyle::NORMAL,
        16,
        TextJustify::Left,
        String::from("1"),
        make_points(100, 116),
        make_size(40, 22),
    );

    text_widget2
        .get_config()
        .set_color(CONFIG_COLOR_TEXT, Color::RGB(0, 0, 255));

    let mut button1 = PushButtonWidget::new(
        make_points(130, 112),
        make_size(50, 30),
        String::from("<"),
        20,
    );

    button1.set_color(CONFIG_COLOR_BORDER, Color::RGB(0, 0, 0));
    button1.set_numeric(CONFIG_BORDER_WIDTH, 2);
    button1.on_click(|_, _widgets, _layouts| {
        let mut spacing = _layouts[0].layout.borrow_mut().get_padding().spacing - 1;
        let top = _layouts[0].layout.borrow_mut().get_padding().top;
        let bottom = _layouts[0].layout.borrow_mut().get_padding().bottom;
        let left = _layouts[0].layout.borrow_mut().get_padding().left;
        let right = _layouts[0].layout.borrow_mut().get_padding().right;
        let text_widget2_id = widget_id_for_name(_widgets, String::from("text_widget2"));

        if spacing <= 0 {
            spacing = 0;
        }

        let spacing_new = PaddingConstraint::new(top, bottom, left, right, spacing);

        _layouts[0]
            .layout
            .borrow_mut()
            .set_padding(spacing_new.clone());
        _layouts[1]
            .layout
            .borrow_mut()
            .set_padding(spacing_new.clone());

        refresh_widgets(_widgets);

        cast!(_widgets, text_widget2_id, TextWidget).set_text(format!("{}", spacing));
    });

    let mut button2 = PushButtonWidget::new(
        make_points(180, 112),
        make_size(50, 30),
        String::from(">"),
        20,
    );

    button2.set_color(CONFIG_COLOR_BORDER, Color::RGB(0, 0, 0));
    button2.set_numeric(CONFIG_BORDER_WIDTH, 2);
    button2.on_click(|_, _widgets, _layouts| {
        let mut spacing = _layouts[0].layout.borrow_mut().get_padding().spacing + 1;
        let top = _layouts[0].layout.borrow_mut().get_padding().top;
        let bottom = _layouts[0].layout.borrow_mut().get_padding().bottom;
        let left = _layouts[0].layout.borrow_mut().get_padding().left;
        let right = _layouts[0].layout.borrow_mut().get_padding().right;
        let text_widget2_id = widget_id_for_name(_widgets, String::from("text_widget2"));

        if spacing >= MAX_SPACING {
            spacing = MAX_SPACING;
        }

        let spacing_new = PaddingConstraint::new(top, bottom, left, right, spacing);

        _layouts[0]
            .layout
            .borrow_mut()
            .set_padding(spacing_new.clone());
        _layouts[1]
            .layout
            .borrow_mut()
            .set_padding(spacing_new.clone());

        refresh_widgets(_widgets);

        cast!(_widgets, text_widget2_id, TextWidget).set_text(format!("{}", spacing));
    });

    let mut text_widget3 = TextWidget::new(
        String::from("assets/OpenSans-Regular.ttf"),
        sdl2::ttf::FontStyle::NORMAL,
        16,
        TextJustify::Right,
        String::from("Top:"),
        make_points(20, 146),
        make_size(70, 22),
    );

    text_widget3
        .get_config()
        .set_color(CONFIG_COLOR_TEXT, Color::RGB(0, 0, 0));

    let mut text_widget4 = TextWidget::new(
        String::from("assets/OpenSans-Regular.ttf"),
        sdl2::ttf::FontStyle::NORMAL,
        16,
        TextJustify::Left,
        String::from("0"),
        make_points(100, 146),
        make_size(40, 22),
    );

    text_widget4
        .get_config()
        .set_color(CONFIG_COLOR_TEXT, Color::RGB(0, 0, 255));

    let mut button3 = PushButtonWidget::new(
        make_points(130, 142),
        make_size(50, 30),
        String::from("<"),
        20,
    );

    button3.set_color(CONFIG_COLOR_BORDER, Color::RGB(0, 0, 0));
    button3.set_numeric(CONFIG_BORDER_WIDTH, 2);
    button3.on_click(|_, _widgets, _layouts| {
        let spacing = _layouts[0].layout.borrow_mut().get_padding().spacing;
        let mut top = _layouts[0].layout.borrow_mut().get_padding().top - 1;
        let bottom = _layouts[0].layout.borrow_mut().get_padding().bottom;
        let left = _layouts[0].layout.borrow_mut().get_padding().left;
        let right = _layouts[0].layout.borrow_mut().get_padding().right;
        let text_widget4_id = widget_id_for_name(_widgets, String::from("text_widget4"));

        if top <= 0 {
            top = 0;
        }

        let spacing_new = PaddingConstraint::new(top, bottom, left, right, spacing);

        _layouts[0]
            .layout
            .borrow_mut()
            .set_padding(spacing_new.clone());
        _layouts[1]
            .layout
            .borrow_mut()
            .set_padding(spacing_new.clone());

        refresh_widgets(_widgets);

        cast!(_widgets, text_widget4_id, TextWidget).set_text(format!("{}", top));
    });

    let mut button4 = PushButtonWidget::new(
        make_points(180, 142),
        make_size(50, 30),
        String::from(">"),
        20,
    );

    button4.set_color(CONFIG_COLOR_BORDER, Color::RGB(0, 0, 0));
    button4.set_numeric(CONFIG_BORDER_WIDTH, 2);
    button4.on_click(|_, _widgets, _layouts| {
        let spacing = _layouts[0].layout.borrow_mut().get_padding().spacing;
        let mut top = _layouts[0].layout.borrow_mut().get_padding().top + 1;
        let bottom = _layouts[0].layout.borrow_mut().get_padding().bottom;
        let left = _layouts[0].layout.borrow_mut().get_padding().left;
        let right = _layouts[0].layout.borrow_mut().get_padding().right;
        let text_widget4_id = widget_id_for_name(_widgets, String::from("text_widget4"));

        if top >= MAX_SPACING {
            top = MAX_SPACING;
        }

        let spacing_new = PaddingConstraint::new(top, bottom, left, right, spacing);

        _layouts[0]
            .layout
            .borrow_mut()
            .set_padding(spacing_new.clone());
        _layouts[1]
            .layout
            .borrow_mut()
            .set_padding(spacing_new.clone());

        refresh_widgets(_widgets);

        cast!(_widgets, text_widget4_id, TextWidget).set_text(format!("{}", top));
    });

    let mut text_widget5 = TextWidget::new(
        String::from("assets/OpenSans-Regular.ttf"),
        sdl2::ttf::FontStyle::NORMAL,
        16,
        TextJustify::Right,
        String::from("Bottom:"),
        make_points(20, 176),
        make_size(70, 22),
    );

    text_widget5
        .get_config()
        .set_color(CONFIG_COLOR_TEXT, Color::RGB(0, 0, 0));

    let mut text_widget6 = TextWidget::new(
        String::from("assets/OpenSans-Regular.ttf"),
        sdl2::ttf::FontStyle::NORMAL,
        16,
        TextJustify::Left,
        String::from("0"),
        make_points(100, 176),
        make_size(40, 22),
    );

    text_widget6
        .get_config()
        .set_color(CONFIG_COLOR_TEXT, Color::RGB(0, 0, 255));

    let mut button5 = PushButtonWidget::new(
        make_points(130, 172),
        make_size(50, 30),
        String::from("<"),
        20,
    );

    button5.set_color(CONFIG_COLOR_BORDER, Color::RGB(0, 0, 0));
    button5.set_numeric(CONFIG_BORDER_WIDTH, 2);
    button5.on_click(|_, _widgets, _layouts| {
        let spacing = _layouts[0].layout.borrow_mut().get_padding().spacing;
        let top = _layouts[0].layout.borrow_mut().get_padding().top;
        let mut bottom = _layouts[0].layout.borrow_mut().get_padding().bottom - 1;
        let left = _layouts[0].layout.borrow_mut().get_padding().left;
        let right = _layouts[0].layout.borrow_mut().get_padding().right;
        let text_widget6_id = widget_id_for_name(_widgets, String::from("text_widget6"));

        if bottom <= 0 {
            bottom = 0;
        }

        let spacing_new = PaddingConstraint::new(top, bottom, left, right, spacing);

        _layouts[0]
            .layout
            .borrow_mut()
            .set_padding(spacing_new.clone());
        _layouts[1]
            .layout
            .borrow_mut()
            .set_padding(spacing_new.clone());

        refresh_widgets(_widgets);

        cast!(_widgets, text_widget6_id, TextWidget).set_text(format!("{}", bottom));
    });

    let mut button6 = PushButtonWidget::new(
        make_points(180, 172),
        make_size(50, 30),
        String::from(">"),
        20,
    );

    button6.set_color(CONFIG_COLOR_BORDER, Color::RGB(0, 0, 0));
    button6.set_numeric(CONFIG_BORDER_WIDTH, 2);
    button6.on_click(|_, _widgets, _layouts| {
        let spacing = _layouts[0].layout.borrow_mut().get_padding().spacing;
        let top = _layouts[0].layout.borrow_mut().get_padding().top;
        let mut bottom = _layouts[0].layout.borrow_mut().get_padding().bottom + 1;
        let left = _layouts[0].layout.borrow_mut().get_padding().left;
        let right = _layouts[0].layout.borrow_mut().get_padding().right;
        let text_widget6_id = widget_id_for_name(_widgets, String::from("text_widget6"));

        if bottom >= MAX_SPACING {
            bottom = MAX_SPACING;
        }

        let spacing_new = PaddingConstraint::new(top, bottom, left, right, spacing);

        _layouts[0]
            .layout
            .borrow_mut()
            .set_padding(spacing_new.clone());
        _layouts[1]
            .layout
            .borrow_mut()
            .set_padding(spacing_new.clone());

        refresh_widgets(_widgets);

        cast!(_widgets, text_widget6_id, TextWidget).set_text(format!("{}", bottom));
    });

    let mut text_widget7 = TextWidget::new(
        String::from("assets/OpenSans-Regular.ttf"),
        sdl2::ttf::FontStyle::NORMAL,
        16,
        TextJustify::Right,
        String::from("Left:"),
        make_points(20, 206),
        make_size(70, 22),
    );

    text_widget7
        .get_config()
        .set_color(CONFIG_COLOR_TEXT, Color::RGB(0, 0, 0));

    let mut text_widget8 = TextWidget::new(
        String::from("assets/OpenSans-Regular.ttf"),
        sdl2::ttf::FontStyle::NORMAL,
        16,
        TextJustify::Left,
        String::from("0"),
        make_points(100, 206),
        make_size(40, 22),
    );

    text_widget8
        .get_config()
        .set_color(CONFIG_COLOR_TEXT, Color::RGB(0, 0, 255));

    let mut button7 = PushButtonWidget::new(
        make_points(130, 202),
        make_size(50, 30),
        String::from("<"),
        20,
    );

    button7.set_color(CONFIG_COLOR_BORDER, Color::RGB(0, 0, 0));
    button7.set_numeric(CONFIG_BORDER_WIDTH, 2);
    button7.on_click(|_, _widgets, _layouts| {
        let spacing = _layouts[0].layout.borrow_mut().get_padding().spacing;
        let top = _layouts[0].layout.borrow_mut().get_padding().top;
        let bottom = _layouts[0].layout.borrow_mut().get_padding().bottom;
        let mut left = _layouts[0].layout.borrow_mut().get_padding().left - 1;
        let right = _layouts[0].layout.borrow_mut().get_padding().right;
        let text_widget8_id = widget_id_for_name(_widgets, String::from("text_widget8"));

        if left <= 0 {
            left = 0;
        }

        let spacing_new = PaddingConstraint::new(top, bottom, left, right, spacing);

        _layouts[0]
            .layout
            .borrow_mut()
            .set_padding(spacing_new.clone());
        _layouts[1]
            .layout
            .borrow_mut()
            .set_padding(spacing_new.clone());

        refresh_widgets(_widgets);

        cast!(_widgets, text_widget8_id, TextWidget).set_text(format!("{}", left));
    });

    let mut button8 = PushButtonWidget::new(
        make_points(180, 202),
        make_size(50, 30),
        String::from(">"),
        20,
    );

    button8.set_color(CONFIG_COLOR_BORDER, Color::RGB(0, 0, 0));
    button8.set_numeric(CONFIG_BORDER_WIDTH, 2);
    button8.on_click(|_, _widgets, _layouts| {
        let spacing = _layouts[0].layout.borrow_mut().get_padding().spacing;
        let top = _layouts[0].layout.borrow_mut().get_padding().top;
        let bottom = _layouts[0].layout.borrow_mut().get_padding().bottom;
        let mut left = _layouts[0].layout.borrow_mut().get_padding().left + 1;
        let right = _layouts[0].layout.borrow_mut().get_padding().right;
        let text_widget8_id = widget_id_for_name(_widgets, String::from("text_widget8"));

        if left >= MAX_SPACING {
            left = MAX_SPACING;
        }

        let spacing_new = PaddingConstraint::new(top, bottom, left, right, spacing);

        _layouts[0]
            .layout
            .borrow_mut()
            .set_padding(spacing_new.clone());
        _layouts[1]
            .layout
            .borrow_mut()
            .set_padding(spacing_new.clone());

        refresh_widgets(_widgets);

        cast!(_widgets, text_widget8_id, TextWidget).set_text(format!("{}", left));
    });

    let mut text_widget9 = TextWidget::new(
        String::from("assets/OpenSans-Regular.ttf"),
        sdl2::ttf::FontStyle::NORMAL,
        16,
        TextJustify::Right,
        String::from("Right:"),
        make_points(20, 236),
        make_size(70, 22),
    );

    text_widget9
        .get_config()
        .set_color(CONFIG_COLOR_TEXT, Color::RGB(0, 0, 0));

    let mut text_widget10 = TextWidget::new(
        String::from("assets/OpenSans-Regular.ttf"),
        sdl2::ttf::FontStyle::NORMAL,
        16,
        TextJustify::Left,
        String::from("0"),
        make_points(100, 236),
        make_size(40, 22),
    );

    text_widget10
        .get_config()
        .set_color(CONFIG_COLOR_TEXT, Color::RGB(0, 0, 255));

    let mut button9 = PushButtonWidget::new(
        make_points(130, 232),
        make_size(50, 30),
        String::from("<"),
        20,
    );

    button9.set_color(CONFIG_COLOR_BORDER, Color::RGB(0, 0, 0));
    button9.set_numeric(CONFIG_BORDER_WIDTH, 2);
    button9.on_click(|_, _widgets, _layouts| {
        let spacing = _layouts[0].layout.borrow_mut().get_padding().spacing;
        let top = _layouts[0].layout.borrow_mut().get_padding().top;
        let bottom = _layouts[0].layout.borrow_mut().get_padding().bottom;
        let left = _layouts[0].layout.borrow_mut().get_padding().left;
        let mut right = _layouts[0].layout.borrow_mut().get_padding().right - 1;
        let text_widget10_id = widget_id_for_name(_widgets, String::from("text_widget10"));

        if right <= 0 {
            right = 0;
        }

        let spacing_new = PaddingConstraint::new(top, bottom, left, right, spacing);

        _layouts[0]
            .layout
            .borrow_mut()
            .set_padding(spacing_new.clone());
        _layouts[1]
            .layout
            .borrow_mut()
            .set_padding(spacing_new.clone());

        refresh_widgets(_widgets);

        cast!(_widgets, text_widget10_id, TextWidget).set_text(format!("{}", right));
    });

    let mut button10 = PushButtonWidget::new(
        make_points(180, 232),
        make_size(50, 30),
        String::from(">"),
        20,
    );

    button10.set_color(CONFIG_COLOR_BORDER, Color::RGB(0, 0, 0));
    button10.set_numeric(CONFIG_BORDER_WIDTH, 2);
    button10.on_click(|_, _widgets, _layouts| {
        let spacing = _layouts[0].layout.borrow_mut().get_padding().spacing;
        let top = _layouts[0].layout.borrow_mut().get_padding().top;
        let bottom = _layouts[0].layout.borrow_mut().get_padding().bottom;
        let left = _layouts[0].layout.borrow_mut().get_padding().left;
        let mut right = _layouts[0].layout.borrow_mut().get_padding().right + 1;
        let text_widget10_id = widget_id_for_name(_widgets, String::from("text_widget10"));

        if right >= MAX_SPACING {
            right = MAX_SPACING;
        }

        let spacing_new = PaddingConstraint::new(top, bottom, left, right, spacing);

        _layouts[0]
            .layout
            .borrow_mut()
            .set_padding(spacing_new.clone());
        _layouts[1]
            .layout
            .borrow_mut()
            .set_padding(spacing_new.clone());

        refresh_widgets(_widgets);

        cast!(_widgets, text_widget10_id, TextWidget).set_text(format!("{}", right));
    });

    engine.add_widget(Box::new(text_widget1), String::from("text_widget1"));
    engine.add_widget(Box::new(text_widget2), String::from("text_widget2"));
    engine.add_widget(Box::new(button1), String::from("button1"));
    engine.add_widget(Box::new(button2), String::from("button2"));
    engine.add_widget(Box::new(text_widget3), String::from("text_widget3"));
    engine.add_widget(Box::new(text_widget4), String::from("text_widget4"));
    engine.add_widget(Box::new(button3), String::from("button3"));
    engine.add_widget(Box::new(button4), String::from("button4"));
    engine.add_widget(Box::new(text_widget5), String::from("text_widget5"));
    engine.add_widget(Box::new(text_widget6), String::from("text_widget6"));
    engine.add_widget(Box::new(button5), String::from("button5"));
    engine.add_widget(Box::new(button6), String::from("button6"));
    engine.add_widget(Box::new(text_widget7), String::from("text_widget7"));
    engine.add_widget(Box::new(text_widget8), String::from("text_widget8"));
    engine.add_widget(Box::new(button7), String::from("button7"));
    engine.add_widget(Box::new(button8), String::from("button8"));
    engine.add_widget(Box::new(text_widget9), String::from("text_widget9"));
    engine.add_widget(Box::new(text_widget10), String::from("text_widget10"));
    engine.add_widget(Box::new(button9), String::from("button9"));
    engine.add_widget(Box::new(button10), String::from("button10"));

    engine.run(sdl_context, window);
}

fn set_text(&mut self, config: u8, text: String)

Sets a text value for a configuration key.

fn set_toggle(&mut self, config: u8, flag: bool)

Sets a toggle for a configuration key.

fn set_compass(&mut self, config: u8, value: CompassPosition)

Sets a compass position for a configuration key.

Examples found in repository

examples/image.rs (line 32)

pub fn main() {
    const WIDTH: u32 = 500;
    const HEIGHT: u32 = 270;

    let sdl_context = sdl2::init().unwrap();
    let video_subsystem = sdl_context.video().unwrap();
    let window = video_subsystem
        .window("pushrod-render image demo", WIDTH, HEIGHT)
        .position_centered()
        .opengl()
        .build()
        .unwrap();
    let mut engine = Engine::new(WIDTH, HEIGHT, 60);
    let mut widget1 = ImageWidget::new(
        String::from("assets/rust-48x48.jpg"),
        make_points(20, 16),
        make_size(60, 60),
        false,
    );

    widget1.set_color(CONFIG_COLOR_BASE, Color::RGB(0, 0, 0));
    widget1.set_compass(CONFIG_IMAGE_POSITION, CompassPosition::NW);

    let mut widget2 = ImageWidget::new(
        String::from("assets/rust-48x48.jpg"),
        make_points(90, 16),
        make_size(60, 60),
        false,
    );

    widget2.set_color(CONFIG_COLOR_BASE, Color::RGB(0, 0, 0));
    widget2.set_compass(CONFIG_IMAGE_POSITION, CompassPosition::N);

    let mut widget3 = ImageWidget::new(
        String::from("assets/rust-48x48.jpg"),
        make_points(160, 16),
        make_size(60, 60),
        false,
    );

    widget3.set_color(CONFIG_COLOR_BASE, Color::RGB(0, 0, 0));
    widget3.set_compass(CONFIG_IMAGE_POSITION, CompassPosition::NE);

    let mut widget4 = ImageWidget::new(
        String::from("assets/rust-48x48.jpg"),
        make_points(20, 86),
        make_size(60, 60),
        false,
    );

    widget4.set_color(CONFIG_COLOR_BASE, Color::RGB(0, 0, 0));
    widget4.set_compass(CONFIG_IMAGE_POSITION, CompassPosition::W);

    let mut widget5 = ImageWidget::new(
        String::from("assets/rust-48x48.jpg"),
        make_points(90, 86),
        make_size(60, 60),
        false,
    );

    widget5.set_color(CONFIG_COLOR_BASE, Color::RGB(0, 0, 0));
    widget5.set_compass(CONFIG_IMAGE_POSITION, CompassPosition::Center);

    let mut widget6 = ImageWidget::new(
        String::from("assets/rust-48x48.jpg"),
        make_points(160, 86),
        make_size(60, 60),
        false,
    );

    widget6.set_color(CONFIG_COLOR_BASE, Color::RGB(0, 0, 0));
    widget6.set_compass(CONFIG_IMAGE_POSITION, CompassPosition::E);

    let mut widget7 = ImageWidget::new(
        String::from("assets/rust-48x48.jpg"),
        make_points(20, 156),
        make_size(60, 60),
        false,
    );

    widget7.set_color(CONFIG_COLOR_BASE, Color::RGB(0, 0, 0));
    widget7.set_compass(CONFIG_IMAGE_POSITION, CompassPosition::SW);

    let mut widget8 = ImageWidget::new(
        String::from("assets/rust-48x48.jpg"),
        make_points(90, 156),
        make_size(60, 60),
        false,
    );

    widget8.set_color(CONFIG_COLOR_BASE, Color::RGB(0, 0, 0));
    widget8.set_compass(CONFIG_IMAGE_POSITION, CompassPosition::S);

    let mut widget9 = ImageWidget::new(
        String::from("assets/rust-48x48.jpg"),
        make_points(160, 156),
        make_size(60, 60),
        false,
    );

    widget9.set_color(CONFIG_COLOR_BASE, Color::RGB(0, 0, 0));
    widget9.set_compass(CONFIG_IMAGE_POSITION, CompassPosition::SE);

    let mut widget10 = ImageWidget::new(
        String::from("assets/rust-48x48.jpg"),
        make_points(230, 16),
        make_size(80, 80),
        true,
    );

    widget10.set_color(CONFIG_COLOR_BASE, Color::RGB(0, 0, 0));
    widget10.set_compass(CONFIG_IMAGE_POSITION, CompassPosition::NW);

    let mut widget11 = ImageWidget::new(
        String::from("assets/rust-48x48.jpg"),
        make_points(260, 46),
        make_size(120, 120),
        true,
    );

    widget11.set_color(CONFIG_COLOR_BASE, Color::RGB(0, 0, 0));
    widget11.set_compass(CONFIG_IMAGE_POSITION, CompassPosition::NW);

    let mut widget12 = ImageWidget::new(
        String::from("assets/rust-48x48.jpg"),
        make_points(320, 86),
        make_size(160, 160),
        true,
    );

    widget12.set_color(CONFIG_COLOR_BASE, Color::RGB(0, 0, 0));
    widget12.set_compass(CONFIG_IMAGE_POSITION, CompassPosition::NW);

    engine.add_widget(Box::new(widget1), String::from("widget1"));
    engine.add_widget(Box::new(widget2), String::from("widget2"));
    engine.add_widget(Box::new(widget3), String::from("widget3"));
    engine.add_widget(Box::new(widget4), String::from("widget4"));
    engine.add_widget(Box::new(widget5), String::from("widget5"));
    engine.add_widget(Box::new(widget6), String::from("widget6"));
    engine.add_widget(Box::new(widget7), String::from("widget7"));
    engine.add_widget(Box::new(widget8), String::from("widget8"));
    engine.add_widget(Box::new(widget9), String::from("widget9"));
    engine.add_widget(Box::new(widget10), String::from("widget10"));
    engine.add_widget(Box::new(widget11), String::from("widget11"));
    engine.add_widget(Box::new(widget12), String::from("widget12"));

    engine.run(sdl_context, window);
}

fn get_point(&mut self, k: u8) -> Points

Retrieves a Points for a configuration key. Returns Points::default if not set.

fn get_size(&mut self, k: u8) -> Size

Retrieves a Size for a configuration key. Returns a Size::default if not set.

fn get_color(&mut self, k: u8) -> Color

Retrieves a Color for a configuration key. Returns white if not set.

fn get_numeric(&mut self, k: u8) -> i32

Retrieves a numeric value for a configuration key. Returns 0 if not set.

fn get_text(&mut self, k: u8) -> String

Retrieves text for a configuration key. Returns a blank string if not set.

fn get_toggle(&mut self, k: u8) -> bool

Retrieves a boolean toggle for a configuration key. Returns false if not set.

fn get_compass(&mut self, k: u8) -> CompassPosition

Retrieves a CompassPosition toggle for a configuration key. Returns CompassPosition::W if not set.

fn set_origin(&mut self, _origin: Points)

Sets the origin of the Widget, adjusting the X and Y coordinates. Automatically sets the invalidate flag to true when adjusted, but only if the new origin is not the same as the previous origin.

fn set_size(&mut self, _size: Vec<u32>)

Sets the size of the Widget, adjusting the width and height. Automatically sets the invalidate flag to true when adjusted, but only if the new size is not the same as the previous size.

fn get_drawing_area(&mut self) -> Rect

Returns a Rect object containing the drawing bounds of this Widget.

fn is_invalidated(&mut self) -> bool

Returns whether or not a Widget is invalidated state.

fn set_invalidated(&mut self, flag: bool)

Sets invalidation state for the current Widget.

Implementors

impl Widget for CheckboxWidget

This is the Widget implementation of the CheckboxWidget.

impl Widget for GridWidget

This is the Widget implementation of the GridWidget.

impl Widget for ImageButtonWidget

This is the Widget implementation of the ImageButtonWidget.

impl Widget for ImageWidget

This is the Widget implementation of the ImageWidget. Image is rendered onto a 3D texture, then copied to the canvas after rendering.

impl Widget for ListWidget

This is the Widget implementation of the ListWidget.

impl Widget for ProgressWidget

This is the Widget implementation of the ProgressWidget. It contains a BaseWidget within its bounds to draw the base background, then draws the progress fill over the top.

impl Widget for PushButtonWidget

This is the Widget implementation of the PushButtonWidget.

impl Widget for SliderWidget

This is the Widget implementation of the SliderWidget.

impl Widget for TabBarWidget

This is the Widget implementation of the TabBarWidget.

impl Widget for TextWidget

This is the Widget implementation of the TextWidget. Text is rendered onto a 3D texture, then copied to the canvas after rendering. It uses blended mode texture mapping, which may be slow (as described by the SDL2 documentation), so this might change later to use 8 bit color mapping.

impl Widget for TileWidget

This is the Widget implementation of the TileWidget.

impl Widget for TimerWidget

This is the Widget implementation of the TimerWidget.

impl Widget for ToggleButtonWidget

This is the Widget implementation of the ToggleButtonWidget.

impl Widget for BaseWidget

Implementation for drawing a BaseWidget, with the Widget trait objects applied. This code can be used as a base implementation, or an example of how to create a Widget in Pushrod. The base set of Widgets show off a multitude of different uses for handling events, display contents, and so on. Look through the code in the pushrod::widgets module to get more of an idea of what is possible.