four-bar-ui 2.0.0

Four🍀bar GUI is a simulator, a synthesizing tool for four-bar linkage mechanism.
1
2
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

# Four🍀bar

[![dependency status](https://deps.rs/repo/github/KmolYuan/four-bar-rs/status.svg)](https://deps.rs/repo/github/KmolYuan/four-bar-rs)
[![documentation](https://docs.rs/four-bar/badge.svg)](https://docs.rs/four-bar)

Four🍀bar is a simulator and a synthesizing tool for four-bar linkage mechanism.

+ GUI program is called `four-bar-ui`, but the executable is called `four-bar`.
+ Kernel library `four-bar` is on [crates.io](https://crates.io).

Online demo: <https://kmolyuan.github.io/four-bar-rs/>

Powered by <https://github.com/emilk/egui>.

Native icon from <https://icons8.com>.

## Native Executable

In Linux, `libxcb` and `libgtk-3` are required. (most desktops are already provided)

In Windows, since the builds are set in Visual Studio, the [support of Visual C++](https://docs.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-160) is required.

Download: <https://github.com/KmolYuan/four-bar-rs/releases/latest>

Native GUI is the default startup behaviour, use `--help` option to see more commands.

```bash
# Equivalent to double-clicking the executable
four-bar
# Equivalent to opening by the app or file dragging
four-bar FILE_PATH1 FILE_PATH2
```

## Native Build

In Linux, you need to install some library for GUI:

```bash
sudo apt install libxcb-render0-dev libxcb-shape0-dev libxcb-xfixes0-dev libxkbcommon-dev libgtk-3-dev
```

Then run with cargo directly:

```bash
cargo run
# CLI Mode
cargo run -- --help
```

## WebAssembly Build

Run those scripts from the repository:

```bash
cargo install trunk
cd four-bar-ui
trunk serve
trunk build --release
```

The application is deployed in the `dist` directory (entire files).