#mechanism #optimization #simulation

app four-bar-ui

Four🍀bar GUI is a simulator, a synthesizing tool for four-bar linkages

4 releases (major breaking)

4.0.0 Apr 13, 2023
3.0.0 Apr 13, 2023
2.0.0 Apr 13, 2023
1.0.0 May 10, 2022

#2024 in Algorithms

AGPL-3.0-or-later

15MB
6K SLoC

Four🍀bar

dependency status documentation

Web demo: https://kmolyuan.github.io/four-bar-rs/

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

  • CLI/GUI program is four-bar-ui crate, but the executable is called four-bar.
  • Kernel library four-bar is on crates.io.

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

Native icon from https://icons8.com.

Releases

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++ 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.

# 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:

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

Then run with cargo directly:

cargo run
# CLI Mode
cargo run -- --help

WebAssembly Build

Run those scripts from the repository:

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

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

Dependencies

~19–60MB
~1M SLoC