16 releases
0.5.21 | Sep 21, 2024 |
---|---|
0.5.19 | Dec 29, 2023 |
0.5.17 | Aug 2, 2023 |
0.5.16 | Jul 19, 2023 |
0.5.8 | Nov 29, 2022 |
#1455 in GUI
66 downloads per month
44KB
909 lines
fl2rust
Usage
A fluid (fltk ui designer) file to Rust transpiler.
MSRV
The minimum supported Rust version for 0.5 is 1.63 and fltk-rs > 1.3.21.
As an executable
You can run fl2rust on the command-line by installing using cargo-install:
$ cargo install fl2rust
Then run:
$ fl2rust <fl file>.fl > <output file>.rs
As a proc-macro
(A template repo usable via cargo-generate can be found here) Add fl2rust-macro to your list of dependencies:
# Cargo.toml
[dependencies]
fltk = "1"
fl2rust-macro = "0.5"
The ui file that's generated by fluid, we'll name it myuifile.fl and keep it in our src directory:
# data file for the Fltk User Interface Designer (fluid)
version 1.0400
header_name {.h}
code_name {.cxx}
class UserInterface {open
} {
Function {make_window()} {open
} {
Fl_Window {} {open selected
xywh {138 161 440 355} type Double visible
} {
Fl_Button but {
label {Click me}
xywh {175 230 95 45}
}
}
}
}
In our main source file:
use fltk::{prelude::*, *};
mod ui {
fl2rust_macro::include_ui!("src/myuifile.fl");
}
fn main() {
let a = app::App::default();
let mut ui = ui::UserInterface::make_window();
ui.but.set_callback(|b| println!("Button clicked!"));
a.run().unwrap();
}
In our build.rs file:
fn main() {
println!("cargo:rerun-if-changed=src/myuifile.fl");
}
As a build-dependency
To automate things through cargo, you can use fl2rust as a library by adding it to your build-dependencies:
# Cargo.toml
[dependencies]
fltk = "1"
[build-dependencies]
fl2rust = "0.5"
// build.rs
fn main() {
use std::path::PathBuf;
use std::env;
println!("cargo:rerun-if-changed=src/myuifile.fl");
let g = fl2rust::Generator::default();
let out_path = PathBuf::from(env::var("OUT_DIR").unwrap());
g.in_out("src/myuifile.fl", out_path.join("myuifile.rs").to_str().unwrap()).expect("Failed to generate rust from fl file!");
}
The ui file that's generated by fluid, we'll name it myuifile.fl and keep it in our src directory:
# data file for the Fltk User Interface Designer (fluid)
version 1.0400
header_name {.h}
code_name {.cxx}
class UserInterface {open
} {
Function {make_window()} {open
} {
Fl_Window {} {open selected
xywh {138 161 440 355} type Double visible
} {
Fl_Button but {
label {Click me}
xywh {175 230 95 45}
}
}
}
}
// src/myuifile.rs
#![allow(unused_variables)]
#![allow(unused_mut)]
#![allow(unused_imports)]
#![allow(dead_code)]
#![allow(clippy::needless_update)]
include!(concat!(env!("OUT_DIR"), "/myuifile.rs"));
// src/main.rs
use fltk::{prelude::*, *};
mod myuifile;
fn main() {
let app = app::App::default();
let mut ui = myuifile::UserInterface::make_window();
ui.but.set_callback(move |_| {
println!("Works!");
});
app.run().unwrap();
}
Where you can get FLUID?
There are several options:
cargo install fltk-fluid
- Through a package manager.
- By building the fltk library yourself using cmake.
i18n support
Version 0.4.4 adds i18n support via the tr!
macro from the tr crate.
To enable it:
- In fluid, go to Edit->Project Settings...->Internationalization.
- Change the dropdown to use GNU gettext (which the tr crate supports in both forms gettext-rs and gettext).
- Add tr to you dependencies in you Cargo.toml.
- Add to your main.rs file:
#[macro_use]
extern crate tr;
- Initialize tr as described in the tr crate's documentation.
Known limitations
- Only constructor methods are supported.
- fl2rust doesn't check the generated Rust code for correctness.
Tutorial
Dependencies
~32KB