d84914ef1e5a
camera_views.rs
//! F5 and F6 switch the projection, the Viewport menu goes to fixed views, and Alt+Shift+drag orbits
//! in 90° steps.
use std::f32::consts::FRAC_PI_2;
use egui::{Event, Key, Modifiers, PointerButton, Pos2, vec2};
use egui_kittest::Harness;
use egui_kittest::kittest::Queryable as _;
use serde_json::json;
use texturecraft_ui_egui::TextureCraftApp;
fn harness() -> Harness<'static, TextureCraftApp> {
let session = texturecraft_engine::sample_session(256, 64).unwrap();
let mut h = Harness::builder().with_size(egui::vec2(1600.0, 960.0)).build_eframe(|cc| TextureCraftApp::new(cc, session));
h.run_steps(4);
h
}
fn press(h: &mut Harness<'_, TextureCraftApp>, key: Key) {
h.event(Event::Key { key, physical_key: None, pressed: true, repeat: false, modifiers: Modifiers::NONE });
h.run_steps(2);
}
/// Drag with the left button and `modifiers` from `from` by `by` in a few moves.
fn drag(h: &mut Harness<'_, TextureCraftApp>, from: Pos2, by: egui::Vec2, modifiers: Modifiers) {
h.event(Event::ModifiersChanged(modifiers));
h.hover_at(from);
h.event(Event::PointerButton { pos: from, button: PointerButton::Primary, pressed: true, modifiers });
h.run_steps(2);
for k in 1..=4 {
h.hover_at(from + by * (k as f32 / 4.0));
h.run_steps(1);
}
h.event(Event::PointerButton { pos: from + by, button: PointerButton::Primary, pressed: false, modifiers });
h.event(Event::ModifiersChanged(Modifiers::NONE));
h.run_steps(3);
}
#[test]
fn f6_switches_to_orthographic_and_f5_back_to_perspective_keeping_the_view() {
let mut h = harness();
h.state_mut().run("camera.set", json!({"yaw": 30, "pitch": 15}));
h.run_steps(2);
let before = h.state().session.camera;
assert!(!before.ortho);
press(&mut h, Key::F6);
let camera = h.state().session.camera;
assert!(camera.ortho, "F6 is orthographic");
assert_eq!((camera.yaw, camera.pitch, camera.distance, camera.target), (before.yaw, before.pitch, before.distance, before.target));
press(&mut h, Key::F6);
assert!(h.state().session.camera.ortho, "F6 again stays orthographic: not a toggle");
press(&mut h, Key::F5);
assert_eq!(h.state().session.camera, before, "F5 is perspective");
}
#[test]
fn the_viewport_menu_goes_to_the_front_view_and_orbit_works_afterwards() {
let mut h = harness();
h.state_mut().run("camera.set", json!({"yaw": 70, "pitch": 30, "ortho": true}));
h.run_steps(2);
// The menu bar's "Viewport", above the dock's tab of the same name
h.get_all_by_label("Viewport").min_by(|a, b| a.rect().top().total_cmp(&b.rect().top())).unwrap().click();
h.run_steps(2);
h.get_by_label_contains("Front view").click();
// The UI glides there over about a third of a second
h.run_steps(6);
let camera = h.state().session.camera;
let looking_from = (camera.eye() - camera.target).normalize();
assert!(looking_from.z > 0.999, "the eye is in front of the mesh: {looking_from}");
assert!(camera.ortho, "the projection stays");
let center = h.state().viewport_rect.center();
drag(&mut h, center, vec2(60.0, 30.0), Modifiers::ALT);
let orbited = h.state().session.camera;
assert!(orbited.yaw != camera.yaw && orbited.pitch != camera.pitch, "Alt+drag still orbits");
}
#[test]
fn alt_shift_drag_orbits_in_quarter_turns() {
let mut h = harness();
h.state_mut().run("camera.set", json!({"yaw": 17, "pitch": 11}));
h.run_steps(2);
let center = h.state().viewport_rect.center();
let at_step = |angle: f32, steps: f32| (angle - steps * FRAC_PI_2).abs() < 1e-5;
// A short drag stays at the nearest quarter turn: straight on, level
drag(&mut h, center, vec2(10.0, 5.0), Modifiers::ALT | Modifiers::SHIFT);
let camera = h.state().session.camera;
assert!(at_step(camera.yaw, 0.0) && at_step(camera.pitch, 0.0), "yaw {} pitch {}", camera.yaw.to_degrees(), camera.pitch.to_degrees());
// A long drag to the left turns a quarter: the eye moves to the right side
drag(&mut h, center, vec2(-200.0, 0.0), Modifiers::ALT | Modifiers::SHIFT);
let camera = h.state().session.camera;
assert!(at_step(camera.yaw, 1.0) && at_step(camera.pitch, 0.0), "yaw {} pitch {}", camera.yaw.to_degrees(), camera.pitch.to_degrees());
// Dragging down far enough looks from above, at the orbit's 89° limit
drag(&mut h, center, vec2(0.0, 200.0), Modifiers::ALT | Modifiers::SHIFT);
let camera = h.state().session.camera;
assert!(at_step(camera.yaw, 1.0) && (camera.pitch - 89f32.to_radians()).abs() < 1e-5, "pitch {}", camera.pitch.to_degrees());
}
/// A harness whose frames are 10 ms apart, so a 0.35 s glide spans about 35 frames and a drag fits inside it.
fn slow_glide_harness() -> Harness<'static, TextureCraftApp> {
let session = texturecraft_engine::sample_session(256, 64).unwrap();
let mut h = Harness::builder().with_size(egui::vec2(1600.0, 960.0)).with_step_dt(0.01).build_eframe(|cc| TextureCraftApp::new(cc, session));
h.run_steps(4);
h
}
/// Start the glide to the front view from a turned camera.
fn start_front_glide(h: &mut Harness<'_, TextureCraftApp>) {
h.state_mut().run("camera.set", json!({"yaw": 70, "pitch": 30}));
h.run_steps(2);
h.state_mut().run("camera.view.front", json!({}));
h.run_steps(2);
}
#[test]
fn f6_during_a_glide_keeps_the_orthographic_projection_when_the_glide_ends() {
let mut h = slow_glide_harness();
start_front_glide(&mut h);
assert!(!h.state().session.camera.ortho);
press(&mut h, Key::F6);
h.run_steps(60);
let camera = h.state().session.camera;
let looking_from = (camera.eye() - camera.target).normalize();
assert!(looking_from.z > 0.999, "the glide still reaches the front view: {looking_from}");
assert!(camera.ortho, "F6 pressed during the glide is not undone when it ends");
// And back: F5 during a glide to a view of an orthographic camera
start_front_glide(&mut h);
press(&mut h, Key::F5);
h.run_steps(60);
assert!(!h.state().session.camera.ortho, "F5 pressed during the glide is not undone either");
}
#[test]
fn a_view_that_returns_to_the_starting_camera_cancels_the_glide_of_the_earlier_view() {
let mut h = slow_glide_harness();
start_front_glide(&mut h);
h.run_steps(60);
// Back, then Front again before a frame runs: the camera is already at the front
h.state_mut().run("camera.view.back", json!({}));
h.state_mut().run("camera.view.front", json!({}));
h.run_steps(60);
let camera = h.state().session.camera;
let looking_from = (camera.eye() - camera.target).normalize();
assert!(looking_from.z > 0.999, "the camera stays at the front instead of gliding to the back: {looking_from}");
}
#[test]
fn a_camera_command_from_the_control_channel_during_a_glide_is_not_overwritten_by_it() {
let mut h = slow_glide_harness();
start_front_glide(&mut h);
let context = h.ctx.clone();
let reply = texturecraft_ui_egui::control::handle(h.state_mut(), &context, "command.run", &json!({"id": "camera.set", "params": {"yaw": 20, "pitch": 10}}));
assert_eq!(reply["ok"], true, "{reply}");
h.run_steps(60);
let camera = h.state().session.camera;
assert!(
(camera.yaw.to_degrees() - 20.0).abs() < 1e-3 && (camera.pitch.to_degrees() - 10.0).abs() < 1e-3,
"yaw {} pitch {}",
camera.yaw.to_degrees(),
camera.pitch.to_degrees()
);
}
#[test]
fn a_control_command_that_leaves_the_camera_alone_does_not_stop_the_glide() {
let mut h = slow_glide_harness();
start_front_glide(&mut h);
let context = h.ctx.clone();
let reply = texturecraft_ui_egui::control::handle(h.state_mut(), &context, "command.run", &json!({"id": "camera.get", "params": {}}));
assert_eq!(reply["ok"], true, "{reply}");
h.run_steps(60);
let camera = h.state().session.camera;
let looking_from = (camera.eye() - camera.target).normalize();
assert!(looking_from.z > 0.999, "the glide still reaches the front view: {looking_from}");
}
#[test]
fn a_control_view_command_naming_the_current_camera_ends_a_glide_started_in_the_same_frame() {
let mut h = slow_glide_harness();
start_front_glide(&mut h);
h.run_steps(60);
// At the front: the UI starts a glide to the back, then a script asks for the front before a frame runs
h.state_mut().run("camera.view.back", json!({}));
let context = h.ctx.clone();
let reply = texturecraft_ui_egui::control::handle(h.state_mut(), &context, "command.run", &json!({"id": "camera.view.front", "params": {}}));
assert_eq!(reply["ok"], true, "{reply}");
h.run_steps(60);
let camera = h.state().session.camera;
let looking_from = (camera.eye() - camera.target).normalize();
assert!(looking_from.z > 0.999, "the explicit front view wins over the pending glide to the back: {looking_from}");
}
#[test]
fn f_during_a_glide_frames_the_mesh_and_the_glide_does_not_take_it_back() {
let mut h = slow_glide_harness();
start_front_glide(&mut h);
press(&mut h, Key::F);
let framed = h.state().session.camera;
h.run_steps(60);
assert_eq!(h.state().session.camera, framed, "Show entire mesh pressed during the glide keeps its view");
}
#[test]
fn a_projection_switch_from_the_control_channel_during_a_glide_lets_the_glide_finish() {
let mut h = slow_glide_harness();
start_front_glide(&mut h);
let context = h.ctx.clone();
let reply = texturecraft_ui_egui::control::handle(h.state_mut(), &context, "command.run", &json!({"id": "camera.orthographic", "params": {}}));
assert_eq!(reply["ok"], true, "{reply}");
h.run_steps(60);
let camera = h.state().session.camera;
let looking_from = (camera.eye() - camera.target).normalize();
assert!(looking_from.z > 0.999, "the glide still reaches the front view: {looking_from}");
assert!(camera.ortho, "and keeps the orthographic projection");
}
#[test]
fn alt_shift_drag_during_a_glide_is_not_overwritten_by_it() {
let mut h = slow_glide_harness();
start_front_glide(&mut h);
let center = h.state().viewport_rect.center();
drag(&mut h, center, vec2(-100.0, 0.0), Modifiers::ALT | Modifiers::SHIFT);
h.run_steps(60);
let camera = h.state().session.camera;
assert!(
(camera.yaw - FRAC_PI_2).abs() < 1e-5 && camera.pitch.abs() < 1e-5,
"the snapped orbit stays: yaw {} pitch {}",
camera.yaw.to_degrees(),
camera.pitch.to_degrees()
);
}
#[test]
fn alt_drag_during_a_glide_is_not_overwritten_by_it() {
let mut h = slow_glide_harness();
start_front_glide(&mut h);
let center = h.state().viewport_rect.center();
drag(&mut h, center, vec2(-200.0, 0.0), Modifiers::ALT);
h.run_steps(60);
let camera = h.state().session.camera;
// The glide ends at yaw 0 and pitch 0; the drag turned the camera away from the front by far more than a degree
assert!(camera.yaw.abs() > 0.1, "the orbit stays: yaw {}", camera.yaw.to_degrees());
}
#[test]
fn the_wheel_during_a_glide_is_not_overwritten_by_it() {
let end_distance = |scroll: f32| {
let mut h = slow_glide_harness();
start_front_glide(&mut h);
let center = h.state().viewport_rect.center();
h.hover_at(center);
h.run_steps(1);
if scroll != 0.0 {
h.event(Event::MouseWheel {
unit: egui::MouseWheelUnit::Point,
delta: vec2(0.0, scroll),
phase: egui::TouchPhase::Move,
source: egui::MouseWheelSource::Wheel,
modifiers: Modifiers::NONE,
});
}
h.run_steps(80);
h.state().session.camera.distance
};
assert!(end_distance(100.0) != end_distance(0.0), "the wheel zoom stays");
}
#[test]
fn the_rotation_dropdown_switches_to_free_rotation_and_alt_drag_turns_the_model_over() {
let mut h = harness();
assert!(!h.state().session.camera.free);
h.get_by_label("Constrained rotation").click();
h.run_steps(2);
h.get_by_label_contains("Free rotation").click();
h.run_steps(2);
assert!(h.state().session.camera.free, "the dropdown picks free rotation");
// A long vertical drag goes over the pole: the horizon is no longer level
let center = h.state().viewport_rect.center();
drag(&mut h, center, vec2(0.0, 300.0), Modifiers::ALT);
let camera = h.state().session.camera;
assert!(camera.up().y < 0.0, "the model is turned over: {}", camera.up());
}
#[test]
fn constrained_rotation_keeps_the_horizon_on_the_same_drag() {
let mut h = harness();
let center = h.state().viewport_rect.center();
drag(&mut h, center, vec2(0.0, 300.0), Modifiers::ALT);
let camera = h.state().session.camera;
assert!(camera.up().y == 1.0 && camera.pitch <= 89f32.to_radians() + 1e-6);
}
#[test]
fn snap_rotate_and_next_camera_are_bindable_and_a_bound_key_runs_them() {
let ids = ["camera.snapRotate.right", "camera.next", "camera.previous", "camera.rotation.free", "camera.rotation.constrained"];
for id in ids {
assert!(texturecraft_ui_egui::keymap::bindings().iter().any(|binding| binding.id == id), "{id} can be bound");
}
let mut h = harness();
h.state_mut().run("camera.set", json!({"yaw": 0, "pitch": 0}));
h.state_mut().ui.keymap.insert("camera.snapRotate.right".into(), "F12".into());
h.run_steps(2);
press(&mut h, Key::F12);
h.run_steps(30);
let camera = h.state().session.camera;
assert!((camera.yaw - FRAC_PI_2).abs() < 1e-3, "one step to the right: {}", camera.yaw);
}
#[test]
fn next_and_previous_camera_commands_move_between_saved_cameras() {
let mut h = harness();
for (name, yaw) in [("A", 20), ("B", 50)] {
h.state_mut().run("camera.set", json!({"yaw": yaw}));
h.state_mut().run("camera.add", json!({"name": name}));
}
h.state_mut().run("camera.select", json!({}));
h.run_steps(2);
h.state_mut().run("camera.next", json!({}));
h.run_steps(30);
assert!((h.state().session.camera.yaw.to_degrees() - 20.0).abs() < 0.5);
h.state_mut().run("camera.next", json!({}));
h.run_steps(30);
assert!((h.state().session.camera.yaw.to_degrees() - 50.0).abs() < 0.5);
h.state_mut().run("camera.previous", json!({}));
h.run_steps(30);
assert!((h.state().session.camera.yaw.to_degrees() - 20.0).abs() < 0.5);
}
#[test]
fn next_camera_advances_from_the_destination_before_the_glide_ends() {
let mut harness = slow_glide_harness();
for (name, yaw) in [("Near", 20), ("Far", 50)] {
let app = harness.state_mut();
app.run("camera.set", json!({"yaw": yaw})).unwrap();
app.run("camera.add", json!({"name": name})).unwrap();
}
let app = harness.state_mut();
app.run("camera.set", json!({"yaw": 0})).unwrap();
app.run("camera.next", json!({})).unwrap();
app.run("camera.next", json!({})).unwrap();
assert!(app.session.camera.yaw.abs() < 1e-3, "the glide starts at the displayed view");
harness.run_steps(60);
assert!((harness.state().session.camera.yaw.to_degrees() - 50.0).abs() < 0.5, "two presses reach the second camera");
}
#[test]
fn the_view_picker_offers_the_combined_normal_view() {
let mut h = harness();
h.get_all_by_role(egui::Role::ComboBox).find(|node| node.value().as_deref() == Some("Material")).expect("the view picker").click();
h.run_steps(2);
h.get_by_label("Normal+height+mesh").click();
h.run_steps(2);
assert_eq!(h.state().session.view, texturecraft_engine::ViewMode::NormalHeightMesh);
}
No file is open. Choose one in the tree, or press Ctrl+O (⌘O on a Mac) to find one by name.
Syntax highlighting could not load. The unmodified read-only text remains available above.