d84914ef1e5a
brush_section_reset.rs
//! Each brush section header has a reset icon that puts only that section's settings back to their defaults
use egui_kittest::Harness;
use egui_kittest::kittest::{NodeT, Queryable};
use texturecraft_engine::paint::{Alignment, BrushAlpha, BrushSettings, Particles, Symmetry};
use texturecraft_ui_egui::TextureCraftApp;
/// The default window; Properties shows only the top of the brush there, so lower headers are scrolled to
const WINDOW_SIZE: egui::Vec2 = egui::vec2(1600.0, 960.0);
/// Frames for the first layout and fonts to settle
const STARTUP_FRAMES: usize = 4;
/// Frames for a click to reach the brush settings and the panel
const SETTLE_FRAMES: usize = 3;
/// Puts one section's fields of the first brush back to the second's values
type SectionReset = fn(&mut BrushSettings, &BrushSettings);
/// Each brush section's title, a label shown only while it is open, whether it starts open, and its reset
const SECTIONS: [(&str, &str, bool, SectionReset); 7] = [
("Size", "Minimum size (%)", true, |brush, defaults| {
(brush.size, brush.min_size, brush.screen_space) = (defaults.size, defaults.min_size, defaults.screen_space)
}),
("Flow and opacity", "Stroke opacity", true, |brush, defaults| {
(brush.flow, brush.opacity, brush.spacing) = (defaults.flow, defaults.opacity, defaults.spacing)
}),
("Angle", "Follow path", false, |brush, defaults| (brush.angle, brush.follow_path) = (defaults.angle, defaults.follow_path)),
("Jitters", "Size jitter", false, |brush, defaults| {
(brush.jitter_size, brush.jitter_angle, brush.jitter_flow, brush.jitter_position) =
(defaults.jitter_size, defaults.jitter_angle, defaults.jitter_flow, defaults.jitter_position)
}),
("Alignment and culling", "Backface culling", false, |brush, defaults| {
(brush.alignment, brush.backface_culling, brush.angle_fade, brush.depth) =
(defaults.alignment, defaults.backface_culling, defaults.angle_fade, defaults.depth)
}),
("Particles", "Gravity", false, |brush, defaults| brush.particles = defaults.particles),
("Lazy mouse", "Lazy mouse distance", false, |brush, defaults| brush.lazy = defaults.lazy),
];
/// A valid brush with every section field changed and a custom alpha that resets must preserve
fn changed_brush() -> BrushSettings {
BrushSettings {
size: 0.1,
min_size: 0.5,
screen_space: true,
flow: 0.5,
opacity: 0.6,
spacing: 0.5,
hardness: 0.9,
angle: 45.0,
follow_path: true,
jitter_size: 0.5,
jitter_angle: 0.4,
jitter_flow: 0.3,
jitter_position: 1.0,
alignment: Alignment::Camera,
backface_culling: false,
angle_fade: (30.0, 60.0),
depth: 2.0,
particles: Particles { enabled: true, count: 8, lifetime: 12, gravity: 0.5 },
lazy: 50.0,
symmetry: Symmetry { x: true, y: true, z: true, radial: 4, axis: 2, ..Symmetry::default() },
alpha: BrushAlpha::Star,
..BrushSettings::default()
}
}
/// The app showing the brush in Properties, set to `brush`
fn app_with_brush(brush: BrushSettings) -> Harness<'static, TextureCraftApp> {
let session = texturecraft_engine::sample_session(256, 64).unwrap();
let mut harness = Harness::builder().with_size(WINDOW_SIZE).build_eframe(|cc| TextureCraftApp::new(cc, session));
// The labels below are English; a first run would speak the system's language
harness.state_mut().ui.prefs.language = "en".into();
harness.state_mut().session.tool.brush = brush;
harness.run_steps(STARTUP_FRAMES);
harness
}
/// The reset icon on the header row titled `title`
fn reset_icon<'tree>(harness: &'tree Harness<'_, TextureCraftApp>, title: &str) -> egui_kittest::Node<'tree> {
let label = format!("{title}: Reset to defaults");
harness
.query_all_by_role(egui::Role::Button)
.find(|node| node.accesskit_node().label().as_deref() == Some(label.as_str()))
.unwrap_or_else(|| panic!("no reset icon on the {title} header"))
}
/// Scrolls the header titled `title` into view and clicks its reset icon
fn click_reset(harness: &mut Harness<'_, TextureCraftApp>, title: &str) {
reset_icon(harness, title).scroll_to_me();
harness.run_steps(SETTLE_FRAMES);
reset_icon(harness, title).click();
harness.run_steps(SETTLE_FRAMES);
}
#[test]
fn each_reset_puts_back_only_its_own_section() {
let defaults = BrushSettings::default();
for (title, _, _, reset_section) in SECTIONS {
let mut harness = app_with_brush(changed_brush());
assert!(!reset_icon(&harness, title).accesskit_node().is_disabled(), "the {title} reset is enabled once its section changed");
let history = harness.state().session.history_labels();
click_reset(&mut harness, title);
let mut expected = changed_brush();
reset_section(&mut expected, &defaults);
assert_eq!(harness.state().session.tool.brush, expected, "resetting {title}");
assert_eq!(harness.state().session.history_labels(), history, "resetting {title} adds no undo step");
}
}
/// Scrolls the header titled `title` into view and clicks the header itself, folding or unfolding it
fn click_header(harness: &mut Harness<'_, TextureCraftApp>, title: &str) {
reset_icon(harness, title).scroll_to_me();
harness.run_steps(SETTLE_FRAMES);
let icon = reset_icon(harness, title).rect();
harness.query_all_by_label(title).find(|label| label.rect().y_range().intersects(icon.y_range())).unwrap_or_else(|| panic!("no {title} header")).click();
harness.run_steps(SETTLE_FRAMES);
}
#[test]
fn clicking_the_reset_icon_does_not_fold_or_unfold_the_section() {
for flip_first in [false, true] {
let mut harness = app_with_brush(changed_brush());
if flip_first {
for (title, _, _, _) in SECTIONS {
click_header(&mut harness, title);
}
}
for (title, body_label, starts_open, _) in SECTIONS {
let open = starts_open != flip_first;
click_reset(&mut harness, title);
assert_eq!(harness.query_by_label(body_label).is_some(), open, "{title} stays {}", if open { "open" } else { "closed" });
}
}
}
#[test]
fn at_the_defaults_the_reset_icons_are_inert() {
let mut harness = app_with_brush(BrushSettings::default());
for (title, body_label, starts_open, _) in SECTIONS {
assert!(reset_icon(&harness, title).accesskit_node().is_disabled(), "the {title} reset is disabled at the defaults");
click_reset(&mut harness, title);
assert_eq!(harness.query_by_label(body_label).is_some(), starts_open, "the click doesn't reach the {title} header");
assert_eq!(harness.state().session.tool.brush, BrushSettings::default(), "the {title} reset is inert");
}
}
#[test]
fn enter_and_space_on_the_focused_reset_icon_reset_only_its_section() {
for key in [egui::Key::Enter, egui::Key::Space] {
let mut harness = app_with_brush(changed_brush());
reset_icon(&harness, "Size").focus();
harness.run_steps(SETTLE_FRAMES);
assert!(reset_icon(&harness, "Size").is_focused());
harness.key_press(key);
harness.run_steps(SETTLE_FRAMES);
let defaults = BrushSettings::default();
let mut expected = changed_brush();
(expected.size, expected.min_size, expected.screen_space) = (defaults.size, defaults.min_size, defaults.screen_space);
assert_eq!(harness.state().session.tool.brush, expected, "resetting Size with {key:?}");
}
}
#[test]
fn reset_icons_identify_their_sections() {
let harness = app_with_brush(changed_brush());
for (title, _, _, _) in SECTIONS {
let label = format!("{title}: Reset to defaults");
assert!(harness.query_by_role_and_label(egui::Role::Button, &label).is_some(), "the reset button must name its {title} section");
}
}
#[test]
fn narrow_headers_keep_title_clicks_separate_from_reset() {
use texturecraft_ui_egui::widgets::section_with_reset;
for right_to_left in [false, true] {
for width in [120.0, 180.0, 300.0] {
let title = "Lazy mouse";
let mut harness = Harness::builder().with_size(egui::vec2(width, 180.0)).with_context_setup(texturecraft_ui_egui::theme::install).build_ui_state(
|ui, resets| {
let alignment = if right_to_left { egui::Align::RIGHT } else { egui::Align::LEFT };
ui.with_layout(egui::Layout::top_down(alignment), |ui| {
ui.style_mut().right_to_left = right_to_left;
if section_with_reset(ui, "narrow_section", title, false, false, |ui| {
ui.label("Section contents");
}) {
*resets += 1;
}
});
},
0_u32,
);
harness.run_steps(STARTUP_FRAMES);
let title_rect = harness.get_by_label(title).rect();
let reset_label = format!("{title}: Reset to defaults");
let reset_rect = harness.get_by_role_and_label(egui::Role::Button, &reset_label).rect();
assert!(!title_rect.intersects(reset_rect), "title and reset overlap at width {width}, right_to_left={right_to_left}");
assert!(reset_rect.left() >= 0.0 && reset_rect.right() <= width, "reset must stay inside the panel");
harness.get_by_label(title).click();
harness.run_steps(SETTLE_FRAMES);
assert_eq!(*harness.state(), 0, "clicking the title must not reset settings");
assert!(harness.query_by_label("Section contents").is_some(), "clicking the title unfolds the section");
harness.get_by_role_and_label(egui::Role::Button, &reset_label).click();
harness.run_steps(SETTLE_FRAMES);
assert_eq!(*harness.state(), 1, "the reset remains clickable in a narrow panel");
assert!(harness.query_by_label("Section contents").is_some(), "resetting leaves the section open");
}
}
}
#[test]
fn tab_visits_changed_resets_and_skips_default_resets() {
use texturecraft_ui_egui::widgets::section_with_reset;
for at_default in [false, true] {
let mut harness = Harness::builder().with_size(egui::vec2(300.0, 180.0)).with_context_setup(texturecraft_ui_egui::theme::install).build_ui(|ui| {
let _ = ui.button("Before section");
section_with_reset(ui, "tab_section", "Size", false, at_default, |_| {});
let _ = ui.button("After section");
});
harness.run_steps(STARTUP_FRAMES);
harness.get_by_role_and_label(egui::Role::Button, "Before section").focus();
harness.run_steps(SETTLE_FRAMES);
assert!(harness.get_by_role_and_label(egui::Role::Button, "Before section").is_focused());
let mut reset_was_focused = false;
// Screen-reader mode also puts the header's labels in the focus order
for _ in 0..8 {
harness.key_press(egui::Key::Tab);
harness.run_steps(SETTLE_FRAMES);
reset_was_focused |= harness.get_by_role_and_label(egui::Role::Button, "Size: Reset to defaults").is_focused();
if harness.get_by_role_and_label(egui::Role::Button, "After section").is_focused() {
break;
}
}
assert!(harness.get_by_role_and_label(egui::Role::Button, "After section").is_focused(), "Tab reaches the next control");
assert_eq!(reset_was_focused, !at_default, "only an enabled reset belongs in the Tab order");
}
}
#[test]
fn overflowing_contents_do_not_push_resets_outside_the_panel() {
use texturecraft_ui_egui::widgets::section_with_reset;
for right_to_left in [false, true] {
let width = 120.0;
let mut harness = Harness::builder().with_size(egui::vec2(width, 180.0)).with_context_setup(texturecraft_ui_egui::theme::install).build_ui_state(
|ui, resets| {
let alignment = if right_to_left { egui::Align::RIGHT } else { egui::Align::LEFT };
ui.with_layout(egui::Layout::top_down(alignment), |ui| {
ui.style_mut().right_to_left = right_to_left;
// A slider in an earlier section can expand the scroll area's content width
ui.allocate_exact_size(egui::vec2(400.0, 1.0), egui::Sense::hover());
if section_with_reset(ui, "overflow_section", "Size", false, false, |_| {}) {
*resets += 1;
}
});
},
0_u32,
);
harness.run_steps(STARTUP_FRAMES);
let reset_rect = harness.get_by_role_and_label(egui::Role::Button, "Size: Reset to defaults").rect();
assert!(reset_rect.left() >= 0.0 && reset_rect.right() <= width, "reset must stay visible when content overflows, right_to_left={right_to_left}");
harness.get_by_role_and_label(egui::Role::Button, "Size: Reset to defaults").click();
harness.run_steps(SETTLE_FRAMES);
assert_eq!(*harness.state(), 1, "overflowing contents must not block the reset");
}
}
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.