Skip to content

Reference: WBConfig() in workbench.library 45 (Workbench backdrop and icon font) - #64

Open
WDrijver wants to merge 1 commit into
mainfrom
reference/workbench-wbconfig
Open

WDrijver wants to merge 1 commit into
mainfrom
reference/workbench-wbconfig

Conversation

@WDrijver

Copy link
Copy Markdown
Contributor

New reference file os/libraries/workbench-wbconfig.md.

The AmigaOS 3.5/3.9 Workbench gets its backdrop pictures and its icon font from IPrefs through the private, undocumented WBConfig() (workbench.library LVO -84). AROS never implemented it, so ApolloOS's AROS-derived IPrefs gave the 3.9 Workbench (which R10 ships) no wallpaper and no icon font. R9.6 worked around that by running the AmigaOS 3.5 IPrefs as C:IPrefs.AOS39. ApolloOS R10 now calls WBConfig() from its own IPrefs.

The file documents:

  • the call: codes 1-4, the return value, and when it can be called;
  • the backdrop struct and the font struct, and how to free them;
  • the WBPattern.prefs format of the AmigaOS 3.5+ editor, including the FIP0 option bits (centre/tile/fill border/precision live there, not in wbp_Flags);
  • the AROS differences: the stub, and picture.datatype's PDTA_BitMap after layout.

Sources: a disassembly of IPrefs 44.23 and workbench.library 45.102, plus measurements on an Apollo V4 with an ApolloOS R10 dev card:

  • each option of R9.6's WBPattern editor was saved on its own and the files compared;
  • wallpaper and XEN 9 icon labels appeared at boot with only R10's IPrefs.

The implementation is in ApolloOS-Port commits 2e09af9, cfe53b4 and 2a68741.

Knowledge base files relied on: none; the knowledge base was silent on this (AGENTS.md section 5).

Checks run locally: check_frontmatter, check_links, check_owners, check_saga_addresses: OK.

🤖 Generated with Claude Code

… of the AmigaOS 3.9 Workbench)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@WDrijver
WDrijver requested a review from TuKo1982 as a code owner November 18, 2026 15:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant