[therenow9]

What's changed?

Wood themes can show the battery level on the top screen, like the DSi and 3DS themes already do. A theme opts in with a new uisettings.ini section and one image:

[battery]
show = 1
x = 228
y = 3

battery.bmp (in the theme folder, next to brightness.bmp) holds 8 frames of equal height, stacked vertically: frames 0-3 are 1-4 bars, frames 4-7 the same while charging. Pure black (0,0,0) is transparent. A bottom-up BMP at 1, 8, 16, 24 or 32 bits works. Any other format is skipped, so nothing unfilled is drawn.

The section is [battery], not [battery icon]. The old akmenu used [battery icon] for a bottom-screen icon built from other files, so old themes that still carry it stay unaffected.

• drawBattery() reads sys().batteryStatus() (the same levels the DSi theme maps: 0xF/0xB/0x7/lower → 4/3/2/1 bars, bit 7 = charging) and redraws only when the frame changes. It is called from bgOperations() next to the calendar parts.
• It is independent of showCalendar and skipped in macro mode, like box art. Themes without the section are unchanged.
• If the icon would fall off the screen, nothing is drawn.
• Changes are in graphics.cpp, graphics.h and main.cpp (+82/−4).
• Theme authors should keep it outside a [box art] panel, because the panel repaints its whole rectangle.
• This touches the same spots as the free-space and loader-badge PRs I'm opening alongside this one. Whichever merges second needs a small rebase; I'll do it.

Where have you tested it?

New Nintendo 3DS XL with a DSpico, TWiLight on the console SD (v27.25.1 + #2698 + this change):

• a Wood theme with [battery] shows the bars at the level, and the charging frames while on the charger;
• a theme without the section (CD - Indigo) is unchanged.

On battery, and on the charger:

---

Pull Request status

• This PR has been tested using the latest version of devkitARM and libnds.

Built in the devkitpro/devkitarm:20241104 Docker image that the nightly workflow uses (no new warnings).

The code was written with help from an AI assistant (Claude Code). I reviewed it and tested it on my console.

[therenow9]

@RocketRobz the merge issues are now resolved