Since you're already using raqote, I though you might be interest in a faster, more actively developed alternative.

tiny-skia is a direct raqote rival. It's basically a Skia CPU subset ported to pure Rust. And it's usually 2-6x faster than raqote, while still 2-3 times slower than Skia (it's mainly SIMD issues). In many cases it's even faster than cairo.

Is still in development (90% is done) and I plan to use it in resvg very soon. And I'm interested in any kind of feedback.

Context

There is very (too?) little documentation available, especially for newbies.

Problem description & Solution

Documentation can be generated with: cargo doc --no-deps --open The resulting documentation is nice and all, but a bit to daunting for a beginner. The examples are super helpful, but do not provide sufficient context. It would be helpful to have some documentation on how to get started. How to connect functions to buttons, update labels (textboxes), etc. These can be extracted from the examples, but only with a lot of effort.

Help?

I am going to try to get some stuff made with orbTk. I would really love to help out by writing documentation (a starters guide or something... to help beginners). However, I would be helpful if somebody could create a start on which I can continue...

Context:

this is the PR linked to the issue https://github.com/redox-os/orbtk/issues/298 .

Contribution checklist:

• [x] Add documentation to all public structs, traits and functions.
• [ ] Add unit tests if possible
• [x] Describe the major change(s) in the CHANGELOG.MD
• [x] Run cargo fmt to make the formatting consistent across the codebase
• [x] Run cargo clippy to check with the linter

Hi, The Popup should work correctly, but currently make ComboBox unable to open. There is a strange behaviour on ComboBox that i don't understand: it have a closing function, but not an opening one. The only thing that could open the popup could be the SelectedBehaviour on:

                        SelectionBehavior::new()
                            .selected(id) //<--- here
                            .enabled(id)
                            .target(id.0)
                            .child(container)
                            .build(ctx),

Unfortunately i have never used that struct, so i don't know how exactly work.

Maybe there is some strange interaction that i miss. Anyway i have moved the popup logic on the PopupRenderObject. It is a simple Render Object that run the popup logic and than tell to a RectangleRenderObject to render. In this way there is no code repetition, while keeping all the features of RectangleRenderObject. I have also pushed the example code that i have used to test it. For now i have pushed it as "popup2.rs" on the example folder. I think that a good test is also check that the current popup example work correctly with the new popup.

I will keep looking for the root of the problem, meanwhile i would like to know what do you think.

Have a good day

Hi, for an application that i'm making i needed a tab widget to manage the user interface, so i have realized it. I think that now it is in a good shape from a functionality point of view, visually it is ugly but at least work correctly. Maybe with some css magic could be better. Since i saw that there is a tab widget request on the project page, i thought: "why not share?". Following an example code that i have used during testing:

use orbtk::prelude::*;

fn main() {
      Application::new()
        .window(|ctx| {
            Window::new()
                .title("OrbTk - minimal example")
                .position((100.0, 100.0))
                .size(600.0, 500.0)
                .resizeable(true)
                .child(
                    TabWidget::new()
                    .tab("Tab header 1",TextBlock::new().text("Tab content 1").build(ctx))
                    .tab("Tab header 2",TextBlock::new().text("Tab content 2").build(ctx))
                    .tab("Tab header 3",TextBlock::new().text("Tab content 3").build(ctx))
                    .build(ctx)
                )
                .build(ctx)
        })
        .run();
}

Currently the TabWidget does not share values about tabs because setting them from the outside could lead into inconsistencies because i cannot get some change callbacks that hint the widget to change state. So for now the widget state is managed internally by the TabWidgetState structure. The widget will not draw everything during the update call, but only what it is changed, so this make it very lightweight. There are 2 values shared by TabWidget:

• close_button(bool): should set the visibility of the close button on the right of the tabs, currently not implemented
• spacing(f64): set the spacing between tabs

I'm writing some other widgets that are less fundamental and more specialized. If you want i can also share those (maybe putting in a separated folder inside widget folder called "extra" or something similar?) Some of those widget already completed:

• DiscreteBar: Similar to ProgressBar, but instead of working on 0%-100% work on discrete value that can be setted as "min" and "max", then the current value can be setted with "val". The widget will display the value using Container widgets that look like bars.
• Fraction: It is a simple TextBlock that have "val" and "max" property and they are used to display a fraction like "3/10". Since they are managed using properties, setting a shared property will make the widget automatically adjust it's values (i have used it in combination with the DiscreteBar)

Hope it could be useful, Have a good day

All examples show that the toolkit is using a fixed timestep, rendering at approximately at 10-15 FPS.

To reproduce Run any example.

Expected behavior The toolkit should pick up the refresh rate of my monitor by using vertical sync.

Configuration:

• OS: Windows 10 Pro
• Native (no browser)
• OrbTK v0.3.1-alpha2

This code

use orbtk::*;
use std::vec::Vec;
use std::cell::RefCell;
use std::rc::Rc;
use std::io::Write;
use std::str::FromStr;

extern crate strum;
#[macro_use]
extern crate strum_macros;

widget!(MainView);

// Enumeration of all possible operators
#[derive(EnumString)]
enum Operator {
    #[strum(serialize="+")]
    Plus,
    #[strum(serialize="-")]
    Min,
    #[strum(serialize="*")]
    Times,
    #[strum(serialize="/")]
    Divide,
}

impl Template for MainView {
    fn template(self, _: Entity, ctx: &mut BuildContext) -> Self {

        // String holding pressed keys creating an infix string
        // And a TextBox object holding that string
        let pressed_keys : Rc<RefCell<String>> = Rc::new(RefCell::new("".to_string()));
        let mut screen : Rc<RefCell<TextBox>> =
            Rc::new(RefCell::new(
                TextBox::create()
                    .text("")
                    .attach(Grid::row(0))
                    .attach(Grid::column(0))
                    .attach(Grid::column_span(4))
            ));


        // Initializing Grid
        let mut grid = Grid::create(); 

        // Configuring grid (amount of rows and columns)
        grid = grid
            .columns(
                Columns::create()
                    .column("*")
                    .column("*")
                    .column("*")
                    .column("*")
                    .build()
            )
            .rows(
                Rows::create()
                    .row(50.0)
                    .row(50.0)
                    .row(50.0)
                    .row(50.0)
                    .row(50.0)
                    .row(50.0)
                    .row(50.0)
                    .build()
            );
       
        //Adding textbox holding entered numbers and operators
        grid = grid.child(
            screen.borrow_mut().build(ctx)
        );

        // Adding all buttons from 1-9 to the grid
        // in calculator format
        let mut counter : u8 = 9;
        for i in 1..4 {
            for j in 0..3 {
                grid = grid.child(
                    Button::create()
                        .text(counter.to_string())
                        .attach(Grid::column(2-j))
                        .attach(Grid::row(i))
                        .on_click({
                            let pressed_keys = pressed_keys.clone();
                            let screen = screen.clone();
                            move |_states, _| -> bool {
                                *pressed_keys.borrow_mut() = format!("{}{}", *pressed_keys.borrow(), counter.to_string());
                                let screen_text : String = pressed_keys.borrow().clone();
                                screen.borrow().text(screen_text);
                                true
                            }
                        })
                        .build(ctx)
                );

                counter = counter - 1;
            }
        }


        self.name("MainView").child(
            grid.build(ctx)
        )
   } 
}


fn main() {
    Application::new()
        .window(|ctx| {
            Window::create()
                .title("OrbTk - Calculator")
                .position((100.0, 100.0))
                .size(420.0, 500.0)
                .child(MainView::create().build(ctx))
                .build(ctx)
        })
        .run();
}

returns the following error:

error[E0507]: cannot move out of dereference of `std::cell::Ref<'_, orbtk_widgets::text_box::TextBox>`
  --> src/main.rs:89:33
   |
89 | ...                   screen.borrow().text(screen_text);
   |                       ^^^^^^^^^^^^^^^ move occurs because value has type `orbtk_widgets::text_box::TextBox`, which does not implement the `Copy` trait

In the Calculator example they use .id() but this doesn't seem to work. How to fix this? I just want to update the value of a textbox when a button is clicked.

Describe the bug Grid rows with auto height are not sized correctly to contain their children. The children end up overlapping with those of other rows. Unsure whether this issue applies to column width as well.

Thank you for your work on this toolkit. On paper it's exactly what I want. :)

To Reproduce Compile and run the following code.

use orbtk::prelude::*;

#[derive(Default, AsAny)]
struct MainViewState {}

impl MainViewState {}

impl State for MainViewState {}

widget!(MainView<MainViewState> {
    text: String16
});

impl Template for MainView {
    fn template(self, id: Entity, ctx: &mut BuildContext) -> Self {
        self.name("MainView")
            .width(400.0)
            .height(1000.0)
            .text("")
            .child(
                Grid::create()
                    .rows(
                        Rows::create()
                            .row("auto")
                            .row("auto")
                            .row("auto")
                            .row("auto")
                            .row("auto")
                            .row("auto")
                            .row("auto")
                            .row("auto")
                            .build(),
                    )
                    .child(
                        generate_text_field(ctx, "Title")
                            .attach(Grid::column(0))
                            .attach(Grid::row(0))
                            .build(ctx),
                    )
                    .child(
                        generate_text_array_field(ctx, "Authors")
                            .attach(Grid::column(0))
                            .attach(Grid::row(1))
                            .build(ctx),
                    )
                    .child(
                        generate_text_array_field(ctx, "Owners")
                            .attach(Grid::column(0))
                            .attach(Grid::row(2))
                            .build(ctx),
                    )
                    .child(
                        generate_text_array_field(ctx, "Recipients")
                            .attach(Grid::column(0))
                            .attach(Grid::row(3))
                            .build(ctx),
                    )
                    .child(
                        generate_text_field(ctx, "Type")
                            .attach(Grid::column(0))
                            .attach(Grid::row(4))
                            .build(ctx),
                    )
                    .child(
                        generate_text_array_field(ctx, "Languages")
                            .attach(Grid::column(0))
                            .attach(Grid::row(5))
                            .build(ctx),
                    )
                    .child(
                        generate_text_array_field(ctx, "Tags")
                            .attach(Grid::column(0))
                            .attach(Grid::row(6))
                            .build(ctx),
                    )
                    .child(
                        generate_text_array_field(ctx, "Keywords")
                            .attach(Grid::column(0))
                            .attach(Grid::row(7))
                            .build(ctx),
                    )
                    .build(ctx),
            )
    }
}

fn generate_text_field(ctx: &mut BuildContext, label: &str) -> Container {
    Container::create()
        .padding(8)
        .border_width(2.0)
        .border_brush(Color::rgb(255, 255, 255))
        .child(
            Grid::create()
                .rows(Rows::create().row("auto").row("auto").build())
                .child(
                    orbtk::TextBlock::create()
                        .attach(Grid::row(0))
                        .text(label)
                        .build(ctx),
                )
                .child(
                    orbtk::TextBox::create()
                        .attach(Grid::row(1))
                        .width(300.0)
                        .text("")
                        .build(ctx),
                )
                .build(ctx),
        )
}

fn generate_text_array_field(ctx: &mut BuildContext, label: &str) -> Container {
    Container::create()
        .padding(8)
        .border_width(2.0)
        .border_brush(Color::rgb(255, 255, 255))
        .child(
            Grid::create()
                .columns(Columns::create().column("auto").column("auto").build())
                .rows(Rows::create().row("auto").row("auto").row("auto").build())
                .child(
                    TextBlock::create()
                        .attach(Grid::row(0))
                        .text(label)
                        .build(ctx),
                )
                .child(
                    TextBox::create()
                        .width(300.0)
                        .text("")
                        .attach(Grid::column(0))
                        .attach(Grid::row(1))
                        .build(ctx),
                )
                .child(
                    Button::create()
                        .size(40.0, 32.0)
                        .text("Delete")
                        .attach(Grid::row(1))
                        .attach(Grid::column(1))
                        .build(ctx),
                )
                .child(
                    Button::create()
                        .size(40.0, 32.0)
                        .text("Add")
                        .attach(Grid::row(2))
                        .attach(Grid::column(0))
                        .build(ctx),
                )
                .build(ctx),
        )
}

pub fn main() {
    orbtk::Application::new()
        .window(|ctx| {
            Window::create()
                .title("Window Title")
                .position((100.0, 100.0))
                .resizeable(true)
                .size(450.0, 500.0)
                .child(MainView::create().build(ctx))
                .build(ctx)
        })
        .run();
}

Expected behavior The rows should automatically be made tall enough to fully contain their respective children. The same should be true for the width of columns with auto width.

Screenshots

Desktop

• OS: Arch Linux with XFCE 4.14

Additional context OrbTk rev abd8f786010584ba21d9f410d381685b14794dad (current develop)

Describe the bug The command cargo run --example showcase --release fails with

error: failed to run custom build command for `sdl2-sys v0.34.3`

Caused by:
  process didn't exit successfully: `/home/wucke13/documents/projects/rust/orbtk/target/release/build/sdl2-sys-d600d0eb48651eb0/build-script-build` (exit code: 101)
--- stderr
thread 'main' panicked at 'Command 'curl' failed:   % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
  0     0    0     0    0     0      0      0 --:--:-- --:--:-- --:--:--     0
curl: (60) SSL certificate problem: unable to get local issuer certificate
More details here: https://curl.haxx.se/docs/sslcerts.html

curl failed to verify the legitimacy of the server and therefore could not
establish a secure connection to it. To learn more about this situation and
how to fix it, please visit the web page mentioned above.
', /home/wucke13/.cargo/registry/src/github.com-1ecc6299db9ec823/sdl2-sys-0.34.3/build.rs:53:17
note: run with `RUST_BACKTRACE=1` environment variable to display a backtrace

warning: build failed, waiting for other jobs to finish...
error: build failed

To Reproduce Steps to reproduce the behavior:

1. run cargo run --example showcase --releas on latest develop branch

Expected behavior The thing compiles at least

Desktop (please complete the following information):

• OS: NixOS 20.09

When running showcase example on Linux X11 a window with all widget appears but it does not react on any input events (e.g. appears to be frozen)

Steps to reproduce:

• find linux workstation
• find X11 DE ( KDE 5.20 in my case)
• cargo new showcase
• copy contents from showcase example
• cargo run

observe the frozen window

Describe the bug The showcase example is lagging even in release mode. I suspect the problem is with the new messaging system introduced not so long ago. The screenshot shows the performance measurement made with perf that the example spends most of the time with multi-threaded types. Also a lot of mouse clicks is lost.

To Reproduce Steps to reproduce the behavior: cargo run --example showcase --release

Expected behavior The example should not lag at all.

Screenshots

Desktop: Win 10 Manjaro KDE 20.0.3

Additional context Even on idle, i have constant 20-35% CPU usage when running an orbtk app.

Context

The ProgessBar should be used to indicates a progress, e.g. the progress by loading a file, or a screen.

Problem description & Solution

The ProgressBar should be indicates the progress between a min-value and a max-value. The current progress should be set by a val property.

Examples and MockUps

ProgressBar::create().min(0.0).max(100.0).val(50.0).build(ctx)

Hello,

when i use sdl2 as ony dependencie it compliles without an error, when i use orbtk (crates and dev-version) as standalone it compliles not under windows-msys2.

 C:/Mounts/externalDrives/extHDD(Home5TB)/Development/Rust/Users/cypu/.cargo/registry/src/github.com-1ecc6299db9ec823/sdl2-sys-0.35.2/SDL/src/joystick/windows/SDL_windows_gaming_input.c:649:113: note: expected '__FIReference_1_INT32 **' but argument is of type 'int **'
  make[2]: *** [CMakeFiles/SDL2-static.dir/build.make:2386: CMakeFiles/SDL2-static.dir/src/joystick/windows/SDL_windows_gaming_input.c.obj] Error 1
  make[2]: *** Waiting for unfinished jobs....
  make[1]: *** [CMakeFiles/Makefile2:112: CMakeFiles/SDL2-static.dir/all] Error 2
  make: *** [Makefile:136: all] Error 2
  thread 'main' panicked at '
  command did not execute successfully, got: exit code: 2

thx

When trying to do the exercises in the orbtk book, I am able to compile the first example orbtk_hello. The window title shows up but the TextBlock contents do not show up. I tried changing the background but that did not resolve the issue. I then tried to use the orbtk_template code. Again, it compiled, title showed up but not the TextBlock.

Desktop (please complete the following information):

• OS: PopOs
• Browser Firefox 105.0.1

Additional context Add any other context about the problem here.

Context

In which context or scenario will your feature/widget be used?

Problem description & Solution

Describe your problem and possible solution here

Examples and MockUps

Can you give a concrete example of how you'd use the feature? A relevant code sample? Can you draw a picture of what you're imagining? :-)

Describe the bug On commit id 68c67da85002195cf8e3ef5ed7fd325ed7bccebe (currently top of develop), I ran

❯ cargo run --example showcase

which gives me a black window. then I use git bisect, find out it's the top commit causing the problem.

My OS is macOS 12.2.

To Reproduce Steps to reproduce the behavior:

1. Git checkout to 68c67da85002195cf8e3ef5ed7fd325ed7bccebe
2. cargo run --example showcase
3. If compile failed due to missing symbol, try to add a orbtk/build.rs and manually link against CoreHaptics
4. See error

Expected behavior Showing normal examples

Screenshots

Desktop (please complete the following information):

• OS: MacOS
• Version 12.2

Additional context I'm willing to help, but it currently gives no more info in console.

Describe the bug When compiling the showcase example on an Intel-based Macbook, it fails with the error "Undefined symbols for architecture x86_64." I know this has been reported in the past but it was for a different version of macOS and I didn't want to hijack another thread.

  = note: Undefined symbols for architecture x86_64:
            "_OBJC_CLASS_$_CHHapticDynamicParameter", referenced from:
                objc-class-ref in libsdl2_sys-ee657edccdc41d23.rlib(SDL_mfijoystick.m.o)
            "_OBJC_CLASS_$_CHHapticEventParameter", referenced from:
                objc-class-ref in libsdl2_sys-ee657edccdc41d23.rlib(SDL_mfijoystick.m.o)
            "_CHHapticDynamicParameterIDHapticIntensityControl", referenced from:
                -[SDL_RumbleMotor setIntensity:] in libsdl2_sys-ee657edccdc41d23.rlib(SDL_mfijoystick.m.o)
            "_CHHapticEventParameterIDHapticIntensity", referenced from:
                -[SDL_RumbleMotor setIntensity:] in libsdl2_sys-ee657edccdc41d23.rlib(SDL_mfijoystick.m.o)
            "_OBJC_CLASS_$_CHHapticPattern", referenced from:
                objc-class-ref in libsdl2_sys-ee657edccdc41d23.rlib(SDL_mfijoystick.m.o)
            "_OBJC_CLASS_$_CHHapticEvent", referenced from:
                objc-class-ref in libsdl2_sys-ee657edccdc41d23.rlib(SDL_mfijoystick.m.o)
            "_CHHapticEventTypeHapticContinuous", referenced from:
                -[SDL_RumbleMotor setIntensity:] in libsdl2_sys-ee657edccdc41d23.rlib(SDL_mfijoystick.m.o)
          ld: symbol(s) not found for architecture x86_64
          clang: error: linker command failed with exit code 1 (use -v to see invocation)


error: could not compile `orbtk` due to previous error

To Reproduce Steps to reproduce the behavior:

1. Clone this repo.
2. Install sdl2 with Homebrew.
3. Build the showcase example as described in the README, with or without the "bundled" feature.
4. See error

Expected behavior the build process to complete successfully

Desktop:

• OS: macOS Monterey
• Version: 12.4
• Darwin kernel version: 21.5.0
• Architecture: x86_64

Additional context

• orbtk develop branch (68c67da8)
• sdl2: stable 2.0.22 (installed by brew install sdl2)
• Command Line Tools for Xcode 13.4

I also tried export LIBRARY_PATH="$(brew --prefix)/lib" as suggested by the rust-sdl2 project but this made no difference.