drew-sim

Librairie de rendu 3D immédiat pour applications [eframe]/[egui], pensée pour la visualisation de télémétrie temps réel : drones, robots, capteurs d'orientation.

Installation

[dependencies]
drew-sim = "0.1"

La feature stl (chargement de fichiers .stl) est activée par défaut. Pour s'en passer :

drew-sim = { version = "0.1", default-features = false }

Contrôles souris (zone de rendu 3D)

Action	Effet
Clic gauche + glisser	Orbite la caméra
Molette	Zoom
Clic droit ou clic molette + glisser	Panoramique

Ces contrôles sont gérés automatiquement par Engine3D::render , rien à faire côté application, mais rien n'est affiché à l'écran non plus (pas de widget de caméra visible : c'est purement à la souris).

Fonctions utiles

Engine3D : moteur haut niveau (src/engine.rs)

Fonction	Rôle
Engine3D::default()	Caméra à orbit=0.5, zoom=1.0, grille par défaut
engine.render(ui, |r| { ... })	Alloue la zone de dessin, applique la souris à la caméra, dessine la grille de sol, puis appelle la closure avec un Render3D prêt à l'emploi
engine.camera	Accès direct à l'OrbitCamera (ex : forcer un angle au démarrage)
engine.grid	GridStyle : couleurs et espacement de la grille au sol

Render3D : primitives de dessin (src/render.rs), utilisées dans la closure de render(...)

Fonction	Rôle
r.world_to_screen(pos)	Projette un point 3D vers l'écran (utile pour dessiner autre chose que les primitives ci-dessous)
r.draw_mesh(&mesh, position, rotation, color)	Maillage en fil de fer
r.draw_mesh_with_stroke(&mesh, position, rotation, stroke)	Idem, avec un egui::Stroke complet (épaisseur de trait)
r.draw_axes(position, rotation, length)	Repère XYZ (Rouge = X, Vert = Y, Bleu = Z)
r.draw_trail(&points, color)	Polyligne reliant un historique de positions
r.draw_chart(rect, &values, min, max, color)	Graphe 2D (courbe de valeurs), indépendant de la caméra 3D :pour afficher un capteur en overlay

Mesh3D (src/mesh.rs)

Fonction	Rôle
Mesh3D::from_stl_file(path)	Charge un .stl (nécessite la feature stl)
Mesh3D::unit_cube(size)	Cube généré sans dépendance externe, pratique pour tester rapidement
Mesh3D::from_raw(vertices, triangles)	Construit un maillage à la main, avec validation des indices
mesh.triangle_count()	Nombre de triangles

TelemetryState / TrailBuffer (src/telemetry.rs)

Fonction	Rôle
TelemetryState { position, rotation }	Contrat agnostique de la source (capteur réel, simulation, rejeu de log)
TrailBuffer::new(capacity)	Historique de positions à taille bornée (évite une fuite mémoire en session longue)
trail.push(pos) / trail.as_slice() / trail.clear()	Alimenter et lire le buffer

Rotation3D (src/math.rs)

Fonction	Rôle
Rotation3D::new(roll, pitch, yaw)	Angles en radians
Rotation3D::IDENTITY	Rotation nulle
rotation.rotate_point(p)	Applique la rotation à un point
rotation.compose(other)	Cumule deux rotations (approximation par angles d'Euler — voir feuille de route)

Exemple minimal

use drew_sim::{Engine3D, Mesh3D, Rotation3D, TelemetryState};
use drew_sim::egui;

struct App {
    engine: Engine3D,
    mesh: Mesh3D,
    state: TelemetryState,
}

impl eframe::App for App {
    fn update(&mut self, ctx: &egui::Context, _frame: &mut eframe::Frame) {
        egui::CentralPanel::default().show(ctx, |ui| {
            self.engine.render(ui, |r| {
                r.draw_mesh(&self.mesh, self.state.position, self.state.rotation, egui::Color32::WHITE);
                r.draw_axes(self.state.position, self.state.rotation, 1.5);
            });
        });
    }
}

fn main() -> eframe::Result<()> {
    eframe::run_native(
        "drew-sim minimal",
        eframe::NativeOptions::default(),
        Box::new(|_cc| {
            Box::new(App {
                engine: Engine3D::default(),
                mesh: Mesh3D::unit_cube(1.5),
                state: TelemetryState::default(),
            })
        }),
    )
}

Le type de retour attendu par run_native dépend de la version d'eframe : en 0.27 la closure retourne directement Box<dyn App> (comme ci-dessus) ; à partir de 0.28 elle retourne Result<Box<dyn App>, _> — adapter selon ta version si cargo signale une erreur E0308 sur ce point.

Exemple complet

Un exemple plus riche (cube animé, trail, graphe d'altitude) est fourni :

cargo run --example orbit_viewer --release

Feuille de route

• Rendu avec faces pleines / z-buffer simple (actuellement fil de fer)
• Import d'autres formats de maillage (OBJ)
• HUD optionnel affichant les contrôles souris et l'état de la caméra

Licence

GPL-2.0-or-later — voir LICENSE.

Copyright (C) 2026 Jorge Andre Castro