ObliviOS Developer portal Project site

Home / Decisions / ADR-156

The loading texture of the boot picture is 720 x 256 and the renderer lines it up with the bottom edge of the mask.

Accepted, recorded 11 October 2026.

Decision
ADR-156
Date
2026-10-11
Status
AcceptedAccepted
Mentions
ADR-152
Mentioned by
ADR-152, ADR-219

1Decision

The loading texture of the boot picture is 720 x 256 and the renderer lines it up with the bottom edge of the mask. Supersedes ADR-152 on two points: the scrolling texture of 720 x 2160, and the statement that it is drawn from the top left of the mask. The track and the segment are on rows 2 to 18 of the texture, which are rows 2146 to 2162 of the mask; the window (rows 2152 to 2156) shows rows 8 to 12. Package branding/boot of sovereignos-platform: source, generator, test and patch 0003 changed; the other patches stay.

2Why and evidence

Owner report 2026-10-11 (chat): the boot picture is shown and the loading bar is missing; the owner asked for the cause and the fix. Measured on lynx image 2026101101 (BOOT-009): a replay of the boot animation service gave six identical frames and every pixel of the window was the clear colour (3,7,6).

Verified in source (BootAnimation.cpp, drawTexturedQuad): y is mapped with mapLinear(yStart, 0, height, -1, 1), GL's y-up convention, so a texture sits on the bottom edge of the mask; the 2160-row shine therefore showed its row 1912 in the window and its track was under the opaque bottom of the mask. A simulation with the texture on the bottom edge differs from the captured frame in 5e-8 of the pixels, one with it on the top edge in 8e-5.

The real renderer, run with a 2400-row texture and with the 256-row texture (the apk bind-mounted for the replay only, restored and compared by sha256), drew the track and a mint segment at changing positions.

3Consequences

Texture memory is 0.74 MB instead of 6.2 MB (computed), 11.1 MB with the mask. The fix is landed on the build server (fda11b7a2c9d, frameworks/base) and in the package; no image carries it yet, so the bar is still missing on the flashed image until the next build. The package test now simulates the bottom alignment and fails for the 2160-row texture; the earlier simulation placed the texture at the top and could not see the defect.

4Review when

An upstream change of drawTexturedQuad; a display taller than 2400 px (the texture follows the bottom of the mask, BOOT-004).

Read from docs/governance/decision-log.md, entry ADR-156.