XenonUI

From Elite Wiki
Revision as of 00:33, 23 March 2018 by Phkb (talk | contribs) (Version History)
Sample screenshot using Dangerous Square Font and Resource Pack E, combined with the Xenon HUD

Overview

This OXP replaces all background UI screens with a new look and feel, based on the assumption that the Oolite UI screens are accessed through some form of computer terminal. The layout will change based on whether the HUD is on or off, in the ship is in space or docked, and (if in space), is in a red alert condition or not. The "Sub-Commands" section will show some important key codes and descriptions that are relevant on that page.

Also provided in this OXP is some new title screen theme music.

The method used to add the backgrounds will mean that the background images of most other OXP's, if they set a background, will be overridden with the Xenon UI images. This is by design.

If an OXP uses background images to convey important information to the player, and the "mission.runScreen" command in the OXP has a "screenID" parameter attached, it is possible to add exceptions to the override by adding the following code to a worldScript:

 var w = worldScripts.XenonUI;
 if (w) w.$addMissionScreenException("mymissionscreenid");

The OXP is made up of two parts: the main XenonUI.oxz, which holds all the config, code and the music file, and a resources pack which holds all the images. This will allow fast updates to the code section, which is small, without having to download the large resources file regularly.

There are different packs for screen ratios of 16:9 or 16:10 (also known as 8:5 ratio), and using different fonts for the text.

Screen Ratio
Font16:916:10
OCR A ExtendedPack APack B
XoloniumPack CPack D
Dangerous SquarePack EPack F
Default (Helvetica)Pack GPack H
Dosis/DangerousPack IPack J
DiscognatePack KPack L
NovaSquarePack MPack N

For narrower screens, there is a "Redux" version, which removes all the sidebars, leaving only the grid background and main window outline. Because of this, the legend overlay on the F6 galactic chart display is not provided in this version.

BackGroundSet (BGS) 1.0 Compatibility

Xenon UI is compatible with BGS, but depending on where each one is installed, one OXP may end up taking priority over the other when backgrounds are selected and displayed. When BGS has priority, its images will be displayed ahead of the Xenon UI images. This will be particularly apparent on screens like the title page or the load/save page.

  • If both OXP's (Xenon UI and BGS) are installed in the Addons folder, Xenon UI will normally take priority over BGS.
  • If both OXP's are installed via the download manager, again, Xenon UI will normally take priority over BGS.
  • If BGS is installed via the download manager, and Xenon UI is installed in the AddOns folder, Xenon UI will take priority over BGS.
  • If Xenon UI is installed via the download manager, and BGS is installed in the AddOns folder, BGS will take priority over Xenon UI.

To ensure the Xenon UI backgrounds appear, the best approach is to make sure they are both installed in the same location.

If you encounter issues where the BGS backgrounds are being displayed rather than the Xenon UI ones, you will need to open the BGS OXP folder, then open the Config folder. Inside Config you will find a 'screenbackgrounds.plist' file. Either remove this or re-name it - perhaps re-name it to 'screenbackgrounds.Xplist' - and the Xenon UI backgrounds will be used without affecting any other aspect of BGS. By re-naming 'screenbackgrounds.plist' rather than removing it you have the option of switching back easily if required.

Background Set 2.0 Compatibility

Xenon UI will hook into Library GUI to register itself as a GUI set. Therefore, you can go to the Library GUI settings and change between BGS 2.0 and Xenon UI anytime you like.

Because of the way the images are created, Xenon UI is still utilising settings in "screenbackgrounds.plist", which may lead to some inconsistencies. For instance, if Xenon UI and BGS 2.0 are installed, when you start Oolite and select the option to open a saved commander, the background will likely be Xenon UI. Once you have loaded a game where BGS 2.0 is the specified GUI, if you then press F2 to load a new game, you will see the BGS background.

Installation

Main Version

There are two components to the installation: The first part contains all the config and code. The second part contains all the image and music resources. Place the 'XenonUI.oxz' and one of the resource packs (A through N) into your 'AddOns' folder and when you start the game, hold down 'Shift' until you see the spinning Cobra.
Alternatively, you can download the expansion using the expansion pack manager in the game itself.

Redux Version (for narrower eg 4:3 screens)

There are two components to the installation: The first part contains all the config and code. The second part contains all the image and music resources. Place the 'XenonReduxUI.oxz' and 'XenonReduxUIResources.oxz' into your 'AddOns' folder and when you start the game, hold down 'Shift' until you see the spinning Cobra.
Alternatively, you can download the expansion using the expansion pack manager in the game itself.

Note: The "Redux" version does not have any sidebars or Galactic chart legend overlays.

Download

Main Version

Download XenonUI.oxz v2.2.1 (downloaded 4462 times).
Download resources pack A (16:9 screens) OCR A Extended font v1.4.0 XenonUIResources.oxz (downloaded 2046 times).
Download resources pack B (16:10 screens) OCR A Extended font v1.4.0 XenonUIResourcesB.oxz (downloaded 1164 times).
Download resources pack C (16:9 screens) Xolonium font v1.2.0 XenonUIResourcesC.oxz (downloaded 1261 times).
Download resources pack D (16:10 screens) Xolonium font v1.2.0 XenonUIResourcesD.oxz (downloaded 1059 times).
Download resources pack E (16:9 screens) Dangerous Square font v1.2.0 XenonUIResourcesE.oxz (downloaded 1267 times).
Download resources pack F (16:10 screens) Dangerous Square font v1.2.0 XenonUIResourcesF.oxz (downloaded 997 times).
Download resources pack G (16:9 screens) Default (Helvetica) font v1.2.0 XenonUIResourcesG.oxz (downloaded 1110 times).
Download resources pack H (16:10 screens) Default (Helvetica) font v1.2.0 XenonUIResourcesH.oxz (downloaded 928 times).
Download resources pack I (16:9 screens) Dosis (Dangerous) font v1.1.0 XenonUIResourcesI.oxz (downloaded 581 times).
Download resources pack J (16:10 screens) Dosis (Dangerous) font v1.1.0 XenonUIResourcesJ.oxz (downloaded 516 times).
Download resources pack K (16:9 screens) Discognate font v1.1.0 XenonUIResourcesK.oxz (downloaded 195 times).
Download resources pack L (16:10 screens) Discognate font v1.1.0 XenonUIResourcesL.oxz (downloaded 316 times).
Download resources pack M (16:9 screens) NovaSquare font v1.1.0 XenonUIResourcesM.oxz (downloaded 220 times).
Download resources pack N (16:10 screens) NovaSquare font v1.1.0 XenonUIResourcesN.oxz (downloaded 186 times).

Redux Version (for narrower eg 4:3 screens)

Download XenonReduxUI.oxz v2.1.5 (downloaded 1915 times).
Download XenonReduxUIResources.oxz v1.2.0 (downloaded 2121 times).

Licence/Author

This work is licensed under the Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License. To view a copy of this license, visit http://creativecommons.org/licenses/by-nc-sa/3.0/ or send a letter to Creative Commons, 171 Second Street, Suite 300, San Francisco, California, 94105, USA.
The expansion pack was developed by phkb.

Version History

2.2.1

  • Improvements in Library GUI integration.

2.2.0

  • Added functions to enable different chart legend overlays to be displayed, based on what the player has selected. (Oolite 1.87/88 required)

2.1.4

  • Improved coverage of different mission screen sequencing scenarios. (Oolite 1.85/86 required)
  • Improved integration with XenonReduxUI via Library GUI.
  • Added new screenbackgrounds added in v1.87 ("custom_chart_mission").

2.1.3

  • Fixed incorrect key lookup with mission screen overlays.
  • Fixed issue with turning off overlay images with Library GUI.
  • Disabling background images on a mission screen will now also disable any overlays as well.

2.1.2

  • Bug fixes.

2.1.1

  • Rejigged connection to Library GUI for nicer handovers when GUI's change.

2.1.0

  • Updated for simpler integration with Library GUI.
  • Code refactoring.

2.0.4

  • Adjusted the Random Hits screen ID exception.

2.0.2

  • Updated title screen image.
  • F5 Cmdr Profile and F5F5 Manifest were swapped around when using Library GUI.

2.0.1

  • Fixed compatibility issue with HDBG when using Library GUI.

2.0.0

  • Made compatible with Library GUI.
  • Added some configuration settings to Library Config.
  • Added additional overlays to various data screens.
  • Code cleanup.

1.4.2

  • Corrected error in Nova Mission runScreen command parameters (caused by me, not the core code!) that was causing the Yes/No option to not display.

1.4.1

  • Updated check for "Allow Big GUI".

1.4.0

  • Changed new game background to the 'no hud' variant.
  • New title screen image.
  • Added mission screen overlays. Can be disabled by setting "this._disableOverlays = true;" in "xenonui.js".
  • Fixed issue with BGS where the F6 overlay image was being removed.
  • Fixed issue where exiting the Ship Library screen would sometimes show the wrong background.
  • Added mission screen exception for Random Hits.

1.3.3

  • Added screenID exceptions for UPS Courier.
  • Added screenID exceptions for Escort Contracts (v1.6.3).
  • Added routine to use 1.83/4 code to check for big GUI HUD's.

1.3.2

  • Fixed Javascript bug.

1.3.1

  • Added screenID exceptions for Blackmonks.
  • Fixed issue where all components were not being disabled correctly when no resource packs are installed.

1.3.0

  • Checks for the "allow_big_gui" option on HUD's. Uses the "nohud" background variations when found.
  • Fixed issue where the wrong background was being selected going to or from the F8 Market screen if Market Observer is installed.
  • Added screenID exceptions for Rescue Stations.

1.2.0

  • Updated all images to be 2048x1024 to stop Oolite from rescaling them. Results in a much cleaner image
  • Fixed issue with mission screens that exit to the short or long range chart, where the wrong background was being displayed.
  • Added screenID's to nova mission screens.
  • Moved the music file back into the main OXP so it doesn't have to be in all the resource packs.
  • Added a paused overlay.
  • Added a legend overlay to the Galactic chart screens to aid in understanding the various highlight modes.
  • Added a routine to check for the presence of resource pack, and output an error to the log if no pack is found.
  • Added a "requires_oxp" section to all resource packs to require the main OXP.

1.1.4

  • Adjusted the main title colour to match with the background.
  • Adjusted graphical elements to line up better between screens, as noted by Tichy.
  • Fixed issue with Trumbles and Nova missions not showing proper background image.
  • Changed license of code section to CC-BY-NC-SA 3.0 due to inclusion of trumbles and nova mission code.

1.1.3

  • Updated manifest to remove required OXP, as there are now two different resource packs available.

1.1.2

  • Changed manifest identifier to try and position the OXP at the bottom of the install list

1.1.1

  • Fixed bug where "." is missing before "indexOf".

1.1.0

  • Split OXZ into two, one for resources (music and images), one for the code and config.
  • Fixed file name issue for one of the files.
  • Code improvements as suggested by Wildeblood.
  • Added exception for Norby's OXP (HDBG)
  • Added some BGS override exceptions

1.0

  • Initial release

Quick Facts

Levelindicator0.png
0-{{{2}}}

Minimum Oolite versionCPU usage lowMemory usage lowGPU usage averageisAPIisDocumentedisConfigurable

Config options available through 'Library'
Version Released License Features Category Author(s) Feedback
2.2.1 2018-03-18 CC BY-NC-SA 3.0 Backgrounds Music Ambience OXPs phkb Oolite BB

Gameplay and Balance indicator

Tag-colour-green.png