bevyengine / bevyengine/bevy-website

0.18 to 0.19 migration guide missing entry: `ImageNode` now draws in the content box by default

Open Beginner friendly
#2,543 1 comment 0 reactions 0 assignees View on GitHub
C-Docs
Dominant language
JavaScript
Stars
249
Forks
450
Avg merge
16h 20m
Merged PRs (30d)
6

Description

The 0.18 to 0.19 migration guide has no entry for the `ImageNode` rendering change introduced in bevyengine/bevy#24154

0.19 added `ImageNode::visual_box` (`VisualBox`), defaulting to `VisualBox::ContentBox`. In 0.18, an `ImageNode`'s image was drawn over the node's full bounds; in 0.19 it is drawn only within the content box — i.e. inset by the node's `border` and `padding`.

Any node combining an `ImageNode` with nonzero `padding` (or `border`) renders differently after upgrading, with no compile error or warning. I ran into this with the exact use case that motivated bevyengine/bevy#24150: a 9-sliced button background with padding used to inset a text label. After upgrading, the sliced background shrinks to hug the label and the padding appears to no longer work.

Contributor guide

Open the contributing guide

Research direction

Start with the 0.18 to 0.19 migration guide and review its existing entries for the appropriate placement and style. Document the ImageNode visual-box default change and its effect on padding and borders, then confirm the new entry explains the upgrade impact described in the issue.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Quiet
Clarity
Clearly specified
Newbie friendliness
78/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.