Currently Online

Latest Posts

Topic: What does wui and fs stands for?

kaputtnik
Avatar
Topic Opener
Joined: 2013-02-18, 19:48
Posts: 2443
OS: Archlinux
Version: current master
Ranking
One Elder of Players
Location: Germany
Posted at: 2024-01-29, 12:11

When working with ui elements or themes it would be nice to have some examples for fonts and styles. Reading fonts leads to questions, because a normal user doesn't know how wui_info_panel_heading or wui_message_heading looks like. And the question what "fs" and "wui" stands for.

I think "wui" stands for "widelands user interface", and definitions containing "wui" are used for in-game and in-editor styles.
Definitions containing "fs" are used mainly for the main menu screens, like the main menu itself, file selection menus and game setup menus. But i am not sure about that.

It would be nice to have an image beside the fonts which shows at least the wui-fonts and styles of the default theme. Showing both, wui- and fs-fonts and styles is probably too big.


Attachment:
fonts_styles.png

Fight simulator for Widelands:
https://wide-fighter.netlify.app/

Top Quote
Nordfriese
Avatar
Joined: 2017-01-17, 17:07
Posts: 1955
OS: Debian Testing
Version: Latest master
Ranking
One Elder of Players
Location: 0x55555d3a34c0
Posted at: 2024-01-29, 12:21

I think "wui" stands for "widelands user interface", and definitions containing "wui" are used for in-game and in-editor styles.
Definitions containing "fs" are used mainly for the main menu screens, like the main menu itself, file selection menus and game setup menus. But i am not sure about that.

Correct, this is also documented here:

https://www.widelands.org/documentation/themes/#required-files

wui/ and fsmenu/

These directories contain images for UI elements for items in the game and editor (‘wui’) and in the main menu (‘fsmenu’).

The name "fs" historically stands for Fullscreen since all main menu panels used to be fullscreen screens. Unnecessary renamings are avoided to increase backwards and forward compatibility.

+1 for such images in the doc face-smile.png


Top Quote
tothxa
Avatar
Joined: 2021-03-24, 11:44
Posts: 439
OS: antix / Debian
Version: some new PR I'm testing
Ranking
Tribe Member
Posted at: 2024-01-29, 13:37

We can document the default style visually, but it should also prominently say that these can be overridden by theme addons.


Top Quote