WDW file structure: Difference between revisions
Jump to navigation
Jump to search
imported>Aggelakis (historical) m (added Related Articles, added Gameplay category) |
imported>Rugiel (historical) m (Expanded breakdown, added note on placement) |
||
| Line 2: | Line 2: | ||
[[Issue 12]] introduced the ability to save in-game window positions. This article aims to document the format/syntax of the text files created. | [[Issue 12]] introduced the ability to save in-game window positions. This article aims to document the format/syntax of the text files created. | ||
== | == Breakdown == | ||
<code>status 470 959 295 65 1.000000 7c7c7cff 4d 0 2</code> | <code>status 470 959 295 65 1.000000 7c7c7cff 4d 0 2</code> | ||
* status = | * <code>status</code> = Window name. Conforms to the list given by {{slashcommand|window_names}}. | ||
* 470 = X coordinate | * <code>470</code> = X coordinate. Distance in pixels from top of screen/window to the top of UI window. | ||
* 959 = Y coordinate | * <code>959</code> = Y coordinate. Distance in pixels from left edge of screen/window to the left edge of UI window. | ||
* 295 = | * <code>295</code> = Window width. In pixels, always the window's width at 100% scale. | ||
* 65 = | * <code>65</code> = Window height. In pixels, always the window's height at 100% scale. | ||
* 1.000000 = Window scale | * <code>1.000000</code> = [[Window scale (Slash Command)|Window scale]]. Values can range from 0.650000 (65%) to 2.25000 (225%). | ||
* 7c7c7cff = Color in RRGGBBAA format. | * <code>7c7c7cff</code> = Color in hexadecimal RRGGBBAA (Red - Green - Blue - Alpha) format. The alpha value is the opacity of the window border, not of the window opacity. Omitting this value will cause a crash or error when loading the file. | ||
* 4d = Unknown internal field | * <code>4d</code> = Unknown internal field. May show other values. ''{{red|Do not edit.}}'' | ||
* 0 = | * <code>0</code> = Window docking status. Can take values '''0''' (undocked/detached from its standard parent window) or '''1''' (docked/attached to its standard parent window). | ||
* 2 = | * <code>2</code> = Window display status. Can take values '''2''' (window is shown) or '''4''' (window is hidden). Numbers > 4 in this field produce odd windows with no title bar that do not always function correctly. | ||
=== Placement and scaling === | |||
Because the window position and dimension values are always given at the window's 100% scale, manually editing this file presents some challenges when trying to arrange windows by their bottom or right edges when the overall UI scale is smaller or larger than 100%. | |||
However, <code>wdw</code> files are editable during play, and any changes will be visible immediately by reloading the edited and saved file into the game. | |||
==Related== | ==Related== | ||
Revision as of 10:36, 9 October 2008
Overview
Issue 12 introduced the ability to save in-game window positions. This article aims to document the format/syntax of the text files created.
Breakdown
status 470 959 295 65 1.000000 7c7c7cff 4d 0 2
status= Window name. Conforms to the list given by /window_names.470= X coordinate. Distance in pixels from top of screen/window to the top of UI window.959= Y coordinate. Distance in pixels from left edge of screen/window to the left edge of UI window.295= Window width. In pixels, always the window's width at 100% scale.65= Window height. In pixels, always the window's height at 100% scale.1.000000= Window scale. Values can range from 0.650000 (65%) to 2.25000 (225%).7c7c7cff= Color in hexadecimal RRGGBBAA (Red - Green - Blue - Alpha) format. The alpha value is the opacity of the window border, not of the window opacity. Omitting this value will cause a crash or error when loading the file.4d= Unknown internal field. May show other values. Do not edit.0= Window docking status. Can take values 0 (undocked/detached from its standard parent window) or 1 (docked/attached to its standard parent window).2= Window display status. Can take values 2 (window is shown) or 4 (window is hidden). Numbers > 4 in this field produce odd windows with no title bar that do not always function correctly.
Placement and scaling
Because the window position and dimension values are always given at the window's 100% scale, manually editing this file presents some challenges when trying to arrange windows by their bottom or right edges when the overall UI scale is smaller or larger than 100%.
However, wdw files are editable during play, and any changes will be visible immediately by reloading the edited and saved file into the game.
Related
- /wdw_save - No parameters/options. Saves window configuration to wdw.txt in the install directory.
- /wdw_load - No parameters/options. Loads window configuration from wdw.txt in the install directory.
- /wdw_save_file path
- /wdw_load_file path