XenonUI

From Elite Wiki
Revision as of 04:18, 18 December 2015 by Phkb (talk | contribs)
Sample screenshot using Dangerous Square Font and Resource Pack E

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

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.

Compatibility with BackGroundSet (BGS)

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 particular 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.

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 H) 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 is incompatible with the main version. If both are installed, the 16:9 version will take precedence. Note: The "Redux" version does not have any sidebars or Galactic chart legend overlays.

Download

Main Version

Download config v1.4.0 XenonUI.oxz (downloaded 4462 times).
Download resources pack A (16:9 screens) OCR A Extended font v1.2.0 XenonUIResources.oxz (downloaded 2046 times).
Download resources pack B (16:10 screens) OCR A Extended font v1.2.0 XenonUIResourcesB.oxz (downloaded 1164 times).
Download resources pack C (16:9 screens) Xolonium font v1.0.0 XenonUIResourcesC.oxz (downloaded 1261 times).
Download resources pack D (16:10 screens) Xoloniun font v1.0.0 XenonUIResourcesD.oxz (downloaded 1059 times).
Download resources pack E (16:9 screens) Dangerous Square font v1.0.0 XenonUIResourcesE.oxz (downloaded 1267 times).
Download resources pack F (16:10 screens) Dangerous Square font v1.0.0 XenonUIResourcesF.oxz (downloaded 997 times).
Download resources pack G (16:9 screens) Default (Helvetica) font v1.0.0 XenonUIResourcesG.oxz (downloaded 1110 times).
Download resources pack H (16:10 screens) Default (Helvetica) font v1.0.0 XenonUIResourcesH.oxz (downloaded 928 times).

Redux Version (for narrower eg 4:3 screens)

Download config v1.3.0 XenonReduxUI.oxz (downloaded 1915 times).
Download resources v1.1.2 XenonReduxUIResources.oxz (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

Version 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.

Version 1.3.3

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

Version 1.3.2

  • Fixed Javascript bug.

Version 1.3.1

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

Version 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.

Version 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.

Version 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.

Version 1.1.3

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

Version 1.1.2

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

Version 1.1.1

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

Version 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

Version 1.0

  • Initial release

Quick Facts

Version Released License Features Category Author(s) Feedback
1.4.0 2015-12-18 CC BY-NC-SA 3.0 Backgrounds Music Ambience OXPs phkb Oolite BB

Gameplay and Balance indicator

Tag-colour-green.png