embassy-ssd1306-physics 0.3.0

Dessins 2D no_std pour objets physiques (bras robotique, pendule, ressort-masse, boussole, engrenages,piston) sur OLED SSD1306 128×64
Documentation 
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
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135

// Copyright (C) 2026 Jorge Andre Castro
// GPL-2.0-or-later

//! # piston
//!
//! Piston 2D mécanique propre (sans gaz).
//!
//! Modèle physique simplifié :
//! - cylindre fermé (chambre)
//! - piston contraint dans la chambre
//! - tige guidée (liaison rigide)
//!
//! Objectif : base future pour moteur thermique / crankshaft.

use embassy_ssd1306_graphics::Graphics;
use embedded_hal_async::i2c::I2c;

use crate::draw_utils::{segment, filled_rect};

/// Piston 2D vertical contraint dans une chambre.
#[derive(Clone, Copy, Debug)]
pub struct Piston {
    /// Centre X du cylindre
    pub cx: i32,
    /// Haut du cylindre
    pub cy: i32,

    /// Largeur du cylindre
    pub w: i32,
    /// Hauteur totale du cylindre
    pub h: i32,

    /// Épaisseur du piston
    pub piston_h: i32,

    /// Position normalisée [0..h - piston_h]
    pub pos: i32,
}

impl Piston {
    /// Crée un piston.
    ///
    /// `cx, cy` : centre haut de la chambre
    /// `w`      : largeur du cylindre
    /// `h`      : hauteur de la chambre
    pub fn new(cx: i32, cy: i32, w: i32, h: i32) -> Self {
        Self {
            cx,
            cy,
            w,
            h,
            piston_h: 6,
            pos: 0,
        }
    }

    /// Force la position du piston dans la chambre.
    #[inline]
    pub fn set_pos(&mut self, pos: i32) {
        let max = self.h - self.piston_h;
        self.pos = pos.clamp(0, max);
    }

    /// Position “physique” normalisée (0.0 → haut, 1.0 → bas)
    #[inline]
    pub fn normalized(&self) -> f32 {
        let max = (self.h - self.piston_h).max(1);
        self.pos as f32 / max as f32
    }

    /// Dessine le système piston + chambre.
    pub fn draw<I: I2c>(
        &self,
        gfx: &mut Graphics<'_, I>,
        _t: f32,
        on: bool,
        _cos_fn: fn(f32) -> f32,
        _sin_fn: fn(f32) -> f32,
    ) {
        let left = self.cx - self.w / 2;
        let right = self.cx + self.w / 2;

        let top = self.cy;
        let bottom = self.cy + self.h;

        // ─────────────────────────────
        // CHAMBRE (rectangle fermé)
        // ─────────────────────────────
        segment(gfx, left, top, right, top, on);
        segment(gfx, left, bottom, right, bottom, on);
        segment(gfx, left, top, left, bottom, on);
        segment(gfx, right, top, right, bottom, on);

        // ─────────────────────────────
        // PISTON (contraint)
        // ─────────────────────────────
        let max = self.h - self.piston_h;
        let y = self.cy + self.pos.clamp(0, max);

        filled_rect(
            gfx,
            left + 2,
            y,
            self.w - 4,
            self.piston_h,
            on,
        );

        // ─────────────────────────────
        // TIGE GUIDÉE (sans débordement visuel)
        // ─────────────────────────────
        let rod_x = self.cx;
        let rod_top = y + self.piston_h / 2;
        let rod_bottom = bottom;

        segment(gfx, rod_x, rod_top, rod_x, rod_bottom, on);

        // ─────────────────────────────
        // CAPUCHON BAS (stabilité visuelle)
        // ─────────────────────────────
        segment(gfx, left, bottom, right, bottom, on);
    }

    /// Efface
    #[inline]
    pub fn erase<I: I2c>(
        &self,
        gfx: &mut Graphics<'_, I>,
        t: f32,
        cos_fn: fn(f32) -> f32,
        sin_fn: fn(f32) -> f32,
    ) {
        self.draw(gfx, t, false, cos_fn, sin_fn);
    }
}