63 releases (11 breaking)
new 0.11.0 | Sep 27, 2023 |
---|---|
0.9.0 | Sep 16, 2023 |
0.7.6 | Jul 27, 2023 |
#33 in Visualization
300 downloads per month
57KB
1K
SLoC
egui_graphs
Graph visualization with rust, petgraph and egui in its DNA.
The project implements a Widget for the egui framework, enabling easy visualization of interactive graphs in rust. The goal is to implement the very basic engine for graph visualization within egui, which can be easily extended and customized for your needs.
Features
- Visualization of any complex graphs;
- Zooming and panning;
- Node labels;
- Node interactions and events reporting: click, double click, select, drag;
- Style configuration;
Status
The project is on track for a stable release v1.0.0. For the moment, breaking releases are still possible.
Docs
Docs can be found here
Examples
Basic setup example
Step 1: Setting up the BasicApp struct.
First, let's define the BasicApp
struct that will hold the graph.
pub struct BasicApp {
g: Graph<(), (), Directed>,
}
Step 2: Implementing the new() function.
Next, implement the new()
function for the BasicApp
struct.
impl BasicApp {
fn new(_: &CreationContext<'_>) -> Self {
let g = generate_graph();
Self { g: Graph::from(&g) }
}
}
Step 3: Generating the graph.
Create a helper function called generate_graph()
. In this example, we create three nodes with and three edges connecting them in a triangular pattern.
fn generate_graph() -> StableGraph<(), (), Directed> {
let mut g: StableGraph<(), ()> = StableGraph::new();
let a = g.add_node(());
let b = g.add_node(());
let c = g.add_node(());
g.add_edge(a, b, ());
g.add_edge(b, c, ());
g.add_edge(c, a, ());
g
}
Step 4: Implementing the update() function.
Now, lets implement the update()
function for the BasicApp
. This function creates a GraphView
widget providing a mutable reference to the graph, and adds it to egui::CentralPanel
using the ui.add()
function for adding widgets.
impl App for BasicApp {
fn update(&mut self, ctx: &Context, _: &mut eframe::Frame) {
egui::CentralPanel::default().show(ctx, |ui| {
ui.add(&mut GraphView::new(&mut self.g));
});
}
}
Step 5: Running the application.
Finally, run the application using the run_native()
function with the specified native options and the BasicApp
.
fn main() {
let native_options = eframe::NativeOptions::default();
run_native(
"egui_graphs_basic_demo",
native_options,
Box::new(|cc| Box::new(BasicApp::new(cc))),
)
.unwrap();
}
You can further customize the appearance and behavior of your graph by modifying the settings or adding more nodes and edges as needed.
Gallery
Dependencies
~5–10MB
~87K SLoC