Struct fltk::enums::Color

source ·
pub struct Color { /* private fields */ }
Expand description

Defines colors used by FLTK. Colors are stored as RGBI values, the last being the index for FLTK colors in this enum. Colors in this enum don’t have an RGB stored. However, custom colors have an RGB, and don’t have an index. The RGBI can be acquired by casting the color to u32 and formatting it to 0x{08x}. The last 2 digits are the hexadecimal representation of the color in this enum. For example, Color::White, has a hex of 0x000000ff, ff being the 255 value of this enum. A custom color like Color::from_u32(0x646464), will have an representation as 0x64646400, of which the final 00 indicates that it is not stored in this enum. For convenience, the fmt::Display trait is implemented so that the name of the Color is shown when there is one, otherwise the RGB value is given.

Implementations§

source§

impl Color

source

pub const ForeGround: Color = _

ForeGround, label colors

source

pub const Foreground: Color = _

Foreground, label colors

source

pub const BackGround2: Color = _

BackGround2, Is the color inside input, output and text display widgets

source

pub const Background2: Color = _

Background2, Is the color inside input, output and text display widgets

source

pub const Inactive: Color = _

Inactive

source

pub const Selection: Color = _

Selection

source

pub const Free: Color = _

Free

source

pub const Gray0: Color = _

Gray0

source

pub const GrayRamp: Color = _

GrayRamp

source

pub const Dark3: Color = _

Dark3

source

pub const Dark2: Color = _

Dark2

source

pub const Dark1: Color = _

Dark1

source

pub const FrameDefault: Color = _

FrameDefault

source

pub const BackGround: Color = _

BackGround

source

pub const Background: Color = _

Background

source

pub const Light1: Color = _

Light1

source

pub const Light2: Color = _

Light2

source

pub const Light3: Color = _

Light3

source

pub const Black: Color = _

Black

source

pub const Red: Color = _

Red

source

pub const Green: Color = _

Green

source

pub const Yellow: Color = _

Yellow

source

pub const Blue: Color = _

Blue

source

pub const Magenta: Color = _

Magenta

source

pub const Cyan: Color = _

Cyan

source

pub const DarkRed: Color = _

DarkRed

source

pub const DarkGreen: Color = _

DarkGreen

source

pub const DarkYellow: Color = _

DarkYellow

source

pub const DarkBlue: Color = _

DarkBlue

source

pub const DarkMagenta: Color = _

DarkMagenta

source

pub const DarkCyan: Color = _

DarkCyan

source

pub const White: Color = _

White

source

pub const XtermBlack: Color = _

ANSI/xterm Black, not part of FLTK’s colormap

source

pub const XtermRed: Color = _

ANSI/xterm Red, not part of FLTK’s colormap

source

pub const XtermGreen: Color = _

ANSI/xterm Green, not part of FLTK’s colormap

source

pub const XtermYellow: Color = _

ANSI/xterm Yellow, not part of FLTK’s colormap

source

pub const XtermBlue: Color = _

ANSI/xterm Blue, not part of FLTK’s colormap

source

pub const XtermMagenta: Color = _

ANSI/xterm Magenta, not part of FLTK’s colormap

source

pub const XtermCyan: Color = _

ANSI/xterm Cyan, not part of FLTK’s colormap

source

pub const XtermWhite: Color = _

ANSI/xterm White, not part of FLTK’s colormap

source

pub const XtermBgRed: Color = _

ANSI/xterm background Red, not part of FLTK’s colormap

source

pub const XtermBgGreen: Color = _

ANSI/xterm background Green, not part of FLTK’s colormap

source

pub const XtermBgYellow: Color = _

ANSI/xterm background Yelllow, not part of FLTK’s colormap

source

pub const XtermBgBlue: Color = _

ANSI/xterm background Blue, not part of FLTK’s colormap

source

pub const XtermBgMagenta: Color = _

ANSI/xterm background Magenta, not part of FLTK’s colormap

source

pub const XtermBgCyan: Color = _

ANSI/xterm background Cyan, not part of FLTK’s colormap

source

pub const XtermBgWhite: Color = _

ANSI/xterm background White, not part of FLTK’s colormap

source

pub const TransparentBg: Color = _

Special background color value that lets the Terminal widget’s box() color show through behind the text. Not part of FLTK’s colormap

source

pub const fn bits(&self) -> u32

Gets the inner color representation

source

pub const fn from_rgb(r: u8, g: u8, b: u8) -> Color

Returns a color from RGB

Examples found in repository?
examples/flex.rs (line 10)
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
fn main() {
    let a = app::App::default().with_scheme(app::Scheme::Gtk);
    let mut win = window::Window::default().with_size(640, 480);
    let mut col = group::Flex::default_fill().column();
    main_panel(&mut col);
    col.end();
    win.resizable(&col);
    win.set_color(enums::Color::from_rgb(250, 250, 250));
    win.end();
    win.show();
    win.size_range(600, 400, 0, 0);
    a.run().unwrap();
}

fn buttons_panel(parent: &mut group::Flex) {
    frame::Frame::default();
    let w = frame::Frame::default().with_label("Welcome to Flex Login");

    let mut urow = group::Flex::default().row();
    {
        frame::Frame::default()
            .with_label("Username:")
            .with_align(enums::Align::Inside | enums::Align::Right);
        let username = input::Input::default();

        urow.fixed(&username, 180);
        urow.end();
    }

    let mut prow = group::Flex::default().row();
    {
        frame::Frame::default()
            .with_label("Password:")
            .with_align(enums::Align::Inside | enums::Align::Right);
        let password = input::Input::default();

        prow.fixed(&password, 180);
        prow.end();
    }

    let pad = frame::Frame::default();

    let mut brow = group::Flex::default().row();
    {
        frame::Frame::default();
        let reg = create_button("Register");
        let login = create_button("Login");

        brow.fixed(&reg, 80);
        brow.fixed(&login, 80);
        brow.end();
    }

    let b = frame::Frame::default();

    frame::Frame::default();

    parent.fixed(&w, 60);
    parent.fixed(&urow, 30);
    parent.fixed(&prow, 30);
    parent.fixed(&pad, 1);
    parent.fixed(&brow, 30);
    parent.fixed(&b, 30);
}

fn middle_panel(parent: &mut group::Flex) {
    frame::Frame::default();

    let mut frame = frame::Frame::default().with_label("Image");
    frame.set_frame(enums::FrameType::BorderBox);
    frame.set_color(enums::Color::from_rgb(0, 200, 0));
    let spacer = frame::Frame::default();

    let mut bp = group::Flex::default().column();
    buttons_panel(&mut bp);
    bp.end();

    frame::Frame::default();

    parent.fixed(&frame, 200);
    parent.fixed(&spacer, 10);
    parent.fixed(&bp, 300);
}

fn main_panel(parent: &mut group::Flex) {
    frame::Frame::default();

    let mut mp = group::Flex::default().row();
    middle_panel(&mut mp);
    mp.end();

    frame::Frame::default();

    parent.fixed(&mp, 200);
}

fn create_button(caption: &str) -> button::Button {
    let mut btn = button::Button::default().with_label(caption);
    btn.set_color(enums::Color::from_rgb(225, 225, 225));
    btn
}
More examples
Hide additional examples
examples/shapedwindow_taskbar.rs (line 35)
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
fn main() {
    let app = app::App::default();

    // Act as the application in the taskbar (scroll to event handling)
    let mut dock_win = window::Window::default()
        .with_size(1, 1) // So we can place it at the center of the screen (needs a size >0 to be centered)
        .with_label("TestApplication")
        .center_screen();
    dock_win.size_range(0, 0, 0, 0);
    dock_win.make_resizable(false);

    dock_win.show();
    dock_win.end();

    let mut win = window::Window::default()
        .with_size(900, 500)
        .with_label("TestApplication")
        .center_screen();
    win.set_color(enums::Color::from_rgb(26, 25, 55));

    let mut but = button::Button::default()
        .with_label("Button")
        .with_size(80, 80)
        .center_of_parent();
    but.set_frame(enums::FrameType::OFlatFrame);
    but.set_color(enums::Color::Cyan);
    but.clear_visible_focus();
    but.set_callback(|_| println!("Clicked"));

    win.show();
    win.end();

    let win_shape = prep_shape(win.w(), win.h());

    // Called after showing window
    win.set_shape(Some(win_shape));

    win.handle({
        let mut x = 0;
        let mut y = 0;
        let mut dock_win = dock_win.clone();
        move |wself, event| match event {
            enums::Event::Push => {
                let coords = app::event_coords();
                x = coords.0;
                y = coords.1;

                true
            }
            enums::Event::Drag => {
                wself.set_pos(app::event_x_root() - x, app::event_y_root() - y);

                // Changing dock window position so it's close enough to the center of the application (not "visible" to user)
                dock_win.set_pos(wself.x() + (wself.w() / 2), wself.y() + (wself.w() / 2));

                true
            }
            enums::Event::Close => {
                app.quit();

                true
            }
            enums::Event::Hide => {
                app.quit();

                true
            }
            _ => false,
        }
    });

    // Make main window appear when "opened" via Alt+Tab or Taskbar
    dock_win.handle({
        let mut win = win.clone();
        move |_wself, event| match event {
            enums::Event::Focus => {
                let win_shape = prep_shape(win.w(), win.h());

                win.show();
                win.set_shape(Some(win_shape));

                true
            }
            enums::Event::Hide => {
                win.hide();

                true
            }
            enums::Event::Close => {
                app.quit();

                true
            }
            _ => false,
        }
    });

    app.run().unwrap();
}
examples/terminal.rs (line 642)
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
fn mb_test4_cb(_choice: &mut fltk::menu::Choice, term: &mut Terminal) {
    term.take_focus().unwrap();
    term.reset_terminal();
    // Test the Utf8Char primitive
    let uc = Utf8Char::new(b'Q');
    let uc1 = uc.text_utf8();
    assert_eq!(&uc1, &[b'Q']);
    assert_eq!(&uc.attrib(), &Attrib::Normal);
    assert_eq!(
        &uc.charflags(),
        &(CharFlags::FG_XTERM | CharFlags::BG_XTERM)
    );
    assert_eq!(&uc.fgcolor(), &Color::XtermWhite);
    assert_eq!(&uc.bgcolor(), &Color::TransparentBg);

    let ring_rows = term.ring_rows();

    term.take_focus().unwrap();
    term.clear_history();
    assert_eq!(term.history_use(), 0);

    // Subtract row numbers, modulo `rows`
    fn row_diff(rows: i32, a: i32, b: i32) -> i32 {
        match a - b {
            n if n < 0 => n + rows,
            n => n,
        }
    }
    // disp_srow is always 1 greater than hist_erow, modulo (ring_rows+1)
    assert_eq!(row_diff(ring_rows, term.disp_srow(), term.hist_erow()), 1);
    assert!(term.disp_srow() >= 0);
    assert!(term.disp_erow() >= 0);
    assert!(term.hist_srow() >= 0);
    assert!(term.hist_erow() >= 0);
    assert!(term.offset() >= 0);
    assert!(term.disp_srow() <= ring_rows);
    assert!(term.disp_erow() <= ring_rows);
    assert!(term.hist_srow() <= ring_rows);
    assert!(term.hist_erow() <= ring_rows);
    assert!(term.offset() <= ring_rows);

    assert_eq!(term.ring_srow(), 0);
    assert_eq!(term.ring_erow(), ring_rows - 1);
    assert_eq!(
        row_diff(ring_rows, term.disp_erow(), term.disp_srow()) + 1,
        term.disp_rows()
    );
    assert_eq!(
        row_diff(ring_rows, term.hist_erow(), term.hist_srow()) + 1,
        term.hist_rows()
    );

    assert_eq!(term.ring_erow(), term.ring_rows() - 1);
    assert_eq!(term.ring_srow(), 0);

    // Check the different cols methods, which should all return the same answer
    assert!(term.disp_cols() > 10);
    assert_eq!(term.disp_cols(), term.ring_cols());
    assert_eq!(term.disp_cols(), term.hist_cols());

    // Redundant protected vs public methods:
    assert_eq!(term.disp_cols(), term.display_columns());
    assert_eq!(term.disp_rows(), term.display_rows());

    /// Local function to read back all rows from the display into a long string.
    /// Does not include scrollback history.
    /// Trims trailing blanks on each line
    fn read_disp(term: &Terminal) -> String {
        let rows = term.display_rows();
        let mut text: Vec<u8> = Vec::with_capacity((rows * 64) as usize);
        for row in 0..rows {
            let r = term.u8c_disp_row(row).trim();
            // Iterate through a row, accumulating [u8]
            for c in r.iter() {
                // Note: Sometimes utf-8 length is > 1
                text.extend_from_slice(c.text_utf8());
            }
            text.extend_from_slice(b"\n");
        }
        // Return the result as a string
        std::str::from_utf8(&text).unwrap().to_string()
    }

    term.clear();
    term.append("Top line  ↑ (up-arrow)");
    term.set_text_attrib(Attrib::Underline);
    term.append("  ");
    term.set_text_attrib(Attrib::Normal);
    term.append("  \n");
    let mut text_out = read_disp(term);
    // Trim trailing empty lines
    text_out = text_out.trim_end_matches(&"\n\n").to_string();
    // The two plain blanks at the end will be trimmed, the two underlined blanks will be retained.

    assert_eq!(text_out, "Top line  ↑ (up-arrow)  \n");
    let r = term.u8c_disp_row(0);
    assert_eq!(r.col(0).text_utf8(), b"T");
    assert_eq!(r.col(10).text_utf8(), b"\xe2\x86\x91"); // UTF-8 up-arrow
    assert_eq!(r.col(24).text_utf8(), b" "); // First blank after test text, NOT trimmed
    let r = term.u8c_disp_row(1);
    assert_eq!(r.col(0).text_utf8(), b" "); // Second row starts with blanks
    assert_eq!(r.col(1).text_utf8(), b" "); // Second row is full of blanks

    // Clear the screen again, then append test text, then read it back and compare
    let test_text = "The wind was a torrent of darkness among the gusty trees.
The moon was a ghostly galleon tossed upon cloudy seas.
The road was a ribbon of moonlight over the purple moor,
And the highwayman came riding—
            Riding—riding—
The highwayman came riding, up to the old inn-door.";

    term.clear_history();
    term.clear();
    let bg_save = term.text_bg_color();
    let fg_save = term.text_fg_color();
    term.set_text_bg_color(Color::DarkBlue); // Set spooky colors
    term.set_text_fg_color(Color::from_rgb(0x40, 0x40, 0xff));
    term.append(test_text);
    term.set_text_bg_color(bg_save);
    term.set_text_fg_color(fg_save);

    let mut text_out = read_disp(term);
    // Trim trailing empty lines
    text_out = text_out.trim_end_matches(&"\n\n").to_string();
    assert_eq!(test_text, text_out);

    assert_eq!(row_diff(ring_rows, term.disp_srow(), term.hist_erow()), 1);

    assert_eq!(term.ring_srow(), 0);
    assert_eq!(term.ring_erow(), ring_rows - 1);
    assert_eq!(
        row_diff(ring_rows, term.disp_erow(), term.disp_srow()) + 1,
        term.disp_rows()
    );
    assert_eq!(
        row_diff(ring_rows, term.hist_erow(), term.hist_srow()) + 1,
        term.hist_rows()
    );

    term.append(&format!(
        "\n\nScreen has {} rows of {} columns.\n",
        term.disp_rows(),
        term.disp_cols()
    ));
}

//--------------------------------------------------------------------------------------
/// Yet another set of tests for misc cursor functions and other stuff
/// Note: these tests depend heavily on the low-level "protected" parts of the fltk library, which should be used with caution.
fn mb_test5_cb(_choice: &mut fltk::menu::Choice, term: &mut Terminal) {
    term.take_focus().unwrap();

    // Test the attr_fg_color and attr_bg_color methods.
    // Put a single character 'A' into the buffer and check it
    term.clear(); // No reset_terminal(), just clear() to preserve the mouse selection for later
    term.set_text_bg_color(Color::TransparentBg);
    term.set_text_fg_color(Color::XtermWhite);
    term.append("A");
    let r = &term.u8c_disp_row(0);
    let uc = r.col(0);
    assert_eq!(uc.text_utf8(), b"A");
    assert_eq!(&uc.attr_fgcolor(None), &Color::XtermWhite);
    assert_eq!(&uc.attr_bgcolor(None), &Color::TransparentBg);
    assert_eq!(&uc.attr_bgcolor(Some(term)), &Color::Black);
    assert_eq!(&uc.attr_fgcolor(Some(term)), &Color::XtermWhite);
    assert_eq!(&uc.attrib(), &Attrib::Normal);

    // Put a short string "BCD" into the first line of the buffer, with fg color change after the 'B' and bold after 'C'
    term.clear();
    term.set_text_fg_color_xterm(fltk::group::experimental::XtermColor::White);
    term.set_text_bg_color_xterm(fltk::group::experimental::XtermColor::Black);
    assert_eq!(term.text_attrib(), Attrib::Normal);

    assert!(term.ansi());
    term.append("B\x1b[32mC\x1b[1mD\n");

    let r = &term.u8c_disp_row(0);
    let uc = r.col(0);
    assert_eq!(uc.text_utf8(), b"B");
    assert!(uc.is_char(b'B'));
    assert!(!uc.is_char(b'A'));
    assert_eq!(&uc.fgcolor(), &Color::XtermWhite);
    assert_eq!(&uc.bgcolor(), &Color::XtermBlack);
    assert_eq!(&uc.attr_fgcolor(None), &Color::XtermWhite);
    assert_eq!(&uc.attr_bgcolor(None), &Color::XtermBlack);
    assert_eq!(
        &uc.charflags(),
        &(CharFlags::FG_XTERM | CharFlags::BG_XTERM)
    );

    let uc = r.col(1);
    assert_eq!(uc.text_utf8(), b"C");
    assert!(uc.is_char(b'C'));
    assert_eq!(&uc.fgcolor(), &Color::XtermGreen);
    assert_eq!(&uc.bgcolor(), &Color::XtermBlack);
    assert_eq!(&uc.attr_fgcolor(None), &Color::XtermGreen);
    assert_eq!(&uc.attr_bgcolor(None), &Color::XtermBlack);
    assert_eq!(
        &uc.charflags(),
        &(CharFlags::FG_XTERM | CharFlags::BG_XTERM)
    );

    let uc = r.col(2);
    assert_eq!(uc.text_utf8(), b"D");
    assert!(uc.is_char(b'D'));
    assert_eq!(&uc.fgcolor(), &Color::XtermGreen);
    assert_eq!(&uc.bgcolor(), &Color::XtermBlack);
    assert_eq!(&uc.attr_fgcolor(None), &Color::from_rgb(0x20, 0xf0, 0x20));
    assert_eq!(&uc.attr_bgcolor(None), &Color::from_rgb(0x20, 0x20, 0x20));
    assert_eq!(
        &uc.attr_fgcolor(Some(term)),
        &Color::from_rgb(0x20, 0xf0, 0x20)
    );
    assert_eq!(&uc.attr_bgcolor(None), &Color::from_rgb(0x20, 0x20, 0x20));
    assert_eq!(
        &uc.charflags(),
        &(CharFlags::FG_XTERM | CharFlags::BG_XTERM)
    );

    // Put a short string "BCDE" into the buffer, with fg color change after the 'B', bg change after 'C', and bold after 'D'
    term.clear();
    term.set_text_fg_color_xterm(fltk::group::experimental::XtermColor::White);
    term.set_text_bg_color_xterm(fltk::group::experimental::XtermColor::Black);
    term.set_text_attrib(Attrib::Normal);
    assert_eq!(term.text_attrib(), Attrib::Normal);

    assert!(term.ansi());
    term.append("B\x1b[37mC\x1b[44mD\x1b[1mE\n");

    let r = &term.u8c_disp_row(0);
    let uc = r.col(0);
    assert_eq!(uc.text_utf8(), b"B");
    assert!(uc.is_char(b'B'));
    assert!(!uc.is_char(b'A'));
    assert_eq!(&uc.fgcolor(), &Color::XtermWhite);
    assert_eq!(&uc.bgcolor(), &Color::XtermBlack);
    assert_eq!(&uc.attr_fgcolor(None), &Color::XtermWhite);
    assert_eq!(&uc.attr_bgcolor(None), &Color::XtermBlack);
    assert_eq!(
        &uc.charflags(),
        &(CharFlags::FG_XTERM | CharFlags::BG_XTERM)
    );

    let uc = r.col(1);
    assert_eq!(uc.text_utf8(), b"C");
    assert!(uc.is_char(b'C'));
    assert_eq!(&uc.fgcolor(), &Color::XtermWhite);
    assert_eq!(&uc.bgcolor(), &Color::XtermBlack);
    assert_eq!(&uc.attr_fgcolor(None), &Color::XtermWhite);
    assert_eq!(&uc.attr_bgcolor(None), &Color::XtermBlack);
    assert_eq!(
        &uc.charflags(),
        &(CharFlags::FG_XTERM | CharFlags::BG_XTERM)
    );

    let uc = r.col(2);
    assert_eq!(uc.text_utf8(), b"D");
    assert!(uc.is_char(b'D'));
    assert_eq!(&uc.fgcolor(), &Color::XtermWhite);
    assert_eq!(&uc.bgcolor(), &Color::XtermBgBlue);
    assert_eq!(&uc.attr_fgcolor(None), &Color::XtermWhite);
    assert_eq!(&uc.attr_bgcolor(None), &Color::XtermBgBlue);
    assert_eq!(
        &uc.charflags(),
        &(CharFlags::FG_XTERM | CharFlags::BG_XTERM)
    );

    let uc = r.col(3);
    assert_eq!(uc.text_utf8(), b"E");
    assert!(uc.is_char(b'E'));
    assert_eq!(&uc.fgcolor(), &Color::XtermWhite);
    assert_eq!(&uc.bgcolor(), &Color::XtermBgBlue);
    assert_eq!(&uc.attr_fgcolor(None), &Color::from_hex(0xf0f0f0));
    assert_eq!(&uc.attr_bgcolor(None), &Color::from_hex(0x2020e0));
    assert_eq!(
        &uc.charflags(),
        &(CharFlags::FG_XTERM | CharFlags::BG_XTERM)
    );

    // Test some miscellaneous Utf8 constants
    assert_eq!(uc.length(), 1);
    assert_eq!(uc.max_utf8(), 4);
    assert_eq!(uc.pwidth(), 8.0);
    assert_eq!(uc.pwidth_int(), 8);

    term.set_text_fg_color_xterm(fltk::group::experimental::XtermColor::White);
    term.set_text_bg_color_xterm(fltk::group::experimental::XtermColor::Black);
    term.clear();
    term.set_text_attrib(Attrib::Normal);

    // Mouse selection functions
    term.append(&format!("Mouse selection: {:?}\n", &term.get_selection()));
    term.clear_mouse_selection();
    assert_eq!(term.get_selection(), None);

    // Play with cursor position
    term.append("0123456789\n"); // Set up test pattern
    term.append("ABCDEFGHIJ\n");
    term.append("abcdefghij\n");

    term.set_cursor_row(1);
    assert_eq!(term.cursor_row(), 1);
    term.set_cursor_col(1);
    assert_eq!(term.cursor_col(), 1);
    assert_eq!(term.u8c_cursor().text_utf8(), b"1");

    term.append("----"); // Overwrites text at cursor and moves cursor forward
    assert_eq!(term.cursor_row(), 1);
    assert_eq!(term.cursor_col(), 5);
    assert_eq!(term.u8c_cursor().text_utf8(), b"5");
    term.set_cursor_col(1);
    assert_eq!(term.u8c_cursor().text_utf8(), b"-"); // Overwritten text

    term.cursor_up(1, false);
    assert_eq!(term.cursor_row(), 0);
    assert_eq!(term.cursor_col(), 1);
    assert_eq!(term.u8c_cursor().text_utf8(), b"o");

    // Hit top of screen, so nothing happens
    term.cursor_up(1, false);
    assert_eq!(term.cursor_row(), 0);
    assert_eq!(term.cursor_col(), 1);
    assert_eq!(term.u8c_cursor().text_utf8(), b"o");

    // Hit top of screen with scroll enabled. A blank line from history is scrolled in.
    term.cursor_up(1, true);
    assert_eq!(term.cursor_row(), 0);
    assert_eq!(term.cursor_col(), 1);
    assert_eq!(term.u8c_cursor().text_utf8(), b" ");

    // Go back down to the overwritten text
    term.cursor_down(2, false);
    assert_eq!(term.cursor_row(), 2);
    assert_eq!(term.cursor_col(), 1);
    assert_eq!(term.u8c_cursor().text_utf8(), b"-");

    // Go right past the overwritten text
    term.cursor_right(4, false);
    assert_eq!(term.cursor_row(), 2);
    assert_eq!(term.cursor_col(), 5);
    assert_eq!(term.u8c_cursor().text_utf8(), b"5");

    // Go left to the end of the overwritten text
    term.cursor_left(1);
    assert_eq!(term.cursor_row(), 2);
    assert_eq!(term.cursor_col(), 4);
    assert_eq!(term.u8c_cursor().text_utf8(), b"-");

    // Scroll back down, removing the blank line at the top.
    // Cursor stays in place, the text moves under it.
    term.scroll(1);
    assert_eq!(term.cursor_row(), 2);
    assert_eq!(term.cursor_col(), 4);
    assert_eq!(term.u8c_cursor().text_utf8(), b"E");

    // Clear from here to end-of-line
    term.clear_eol();
    assert_eq!(term.cursor_row(), 2);
    assert_eq!(term.cursor_col(), 4);
    assert_eq!(term.u8c_cursor().text_utf8(), b" ");

    // Now clear from here to start-of-line. Cursor does not move.
    term.clear_sol();
    assert_eq!(term.cursor_row(), 2);
    assert_eq!(term.cursor_col(), 4);
    assert_eq!(term.u8c_cursor().text_utf8(), b" ");
    term.cursor_left(1);
    assert_eq!(term.u8c_cursor().text_utf8(), b" ");
    term.set_cursor_col(0);
    assert_eq!(term.u8c_cursor().text_utf8(), b" ");

    // Clear some lines
    term.clear_line(1);
    assert_eq!(term.cursor_row(), 2);
    assert_eq!(term.cursor_col(), 0);
    term.set_cursor_row(1);
    assert_eq!(term.u8c_cursor().text_utf8(), b" ");
    term.set_cursor_row(3);
    term.clear_cur_line();
    assert_eq!(term.u8c_cursor().text_utf8(), b" ");
    assert_eq!(term.cursor_row(), 3);
    assert_eq!(term.cursor_col(), 0);

    term.append("Two lines above are intentionally left blank.\n");
    assert_eq!(term.cursor_row(), 4);
    assert_eq!(term.cursor_col(), 0);

    // Set up the test pattern again, then play with insert/delete
    term.append("0123456789\n");
    term.append("ABCDEFGHIJ\n");
    term.append("abcdefghij\n");
    assert_eq!(term.cursor_row(), 7);

    term.set_cursor_row(4);
    term.set_cursor_col(4);
    assert_eq!(term.u8c_cursor().text_utf8(), b"4");

    term.insert_char('x', 5); // Push this row right 5 chars starting at col 4
    assert_eq!(term.u8c_cursor().text_utf8(), b"x");
    term.cursor_right(5, false);
    assert_eq!(term.cursor_col(), 9);
    assert_eq!(term.u8c_cursor().text_utf8(), b"4");

    // Insert two blank rows above cursor. Cursor stays put.
    term.insert_rows(2);
    assert_eq!(term.cursor_row(), 4);
    assert_eq!(term.cursor_col(), 9);
    assert_eq!(term.u8c_cursor().text_utf8(), b" ");
    term.cursor_down(2, false); // Go down to find our text again
    assert_eq!(term.u8c_cursor().text_utf8(), b"4");

    // Go back to the beginning of the inserted 'x' characters and delete them.
    term.cursor_left(5);
    assert_eq!(term.u8c_cursor().text_utf8(), b"x");
    term.delete_cur_chars(5);
    assert_eq!(term.cursor_row(), 6);
    assert_eq!(term.cursor_col(), 4);
    assert_eq!(term.u8c_cursor().text_utf8(), b"4");

    term.delete_chars(7, 2, 2); // Delete "CD" from the next row
    term.cursor_down(1, false);
    term.cursor_left(2);
    assert_eq!(term.u8c_cursor().text_utf8(), b"E");

    term.delete_rows(1); // Middle row of pattern is gone, cursor stays put
    assert_eq!(term.u8c_cursor().text_utf8(), b"c");
    term.cursor_up(1, false);
    term.delete_rows(2); // Delete remains of test pattern

    term.set_text_attrib(Attrib::Bold);
    term.insert_char_eol('-', 3, 15, 20);
    term.set_cursor_row(3);
    term.set_cursor_col(15);
    assert_eq!(term.u8c_cursor().text_utf8(), b"-"); // Check the insertion
    assert_eq!(term.u8c_cursor().attrib(), Attrib::Bold);

    term.set_text_attrib(Attrib::Italic);
    term.append(" and all lines below");
    term.set_text_attrib(Attrib::Normal);
    term.cursor_down(1, false);
}
source

pub const fn from_rgba(r: u8, g: u8, b: u8, a: u8) -> Color

Available on crate feature enable-glwindow only.

Returns a color from RGB

source

pub const fn from_rgbi(rgbi: u32) -> Color

Returns a color enum from RGBI encoding

source

pub fn from_rgba_tuple(tup: (u8, u8, u8, u8)) -> Color

Create color from RGBA using alpha compositing. Works for non-group types.

source

pub const fn from_u32(val: u32) -> Color

Returns a color from hex or decimal

Examples found in repository?
examples/frames.rs (line 14)
9
10
11
12
13
14
15
16
17
18
19
    pub fn new(idx: usize) -> MyFrame {
        let mut f = frame::Frame::default();
        // Normally you would use the FrameType enum, for example:
        // some_widget.set_frame(FrameType::DownBox);
        f.set_frame(enums::FrameType::by_index(idx));
        f.set_color(enums::Color::from_u32(0x7FFFD4));
        let f_name = format!("{:?}", f.frame());
        f.set_label(&f_name);
        f.set_label_size(12);
        Self { f }
    }
More examples
Hide additional examples
examples/custom_dial.rs (line 70)
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
fn main() {
    let app = app::App::default();
    app::background(255, 255, 255);
    let mut win = window::Window::default().with_size(400, 300);
    let mut dial = MyDial::new(100, 100, 200, 200, "CPU Load %");
    dial.set_label_size(22);
    dial.set_label_color(Color::from_u32(0x797979));
    win.end();
    win.show();

    // get the cpu load value from somewhere, then call dial.set_value() in a callback or event loop
    dial.set_value(10);

    app.run().unwrap();
}
examples/table.rs (line 66)
63
64
65
66
67
68
69
70
71
72
73
74
75
76
fn draw_data(txt: &str, x: i32, y: i32, w: i32, h: i32, selected: bool) {
    draw::push_clip(x, y, w, h);
    if selected {
        draw::set_draw_color(enums::Color::from_u32(0x00D3_D3D3));
    } else {
        draw::set_draw_color(enums::Color::White);
    }
    draw::draw_rectf(x, y, w, h);
    draw::set_draw_color(enums::Color::Gray0);
    draw::set_font(enums::Font::Helvetica, 14);
    draw::draw_text2(txt, x, y, w, h, enums::Align::Center);
    draw::draw_rect(x, y, w, h);
    draw::pop_clip();
}
examples/editor2.rs (line 80)
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
    pub fn new(buf: text::TextBuffer) -> Self {
        let mut editor = text::TextEditor::new(5, 35, 790, 560, "");
        editor.set_buffer(Some(buf));

        #[cfg(target_os = "macos")]
        editor.resize(5, 5, 790, 590);

        editor.set_scrollbar_size(15);
        editor.set_text_font(Font::Courier);
        editor.set_linenumber_width(32);
        editor.set_linenumber_fgcolor(Color::from_u32(0x008b_8386));
        editor.set_trigger(CallbackTrigger::Changed);

        Self { editor }
    }
examples/spreadsheet.rs (line 132)
129
130
131
132
133
134
135
136
137
138
139
140
141
142
    fn draw_data(txt: &str, x: i32, y: i32, w: i32, h: i32, selected: bool) {
        draw::push_clip(x, y, w, h);
        if selected {
            draw::set_draw_color(enums::Color::from_u32(0x00D3_D3D3));
        } else {
            draw::set_draw_color(enums::Color::White);
        }
        draw::draw_rectf(x, y, w, h);
        draw::set_draw_color(enums::Color::Gray0);
        draw::set_font(enums::Font::Helvetica, 14);
        draw::draw_text2(txt, x, y, w, h, enums::Align::Center);
        draw::draw_rect(x, y, w, h);
        draw::pop_clip();
    }
examples/composite_widgets.rs (line 12)
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
    pub fn new(w: i32, h: i32) -> MyButton {
        let mut grp = group::Group::new(0, 0, w, h, None);
        grp.set_frame(enums::FrameType::RFlatBox);
        grp.set_color(enums::Color::from_u32(0x01579b));
        grp.set_align(enums::Align::Center);
        let mut btn = button::Button::new(grp.x() + 420, grp.y() + 35, 30, 25, "@1+");
        btn.set_frame(enums::FrameType::OFlatFrame);
        btn.set_color(enums::Color::from_u32(0xf49da9));
        btn.set_callback(move |b| b.parent().unwrap().hide());
        grp.end();
        grp.handle(|g, ev| match ev {
            enums::Event::Push => {
                g.do_callback();
                true
            }
            _ => false,
        });
        MyButton { grp }
    }
source

pub const fn from_hex(val: u32) -> Color

Returns a color from hex or decimal

Examples found in repository?
examples/counter3.rs (line 7)
7
8
9
const BLUE: Color = Color::from_hex(0x42A5F5);
const SEL_BLUE: Color = Color::from_hex(0x3f51b5);
const GRAY: Color = Color::from_hex(0x757575);
More examples
Hide additional examples
examples/calculator2.rs (line 43)
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
    pub fn new(title: &'static str) -> MyButton {
        let mut b = Button::new(0, 0, 100, 0, title);
        b.set_label_size(24);
        b.set_frame(FrameType::FlatBox);
        match title {
            "CE" => {
                b.set_color(Color::from_hex(0xd50000));
                b.set_shortcut(Shortcut::None | Key::Delete);
            }
            "x" | "/" | "+" | "-" | "=" | "C" | "@<-" => {
                b.set_color(Color::from_hex(0xffee58));
                b.set_label_color(Color::Black);
                let shortcut = if title == "x" {
                    '*'
                } else {
                    title.chars().next().unwrap()
                };
                b.set_shortcut(Shortcut::None | shortcut);
                if shortcut == '@' {
                    b.set_shortcut(Shortcut::None | Key::BackSpace);
                }
                if shortcut == '=' {
                    b.set_shortcut(Shortcut::None | Key::Enter);
                }
            }
            _ => {
                if title == "0" {
                    b.resize(0, 0, 100 * 2, 0);
                }
                b.set_label_color(Color::White);
                b.set_selection_color(Color::from_hex(0x1b1b1b));
                b.set_shortcut(Shortcut::None | title.chars().next().unwrap());
                b.handle(move |b, ev| match ev {
                    Event::Enter => {
                        b.set_color(Color::from_hex(0x2b2b2b));
                        b.redraw();
                        true
                    }
                    Event::Leave => {
                        b.set_color(Color::from_hex(0x424242));
                        b.redraw();
                        true
                    }
                    _ => false,
                });
            }
        }
        Self { b }
    }
}

impl Deref for MyButton {
    type Target = Button;

    fn deref(&self) -> &Self::Target {
        &self.b
    }
}

impl DerefMut for MyButton {
    fn deref_mut(&mut self) -> &mut Self::Target {
        &mut self.b
    }
}

fn main() {
    let app = app::App::default();
    app::set_visible_focus(false);
    app::background(0x42, 0x42, 0x42);

    let win_w = 400;
    let win_h = 500;
    let but_row = 160;

    let mut operation = Ops::None;
    let mut txt = String::from("0");
    let mut old_val = String::from("0");
    let mut new_val: String;

    let mut wind = Window::default()
        .with_label("FLTK Calc")
        .with_size(win_w, win_h)
        .center_screen();

    let mut out = Frame::new(0, 0, win_w, 160, "").with_align(Align::Right | Align::Inside);
    out.set_color(Color::from_hex(0x1b1b1b));
    out.set_frame(FrameType::FlatBox);
    out.set_label_color(Color::White);
    out.set_label_size(36);
    out.set_label("0");

    let vpack = Pack::new(0, but_row, win_w, win_h - 170, "");

    let mut hpack = Pack::new(0, 0, win_w, 68, "");
    let but_ce = MyButton::new("CE");
    let but_c = MyButton::new("C");
    let but_back = MyButton::new("@<-");
    let but_div = MyButton::new("/");
    hpack.end();
    hpack.set_type(PackType::Horizontal);

    let mut hpack = Pack::new(0, 0, win_w, 68, "");
    let mut but7 = MyButton::new("7");
    let mut but8 = MyButton::new("8");
    let mut but9 = MyButton::new("9");
    let but_mul = MyButton::new("x");
    hpack.end();
    hpack.set_type(PackType::Horizontal);

    let mut hpack = Pack::new(0, 0, win_w, 68, "");
    let mut but4 = MyButton::new("4");
    let mut but5 = MyButton::new("5");
    let mut but6 = MyButton::new("6");
    let but_sub = MyButton::new("-");
    hpack.end();
    hpack.set_type(PackType::Horizontal);

    let mut hpack = Pack::new(0, 0, win_w, 68, "");
    let mut but1 = MyButton::new("1");
    let mut but2 = MyButton::new("2");
    let mut but3 = MyButton::new("3");
    let but_add = MyButton::new("+");
    hpack.end();
    hpack.set_type(PackType::Horizontal);

    let mut hpack = Pack::new(0, 0, win_w, 68, "");
    let mut but_dot = MyButton::new(".");
    let mut but0 = MyButton::new("0");
    let but_eq = MyButton::new("=");
    hpack.end();
    hpack.set_type(PackType::Horizontal);

    vpack.end();

    wind.make_resizable(false);
    wind.end();
    wind.show();

    app::set_focus(&*but1);
    app::get_system_colors();

    let but_vec = vec![
        &mut but1, &mut but2, &mut but3, &mut but4, &mut but5, &mut but6, &mut but7, &mut but8,
        &mut but9, &mut but0,
    ];

    let but_op_vec = vec![
        but_add, but_sub, but_mul, but_div, but_c, but_ce, but_back, but_eq,
    ];

    let (s, r) = app::channel::<Message>();

    for but in but_vec {
        let label = but.label();
        but.emit(s, Message::Number(label.parse().unwrap()));
    }

    for mut but in but_op_vec {
        let op = match but.label().as_str() {
            "+" => Ops::Add,
            "-" => Ops::Sub,
            "x" => Ops::Mul,
            "/" => Ops::Div,
            "=" => Ops::Eq,
            "CE" => Ops::CE,
            "C" => Ops::C,
            "@<-" => Ops::Back,
            _ => Ops::None,
        };
        but.emit(s, Message::Op(op));
    }

    but_dot.emit(s, Message::Dot);

    while app.wait() {
        if let Some(val) = r.recv() {
            match val {
                Message::Number(num) => {
                    if out.label() == "0" {
                        txt.clear();
                    }
                    txt.push_str(&num.to_string());
                    out.set_label(txt.as_str());
                }
                Message::Dot => {
                    if operation == Ops::Eq {
                        txt.clear();
                        operation = Ops::None;
                        out.set_label("0.");
                        txt.push_str("0.");
                    }
                    if !txt.contains('.') {
                        txt.push('.');
                        out.set_label(txt.as_str());
                    }
                }
                Message::Op(op) => match op {
                    Ops::Add | Ops::Sub | Ops::Div | Ops::Mul => {
                        old_val.clear();
                        old_val.push_str(&out.label());
                        operation = op;
                        out.set_label("0");
                    }
                    Ops::Back => {
                        let val = out.label();
                        txt.pop();
                        if val.len() > 1 {
                            out.set_label(txt.as_str());
                        } else {
                            out.set_label("0");
                        }
                    }
                    Ops::CE => {
                        txt.clear();
                        old_val.clear();
                        txt.push('0');
                        out.set_label(txt.as_str());
                    }
                    Ops::C => {
                        txt.clear();
                        txt.push('0');
                        out.set_label(txt.as_str());
                    }
                    Ops::Eq => {
                        new_val = out.label();
                        let old: f64 = old_val.parse().unwrap();
                        let new: f64 = new_val.parse().unwrap();
                        let val = match operation {
                            Ops::Div => old / new,
                            Ops::Mul => old * new,
                            Ops::Add => old + new,
                            Ops::Sub => old - new,
                            _ => new,
                        };
                        operation = Ops::None;
                        txt = String::from("0");
                        out.set_label(&val.to_string());
                    }
                    _ => (),
                },
            }
        }
    }
}
examples/terminal.rs (line 144)
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
fn main() {
    let app = fltk::app::App::default();

    // Set panic handler for main thread (will become UI thread)
    std::panic::set_hook(Box::new({
        |e| {
            eprintln!("!!!!PANIC!!!!{:#?}", e);
            error_box(e.to_string()); // Only works from the UI thread
            std::process::exit(2);
        }
    }));

    let mut main_win = Window::new(
        2285,
        180,
        WIN_WIDTH,
        WIN_HEIGHT,
        "FLTK/Terminal Rust wrapper test",
    );
    main_win.set_type(WindowType::Double);
    main_win.make_resizable(true);

    let mut menu_bar = MenuBar::new(0, 0, WIN_WIDTH, 30, None);

    let mut term = Terminal::new(0, 30, WIN_WIDTH, WIN_HEIGHT - 30, None);
    term.set_label("term");
    main_win.resizable(&term);
    term.set_label_type(LabelType::None);

    let idx = menu_bar.add_choice("Test&1");
    menu_bar.at(idx).unwrap().set_callback({
        let mut term1 = term.clone();
        move |c| mb_test1_cb(c, &mut term1)
    });
    menu_bar
        .at(idx)
        .unwrap()
        .set_shortcut(unsafe { std::mem::transmute(0x80031) }); // Alt-1

    let idx = menu_bar.add_choice("Test&2");
    menu_bar.at(idx).unwrap().set_callback({
        let mut term1 = term.clone();
        move |c| mb_test2_cb(c, &mut term1)
    });
    menu_bar
        .at(idx)
        .unwrap()
        .set_shortcut(unsafe { std::mem::transmute(0x80032) }); // Alt-2

    let idx = menu_bar.add_choice("Test&3");
    menu_bar.at(idx).unwrap().set_callback({
        let mut term1 = term.clone();
        move |c| mb_test3_cb(c, &mut term1)
    });
    menu_bar
        .at(idx)
        .unwrap()
        .set_shortcut(unsafe { std::mem::transmute(0x80033) }); // Alt-3

    let idx = menu_bar.add_choice("Test&4");
    menu_bar.at(idx).unwrap().set_callback({
        let mut term1 = term.clone();
        move |c| mb_test4_cb(c, &mut term1)
    });
    menu_bar
        .at(idx)
        .unwrap()
        .set_shortcut(unsafe { std::mem::transmute(0x80034) }); // Alt-4

    let idx = menu_bar.add_choice("Test&5");
    menu_bar.at(idx).unwrap().set_callback({
        let mut term1 = term.clone();
        move |c| mb_test5_cb(c, &mut term1)
    });
    menu_bar
        .at(idx)
        .unwrap()
        .set_shortcut(unsafe { std::mem::transmute(0x80035) }); // Alt-5

    menu_bar.end();

    main_win.end();
    main_win.show();

    // Worker thread that drives the startup tests
    let _worker_thread: std::thread::JoinHandle<_> = std::thread::spawn({
        let mut term = term.clone();
        move || {
            println!("Startup tests\n");
            term.append("Startup tests\n\n");

            // Testing ansi() and set_ansi() methods
            assert!(term.ansi(), "Default ANSI mode should be ON at startup");
            term.append("ANSI mode is \x1b[4mON\x1b[0m\n");
            term.set_ansi(false);
            assert!(!term.ansi());
            term.append("ANSI mode is \x1b[4mOFF\x1b[0m\n");
            // append() method is already being used/tested. Test the u8, ascii, and utf8 variants
            term.append_u8(b"Appending u8 array\n");
            term.append_ascii("Appending ASCII array ↑ (up-arrow is dropped)\n");
            term.set_ansi(true); // Restore ANSI state

            // Test show_unknown() as incidental part of testing append methods
            term.set_show_unknown(true);
            assert!(term.show_unknown());
            term.append_ascii(
                "Appending ASCII array with show_unknown() ↑ (up-arrow is three unknown bytes)\n",
            );
            term.set_show_unknown(false);
            assert!(!term.show_unknown());

            term.append_utf8("Appending UTF8 array ↑ (up-arrow is visible)\n");
            term.append_utf8_u8(b"Appending UTF8 array as u8 \xe2\x86\x91 (up-arrow is visible)\n");

            let r = term.cursor_row();
            assert_eq!(term.cursor_col(), 0);
            term.append(&format!("Testing cursor row/col {r}"));
            assert_eq!(term.cursor_col(), 24);
            assert_eq!(term.cursor_row(), r);

            // Test cursor color methods
            assert_eq!(
                term.cursor_bg_color(),
                Color::XtermGreen,
                "Default cursor bg at startup"
            );
            assert_eq!(
                term.cursor_fg_color(),
                Color::from_hex(0xff_ff_f0),
                "Default cursor fg at startup"
            );
            term.set_cursor_bg_color(Color::Red);
            assert_eq!(term.cursor_bg_color(), Color::Red);
            assert_eq!(term.cursor_fg_color(), Color::from_hex(0xff_ff_f0));
            term.set_cursor_fg_color(Color::Blue);
            assert_eq!(term.cursor_bg_color(), Color::Red);
            assert_eq!(term.cursor_fg_color(), Color::Blue);
            term.set_cursor_bg_color(Color::XtermGreen); // Restore the defaults
            term.set_cursor_fg_color(Color::from_hex(0xff_ff_f0));
            assert_eq!(term.cursor_bg_color(), Color::XtermGreen);
            assert_eq!(term.cursor_fg_color(), Color::from_hex(0xff_ff_f0));

            // The default display_rows() will derive from the window size
            let dr = term.display_rows();
            assert!(dr > 20, "Default display_rows at startup");
            term.set_display_rows(60);
            assert_eq!(term.display_rows(), 60);
            term.set_display_rows(dr); // Set back to default
            assert_eq!(term.display_rows(), dr);

            // The default display_columns() will derive from the window size
            let dc = term.display_columns();
            assert!(dc > 80, "Default display_rows at startup");
            term.set_display_columns(200);
            assert_eq!(term.display_columns(), 200);
            term.append("\n         1         2         3         4         5         6         7         8         9");
            term.append("\n123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890");
            term.append("[This text should be truncated by display_columns() call below.]\n"); // We shouldn't see this on screen
            term.set_display_columns(90);
            assert_eq!(term.display_columns(), 90);
            term.set_display_columns(dc); // Set back to default
            assert_eq!(term.display_columns(), dc);

            let hl = term.history_lines();
            assert_eq!(hl, 100, "Default history_lines at startup");
            term.set_history_lines(60);
            assert_eq!(term.history_lines(), 60);
            term.set_history_lines(hl); // Set back to default
            assert_eq!(term.history_lines(), hl);

            // Is history_rows() an alias for history_lines()?
            assert_eq!(term.history_rows(), 100, "Default history_rows at startup");
            term.set_history_rows(50);
            assert_eq!(term.history_rows(), 50);
            term.set_history_lines(100); // Set back to default
            assert_eq!(term.history_lines(), 100);

            let hu = term.history_use();
            term.append(&format!(
                "history_use = {hu} (it's not clear what this means)\n"
            ));
            // assert_eq!(term.history_use(), hu+1);

            term.append(&format!(
                "margins = b:{} l:{} r:{} t{}\n",
                term.margin_bottom(),
                term.margin_left(),
                term.margin_right(),
                term.margin_top()
            ));
            assert_eq!(term.margin_bottom(), 3);
            assert_eq!(term.margin_left(), 3);
            assert_eq!(term.margin_right(), 3);
            assert_eq!(term.margin_top(), 3);

            term.set_margin_bottom(5);
            term.set_margin_left(10);
            term.set_margin_right(15);
            term.set_margin_top(20);
            assert_eq!(term.margin_bottom(), 5);
            assert_eq!(term.margin_left(), 10);
            assert_eq!(term.margin_right(), 15);
            assert_eq!(term.margin_top(), 20);

            term.append("Single character: '");
            term.print_char('X');
            term.append("', single UTF-8 character: '");
            term.print_char_utf8('↑');
            term.append("'\n");

            let rr = term.redraw_rate();
            assert_eq!(rr, 0.1, "Default redraw rate at startup");
            term.append(&format!("Redraw rate {rr}\n"));
            term.set_redraw_rate(1.0);
            assert_eq!(term.redraw_rate(), 1.0);
            term.set_redraw_rate(rr);
            assert_eq!(term.redraw_rate(), rr);

            let rs = term.redraw_style();
            term.append(&format!("Redraw style {rs:?}\n"));
            assert_eq!(
                rs,
                RedrawStyle::RateLimited,
                "Default redraw style at startup"
            );
            term.set_redraw_style(RedrawStyle::NoRedraw);
            assert_eq!(term.redraw_style(), RedrawStyle::NoRedraw);
            term.set_redraw_style(rs);
            assert_eq!(term.redraw_style(), rs);

            // Sanity checks: enum values are implicitly assigned in the C++ code so could change unexpectedly
            assert_eq!(
                RedrawStyle::NoRedraw.bits(),
                0x0000,
                "RedrawStyle enum values have been reassigned"
            );
            assert_eq!(
                RedrawStyle::RateLimited.bits(),
                0x0001,
                "RedrawStyle enum values have been reassigned"
            );
            assert_eq!(
                RedrawStyle::PerWrite.bits(),
                0x0002,
                "RedrawStyle enum values have been reassigned"
            );

            term.append(&format!(
                "Scrollbar actual size {}\n",
                term.scrollbar_actual_size()
            ));
            assert_eq!(term.scrollbar_actual_size(), 16);
            term.append(&format!("Scrollbar size {}\n", term.scrollbar_size()));
            assert_eq!(
                term.scrollbar_size(),
                0,
                "Default scrollbar size at startup"
            );
            term.set_scrollbar_size(40);
            assert_eq!(term.scrollbar_size(), 40);
            assert_eq!(term.scrollbar_actual_size(), 40);
            term.append(&format!(
                "Scrollbar actual size {}\n",
                term.scrollbar_actual_size()
            ));
            term.set_scrollbar_size(0); // Restore default
            assert_eq!(term.scrollbar_size(), 0);
            assert_eq!(term.scrollbar_actual_size(), 16);

            let sfc = term.selection_fg_color();
            let sbc = term.selection_bg_color();
            assert_eq!(sfc, Color::Black);
            assert_eq!(sbc, Color::White);
            term.append(&format!("Selection colors: {sfc} {sbc}\n"));
            term.set_selection_fg_color(Color::Green);
            term.set_selection_bg_color(Color::DarkBlue);
            assert_eq!(term.selection_fg_color(), Color::Green);
            assert_eq!(term.selection_bg_color(), Color::DarkBlue);
            term.set_selection_fg_color(sfc);
            term.set_selection_bg_color(sbc);
            assert_eq!(term.selection_fg_color(), Color::Black);
            assert_eq!(term.selection_bg_color(), Color::White);

            let tfcd = term.text_fg_color_default();
            let tbcd = term.text_bg_color_default();
            assert_eq!(tfcd, Color::XtermWhite);
            assert_eq!(tbcd, Color::TransparentBg);
            term.append(&format!("Default text colors: {sfc} {sbc}\n"));
            term.set_text_fg_color_default(Color::Green);
            term.set_text_bg_color_default(Color::DarkBlue);
            assert_eq!(term.text_fg_color_default(), Color::Green);
            assert_eq!(term.text_bg_color_default(), Color::DarkBlue);
            term.set_text_fg_color_default(tfcd);
            term.set_text_bg_color_default(tbcd);
            assert_eq!(term.text_fg_color_default(), Color::XtermWhite);
            assert_eq!(term.text_bg_color_default(), Color::TransparentBg);

            let tfc = term.text_fg_color();
            let tbc = term.text_bg_color();
            assert_eq!(tfc, Color::XtermWhite);
            assert_eq!(tbc, Color::TransparentBg);
            term.append(&format!("Text colors: {sfc} {sbc}\n"));
            term.set_text_fg_color(Color::Green);
            term.set_text_bg_color(Color::DarkBlue);
            assert_eq!(term.text_fg_color(), Color::Green);
            assert_eq!(term.text_bg_color(), Color::DarkBlue);
            term.set_text_fg_color(tfc);
            term.set_text_bg_color(tbc);
            assert_eq!(term.text_fg_color(), Color::XtermWhite);
            assert_eq!(term.text_bg_color(), Color::TransparentBg);

            let tf = term.text_font();
            term.append(&format!("Text font: {tf:?}\n"));
            assert_eq!(tf, Font::Courier);
            term.set_text_font(Font::Screen);
            assert_eq!(term.text_font(), Font::Screen);
            term.set_text_font(tf);
            assert_eq!(term.text_font(), Font::Courier);

            let ts = term.text_size();
            term.append(&format!("Text size: {ts}\n"));
            assert_eq!(ts, 14);
            term.set_text_size(30);
            assert_eq!(term.text_size(), 30);
            term.set_text_size(ts);
            assert_eq!(term.text_size(), ts);

            // Keyboard handler
            term.handle({
                move |term, e| {
                    match e {
                        fltk::enums::Event::KeyDown
                            if fltk::app::event_key() == fltk::enums::Key::Escape =>
                        {
                            // false to let FLTK handle ESC. true to hide ESC
                            false
                        }

                        fltk::enums::Event::KeyDown
                            if fltk::app::event_length() == 1 && fltk::app::is_event_ctrl() =>
                        {
                            // We handle control keystroke
                            let k = fltk::app::event_text();
                            term.append_utf8(&k);
                            true
                        }

                        fltk::enums::Event::KeyDown
                            if fltk::app::event_length() == 1 && !fltk::app::is_event_alt() =>
                        {
                            // We handle normal printable keystroke
                            let k = fltk::app::event_text();
                            term.take_focus().unwrap();
                            term.append(&k);
                            true
                        }

                        // fltk docs say that keyboard handler should always claim Focus and Unfocus events
                        // We can do this, or else ignore them (return false)
                        // fltk::enums::Event::Focus | fltk::enums::Event::Unfocus => {
                        //     term.redraw();
                        //     true
                        // }
                        _ => false, // Let FLTK handle everything else
                    }
                }
            });

            let attr_save = term.text_attrib();
            term.set_text_attrib(Attrib::Inverse | Attrib::Italic);
            term.append("\nStartup tests complete. Keyboard is live.\n");
            assert_eq!(term.text_attrib(), Attrib::Inverse | Attrib::Italic);
            term.set_text_attrib(attr_save);
            assert_eq!(term.text_attrib(), attr_save);
            term.redraw();
        }
    });

    app.run().unwrap();
}
//--------------------------------------------------------------------------------------
/// More tests that run when the menu bar Test1 is clicked
fn mb_test1_cb(_choice: &mut fltk::menu::Choice, term: &mut Terminal) {
    term.take_focus().unwrap();
    term.reset_terminal();
    term.append("0123456789 0\n");
    term.append("0123456789 1\n");
    term.append("0123456789 2\n");
    term.append("0123456789 3\n");
    term.append("0123456789 4\n");
    term.append("0123456789 5\n");
    term.append("0123456789 6\n");
    term.append("0123456789 7\n");
    term.append("0123456789 8\n");
    term.append("0123456789 9\n");
    term.append("------------\n");

    term.set_text_fg_color(Color::Green);
    term.plot_char('A', 0, 0);
    term.plot_char('B', 1, 1);
    term.plot_char('C', 2, 2);
    term.plot_char('D', 3, 3);
    term.plot_char('E', 4, 4);
    term.plot_char('F', 5, 5);
    term.set_text_fg_color(Color::XtermWhite);

    assert_eq!(term.cursor_row(), 11);
    assert_eq!(term.cursor_col(), 0);

    term.set_text_bg_color(Color::DarkBlue);
    term.plot_char_utf8('b', 8, 1);
    term.plot_char_utf8('↑', 9, 1);
    term.plot_char_utf8('c', 8, 2);
    term.plot_char_utf8('↑', 9, 2);
    term.plot_char_utf8('d', 8, 3);
    term.plot_char_utf8('↑', 9, 3);
    term.plot_char_utf8('e', 8, 4);
    term.plot_char_utf8('↑', 9, 4);
    term.plot_char_utf8('f', 8, 5);
    term.plot_char_utf8('↑', 9, 5);
    term.plot_char_utf8('g', 8, 6);
    term.plot_char_utf8('↑', 9, 6);
    term.set_text_bg_color(Color::TransparentBg);

    term.set_text_attrib(Attrib::Inverse | Attrib::Italic);
    term.append("Done!\n");
    term.set_text_attrib(Attrib::Normal);
}

//--------------------------------------------------------------------------------------
/// More tests that run when the menu bar button Test2 is clicked
fn mb_test2_cb(_choice: &mut fltk::menu::Choice, term: &mut Terminal) {
    term.take_focus().unwrap();
    term.reset_terminal();

    for i in 0..50 {
        term.append(&format!("{i}\n"));
    }
    assert_eq!(term.history_rows(), 100);
    assert_eq!(term.history_lines(), 100);

    term.clear_history();
    assert_eq!(term.history_use(), 0);

    term.set_text_attrib(Attrib::Inverse | Attrib::Italic);
    term.append("\nDone!\n");
    term.set_text_attrib(Attrib::Normal);
}

//--------------------------------------------------------------------------------------
/// Another set of tests that run when Test3 is clicked
fn mb_test3_cb(_choice: &mut fltk::menu::Choice, term: &mut Terminal) {
    term.take_focus().unwrap();
    term.reset_terminal();
    assert_eq!(term.text_bg_color_default(), Color::TransparentBg);

    assert_eq!(term.history_use(), 0);
    term.clear();
    assert_eq!(term.cursor_row(), 0);
    assert_eq!(term.history_use(), term.display_rows()); // A screenful of lines added to history

    term.append("Test\ntext\na\nb\nc\nd");
    assert_eq!(term.cursor_row(), 5);
    let hist = term.history_use();
    term.clear_screen_home(false);
    assert_eq!(term.cursor_row(), 0);
    assert_eq!(term.history_use(), hist); // History not changed

    term.append("Test\ntext\na\nb\nc\nd\ne");
    assert_eq!(term.cursor_row(), 6);
    term.clear_screen_home(true);
    assert_eq!(term.cursor_row(), 0);

    term.append("Test\ntext\na\nb\nc\n");
    assert_eq!(term.cursor_row(), 5);
    term.clear_to_color(Color::DarkBlue);
    assert_eq!(term.text_bg_color_default(), Color::TransparentBg);
    assert_eq!(term.text_bg_color(), Color::TransparentBg);
    assert_eq!(term.cursor_row(), 0);

    // Test cursor_home()
    term.append("Test\n\n\n\n\n\n\n\n\n\n");
    assert_eq!(term.cursor_row(), 10);
    term.cursor_home();
    assert_eq!(term.cursor_row(), 0);

    // Test the widget color
    assert_eq!(term.color(), Color::Black); // Default
    term.set_color(Color::DarkGreen);
    assert_eq!(term.color(), Color::DarkGreen);
    term.set_color(Color::Black);
    assert_eq!(term.color(), Color::Black);
    term.append(
        "This should be one line of white text on black, embedded into the top of a blue field.\n",
    );

    assert_eq!(term.output_translate(), OutFlags::LF_TO_CRLF); // default
    term.set_output_translate(OutFlags::OFF);
    assert_eq!(term.output_translate(), OutFlags::OFF);
    term.set_output_translate(OutFlags::LF_TO_CRLF); // restore default
    assert_eq!(term.output_translate(), OutFlags::LF_TO_CRLF);

    term.set_text_attrib(Attrib::Inverse | Attrib::Italic);
    term.append("\nDone!\n");
    term.set_text_attrib(Attrib::Normal);
}

//--------------------------------------------------------------------------------------
/// Another set of tests for the ring-buffer access methods
/// Note: these tests depend heavily on the low-level "protected" parts of the fltk library, which should be used with caution.
fn mb_test4_cb(_choice: &mut fltk::menu::Choice, term: &mut Terminal) {
    term.take_focus().unwrap();
    term.reset_terminal();
    // Test the Utf8Char primitive
    let uc = Utf8Char::new(b'Q');
    let uc1 = uc.text_utf8();
    assert_eq!(&uc1, &[b'Q']);
    assert_eq!(&uc.attrib(), &Attrib::Normal);
    assert_eq!(
        &uc.charflags(),
        &(CharFlags::FG_XTERM | CharFlags::BG_XTERM)
    );
    assert_eq!(&uc.fgcolor(), &Color::XtermWhite);
    assert_eq!(&uc.bgcolor(), &Color::TransparentBg);

    let ring_rows = term.ring_rows();

    term.take_focus().unwrap();
    term.clear_history();
    assert_eq!(term.history_use(), 0);

    // Subtract row numbers, modulo `rows`
    fn row_diff(rows: i32, a: i32, b: i32) -> i32 {
        match a - b {
            n if n < 0 => n + rows,
            n => n,
        }
    }
    // disp_srow is always 1 greater than hist_erow, modulo (ring_rows+1)
    assert_eq!(row_diff(ring_rows, term.disp_srow(), term.hist_erow()), 1);
    assert!(term.disp_srow() >= 0);
    assert!(term.disp_erow() >= 0);
    assert!(term.hist_srow() >= 0);
    assert!(term.hist_erow() >= 0);
    assert!(term.offset() >= 0);
    assert!(term.disp_srow() <= ring_rows);
    assert!(term.disp_erow() <= ring_rows);
    assert!(term.hist_srow() <= ring_rows);
    assert!(term.hist_erow() <= ring_rows);
    assert!(term.offset() <= ring_rows);

    assert_eq!(term.ring_srow(), 0);
    assert_eq!(term.ring_erow(), ring_rows - 1);
    assert_eq!(
        row_diff(ring_rows, term.disp_erow(), term.disp_srow()) + 1,
        term.disp_rows()
    );
    assert_eq!(
        row_diff(ring_rows, term.hist_erow(), term.hist_srow()) + 1,
        term.hist_rows()
    );

    assert_eq!(term.ring_erow(), term.ring_rows() - 1);
    assert_eq!(term.ring_srow(), 0);

    // Check the different cols methods, which should all return the same answer
    assert!(term.disp_cols() > 10);
    assert_eq!(term.disp_cols(), term.ring_cols());
    assert_eq!(term.disp_cols(), term.hist_cols());

    // Redundant protected vs public methods:
    assert_eq!(term.disp_cols(), term.display_columns());
    assert_eq!(term.disp_rows(), term.display_rows());

    /// Local function to read back all rows from the display into a long string.
    /// Does not include scrollback history.
    /// Trims trailing blanks on each line
    fn read_disp(term: &Terminal) -> String {
        let rows = term.display_rows();
        let mut text: Vec<u8> = Vec::with_capacity((rows * 64) as usize);
        for row in 0..rows {
            let r = term.u8c_disp_row(row).trim();
            // Iterate through a row, accumulating [u8]
            for c in r.iter() {
                // Note: Sometimes utf-8 length is > 1
                text.extend_from_slice(c.text_utf8());
            }
            text.extend_from_slice(b"\n");
        }
        // Return the result as a string
        std::str::from_utf8(&text).unwrap().to_string()
    }

    term.clear();
    term.append("Top line  ↑ (up-arrow)");
    term.set_text_attrib(Attrib::Underline);
    term.append("  ");
    term.set_text_attrib(Attrib::Normal);
    term.append("  \n");
    let mut text_out = read_disp(term);
    // Trim trailing empty lines
    text_out = text_out.trim_end_matches(&"\n\n").to_string();
    // The two plain blanks at the end will be trimmed, the two underlined blanks will be retained.

    assert_eq!(text_out, "Top line  ↑ (up-arrow)  \n");
    let r = term.u8c_disp_row(0);
    assert_eq!(r.col(0).text_utf8(), b"T");
    assert_eq!(r.col(10).text_utf8(), b"\xe2\x86\x91"); // UTF-8 up-arrow
    assert_eq!(r.col(24).text_utf8(), b" "); // First blank after test text, NOT trimmed
    let r = term.u8c_disp_row(1);
    assert_eq!(r.col(0).text_utf8(), b" "); // Second row starts with blanks
    assert_eq!(r.col(1).text_utf8(), b" "); // Second row is full of blanks

    // Clear the screen again, then append test text, then read it back and compare
    let test_text = "The wind was a torrent of darkness among the gusty trees.
The moon was a ghostly galleon tossed upon cloudy seas.
The road was a ribbon of moonlight over the purple moor,
And the highwayman came riding—
            Riding—riding—
The highwayman came riding, up to the old inn-door.";

    term.clear_history();
    term.clear();
    let bg_save = term.text_bg_color();
    let fg_save = term.text_fg_color();
    term.set_text_bg_color(Color::DarkBlue); // Set spooky colors
    term.set_text_fg_color(Color::from_rgb(0x40, 0x40, 0xff));
    term.append(test_text);
    term.set_text_bg_color(bg_save);
    term.set_text_fg_color(fg_save);

    let mut text_out = read_disp(term);
    // Trim trailing empty lines
    text_out = text_out.trim_end_matches(&"\n\n").to_string();
    assert_eq!(test_text, text_out);

    assert_eq!(row_diff(ring_rows, term.disp_srow(), term.hist_erow()), 1);

    assert_eq!(term.ring_srow(), 0);
    assert_eq!(term.ring_erow(), ring_rows - 1);
    assert_eq!(
        row_diff(ring_rows, term.disp_erow(), term.disp_srow()) + 1,
        term.disp_rows()
    );
    assert_eq!(
        row_diff(ring_rows, term.hist_erow(), term.hist_srow()) + 1,
        term.hist_rows()
    );

    term.append(&format!(
        "\n\nScreen has {} rows of {} columns.\n",
        term.disp_rows(),
        term.disp_cols()
    ));
}

//--------------------------------------------------------------------------------------
/// Yet another set of tests for misc cursor functions and other stuff
/// Note: these tests depend heavily on the low-level "protected" parts of the fltk library, which should be used with caution.
fn mb_test5_cb(_choice: &mut fltk::menu::Choice, term: &mut Terminal) {
    term.take_focus().unwrap();

    // Test the attr_fg_color and attr_bg_color methods.
    // Put a single character 'A' into the buffer and check it
    term.clear(); // No reset_terminal(), just clear() to preserve the mouse selection for later
    term.set_text_bg_color(Color::TransparentBg);
    term.set_text_fg_color(Color::XtermWhite);
    term.append("A");
    let r = &term.u8c_disp_row(0);
    let uc = r.col(0);
    assert_eq!(uc.text_utf8(), b"A");
    assert_eq!(&uc.attr_fgcolor(None), &Color::XtermWhite);
    assert_eq!(&uc.attr_bgcolor(None), &Color::TransparentBg);
    assert_eq!(&uc.attr_bgcolor(Some(term)), &Color::Black);
    assert_eq!(&uc.attr_fgcolor(Some(term)), &Color::XtermWhite);
    assert_eq!(&uc.attrib(), &Attrib::Normal);

    // Put a short string "BCD" into the first line of the buffer, with fg color change after the 'B' and bold after 'C'
    term.clear();
    term.set_text_fg_color_xterm(fltk::group::experimental::XtermColor::White);
    term.set_text_bg_color_xterm(fltk::group::experimental::XtermColor::Black);
    assert_eq!(term.text_attrib(), Attrib::Normal);

    assert!(term.ansi());
    term.append("B\x1b[32mC\x1b[1mD\n");

    let r = &term.u8c_disp_row(0);
    let uc = r.col(0);
    assert_eq!(uc.text_utf8(), b"B");
    assert!(uc.is_char(b'B'));
    assert!(!uc.is_char(b'A'));
    assert_eq!(&uc.fgcolor(), &Color::XtermWhite);
    assert_eq!(&uc.bgcolor(), &Color::XtermBlack);
    assert_eq!(&uc.attr_fgcolor(None), &Color::XtermWhite);
    assert_eq!(&uc.attr_bgcolor(None), &Color::XtermBlack);
    assert_eq!(
        &uc.charflags(),
        &(CharFlags::FG_XTERM | CharFlags::BG_XTERM)
    );

    let uc = r.col(1);
    assert_eq!(uc.text_utf8(), b"C");
    assert!(uc.is_char(b'C'));
    assert_eq!(&uc.fgcolor(), &Color::XtermGreen);
    assert_eq!(&uc.bgcolor(), &Color::XtermBlack);
    assert_eq!(&uc.attr_fgcolor(None), &Color::XtermGreen);
    assert_eq!(&uc.attr_bgcolor(None), &Color::XtermBlack);
    assert_eq!(
        &uc.charflags(),
        &(CharFlags::FG_XTERM | CharFlags::BG_XTERM)
    );

    let uc = r.col(2);
    assert_eq!(uc.text_utf8(), b"D");
    assert!(uc.is_char(b'D'));
    assert_eq!(&uc.fgcolor(), &Color::XtermGreen);
    assert_eq!(&uc.bgcolor(), &Color::XtermBlack);
    assert_eq!(&uc.attr_fgcolor(None), &Color::from_rgb(0x20, 0xf0, 0x20));
    assert_eq!(&uc.attr_bgcolor(None), &Color::from_rgb(0x20, 0x20, 0x20));
    assert_eq!(
        &uc.attr_fgcolor(Some(term)),
        &Color::from_rgb(0x20, 0xf0, 0x20)
    );
    assert_eq!(&uc.attr_bgcolor(None), &Color::from_rgb(0x20, 0x20, 0x20));
    assert_eq!(
        &uc.charflags(),
        &(CharFlags::FG_XTERM | CharFlags::BG_XTERM)
    );

    // Put a short string "BCDE" into the buffer, with fg color change after the 'B', bg change after 'C', and bold after 'D'
    term.clear();
    term.set_text_fg_color_xterm(fltk::group::experimental::XtermColor::White);
    term.set_text_bg_color_xterm(fltk::group::experimental::XtermColor::Black);
    term.set_text_attrib(Attrib::Normal);
    assert_eq!(term.text_attrib(), Attrib::Normal);

    assert!(term.ansi());
    term.append("B\x1b[37mC\x1b[44mD\x1b[1mE\n");

    let r = &term.u8c_disp_row(0);
    let uc = r.col(0);
    assert_eq!(uc.text_utf8(), b"B");
    assert!(uc.is_char(b'B'));
    assert!(!uc.is_char(b'A'));
    assert_eq!(&uc.fgcolor(), &Color::XtermWhite);
    assert_eq!(&uc.bgcolor(), &Color::XtermBlack);
    assert_eq!(&uc.attr_fgcolor(None), &Color::XtermWhite);
    assert_eq!(&uc.attr_bgcolor(None), &Color::XtermBlack);
    assert_eq!(
        &uc.charflags(),
        &(CharFlags::FG_XTERM | CharFlags::BG_XTERM)
    );

    let uc = r.col(1);
    assert_eq!(uc.text_utf8(), b"C");
    assert!(uc.is_char(b'C'));
    assert_eq!(&uc.fgcolor(), &Color::XtermWhite);
    assert_eq!(&uc.bgcolor(), &Color::XtermBlack);
    assert_eq!(&uc.attr_fgcolor(None), &Color::XtermWhite);
    assert_eq!(&uc.attr_bgcolor(None), &Color::XtermBlack);
    assert_eq!(
        &uc.charflags(),
        &(CharFlags::FG_XTERM | CharFlags::BG_XTERM)
    );

    let uc = r.col(2);
    assert_eq!(uc.text_utf8(), b"D");
    assert!(uc.is_char(b'D'));
    assert_eq!(&uc.fgcolor(), &Color::XtermWhite);
    assert_eq!(&uc.bgcolor(), &Color::XtermBgBlue);
    assert_eq!(&uc.attr_fgcolor(None), &Color::XtermWhite);
    assert_eq!(&uc.attr_bgcolor(None), &Color::XtermBgBlue);
    assert_eq!(
        &uc.charflags(),
        &(CharFlags::FG_XTERM | CharFlags::BG_XTERM)
    );

    let uc = r.col(3);
    assert_eq!(uc.text_utf8(), b"E");
    assert!(uc.is_char(b'E'));
    assert_eq!(&uc.fgcolor(), &Color::XtermWhite);
    assert_eq!(&uc.bgcolor(), &Color::XtermBgBlue);
    assert_eq!(&uc.attr_fgcolor(None), &Color::from_hex(0xf0f0f0));
    assert_eq!(&uc.attr_bgcolor(None), &Color::from_hex(0x2020e0));
    assert_eq!(
        &uc.charflags(),
        &(CharFlags::FG_XTERM | CharFlags::BG_XTERM)
    );

    // Test some miscellaneous Utf8 constants
    assert_eq!(uc.length(), 1);
    assert_eq!(uc.max_utf8(), 4);
    assert_eq!(uc.pwidth(), 8.0);
    assert_eq!(uc.pwidth_int(), 8);

    term.set_text_fg_color_xterm(fltk::group::experimental::XtermColor::White);
    term.set_text_bg_color_xterm(fltk::group::experimental::XtermColor::Black);
    term.clear();
    term.set_text_attrib(Attrib::Normal);

    // Mouse selection functions
    term.append(&format!("Mouse selection: {:?}\n", &term.get_selection()));
    term.clear_mouse_selection();
    assert_eq!(term.get_selection(), None);

    // Play with cursor position
    term.append("0123456789\n"); // Set up test pattern
    term.append("ABCDEFGHIJ\n");
    term.append("abcdefghij\n");

    term.set_cursor_row(1);
    assert_eq!(term.cursor_row(), 1);
    term.set_cursor_col(1);
    assert_eq!(term.cursor_col(), 1);
    assert_eq!(term.u8c_cursor().text_utf8(), b"1");

    term.append("----"); // Overwrites text at cursor and moves cursor forward
    assert_eq!(term.cursor_row(), 1);
    assert_eq!(term.cursor_col(), 5);
    assert_eq!(term.u8c_cursor().text_utf8(), b"5");
    term.set_cursor_col(1);
    assert_eq!(term.u8c_cursor().text_utf8(), b"-"); // Overwritten text

    term.cursor_up(1, false);
    assert_eq!(term.cursor_row(), 0);
    assert_eq!(term.cursor_col(), 1);
    assert_eq!(term.u8c_cursor().text_utf8(), b"o");

    // Hit top of screen, so nothing happens
    term.cursor_up(1, false);
    assert_eq!(term.cursor_row(), 0);
    assert_eq!(term.cursor_col(), 1);
    assert_eq!(term.u8c_cursor().text_utf8(), b"o");

    // Hit top of screen with scroll enabled. A blank line from history is scrolled in.
    term.cursor_up(1, true);
    assert_eq!(term.cursor_row(), 0);
    assert_eq!(term.cursor_col(), 1);
    assert_eq!(term.u8c_cursor().text_utf8(), b" ");

    // Go back down to the overwritten text
    term.cursor_down(2, false);
    assert_eq!(term.cursor_row(), 2);
    assert_eq!(term.cursor_col(), 1);
    assert_eq!(term.u8c_cursor().text_utf8(), b"-");

    // Go right past the overwritten text
    term.cursor_right(4, false);
    assert_eq!(term.cursor_row(), 2);
    assert_eq!(term.cursor_col(), 5);
    assert_eq!(term.u8c_cursor().text_utf8(), b"5");

    // Go left to the end of the overwritten text
    term.cursor_left(1);
    assert_eq!(term.cursor_row(), 2);
    assert_eq!(term.cursor_col(), 4);
    assert_eq!(term.u8c_cursor().text_utf8(), b"-");

    // Scroll back down, removing the blank line at the top.
    // Cursor stays in place, the text moves under it.
    term.scroll(1);
    assert_eq!(term.cursor_row(), 2);
    assert_eq!(term.cursor_col(), 4);
    assert_eq!(term.u8c_cursor().text_utf8(), b"E");

    // Clear from here to end-of-line
    term.clear_eol();
    assert_eq!(term.cursor_row(), 2);
    assert_eq!(term.cursor_col(), 4);
    assert_eq!(term.u8c_cursor().text_utf8(), b" ");

    // Now clear from here to start-of-line. Cursor does not move.
    term.clear_sol();
    assert_eq!(term.cursor_row(), 2);
    assert_eq!(term.cursor_col(), 4);
    assert_eq!(term.u8c_cursor().text_utf8(), b" ");
    term.cursor_left(1);
    assert_eq!(term.u8c_cursor().text_utf8(), b" ");
    term.set_cursor_col(0);
    assert_eq!(term.u8c_cursor().text_utf8(), b" ");

    // Clear some lines
    term.clear_line(1);
    assert_eq!(term.cursor_row(), 2);
    assert_eq!(term.cursor_col(), 0);
    term.set_cursor_row(1);
    assert_eq!(term.u8c_cursor().text_utf8(), b" ");
    term.set_cursor_row(3);
    term.clear_cur_line();
    assert_eq!(term.u8c_cursor().text_utf8(), b" ");
    assert_eq!(term.cursor_row(), 3);
    assert_eq!(term.cursor_col(), 0);

    term.append("Two lines above are intentionally left blank.\n");
    assert_eq!(term.cursor_row(), 4);
    assert_eq!(term.cursor_col(), 0);

    // Set up the test pattern again, then play with insert/delete
    term.append("0123456789\n");
    term.append("ABCDEFGHIJ\n");
    term.append("abcdefghij\n");
    assert_eq!(term.cursor_row(), 7);

    term.set_cursor_row(4);
    term.set_cursor_col(4);
    assert_eq!(term.u8c_cursor().text_utf8(), b"4");

    term.insert_char('x', 5); // Push this row right 5 chars starting at col 4
    assert_eq!(term.u8c_cursor().text_utf8(), b"x");
    term.cursor_right(5, false);
    assert_eq!(term.cursor_col(), 9);
    assert_eq!(term.u8c_cursor().text_utf8(), b"4");

    // Insert two blank rows above cursor. Cursor stays put.
    term.insert_rows(2);
    assert_eq!(term.cursor_row(), 4);
    assert_eq!(term.cursor_col(), 9);
    assert_eq!(term.u8c_cursor().text_utf8(), b" ");
    term.cursor_down(2, false); // Go down to find our text again
    assert_eq!(term.u8c_cursor().text_utf8(), b"4");

    // Go back to the beginning of the inserted 'x' characters and delete them.
    term.cursor_left(5);
    assert_eq!(term.u8c_cursor().text_utf8(), b"x");
    term.delete_cur_chars(5);
    assert_eq!(term.cursor_row(), 6);
    assert_eq!(term.cursor_col(), 4);
    assert_eq!(term.u8c_cursor().text_utf8(), b"4");

    term.delete_chars(7, 2, 2); // Delete "CD" from the next row
    term.cursor_down(1, false);
    term.cursor_left(2);
    assert_eq!(term.u8c_cursor().text_utf8(), b"E");

    term.delete_rows(1); // Middle row of pattern is gone, cursor stays put
    assert_eq!(term.u8c_cursor().text_utf8(), b"c");
    term.cursor_up(1, false);
    term.delete_rows(2); // Delete remains of test pattern

    term.set_text_attrib(Attrib::Bold);
    term.insert_char_eol('-', 3, 15, 20);
    term.set_cursor_row(3);
    term.set_cursor_col(15);
    assert_eq!(term.u8c_cursor().text_utf8(), b"-"); // Check the insertion
    assert_eq!(term.u8c_cursor().attrib(), Attrib::Bold);

    term.set_text_attrib(Attrib::Italic);
    term.append(" and all lines below");
    term.set_text_attrib(Attrib::Normal);
    term.cursor_down(1, false);
}
source

pub fn from_hex_str(col: &str) -> Result<Color, FltkError>

Return a Color from a hex color format (#xxxxxx)

source

pub fn to_hex_str(&self) -> String

Returns the color in hex string format

source

pub fn by_index(idx: u8) -> Color

Returns a color by index of RGBI

Examples found in repository?
examples/tile.rs (line 26)
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
fn main() {
    let app = app::App::default();
    let mut window = window::Window::default().with_size(300, 300);
    window.set_frame(FrameType::NoBox);
    window.make_resizable(true);

    let dx = 20;
    let dy = dx; // border width of resizable() - see below
    let tile = group::Tile::default_fill();

    // create the symmetrical resize box with dx and dy pixels distance, resp.
    // from the borders of the Fl_Tile widget before all other children
    let r = frame::Frame::new(
        tile.x() + dx,
        tile.y() + dy,
        tile.w() - 2 * dx,
        tile.h() - 2 * dy,
        None,
    );
    tile.resizable(&r);

    let mut box0 = frame::Frame::new(0, 0, 150, 150, "0");
    box0.set_frame(FrameType::DownBox);
    box0.set_color(Color::by_index(9));
    box0.set_label_size(36);
    box0.set_align(Align::Clip);

    let mut w1 = window::Window::new(150, 0, 150, 150, "1");
    w1.set_frame(FrameType::NoBox);
    let mut box1 = frame::Frame::new(0, 0, 150, 150, "1\nThis is a child window");
    box1.set_frame(FrameType::DownBox);
    box1.set_color(Color::by_index(19));
    box1.set_label_size(18);
    box1.set_align(Align::Clip | Align::Inside | Align::Wrap);
    w1.resizable(&box1);
    w1.end();

    let mut box2a = frame::Frame::new(0, 150, 70, 150, "2a");
    box2a.set_frame(FrameType::DownBox);
    box2a.set_color(Color::by_index(12));
    box2a.set_label_size(36);
    box2a.set_align(Align::Clip);

    let mut box2b = frame::Frame::new(70, 150, 80, 150, "2b");
    box2b.set_frame(FrameType::DownBox);
    box2b.set_color(Color::by_index(13));
    box2b.set_label_size(36);
    box2b.set_align(Align::Clip);

    let mut box3a = frame::Frame::new(150, 150, 150, 70, "3a");
    box3a.set_frame(FrameType::DownBox);
    box3a.set_color(Color::by_index(12));
    box3a.set_label_size(36);
    box3a.set_align(Align::Clip);

    let mut box3b = frame::Frame::new(150, 150 + 70, 150, 80, "3b");
    box3b.set_frame(FrameType::DownBox);
    box3b.set_color(Color::by_index(13));
    box3b.set_label_size(36);
    box3b.set_align(Align::Clip);

    tile.end();
    window.end();

    w1.show();
    window.show();

    app.run().unwrap();
}
source

pub fn inactive(&self) -> Color

Returns an inactive form of the color

Examples found in repository?
examples/gradients.rs (line 19)
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
fn create_vertical_gradient_frame(
    x: i32,
    y: i32,
    w: i32,
    h: i32,
    col1: Color,
    col2: Color,
) -> frame::Frame {
    let mut frame = frame::Frame::new(x, y, w, h, "Vertical");
    frame.draw(move |f| {
        let imax = f.h();
        let d = if imax > 0 { imax } else { 1 };
        for i in 0..=imax {
            let w = 1.0 - i as f32 / d as f32;
            set_draw_color(Color::inactive(&Color::color_average(col1, col2, w)));
            draw_xyline(f.x(), f.y() + i, f.x() + f.w());
        }
        set_draw_color(Color::Black);
        set_font(Font::Helvetica, app::font_size());
        draw_text2(&f.label(), f.x(), f.y(), f.w(), f.h(), f.align());
    });
    frame
}

fn create_horizontal_gradient_frame(
    x: i32,
    y: i32,
    w: i32,
    h: i32,
    col1: Color,
    col2: Color,
) -> frame::Frame {
    let mut frame = frame::Frame::new(x, y, w, h, "Horizontal");
    frame.draw(move |f| {
        let imax = f.w();
        let d = if imax > 0 { imax } else { 1 };
        for i in 0..=imax {
            let w = 1.0 - i as f32 / d as f32;
            set_draw_color(Color::inactive(&Color::color_average(col1, col2, w)));
            draw_yxline(f.x() + i, f.y(), f.y() + f.h());
        }
        set_draw_color(Color::Black);
        set_font(Font::Helvetica, app::font_size());
        draw_text2(&f.label(), f.x(), f.y(), f.w(), f.h(), f.align());
    });
    frame
}

fn create_horizontal_svg_gradient_frame(
    x: i32,
    y: i32,
    w: i32,
    h: i32,
    col1: Color,
    col2: Color,
) -> frame::Frame {
    let mut frame = frame::Frame::new(x, y, w, h, "Svg");
    frame.draw(move |f| {
        let (r1, g1, b1) = Color::inactive(&col1).to_rgb();
        let (r2, g2, b2) = Color::inactive(&col2).to_rgb();
        let svg = format!(
            "<svg viewBox='0 0 {} {}'>
        <defs>
        <linearGradient id='grad1' x1='0%' y1='0%' x2='0%' y2='100%'>
        <stop offset='0%' style='stop-color:rgb({},{},{});stop-opacity:1' />
        <stop offset='100%' style='stop-color:rgb({},{},{});stop-opacity:1' />
        </linearGradient>
        </defs>
        <rect width='100%' height='100%' fill='url(#grad1)' />
        </svg>",
            f.w(),
            f.h() + 1,
            r1,
            g1,
            b1,
            r2,
            g2,
            b2
        );
        let mut image = image::SvgImage::from_data(&svg).unwrap();
        image.draw(f.x(), f.y(), f.w(), f.h());
        set_draw_color(Color::Black);
        set_font(Font::Helvetica, app::font_size());
        draw_text2(&f.label(), f.x(), f.y(), f.w(), f.h(), f.align());
    });
    frame
}
source

pub fn darker(&self) -> Color

Returns an darker form of the color

source

pub fn lighter(&self) -> Color

Returns an lighter form of the color

source

pub fn gray_ramp(val: i32) -> Color

Returns a gray color value from black (i == 0) to white (i == FL_NUM_GRAY - 1)

source

pub fn color_average(c1: Color, c2: Color, weight: f32) -> Color

Returns a gray color value from black (i == 0) to white (i == FL_NUM_GRAY - 1)

Examples found in repository?
examples/gradients.rs (line 19)
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
fn create_vertical_gradient_frame(
    x: i32,
    y: i32,
    w: i32,
    h: i32,
    col1: Color,
    col2: Color,
) -> frame::Frame {
    let mut frame = frame::Frame::new(x, y, w, h, "Vertical");
    frame.draw(move |f| {
        let imax = f.h();
        let d = if imax > 0 { imax } else { 1 };
        for i in 0..=imax {
            let w = 1.0 - i as f32 / d as f32;
            set_draw_color(Color::inactive(&Color::color_average(col1, col2, w)));
            draw_xyline(f.x(), f.y() + i, f.x() + f.w());
        }
        set_draw_color(Color::Black);
        set_font(Font::Helvetica, app::font_size());
        draw_text2(&f.label(), f.x(), f.y(), f.w(), f.h(), f.align());
    });
    frame
}

fn create_horizontal_gradient_frame(
    x: i32,
    y: i32,
    w: i32,
    h: i32,
    col1: Color,
    col2: Color,
) -> frame::Frame {
    let mut frame = frame::Frame::new(x, y, w, h, "Horizontal");
    frame.draw(move |f| {
        let imax = f.w();
        let d = if imax > 0 { imax } else { 1 };
        for i in 0..=imax {
            let w = 1.0 - i as f32 / d as f32;
            set_draw_color(Color::inactive(&Color::color_average(col1, col2, w)));
            draw_yxline(f.x() + i, f.y(), f.y() + f.h());
        }
        set_draw_color(Color::Black);
        set_font(Font::Helvetica, app::font_size());
        draw_text2(&f.label(), f.x(), f.y(), f.w(), f.h(), f.align());
    });
    frame
}

fn create_horizontal_svg_gradient_frame(
    x: i32,
    y: i32,
    w: i32,
    h: i32,
    col1: Color,
    col2: Color,
) -> frame::Frame {
    let mut frame = frame::Frame::new(x, y, w, h, "Svg");
    frame.draw(move |f| {
        let (r1, g1, b1) = Color::inactive(&col1).to_rgb();
        let (r2, g2, b2) = Color::inactive(&col2).to_rgb();
        let svg = format!(
            "<svg viewBox='0 0 {} {}'>
        <defs>
        <linearGradient id='grad1' x1='0%' y1='0%' x2='0%' y2='100%'>
        <stop offset='0%' style='stop-color:rgb({},{},{});stop-opacity:1' />
        <stop offset='100%' style='stop-color:rgb({},{},{});stop-opacity:1' />
        </linearGradient>
        </defs>
        <rect width='100%' height='100%' fill='url(#grad1)' />
        </svg>",
            f.w(),
            f.h() + 1,
            r1,
            g1,
            b1,
            r2,
            g2,
            b2
        );
        let mut image = image::SvgImage::from_data(&svg).unwrap();
        image.draw(f.x(), f.y(), f.w(), f.h());
        set_draw_color(Color::Black);
        set_font(Font::Helvetica, app::font_size());
        draw_text2(&f.label(), f.x(), f.y(), f.w(), f.h(), f.align());
    });
    frame
}

fn main() {
    let a = app::App::default();
    let mut win = window::Window::default().with_size(300, 300);
    create_vertical_gradient_frame(0, 0, 100, 100, Color::Red, Color::Cyan);
    create_horizontal_gradient_frame(100, 0, 100, 100, Color::Red, Color::Cyan);
    create_horizontal_svg_gradient_frame(200, 0, 100, 100, Color::Red, Color::Cyan);
    win.end();
    win.draw(|w| {
        // vertical gradient
        let imax = w.w();
        let d = if imax > 0 { imax } else { 1 };
        for i in 0..=imax {
            let v = 1.0 - i as f32 / d as f32;
            set_draw_color(Color::color_average(Color::Red, Color::Blue, v));
            draw_yxline(i, 0, w.h());
        }
        w.draw_children();
    });
    win.make_resizable(true);
    win.show();
    a.run().unwrap();
}
source

pub fn contrast(fg: Color, bg: Color) -> Color

Returns a color that contrasts with the background color.

source

pub fn gray_scale(g: u8) -> Color

Returns the color closest to the passed grayscale value

source

pub fn rgb_color(r: u8, g: u8, b: u8) -> Color

Returns the color closest to the passed rgb value

source

pub fn to_rgb(&self) -> (u8, u8, u8)

Get the RGB value of the color

Examples found in repository?
examples/gradients.rs (line 63)
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
fn create_horizontal_svg_gradient_frame(
    x: i32,
    y: i32,
    w: i32,
    h: i32,
    col1: Color,
    col2: Color,
) -> frame::Frame {
    let mut frame = frame::Frame::new(x, y, w, h, "Svg");
    frame.draw(move |f| {
        let (r1, g1, b1) = Color::inactive(&col1).to_rgb();
        let (r2, g2, b2) = Color::inactive(&col2).to_rgb();
        let svg = format!(
            "<svg viewBox='0 0 {} {}'>
        <defs>
        <linearGradient id='grad1' x1='0%' y1='0%' x2='0%' y2='100%'>
        <stop offset='0%' style='stop-color:rgb({},{},{});stop-opacity:1' />
        <stop offset='100%' style='stop-color:rgb({},{},{});stop-opacity:1' />
        </linearGradient>
        </defs>
        <rect width='100%' height='100%' fill='url(#grad1)' />
        </svg>",
            f.w(),
            f.h() + 1,
            r1,
            g1,
            b1,
            r2,
            g2,
            b2
        );
        let mut image = image::SvgImage::from_data(&svg).unwrap();
        image.draw(f.x(), f.y(), f.w(), f.h());
        set_draw_color(Color::Black);
        set_font(Font::Helvetica, app::font_size());
        draw_text2(&f.label(), f.x(), f.y(), f.w(), f.h(), f.align());
    });
    frame
}
More examples
Hide additional examples
examples/rounded_images.rs (line 12)
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
    pub fn new(radius: i32, mut image: image::RgbImage) -> Self {
        let mut frame = frame::Frame::new(0, 0, radius * 2, radius * 2, None);
        frame.set_frame(enums::FrameType::FlatBox);
        frame.draw(move |f| {
            image.scale(f.w(), f.h(), false, true);
            image.draw(f.x(), f.y(), f.w(), f.h());
            let color = f.color().to_rgb();
            let s = format!(
                "<?xml version='1.0' encoding='UTF-8' standalone='no'?>\n
              <svg width='{}' height='{}'>\n
                <rect x='{}' 
                    y='{}' 
                    rx='{}' 
                    ry='{}' 
                    width='{}' 
                    height='{}' 
                    fill='none' 
                    stroke='rgb({}, {}, {})' 
                    stroke-width='{}' />\n
              </svg>\n",
                f.w(),
                f.h(),
                -f.w() / 2,
                -f.w() / 2,
                f.w(),
                f.w(),
                f.w() + f.w(),
                f.h() + f.w(),
                color.0,
                color.1,
                color.2,
                f.w()
            );
            let mut s = image::SvgImage::from_data(&s).unwrap();
            s.draw(f.x(), f.y(), f.w(), f.h());
        });
        Self
    }
examples/format_text.rs (line 296)
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
fn main() {
    let style = Rc::from(RefCell::from(Style::new()));

    let app = App::default().with_scheme(Scheme::Gleam);
    let mut wind = Window::default()
        .with_size(500, 200)
        .with_label("Highlight");
    let mut vpack = Pack::new(4, 4, 492, 192, "");
    vpack.set_spacing(4);
    let mut text_editor = TextEditor::default().with_size(492, 163);

    let mut hpack = Pack::new(4, 4, 492, 25, "").with_type(PackType::Horizontal);
    hpack.set_spacing(8);
    let mut font = Choice::default().with_size(130, 25);
    let mut choice = Choice::default().with_size(130, 25);
    let mut size = Spinner::default().with_size(60, 25);

    let mut color = Choice::default().with_size(100, 25);
    let mut btn_clear = Button::default().with_size(40, 25).with_label("X");
    hpack.end();

    vpack.end();
    wind.end();
    wind.show();

    text_editor.wrap_mode(fltk::text::WrapMode::AtBounds, 0);
    text_editor.set_buffer(TextBuffer::default());

    font.add_choice("Courier|Helvetica|Times");
    font.set_value(0);
    font.set_tooltip("Font");

    choice.add_choice("Normal|Underline|Strike");
    choice.set_value(0);

    size.set_value(18.0);
    size.set_step(1.0);
    size.set_range(12.0, 28.0);
    size.set_tooltip("Size");

    color.set_tooltip("Color");
    color.add_choice("#000000|#ff0000|#00ff00|#0000ff|#ffff00|#00ffff");
    color.set_value(0);

    btn_clear.set_label_color(Color::Red);
    btn_clear.set_tooltip("Clear style");

    // set colors
    for mut item in color.clone() {
        if let Some(lbl) = item.label() {
            item.set_label_color(Color::from_u32(
                u32::from_str_radix(lbl.trim().strip_prefix('#').unwrap(), 16)
                    .ok()
                    .unwrap(),
            ));
        }
    }

    let style_rc1 = Rc::clone(&style);

    text_editor.buffer().unwrap().add_modify_callback({
        let mut text_editor1 = text_editor.clone();
        let font1 = font.clone();
        let size1 = size.clone();
        let color1 = color.clone();
        let choice1 = choice.clone();
        move |pos: i32, ins_items: i32, del_items: i32, _: i32, _: &str| {
            let attr = if choice1.value() == 1 {
                TextAttr::Underline
            } else if choice1.value() == 2 {
                TextAttr::StrikeThrough
            } else {
                TextAttr::None
            };
            if ins_items > 0 || del_items > 0 {
                let mut style = style_rc1.borrow_mut();
                let color = Color::from_u32(
                    u32::from_str_radix(
                        color1
                            .text(color1.value())
                            .unwrap()
                            .trim()
                            .strip_prefix('#')
                            .unwrap(),
                        16,
                    )
                    .ok()
                    .unwrap(),
                );
                style.apply_style(
                    Some(pos),
                    Some(ins_items),
                    Some(del_items),
                    None,
                    None,
                    Font::by_name(font1.text(font1.value()).unwrap().trim()),
                    size1.value() as i32,
                    color,
                    attr,
                    &mut text_editor1,
                );
            }
        }
    });

    color.set_callback({
        let size = size.clone();
        let font = font.clone();
        let choice = choice.clone();
        let mut text_editor = text_editor.clone();
        let style_rc1 = Rc::clone(&style);
        move |color| {
            let attr = match choice.value() {
                0 => TextAttr::None,
                1 => TextAttr::Underline,
                2 => TextAttr::StrikeThrough,
                _ => unreachable!(),
            };
            if let Some(buf) = text_editor.buffer() {
                if let Some((s, e)) = buf.selection_position() {
                    let mut style = style_rc1.borrow_mut();
                    let color = Color::from_u32(
                        u32::from_str_radix(
                            color
                                .text(color.value())
                                .unwrap()
                                .trim()
                                .strip_prefix('#')
                                .unwrap(),
                            16,
                        )
                        .ok()
                        .unwrap(),
                    );
                    style.apply_style(
                        None,
                        None,
                        None,
                        Some(s),
                        Some(e),
                        Font::by_name(font.text(font.value()).unwrap().trim()),
                        size.value() as i32,
                        color,
                        attr,
                        &mut text_editor,
                    );
                }
            }
        }
    });

    // get the style from the current cursor position
    text_editor.handle({
        let style_rc1 = Rc::clone(&style);
        let mut font1 = font.clone();
        let mut size1 = size.clone();
        let mut color1 = color.clone();
        move |te, e| match e {
            Event::KeyUp | Event::Released => {
                if let Some(buff) = te.style_buffer() {
                    let i = te.insert_position();
                    if let Some(t) = buff.text_range(i, i + 1) {
                        if !t.is_empty() {
                            let style = style_rc1.borrow_mut();
                            if let Some(i) = t.chars().next().map(|c| (c as usize - 65)) {
                                if let Some(style) = style.style_table.get(i) {
                                    if let Some(mn) = font1.find_item(&format!("{:?}", style.font))
                                    {
                                        font1.set_item(&mn);
                                    }
                                    size1.set_value(style.size as f64);
                                    let (r, g, b) = style.color.to_rgb();
                                    if let Some(mn) =
                                        color1.find_item(format!("{r:02x}{g:02x}{b:02x}").as_str())
                                    {
                                        color1.set_item(&mn);
                                    }
                                }
                            }
                        }
                    }
                }
                true
            }
            _ => false,
        }
    });

    choice.set_callback({
        let mut color1 = color.clone();
        move |_| color1.do_callback()
    });

    font.set_callback({
        let mut color1 = color.clone();
        move |_| color1.do_callback()
    });

    size.set_callback({
        let mut color1 = color.clone();
        move |_| color1.do_callback()
    });

    // clear style of the current selection or, if no text is selected, clear all text style
    btn_clear.set_callback({
        let style_rc1 = Rc::clone(&style);
        let text_editor1 = text_editor.clone();
        move |_| {
            match text_editor1.buffer().unwrap().selection_position() {
                Some((_, _)) => {
                    font.set_value(0);
                    size.set_value(18.0);
                    color.set_value(0);
                    choice.set_value(0);
                    color.do_callback();
                }
                None => {
                    font.set_value(0);
                    size.set_value(18.0);
                    color.set_value(0);
                    style_rc1.borrow_mut().apply_style(
                        None,
                        None,
                        None,
                        Some(0),
                        Some(text_editor1.buffer().unwrap().length()),
                        Font::Courier,
                        16,
                        Color::Black,
                        TextAttr::None,
                        &mut text_editor,
                    );
                }
            };
        }
    });

    app.run().unwrap();
}
source

pub fn to_rgba(&self) -> (u8, u8, u8, u8)

Available on crate feature enable-glwindow only.

Get the RGBA value of the color

Trait Implementations§

source§

impl Clone for Color

source§

fn clone(&self) -> Color

Returns a copy of the value. Read more
1.0.0 · source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
source§

impl Debug for Color

source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
source§

impl Display for Color

source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
source§

impl Hash for Color

source§

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher. Read more
1.3.0 · source§

fn hash_slice<H>(data: &[Self], state: &mut H)
where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher. Read more
source§

impl Ord for Color

source§

fn cmp(&self, other: &Color) -> Ordering

This method returns an Ordering between self and other. Read more
1.21.0 · source§

fn max(self, other: Self) -> Self
where Self: Sized,

Compares and returns the maximum of two values. Read more
1.21.0 · source§

fn min(self, other: Self) -> Self
where Self: Sized,

Compares and returns the minimum of two values. Read more
1.50.0 · source§

fn clamp(self, min: Self, max: Self) -> Self
where Self: Sized + PartialOrd,

Restrict a value to a certain interval. Read more
source§

impl PartialEq for Color

source§

fn eq(&self, other: &Color) -> bool

This method tests for self and other values to be equal, and is used by ==.
1.0.0 · source§

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
source§

impl PartialOrd for Color

source§

fn partial_cmp(&self, other: &Color) -> Option<Ordering>

This method returns an ordering between self and other values if one exists. Read more
1.0.0 · source§

fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator. Read more
1.0.0 · source§

fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator. Read more
1.0.0 · source§

fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator. Read more
1.0.0 · source§

fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator. Read more
source§

impl Copy for Color

source§

impl Eq for Color

source§

impl StructuralPartialEq for Color

Auto Trait Implementations§

§

impl Freeze for Color

§

impl RefUnwindSafe for Color

§

impl Send for Color

§

impl Sync for Color

§

impl Unpin for Color

§

impl UnwindSafe for Color

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> ToOwned for T
where T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T> ToString for T
where T: Display + ?Sized,

source§

default fn to_string(&self) -> String

Converts the given value to a String. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.