16 unstable releases (3 breaking)

0.4.2 Oct 11, 2021
0.4.1 Oct 10, 2021
0.3.2 Oct 7, 2021
0.2.3 Oct 5, 2021
0.1.5 Jul 26, 2021

#90 in GUI

Download history 51/week @ 2022-04-21 140/week @ 2022-04-28 131/week @ 2022-05-05 301/week @ 2022-05-12 115/week @ 2022-05-19 142/week @ 2022-05-26 201/week @ 2022-06-02 48/week @ 2022-06-09 54/week @ 2022-06-16 53/week @ 2022-06-23 78/week @ 2022-06-30 76/week @ 2022-07-07 55/week @ 2022-07-14 87/week @ 2022-07-21 63/week @ 2022-07-28 67/week @ 2022-08-04

297 downloads per month
Used in 4 crates

MIT license

195KB
4.5K SLoC

fltk-theme

A theming crate for fltk-rs.

  • The widget themes are based on work by Remy Oukaour and Rangi42.
  • The color themes are based on work by Greg Ercolano.
  • Some of the widget schemes are based on work by the NTK GUI library, others are nouveau.

Definitions

Color theme

  • A color theme modify FLTK's color map without modifying any of the drawing routines of the widgets.

Widget scheme

  • A widget scheme modifies FLTK's drawing routines for widgets, thus changing their appearance, without changing their colors.

Widget theme

  • A widget theme modifies FLTK's drawing routines for widgets, as well as the color map, or default colors used for drawing widgets.

As such, color themes can be combined with widget schemes. Widget schemes also enable individually changing the colors and selection colors of each widget. While widget themes have a fixed coloring for widgets, and these usually follow the theme they're named after.

Usage

[dependencies]
fltk = "1.2"
fltk-theme = "0.4"

Example

Setting the color theme:

use fltk::{prelude::*, *};
use fltk_theme::{ColorTheme, color_themes};

fn main() {
    let a = app::App::default().with_scheme(app::Scheme::Gtk);
    let theme = ColorTheme::new(color_themes::BLACK_THEME);
    theme.apply();
    let mut win = window::Window::default().with_size(400, 300);
    let mut btn = button::Button::new(160, 200, 80, 40, "Hello");
    btn.set_color(btn.color().lighter());
    win.end();
    win.show();
    a.run().unwrap();
}

Setting the widget theme:

use fltk::{prelude::*, *};
use fltk_theme::{widget_themes, WidgetTheme, ThemeType};

fn main() {
    let a = app::App::default();
    let widget_theme = WidgetTheme::new(ThemeType::AquaClassic);
    widget_theme.apply();
    let mut win = window::Window::default().with_size(400, 300);
    let mut btn = button::Button::new(160, 200, 80, 30, "Hello");
    btn.set_frame(widget_themes::OS_DEFAULT_BUTTON_UP_BOX);
    win.end();
    win.show();
    a.run().unwrap();
}

Setting the widget scheme:

use fltk::{prelude::*, *};
use fltk_theme::{WidgetScheme, SchemeType};

fn main() {
    let a = app::App::default();
    let widget_scheme = WidgetScheme::new(SchemeType::Clean);
    widget_scheme.apply();
    let mut win = window::Window::default().with_size(400, 300);
    let mut btn = button::Button::new(160, 200, 80, 30, "Hello");
    win.end();
    win.show();
    a.run().unwrap();
}

Widget themes

  • Classic (old Windows theme)

  • alt_test

  • Aero (Windows 7 theme)

  • alt_test

  • AquaClassic (classic MacOS theme),

  • alt_test

  • Dark

  • alt_test

  • High Contrast

  • alt_test

  • Blue

  • alt_test

  • Metro (Windows 8 theme)

  • alt_test

  • Greybird (Gnome xfce)

  • alt_test

Theme FrameTypes

Choosing a WidgetTheme will also define a set of FrameTypes which can be used for your widgets.

OS_BUTTON_UP_BOX
OS_CHECK_DOWN_BOX
OS_BUTTON_UP_FRAME
OS_CHECK_DOWN_FRAME
OS_PANEL_THIN_UP_BOX
OS_SPACER_THIN_DOWN_BOX
OS_PANEL_THIN_UP_FRAME
OS_SPACER_THIN_DOWN_FRAME
OS_RADIO_ROUND_DOWN_BOX
OS_HOVERED_UP_BOX
OS_DEPRESSED_DOWN_BOX
OS_HOVERED_UP_FRAME
OS_DEPRESSED_DOWN_FRAME
OS_INPUT_THIN_DOWN_BOX
OS_INPUT_THIN_DOWN_FRAME
OS_MINI_BUTTON_UP_BOX
OS_MINI_DEPRESSED_DOWN_BOX
OS_MINI_BUTTON_UP_FRAME
OS_MINI_DEPRESSED_DOWN_FRAME
OS_DEFAULT_BUTTON_UP_BOX
OS_DEFAULT_HOVERED_UP_BOX
OS_DEFAULT_DEPRESSED_DOWN_BOX
OS_TOOLBAR_BUTTON_HOVER_BOX
OS_TABS_BOX
OS_SWATCH_BOX
OS_SWATCH_FRAME
OS_BG_BOX

You can check the frames example to see all FrameType's you can apply to you widgets.

  • alt_test

Color themes

  • Black theme

  • alt_test

  • Dark theme

  • alt_test

  • Plain gray theme

  • alt_test

  • Tan theme

  • alt_test

  • Shake theme

  • alt_test

Widget Schemes

These provide schemes for widgets without color theming. Currently there are 6 schemes:

  • Clean: Taken from NTK's clear scheme.

  • alt_test

  • Crystal: Taken from NTK's crystal scheme.

  • alt_test

  • Gleam: Taken from NTK's gleam scheme.

  • alt_test

  • Aqua: Tries to mimic the modern MacOS's styles.

  • alt_test

  • alt_test

  • Fluent: Tries to mimic Window's 10 styles.

  • alt_test

  • alt_test

  • SvgBased: This overrides FLTK's Base scheme round/rounded/oval FrameTypes which are drawn using scalable vector graphics.

  • alt_test

Colors

The crate also provides colors, namely html colors and aqua colors. The aqua colors are provided as lazy_static values and are named after the cocoa NSColor properties (such as windowBackgroundColor, systemBlueColor, controlAccentColor...etc). The html colors are provided in a lazy_static HashMap and can be accessed by their html names. Refer to the html_colors and aqua_dark examples to see how the colors are used.

  • alt_test

Colors and Color themes can also be used with widget schemes or even in a regular fltk-rs application.

Dependencies

~12MB
~264K SLoC