Difference between revisions of "GUIToolkit"

From The Battle for Wesnoth Wiki
m (Fix heading markup)
(Links)
(5 intermediate revisions by the same user not shown)
Line 21: Line 21:
  
 
== Links ==
 
== Links ==
* [[GUIVariable]] describes the variable used for the parts of WML.
+
* [https://devdocs.wesnoth.org/group__GUIWidgetWML.html Widgets] - the various widgets, the options which can be used when a widget is "instantiated" in a window definition, and the types of GUI2 variables available.
* [[GUILayout]] describes how to place widgets in a window.
+
* [https://devdocs.wesnoth.org/GUILayout.html Layout] - describes how to place widgets in a window.
* [[GUIWidgetDefinitionWML]] describes how the various widgets are defined.
+
* [https://devdocs.wesnoth.org/group__GUIWindowDefinitionWML.html WindowDefinitionWML] - describes the windows available and which widgets the 'know' about.
* [[GUIWidgetInstanceWML]] describes the options which can be used when a widget is "instantiated" in a window definition.
+
* [https://devdocs.wesnoth.org/GUIToolkitWML.html GUIToolkit] - describes the basics of the engine.
* [[GUIWindowDefinitionWML]] describes the windows available and which widgets the 'know' about.
+
* [https://devdocs.wesnoth.org/group__GUICanvasWML.html GUICanvas] - describes what to draw on a widget.
* [[GUIToolkitWML]] describes the basics of the engine.
 
* [[GUICanvasWML]] describes what to draw on a widget.
 
* [[Wiki_grabber]] describes the tool to generate the wiki pages.
 
  
  
 
[[Category:WML Reference]]
 
[[Category:WML Reference]]
 
[[Category: GUI WML Reference]]
 
[[Category: GUI WML Reference]]

Revision as of 07:24, 22 January 2021

Introduction

This is a new toolkit aiming to make it possible to make the look of Wesnoth fully skinnable. This will be used in Wesnoth the make it easier to optimize for different screen resolutions. The initial work in progress version has been released with Wesnoth 1.6. Since the development isn't done yet, these pages reflect the state of the trunk.

The engine has two parts:

  • Widget definition, which defines how a widget looks.
  • Window definition, which defines how a certain window looks and it uses the widget definitions.

Todo list

Here's a(n incomplete) list of items which still need to be done.

  • The layout engine can still have problems with not finding a solution and stop.
    • Make sure labels buttons etc can shrink and show ellipses to shrink small enough
    • Optimize the shrink algorithm
  • The code for the events is not entirely to my liking and I want to look at using signals instead, events are there bug not yet used everywhere.
  • EasyCoding#GUI2_related_features
  • Improve the markup for the text
  • Convert more dialogs

Links

  • Widgets - the various widgets, the options which can be used when a widget is "instantiated" in a window definition, and the types of GUI2 variables available.
  • Layout - describes how to place widgets in a window.
  • WindowDefinitionWML - describes the windows available and which widgets the 'know' about.
  • GUIToolkit - describes the basics of the engine.
  • GUICanvas - describes what to draw on a widget.