`box_shadow` example with adjustable settings #19345

oracle58 · 2025-05-23T12:59:46Z

Objective

Addresses the previous example's lack of visual appeal and clarity. It was missing labels for clear distinction of the shadow settings used on each of the shapes. The suggestion in the linked issue was to either just visually update and add labels or to collapse example to a single node with adjustable settings.
Fixes Improve the box_shadow example #19240

Solution

Replace the previous static example with a single, central node with adjustable settings as per issue suggestion.
Implement button-based setting adjustments. Unfortunately slider widgets don't seem available yet and I didn't want to further bloat the example.
Improve overall aesthetics of the example -- although color pallette could still be improved. flat gray tones are probably not the best choice as a contrast to the shadow, but the white border does help in that aspect.
Dynamically recolor shadows for visual clarity when increasing shadow count.
Add Adjustable Settings:
- Shape selection
- Shadow X/Y offset, blur, spread, and count
Add Reset button to restore default settings

The disadvantage of this solution is that the old example code would have probably been easier to digest as the new example is quite bloated in comparison. Alternatively I could also just implement labels and fix aesthetics of the old example without adding functionality for adjustable settings, but I personally feel like interactive examples are more engaging to users.

Testing

Did you test these changes? If so, how? cargo run --example box_shadow and functionality of all features of the example.
Are there any parts that need more testing? Not that I am aware of.
How can other people (reviewers) test your changes? Is there anything specific they need to know? Not really, it should be pretty straightforward just running the new example and testing the feats.

Showcase

- Replaces the previous static example with a single, central node with adjustable settings as per issue suggestion. - Implements button-based setting adjustments. Slider widgets don't seem available yet. - Improved overall aesthetics of the example - Dynamically recolors shadows for visual clarity when increasing shadow count. - Adjustable Settings: - Shape selection - Shadow X/Y offset, blur, spread, and count - Added Reset button to restore default settings

ickshonpe

Really nice. Just made a few suggestions but overall it's a huge improvement over the old example.

examples/ui/box_shadow.rs

Co-authored-by: ickshonpe <[email protected]>

oracle58 · 2025-05-24T11:47:59Z

Really nice. Just made a few suggestions but overall it's a huge improvement over the old example.

Thanks for the feedback and review! Suggestions already applied for the most part. Just working out the button pressed repeat logic.

make shape label transparent while keeping others gray for improved UI clarity

- Track last pressed button and press time in a resource - Add system to trigger button actions at a repeat interval when held - Improves UX for increment/decrement and shape navigation buttons

alice-i-cecile

Very fancy! I'm looking forward to replacing this complexity with some native widgets in the future, but I think this is a step in the right direction.

IMO it's much more important for this example to allow users to explore the box shadow options interactively, rather than simply learning how to add a box shadow.

oracle58 · 2025-05-26T07:41:39Z

Very fancy! I'm looking forward to replacing this complexity with some native widgets in the future, but I think this is a step in the right direction.

Absolutely, native widgets and possibly even a template for interactive examples using some set of these widgets would definitely reduce complexity and furthermore enable consistency across the examples in the long-term. Especially if the objective is to make more examples interactive down the road.

IMO it's much more important for this example to allow users to explore the box shadow options interactively, rather than simply learning how to add a box shadow.

I also feel that is the right choice.

JMS55 · 2025-05-26T18:18:02Z

The downside is that the CI screenshot tests no longer tests all the different shadow combinations

alice-i-cecile · 2025-05-26T20:14:20Z

@oracle58 ping me when merge conflicts are resolved and I'll get this in :)

rparrett

IMO, this and other example widgetification attempts are a bit premature. This is adding a lot of example code that must be maintained and is likely to change soon.

If we want to do this, I have some suggested changes.

examples/ui/box_shadow.rs

- rename `spawn_setting_children` -> `build_setting_row` - remove bg color from value labels (made them seem like input fields) - Fix settings panel positioning: bottom and left margins between screen and panel are uneven - use `resource_changed` rather than `is_changed` for shape and shadow settings - The `button_color_system` now uses With<SettingsButton> in its query filter, so it only runs for buttons with a `SettingsButton` component. - Refactor setting value updates to use new `SettingType` enum component instead of fragile label string comparisons - Add Samples as a controllable setting in the UI panel

- Replace tuple struct syntax with BorderColor::all(...) in shape node and settings panel. - Resolves E0423 error due to struct construction changes in Bevy UI. - consistent formatting - Fmt imports

oracle58 · 2025-05-27T13:42:08Z

If we want to do this, I have some suggested changes.

I think I have the suggested changes applied @rparrett

@oracle58 ping me when merge conflicts are resolved and I'll get this in :)

@alice-i-cecile
Conflicts are resolved and suggestions from @rparrett applied.

alice-i-cecile · 2025-05-27T19:43:40Z

IMO, this and other example widgetification attempts are a bit premature. This is adding a lot of example code that must be maintained and is likely to change soon.

I 100% see where you're coming from, but I'd like to merge a couple of these now, mostly so we can compare them as a baseline.

Thanks for the thorough feedback as always :)

# Objective Minimal effort to address feedback here: #19345 (comment) more thoroughly. ## Solution - Remove hardcoded label string comparisons and make more use of the new enum added during review - Resist temptation to let this snowball this into a huge refactor - Maybe come back later for a few other small improvements ## Testing `cargo run --example box_shadow`

oracle58 force-pushed the improve-box-shadow branch from 792458e to a1e8f7c Compare May 23, 2025 13:08

oracle58 force-pushed the improve-box-shadow branch from a1e8f7c to 91b39f8 Compare May 23, 2025 13:08

oracle58 changed the title ~~Interactive, single node box_shadow example~~ box_shadow example with adjustable settings May 23, 2025

ickshonpe self-requested a review May 23, 2025 17:40

ickshonpe approved these changes May 23, 2025

View reviewed changes

examples/ui/box_shadow.rs Show resolved Hide resolved

examples/ui/box_shadow.rs Outdated Show resolved Hide resolved

examples/ui/box_shadow.rs Outdated Show resolved Hide resolved

oracle58 and others added 2 commits May 24, 2025 13:01

Add tall node to box_shadow example

661bf86

Co-authored-by: ickshonpe <[email protected]>

use children! instead of with_children in box_shadow example

7a18fa5

Co-authored-by: ickshonpe <[email protected]>

oracle58 force-pushed the improve-box-shadow branch from 442c267 to 7a18fa5 Compare May 24, 2025 11:21

oracle58 added 2 commits May 24, 2025 14:08

Refactor value label backgrounds

a87a028

make shape label transparent while keeping others gray for improved UI clarity

Add button repeat functionality

cafaf79

- Track last pressed button and press time in a resource - Add system to trigger button actions at a repeat interval when held - Improves UX for increment/decrement and shape navigation buttons

oracle58 force-pushed the improve-box-shadow branch from 68dc3e1 to cafaf79 Compare May 24, 2025 17:30

alice-i-cecile added C-Examples An addition or correction to our examples A-UI Graphical user interfaces, styles, layouts, and widgets S-Needs-Review Needs reviewer attention (from anyone!) to move forward labels May 26, 2025

alice-i-cecile approved these changes May 26, 2025

View reviewed changes

alice-i-cecile mentioned this pull request May 26, 2025

Test box shadow variations in a testbed example #19379

Closed

rparrett suggested changes May 26, 2025

View reviewed changes

alice-i-cecile added S-Waiting-on-Author The author needs to make changes or address concerns before this can be merged and removed S-Ready-For-Final-Review This PR has been approved by the community. It's ready for a maintainer to consider merging it labels May 26, 2025

alice-i-cecile added this to the 0.17 milestone May 26, 2025

oracle58 added 2 commits May 27, 2025 14:36

Merge branch 'main' into improve-box-shadow

2cec73b

oracle58 requested a review from rparrett May 27, 2025 12:41

oracle58 force-pushed the improve-box-shadow branch from a55ca05 to 5394519 Compare May 27, 2025 12:58

Fix CI Build

e1d7b2c

- Replace tuple struct syntax with BorderColor::all(...) in shape node and settings panel. - Resolves E0423 error due to struct construction changes in Bevy UI. - consistent formatting - Fmt imports

oracle58 force-pushed the improve-box-shadow branch from 5394519 to e1d7b2c Compare May 27, 2025 13:04

force redraw events while button is held

40a1cfa

alice-i-cecile added this pull request to the merge queue May 27, 2025

Merged via the queue into bevyengine:main with commit 8e58517 May 27, 2025
32 checks passed

rparrett mentioned this pull request May 27, 2025

Minor refactoring of box_shadow example #19404

Merged

Uh oh!

box_shadow example with adjustable settings #19345

box_shadow example with adjustable settings #19345

Uh oh!

Conversation

oracle58 commented May 23, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Objective

Solution

Testing

Showcase

Uh oh!

ickshonpe left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

oracle58 commented May 24, 2025

Uh oh!

alice-i-cecile left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

oracle58 commented May 26, 2025

Uh oh!

JMS55 commented May 26, 2025

Uh oh!

alice-i-cecile commented May 26, 2025

Uh oh!

rparrett left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

oracle58 commented May 27, 2025

Uh oh!

alice-i-cecile commented May 27, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

`box_shadow` example with adjustable settings #19345

`box_shadow` example with adjustable settings #19345

oracle58 commented May 23, 2025 •

edited

Loading

alice-i-cecile left a comment •

edited

Loading

alice-i-cecile commented May 27, 2025 •

edited

Loading