Record your screen, ship a demo. Free and open-source, GPU-accelerated, no watermarks, no subscriptions. Windows, macOS, Linux. Actively maintained.
TypeScript cross-platformelectronffmpegopen-sourceproduct-demorustscreen-capturescreen-recorderscreen-recordingscreen-studioscreencastspeech-to-texttypescriptvideo-editingvideo-editorwaylandwgpuwhisper
fix(zoom): let 3D Orbit frame the screen's corners like the other cameras
EtienneLescot0f1b4d4cb286
diff --git a/crates/compositor/src/camera.rs b/crates/compositor/src/camera.rsindex b218e338d..abe554344 100644--- a/crates/compositor/src/camera.rs+++ b/crates/compositor/src/camera.rs@@ -246,8 +246,6 @@ const FOLLOW_LOOKAHEAD_S: f32 = 0.25;/// Pas et longueur du noyau : ω·τ va jusqu'à 10, la queue coupée pèse 5·10⁻⁴.const FOLLOW_STEP_S: f32 = 1.0 / 60.0;const FOLLOW_TAPS: usize = 120;-/// La vue comptée plus large que `1/zoom` de l'écran, pour la portée du point visé.-const VIEW_MARGIN: f32 = 1.1;/// Ce que le cadreur rend pour une frame, en fractions de l'écran recadré : le point visé et le/// pointeur lissé.@@ -261,10 +259,13 @@ impl Follow {pub const CENTRE: Follow = Follow { aim: [0.5; 2], orbit: [0.5; 2] };}-/// Portée du point visé au zoom `zoom` : il reste dans `0,5 ± reach`, là où la vue reste dans-/// l'écran ; au zoom 1, le centre.+/// Portée du point visé au zoom `zoom` : il reste dans `0,5 ± reach`, la portée du focus d'un+/// zoom à plat (le gimbal de l'aperçu). Comme sous les autres caméras, la vue va jusqu'au bord de+/// l'écran et le padding montre ce qu'il y a au-delà. Visé en butée, le bord de l'écran tombe au+/// plus à 3 % de la boîte au-delà de celui d'un zoom à plat : la perspective agrandit le côté+/// proche. Au zoom 1, le centre.fn reach(zoom: f32) -> f32 {- (0.5 - 0.5 * VIEW_MARGIN / zoom.max(1.0)).max(0.0)+ (0.5 - 0.5 / zoom.max(1.0)).max(0.0)}/// L'orbite en focus manuel, posée par le point de focus de la région (`point`, fractions de@@ -286,8 +287,7 @@ pub fn fixed(point: [f32; 2], zoom: f32) -> Follow {/// région. Pas de zone morte : la caméra vit avec le pointeur, le lissage la garde calme.////// - `orbit` : le pointeur lissé, sur tout l'écran.-/// - `aim` : le même, borné avant lissage à `0,5 ± (0,5 − 0,5·VIEW_MARGIN/zoom)`, là où la vue-/// reste dans l'écran ; au zoom 1, le centre.+/// - `aim` : le même, borné avant lissage à la portée du zoom (`reach`) ; au zoom 1, le centre.pub fn follow(frame: &CameraFrame, t: f32, zoom: f32) -> Follow {let Some(track) = frame.track else { return Follow::CENTRE };let reach = reach(zoom);@@ -317,7 +317,7 @@ mod tests {const BOX: [f32; 2] = [1536.0, 864.0];fn pose(orbit: [f32; 2], zoom: f32) -> CameraPose {- let reach = (0.5 - 0.5 * VIEW_MARGIN / zoom).max(0.0);+ let reach = reach(zoom);let aim = orbit.map(|o| o.clamp(0.5 - reach, 0.5 + reach));CameraPose { weight: 1.0, aim, orbit, zoom, press: 0.0 }}@@ -333,7 +333,7 @@ mod tests {fn envelope() -> Vec<(f32, f32, [f32; 2], View, [f32; 2])> {let mut out = Vec::new();for zoom in [1.0f32, 1.25, 1.5, 1.8, 2.2, 3.5, 5.0] {- let reach = (0.5 - 0.5 * VIEW_MARGIN / zoom).max(0.0);+ let reach = reach(zoom);for k in [2, 5, 8, 10] {let weight = k as f32 / 10.0;let z = 1.0 + (zoom - 1.0) * weight;@@ -639,20 +639,35 @@ mod tests {let settled = settled.expect("jamais posée");println!("95 % du saut {settled:.2} s après lui");assert!((0.6..=1.0).contains(&settled), "{settled}");- // Le point visé : borné à 0,5 ± 0,225 au zoom 2.+ // Le point visé : borné à 0,5 ± 0,25 au zoom 2.let posed = at(8.0);- assert!((posed.aim[0] - 0.725).abs() < 1e-3 && (posed.aim[1] - 0.275).abs() < 1e-3, "{posed:?}");+ assert!((posed.aim[0] - 0.75).abs() < 1e-3 && (posed.aim[1] - 0.25).abs() < 1e-3, "{posed:?}");assert!((posed.orbit[0] - 0.8).abs() < 1e-3);}- /// Le point visé reste là où la vue reste dans l'écran (au centre au zoom 1), l'orbite lit- /// tout l'écran. Recadrage compris ; sans piste, le centre.+ /// Visé en butée, comme un zoom à plat au bord du gimbal, la vue va jusqu'au bord de l'écran :+ /// le bord tombe au plus à 3,5 % de la boîte au-delà de celui du zoom à plat, et le padding+ /// montre ce qu'il y a derrière. Les coins du métrage se voient, comme sous les autres caméras.#[test]- fn the_aim_keeps_the_view_on_the_screen() {+ fn at_its_limit_the_view_reaches_the_screen_edge() {+ for zoom in [1.5f32, 1.8, 2.2, 3.5, 5.0] {+ let (bx, edge) = (BOX.map(|b| b * zoom), 0.5 - reach(zoom));+ let pose = CameraPose { weight: 1.0, aim: [edge, 0.5], orbit: [edge, 0.5], zoom, press: 0.0 };+ let x = View::new(bx, pose).project([-bx[0] * 0.5, 0.0, 0.0]).unwrap()[0];+ let past = (-BOX[0] * 0.5 - x) / BOX[0];+ println!("zoom {zoom} : le bord de l'écran à {past:+.3} boîte au-delà d'un zoom à plat");+ assert!(past < 0.035, "zoom {zoom} : {past}");+ }+ }++ /// Le point visé va aussi loin que le focus d'un zoom à plat (au centre au zoom 1), l'orbite+ /// lit tout l'écran. Recadrage compris ; sans piste, le centre.+ #[test]+ fn the_aim_goes_as_far_as_a_flat_zoom() {let corner = track(|_| (0.99, 0.01));for zoom in [1.0f32, 1.5, 2.0, 3.0] {let got = follow(&whole(&corner), 5.0, zoom);- let reach = (0.5 - 0.5 * VIEW_MARGIN / zoom).max(0.0);+ let reach = reach(zoom);assert!((got.aim[0] - (0.5 + reach)).abs() < 1e-3 && (got.aim[1] - (0.5 - reach)).abs() < 1e-3,"{zoom} {got:?}"diff --git a/crates/compositor/src/frame_geometry.rs b/crates/compositor/src/frame_geometry.rsindex f58255760..667e24b16 100644--- a/crates/compositor/src/frame_geometry.rs+++ b/crates/compositor/src/frame_geometry.rs@@ -6534,8 +6534,8 @@ mod tests {let left = plan(&scene, parked(0.05, vec![]));let (cr, cl) = (right.camera.expect("caméra"), left.camera.expect("caméra"));assert_eq!(cr.weight, 1.0);- // Zoom 2 : la vue reste dans l'écran tant que la visée reste dans [0,275 ; 0,725].- assert!(cr.aim[0] > 0.72 && cl.aim[0] < 0.28, "{:?} {:?}", cr.aim, cl.aim);+ // Zoom 2 : la visée va jusqu'à [0,25 ; 0,75], la portée du gimbal.+ assert!(cr.aim[0] > 0.74 && cl.aim[0] < 0.26, "{:?} {:?}", cr.aim, cl.aim);// L'orbite lit tout le recadrage, sans la borne du zoom : 0,55 y tombe à 0,9.assert!(cr.orbit[0] > 0.89 && cl.orbit[0] < 0.1, "{:?} {:?}", cr.orbit, cl.orbit);assert_eq!((cr.zoom, cr.press), (2.0, 0.0));@@ -6587,7 +6587,7 @@ mod tests {let cfg = crate::config::all().pop().expect("au moins une config");let json = zoomed_golden_scene_json().replace(r#""focusX":0.5,"focusY":0.3,"rotation":"none""#,- r#""focusX":0.74,"focusY":0.3,"rotation":"orbit","focusMode":"manual""#,+ r#""focusX":0.8,"focusY":0.3,"rotation":"orbit","focusMode":"manual""#,);assert_ne!(json, zoomed_golden_scene_json(), "la substitution doit poser l'orbite");let scene = Scene::from_json(&json).expect("scène");@@ -6606,9 +6606,9 @@ mod tests {};for p in [pose(&scene, 0.55), pose(&scene, 0.05), pose(&hidden, 0.55)] {assert_eq!(p.weight, 1.0);- // Zoom 2 : l'œil sur l'orbite du point, la visée bornée à 0,725.- assert!((p.orbit[0] - 0.74).abs() < 1e-3 && (p.orbit[1] - 0.3).abs() < 1e-3, "{:?}", p.orbit);- assert!((p.aim[0] - 0.725).abs() < 1e-3 && (p.aim[1] - 0.3).abs() < 1e-3, "{:?}", p.aim);+ // Zoom 2 : l'œil sur l'orbite du point, la visée bornée à 0,75, la portée du gimbal.+ assert!((p.orbit[0] - 0.8).abs() < 1e-3 && (p.orbit[1] - 0.3).abs() < 1e-3, "{:?}", p.orbit);+ assert!((p.aim[0] - 0.75).abs() < 1e-3 && (p.aim[1] - 0.3).abs() < 1e-3, "{:?}", p.aim);}}diff --git a/crates/compositor/src/regions.rs b/crates/compositor/src/regions.rsindex fda531a16..cd5346c6a 100644--- a/crates/compositor/src/regions.rs+++ b/crates/compositor/src/regions.rs@@ -3309,8 +3309,8 @@ mod orbit_camera_tests {for t in [3.0f32, 5.0, 7.0] {let m = zoom_state_in(std::slice::from_ref(&manual), t, Some(&tr), &whole(&tr), &ScreenClock::default());assert_eq!((m.camera, m.focus), (1.0, [0.5, 0.5]), "t {t}");- // Zoom 2 : la visée reste dans [0,275 ; 0,725].- assert!(near(m.orbit, [0.2, 0.7]) && near(m.aim, [0.275, 0.7]), "t {t} : {:?} {:?}", m.orbit, m.aim);+ // Zoom 2 : la visée reste dans [0,25 ; 0,75], la portée du gimbal.+ assert!(near(m.orbit, [0.2, 0.7]) && near(m.aim, [0.25, 0.7]), "t {t} : {:?} {:?}", m.orbit, m.aim);let p = zoom_state_in(&[region("orbit", 2.0, 8.0)], t, Some(&parked), &whole(&parked), &ScreenClock::default());assert!(near(m.orbit, p.orbit) && near(m.aim, p.aim), "t {t} : {:?} {:?}", p.orbit, p.aim);let blind = zoom_state_at(std::slice::from_ref(&manual), t, None);diff --git a/docs/3d-effects-v2.md b/docs/3d-effects-v2.mdindex 2cc173f82..5c6cd8a62 100644--- a/docs/3d-effects-v2.md+++ b/docs/3d-effects-v2.md@@ -110,8 +110,12 @@ ne se lit que si l'œil se déplace autour de l'écran.(sans centrage) ; au plus près, l'écran passe à 0,7 px du bord de sa boîte. Au repos, il en occupe85 % × 83 %.- **Cadrage au zoom** : le centrage et le containment s'effacent linéairement jusqu'au zoom 2. Au- delà, le point visé tombe au centre de l'image, grossi exactement du zoom. Le point visé reste dans- `0,5 ± max(0, 0,5 − 0,55/max(zoom, 1))`, comme avant : au centre au zoom 1.+ delà, le point visé tombe au centre de l'image, grossi exactement du zoom. Le point visé va aussi+ loin que le focus d'un zoom à plat (le gimbal) : `0,5 ± max(0, 0,5 − 0,5/max(zoom, 1))`, au centre+ au zoom 1. La vue atteint donc le bord de l'écran et le padding montre ce qu'il y a au-delà, comme+ sous les autres caméras. En butée, la perspective agrandit le côté proche : le bord tombe au plus+ à 3 % de la boîte au-delà de celui d'un zoom à plat (27/09 ; avant, une marge de 10 % gardait la+ vue dans l'écran et cachait ses coins).- **Force 0** = le rendu plat, par le même chemin (mode 0).**Le cadreur** (`camera::follow`), pure fonction de `t`, sans zone morte : le pointeur, lu dans