https://wiki.alioth.net/api.php?action=feedcontributions&feedformat=atom&user=Another+commanderElite Wiki - User contributions [en]2026-05-07T05:22:20ZUser contributionsMediaWiki 1.31.12https://wiki.alioth.net/index.php?title=Developing_Oolite&diff=87482Developing Oolite2025-12-18T20:45:26Z<p>Another commander: /* Current way to do it */</p>
<hr />
<div>= Overview =<br />
<br />
This page intends to allow you to setup an environment to develop Oolite.<br />
<br />
== Before you begin ==<br />
<br />
If you do not know Objective C, see [https://bb.oolite.space/viewtopic.php?f=7&t=10525 I want to help develop Oolite] (2011).<br />
<br />
== Cloning or forking? ==<br />
<br />
When developing software, each little modification is tracked independently and assigned a version identifier.<br />
That's called [http://en.wikipedia.com/Software_versioning versioning].<br />
To do this, we use the [http://en.wikipedia.com/Git_(software) git] software.<br />
We used to use a svn repository, but this one isn't maintained anymore.<br />
<br />
It is possible either to fork (create a copy of) your own branch on github, or to only clone locally the master branch.<br />
In both cases, you can hack, try, do whatever takes your fancy :-)<br />
But to have your changes integrated back into the main Oolite, it is easier to setup your own branch. Luckily, you can do this at the end when you are ready to propose your code too.<br />
<br />
== Installing git ==<br />
<br />
We need git for this. <br />
<br />
=== On Linux ===<br />
<br />
Installing git depends on your distribution. For ubuntu:<br />
<code>sudo apt-get install git</code><br />
<br />
= Getting the code by cloning the master branch =<br />
<br />
The Oolite source is available from github. First do<br />
<br />
<code> git clone https://github.com/OoliteProject/oolite </code><br />
<br />
to retrieve. Then, in the directory this creates, do<br />
<br />
<code> git submodule update --init</code><br />
<br />
to pull in various other components such as dependencies, binary resources, and so on. The old SVN repository is no longer being updated.<br />
<br />
Et voila! You've got the source ready to be compiled and/or tweaked.<br />
<br />
= Getting the code by forking your own branch (alternative to cloning the master branch) =<br />
<br />
The Oolite code is hosted on a git-friendly repository: github.<br />
<br />
== Creating a GitHub account ==<br />
<br />
Go to https://github.com/ and create an account.<br />
<br />
== Creating a branch on GitHub ==<br />
<br />
Fork the [https://github.com/OoliteProject/oolite oolite main branch].<br />
<br />
== Fetching your branch ==<br />
<br />
We now repatriate the code locally: we fetch it.<br />
<br />
=== On Linux ===<br />
<br />
<code>git fetch --help</code><br />
<br />
= Documentation =<br />
<br />
The documentation is automatically generated from the source code.<br />
When generated, it's 700mb heavy !<br />
<br />
This documentation is automatically generated on Github whenever the repository changes. The result is published as one of the build artifacts that you can download locally. The latest version is also published on https://ooliteproject.github.io/oolite/.<br />
<br />
== Pre-requisites ==<br />
<br />
Installing Doxygen<br />
<br />
=== On Linux ===<br />
<br />
It depends on your distribution. For Ubuntu:<br />
<code>sudo apt-get install doxygen</code><br />
<br />
=== On Windows ===<br />
<br />
You can download Doxygen binaries from the [https://www.doxygen.nl/download.html ''project's home page''].<br />
<br />
== Generation ==<br />
<br />
The documentation is generated into a html sub-directory.<br />
<br />
=== On Linux & Windows ===<br />
<br />
Just go into your oolite directory and do:<br />
<br />
<code>doxygen Doxyfile</code><br />
Note that this will generate the Mac source documentation by default. For Linux and Windows, you will also have to pass the appropriate defines (e.g. OOLITE_WINDOWS, OOLITE_SDL etc.) to Doxygen.<br />
<br />
If you don't want to install Doxygen and generate it yourself you can download the documentation from Github, or browse it directly on https://ooliteproject.github.io/oolite/.<br />
<br />
= Setting up your development environment =<br />
<br />
= Building =<br />
== On AppleMac ==<br />
At time of writing (Dec 2023), this is impossible with current versions. But see [[Running Oolite-Mac]] for what used to work.<br />
<br />
== On Windows ==<br />
=== Current way to do it ===<br />
<br />
''Let's hear the wise words of another_commander (Updated 18th April 2023)''<br />
<br />
Seeing that, despite the quite comprehensive wiki instructions on how to make an Oolite executable, building from source on Windows is still a quite complicated matter, I have created a package that will hopefully simplify the process a lot and allow even the relatively inexperienced users to have a razor bleeding edge version of the game to play with and test. Please note that bleeding edge versions may cause spontaneous combustion of your computer, so you use them at own risk.<br />
<br />
<br />
The download link to the Oolite Development Environment - Light Edition is this:<br />
https://drive.google.com/file/d/1u1IvBxiQjNvtrFs_2POaRP3IZhAi46N0/view?usp=sharing<br />
The package contains the Objective-C compiler plus Posix environment (MinGW/MSYS), the Git package version 2.16.2 required for checking out and updating the source code and the required gnustep-base 1.20.1 files. No other downloads will be required. <br />
<br />
Alternatively, you can use the same Development Environment we deploy on github to produce the Windows nightly pre-release builds. This is guaranteed to always be the most recent and updated version, but it is a significantly bigger download. You can get it from https://github.com/OoliteProject/oolite-windows-build-env/releases/download/latest/DevelopmentEnvironment.zip<br />
<br />
Alternatively alternatively, if you want to use the latest compilers available, it is now possible to do so. Oolite can be built also with MinGW64-GCC 15.2.0 / MSVCRT or Clang 21.1.7 / UCRT. The development environment with these two compilers can be downloaded from https://drive.google.com/file/d/1YcqMN3N77pxQRs01hC-GfVsbylyToaGD/view?usp=drive_link . <br />
<br />
<br />
Instructions on how to build an Oolite trunk executable from zero:<br />
<br />
<br />
If building with the legacy GCC 4.7.1, download the environment and unzip it to a folder of your choice. IMPORTANT: The zip file you downloaded must be decompressed maintaining the folders' path structure, check your unzip program's documentation if you are not sure how to do this. Also note that in the unlikely case that your system is using drive letter O:, you will need to edit the files msys_x2/1.0/msys.bat and msys_x2/1.0/etc/fstab and change the references to o: to an unused drive letter. MORE IMPORTANT: Do not install this in a path containing spaces. We have had cases where the environment failed to work when installed in locations such as My Documents, Program Files etc.<br />
<br />
<br />
Once unzipped, you must run the msys.bat file, found in <RootOfWhereTheEnvironmentWasInstalled>\msys_x2\1.0. You can create a shortcut to desktop for this file if you want. Once run, the environment will start up.<br />
<br />
<br />
Important note: The latest development environment is by default configured for building the 64-bit version of the game, but it contains all files necessary for building the 32-bit flavor as well. To switch to the 32-bit version of the compiler, you need to navigate to the folder Msys_x2/1.0 and rename the following folders like this:<br />
1) Devlibs -> Devlibs64<br />
2) Mingw -> Mingw64<br />
3) Devlibs32 -> Devlibs<br />
4) Mingw32 -> Mingw.<br />
Reverse-rename to return to the 64-bit configuration. Never, ever mix 32-bit Devlibs with 64-bit Mingw or vice-versa. Expect build failure if you do so.<br />
<br />
If you are building using the GCC 15.2.0 / Clang 21.1.7 environment, unzip the downloaded zip file to a folder of your choice. Then run:<br />
* For MinGW64/MSVCRT configuration ---> <FolderYouExtractedTo>\DevEnvMSVCRT\msys64\mingw64.exe<br />
* For Clang/UCRT configuration ---> <FolderYouExtractedTo>\DevEnvUCRT\msys64\ucrt64.exe<br />
<br />
<br />
The rest of the steps are:<br />
<br />
''1. Create our working directory:''<br />
* <code> mkdir /d/myoolite </code> - to create a folder called myoolite under D:\. This is where we will check out the code, but instead of D: any available drive letter can be used. We will refer to D: here for simplicity.<br />
*<code> cd /d/myoolite </code> - to enter our working directory.<br />
<br />
<br />
''2. Check out the oolite code:''<br />
* <code> git clone https://github.com/OoliteProject/oolite.git </code> - this will start copying the source code from the repository to your working dir. When finished, there will be a folder named oolite under the folder you performed the checkout. Next do a<br />
* <code> cd oolite </code> to enter in the trunk folder, where the actual build will take place. Finally, execute this command to pull in all the binary dependencies needed for the full build (maybe you can take a coffee break here, this takes a while):<br />
* <code> git submodule update --init </code><br />
<br />
<br />
''3. Build the source:''<br />
* <code> make debug=no </code> - That's it! Go get a coffee while it builds, then come back and you will find two new folders under trunk: obj and oolite.app. obj contains the object files produced by the compiler and you don't need to worry too much about it. And of course you all know what oolite.app is.<br />
<br />
<br />
''4. Profit:''<br />
Double click the oolite.exe file that resides in your <code>D:\myoolite\trunk\oolite.app </code> folder. You should see the splash screen followed by the familiar rotating Cobra. Now you can go and improve your Elite rating and give us some feedback from your testing while you're at it.<br />
<br />
If at any later time you would like to update to the code that will be current by then, all you need to do is start up MSYS, then <br />
* <code> cd /d/myoolite/oolite </code><br />
* <code>git pull </code><br />
* <code>git submodule update </code><br />
* <code>make debug=no </code><br />
<br />
<br />
Good luck!<br />
<br />
=== Old Building Oolite from source ===<br />
'''Updated on 09 January 2009 - (left here for reference, please use the instructions above).'''<br />
<br />
'''Acknowledgments and thanks to [[User:Kaks|Kaks]] for providing them:'''<br />
<br />
<br />
'''Important note: It is recommended that all packages for Windows be installed in paths that do not contain spaces. The same recommendation applies for the Windows username of the account the build is performed from. There have been reports of MSYS/make problems in such cases.'''<br />
<br />
# If you have an older version of GNUstep(GNUstep-base-1.11.1-gui-0.10.1-3 - from the wiki howto), uninstall it, then delete its root directory if it's still there(c:\GNUstep). <br />
# Google & download the following 2 packages, and - this is important - install them in this sequence: http://ftpmain.gnustep.org/pub/gnustep/binaries/windows/gnustep-system-0.19.2-setup.exe, http://ftpmain.gnustep.org/pub/gnustep/binaries/windows/gnustep-core-0.19.2-setup.exe<br />
# Google & download tortoiseSVN, install. <br />
# You now need the dependencies files for Windows. Download Local_20090108.zip [ftp://ftp.alioth.net/oolite/Local_20090108.zip].<br />
# Go to the Windows Start menu, navigate to and select ''Start>Programs>GNUstep>Shell''<br />
# At the prompt :<br />
## <code>mkdir /Local </code><br />
## <code>mkdir /Local/oolite </code><br />
## <code>mkdir /Local/oolite/trunk </code>. The first slash & the upper case L are very important! <br />
# From windows, extract the directories inside Local_20090108.zip to <code>C:\GNUstep\Local </code><br />
# Still from windows go to <code>C:\GNUstep\Local\oolite\trunk </code><br />
# It's empty. Right click>SVN checkout. The repository is <code>svn://svn.berlios.de/oolite-linux/trunk </code>. Wait for it to finish. <br />
# From inside the GNUstep shell <br />
## <code>export PATH=$PATH:/Local/bin </code><br />
## <code>cd /Local/oolite/trunk </code><br />
## <code>make debug=no</code><br />
# We're now ready to launch the compiled oolite! From inside the GNUstep shell:<br />
## <code>cd /Local/oolite/trunk </code><br />
## <code>openapp oolite.app </code><br />
<br />
<br />
<br />
''' The instructions below are valid only for versions prior to 1.70, only use them as an alternative if the updated ones fail for whatever reason.'''<br />
<br />
# Download and install the necessary software<br />
## Download and install svn for Windows: [http://subversion.tigris.org/project_packages.html#binary-packages]. Accept all defaults given by the installer.<br />
## Download and install GNUstep for windows: [ftp://ftp.gnustep.org/pub/gnustep/binaries/windows/base-1.11.1-gui-0.10.1/GNUstep-base-1.11.1-gui-0.10.1-3.exe]. Accept all defaults given by the installer.<br />
## Download the SDL files required to build Oolite: [http://prdownload.berlios.de/oolite-pc/Local.zip]<br />
## Unzip this file to <code>c:\GNUstep\Local</code><br />
# Get the source and build it (note, the source comes from the oolite-linux project)<br />
## Start the GNUstep command line (<i>Start -> Programs -> GNUstep Development -> MSYS for GNUstep</i>) and issue the following commands:<br />
## <code>cd $GNUSTEP_LOCAL_ROOT</code><br />
## <code>export PATH=$PATH:$GNUSTEP_LOCAL_ROOT/bin</code><br />
## <code>mkdir oolite</code><br />
## <code>cd oolite</code><br />
## <code>svn checkout svn://svn.berlios.de/oolite-linux/trunk</code><br />
## <code>cd trunk</code><br />
## <code>make</code><br />
# To run the game in the build environment:<br />
## Before running the first time: <code>cp $GNUSTEP_LOCAL_ROOT/bin/*.dll oolite.app</code><br />
## <code>openapp oolite.app</code><br />
<br />
Assuming you have installed one of Nic's releases as detailed above, you can easily keep updating the installation from the latest source. In the <code>$GNUSTEP_LOCAL_ROOT/oolite/trunk</code> directory, issue the commands:<br />
<br />
# <code>export PATH=$PATH:$GNUSTEP_LOCAL_ROOT/bin</code><br />
# <code>svn up</code><br />
# <code>rm -rf oolite.app/Resources; make</code><br />
<br />
You only need to issue the export PATH command when you first start the command line. The rm -rf command before make is required because GNUstep for Windows cannot parse the XML plist file format, and the build fails when it tries to read one of these generated each time the build is performed. This failure is not important, and the process still works, but it is annoying.<br />
<br />
Then use the following script to copy the new files over the existing installation:<br />
<br />
<pre><br />
OA="/c/Program Files/Oolite/oolite.app"<br />
cd $GNUSTEP_LOCAL_ROOT/oolite/trunk<br />
if [ oolite.app/oolite.exe -nt "$OA/oolite.exe" ]; then<br />
echo "Updating oolite.exe"<br />
cp oolite.app/oolite.exe "$OA/oolite.exe"<br />
fi<br />
<br />
for a in AIs Config Images Models Music Sounds Textures; do<br />
for b in Resources/$a/*; do<br />
c=`basename $b`<br />
if [ $b -nt "$OA/Contents/Resources/$a/$c" ]; then<br />
echo "Updating with $b"<br />
cp $b "$OA/Contents/Resources/$a/$c"<br />
fi<br />
done<br />
done<br />
</pre><br />
<br />
If you want to edit the source, Notepad++ has good Objective-C support and is free: [http://notepad-plus.sourceforge.net/]<br />
<br />
Also see the Oolite-PC forum: [https://bb.oolite.space/viewforum.php?f=8]<br />
<br />
== Building Oolite-Linux ==<br />
<br />
=== Dependencies ===<br />
<br />
You will need the following components:<br />
* The GNU Objective-C compiler (gcc-objc). Your distribution should have this available.<br />
* [http://www.gnustep.org GNUstep Startup]. Your distro may provide the appropriate GNUstep development libraries.<br />
* SDL development libraries including SDL_mixer and SDL_image. All Linux distros seem to have the main SDL library, but some do not seem to have SDL_image. This can be downloaded from [http://www.libsdl.org the SDL Library Development website].<br />
* OpenGL development libraries - your distribution will have these.<br />
* To build Autopackages, you will also need the Autopackage development kit, which is available at [http://autopackage.org Autopackage.org]<br />
<br />
The source code for these dependencies is also available at [ftp://ftp.alioth.net]<br />
<br />
You may also want the following optional component:<br />
* espeak, if you want speech (1.73 & later). Your distribution should have this; otherwise, see [http://espeak.sourceforge.net espeak.sourceforge.net].<br />
<br />
=== Building ===<br />
Once you have a source tree, you can build it by just typing 'make'. To run the newly-built code, then type 'openapp oolite'. If you want to build the Autopackage .package file, type 'makeinstaller'. This will leave a .package file in the build directory. You can then run this file to install the game.<br />
<br />
=== Notes about the build process ===<br />
<br />
* The makefile is called GNUmakefile rather than 'Makefile'; this seems to be the convention for GNUstep applications. If you are not using GNUmake, then you will probably need to 'make -f GNUmakefile'. However, it is recommended that you install gmake if you are using a platform (BSD) that doesn't include GNU make (it's a dependency for GNUstep anyway). The build process first builds all the Objective-C source (source code files end in '.m' which is the standard file extension for Objective-C) into the executable oolite.app/oolite and then copies the data into oolite.app/Contents.<br />
<br />
* A new dependency on the SpiderMonkey JavaScript v1.70 library was introduced on SVN revision 1157. This requires some attention regarding the Linux build process. The full instructions on building the game successfully with JavaScript 1.70 on Debian can be found in the following forum post:<br />https://bb.oolite.space/viewtopic.php?p=42188&highlight=#42188<br />
<br />
* As of 1.73, a new 'Makefile' has been added to the project to simplify building Oolite. Assuming your system has all required build dependencies installed (as outlined above), you can build debug and optimised copies of Oolite with the following commands. The included Spidermonkey dependency is automatically built as well. For a full list of targets, use 'make -f Makefile help'.<br />
** make -f Makefile debug<br />
** make -f Makefile release<br />
<br />
=== Notes about GNUstep ===<br />
<br />
Several bugs have been found with gnustep-base1.19.3 which affect Oolite to a greater or lesser extent. As older versions of several popular Linux Distributions ship with this version of GNUstep, it is highly recommended that you compile and install a known good version of GNUstep for development. gnustep-base1.18 is known to be good. The current trunk (gnustep-base1.21.1) appears to also be ok.<br />
<br />
This [https://bb.oolite.space/viewtopic.php?t=8008&highlight= forum post] details how to build and install gnustep for developing Oolite.<br />
<div style="clear:both"></div><br />
<br />
== Objective-C ==<br />
If you’re familiar with OO design concepts, learning Objective-C is about half a day’s work. If not, maybe a few days. Objective-C is a much, much smaller extension to C than C++ is. Take your choice of introductory documents:<br />
*[http://developer.apple.com/documentation/Cocoa/Conceptual/ObjectiveC/index.html The Objective-C Programming Language] – covers OO basics, just about the entire language (including bits not used in Oolite – the Exception Handling and Thread Synchronization chapter in particular) and the runtime library used in Apple’s implementation.<br />
*[http://www.gnustep.org/resources/ObjCFun.html Objective-C is Fun] – covers most of the language in about three pages. (Assumes a knowledge of C.)<br />
*[http://www.otierney.net/objective-c.html Objective-C Beginner’s Guide] – a more hands-on tutorial.<br />
<br />
The biggest roadblock to most people seems to be [http://developer.apple.com/documentation/Cocoa/Conceptual/MemoryMgmt/index.html the memory management model]. (The chapter “Implementing Object Copy” can be considered an advanced topic in the context of Oolite, and the Core Foundation and Zones bit are of no interest.) The section [http://developer.apple.com/documentation/Cocoa/Conceptual/MemoryMgmt/Tasks/MemoryManagementRules.html Memory Management Rules] is the really important bit.<br />
<br />
That said, Oolite is not necessarily the best project to start with; taking a look at [http://developer.apple.com/documentation/Cocoa/Conceptual/ObjCTutorial/index.html Apple’s] or [http://www.gnustep.it/pierre-yves/index.html GNUstep’s] tutorials. (The latter appears to be a rip-off– er, adaptation of the former.) These are geared towards GUI apps, though.<br />
<br />
[[User:Ahruman|Ahruman]], 2007 from [https://bb.oolite.space/viewtopic.php?p=32138#p32138 Learning Objective-C]<br />
<br />
== Links ==<br />
* [https://bb.oolite.space/viewtopic.php?p=270121#p270121 Building Spidermonkey (2020)]<br />
<br />
* [https://bb.oolite.space/viewtopic.php?t=21215 Steam-ready (almost)] (2022-24)<br />
<br />
*[https://bb.oolite.space/viewtopic.php?t=21539 How to access Oolite build artifacts on Github] (2023)<br />
<br />
[[Category:Oolite]] [[Category:Oolite Development| ]]</div>Another commanderhttps://wiki.alioth.net/index.php?title=File:ReorteIsHotGiant.oxz&diff=86469File:ReorteIsHotGiant.oxz2025-07-22T11:28:50Z<p>Another commander: Turns Reorte into a hot giant. Uses alpha channel of diffuse map to set the illuminated areas.</p>
<hr />
<div>== Summary ==<br />
Turns Reorte into a hot giant. Uses alpha channel of diffuse map to set the illuminated areas.</div>Another commanderhttps://wiki.alioth.net/index.php?title=AppleMac&diff=85414AppleMac2025-04-29T16:42:54Z<p>Another commander: /* For Linux */</p>
<hr />
<div>[[File:Late 2016 MacBook Pro.jpg|right|400px]]<br />
Oolite was originally written for the AppleMac.<br />
<br />
== Overview ==<br />
Whilst this meant that those playing Oolite on AppleMacs in the early days had an advantage, the haemorrhaging of AppleMac-friendly developers has led to the inability to fix recent issues (such as the loss of sound) and worries over eventual play on BigSur once backwards compatibility is abandoned by Apple. <br />
<br />
[[File:AppleMac Help.png|thumb|right|200px|AppleMac "help" (" ⌘ ? ") creates this drop-down in a full-screen game]]<br />
=== Advantages ===<br />
Some of the Oolite functionality is "built-in" to the AppleMac. This is most obvious when running the [http://www.oolite.org/download/ OXP developer releases] of Oolite, where the Debug console is built-in to the AppleMac.<br />
<br />
The OpenStep Legacy script is from the AppleMac OS <br />
<br />
=== Disadvantages ===<br />
*As Apple try more and more to suck money out of anything designed to work on an AppleMac, they have made opening an Oolite download on an AppleMac more difficult.<br />
*The ''Load Commander'' option on game start-up is also built in to the AppleMac, so one gets the standard AppleMac "open file" dialogue box, which gives no information about the save files other than their size and date (in Windows, for example, you get details of Elite rank, location and wealth).<br />
*The AppleMac parsing of Javascript is rather more tendentious than that of Windows, so, for example, oxp's will be rejected because of a wonky "quotations mark" which windows would just accept and interpret. On the other hand, if you write an oxp on your AppleMac, it should work happily on any other contraption (if you can ever get it to work on yours!!).<br />
*The newer AppleOS's use the control key for windows management, and this requires disabling if you want to use the control key in-game.<br />
*Many of the HOTAS setups are incompatible with the AppleMac, and thus only partially usable for Oolite.<br />
*The AppleMac OS hides files away from view, so finding your AddOns and Managed AddOns folders can be pains in the unmentionables. As can looking at the vanilla game code.<br />
*There are issues with the game sounds disappearing when playing for any length of time.<br />
<br />
----<br />
== Running your new download of Oolite ==<br />
Newly-downloaded copies of Oolite are not allowed to run under AppleOS, because it’s “from an unidentified developer” (''ie'' none of us paid $300 to get a signature from Apple Inc.).<br />
<br />
=== Solution ===<br />
You can bypass this behaviour as follows:<br />
:Select Oolite in the Finder.<br />
:Hold down the <font color="Red">'''control'''</font> key and click the Oolite icon.<br />
:Select '''Open''' from the pop-up menu.<br />
:You will get the traditional ''This is an application downloaded from the Internet'' warning, and can now choose to open Oolite and start playing!<br />
<br />
----<br />
== Installing expansions on Oolite 1.90 (and previous)==<br />
Oolite can be customized easily by installing expansion packs (OXP directories or OXZ files). There is a builtin expansion manager that downloads and installs expansions you select.<br />
They are accessed from the website oolite.org. Unfortunately the Oolite project has moved to a different domain oolite.space, and the all builds before v1.91 are not aware of this. <br />
<br />
There are several options to overcome this limitation:<br />
<br />
=== Solution 1: Manage expansions manually. It is an effort but is quite possible ===<br />
You need to know where to get downloads from, and you need to know where to drop them on your harddrive.<br />
<br />
To find out the available expansions, go to https://www.oolite.space/#oxp.<br />
You can sort the list by clicking the column header and download it using the icon on the right.<br />
<br />
After downloading, move the file to <br />
~/Library/Application Support/Oolite/Managed Addons<br />
<br />
The tilde character will be replaced by your user home directory. If you prefer, you can as well write<br />
$HOME/Library/Application Support/Oolite/Managed Addons<br />
<br />
{| border="2" style="margin: 1em auto 1em auto;"<br />
|style="background-color: #00aaaa;padding: .6em 3em 1em;"|<br />
<center>'''Note'''</center><br />
The "Managed Addons" folder might not exist immediately after your installation of Oolite. It is created via the expansions manager.<br />
|}<br />
<br />
<br />
In any case, mind the space characters in the directory names. And while we are at it, uninstall expansions by simply removing them from the directory.<br />
<br />
<br />
=== Solution 2: Configure Oolite to access the expansion catalog from the new URL ===<br />
<br />
==== For MacOS ====<br />
Oolite reads preferences from a file called<br />
~/Library/Preferences/org.aegidian.oolite.plist<br />
(see also [[Location of Oolite saved settings]]). The file is in [[Property list]] format, which used to be human-readable but today is binary. <br />
<br />
While Oolite is not running, open a [[Terminal_Utility|terminal window]] (command prompt) and run this command:<br />
defaults write org.aegidian.oolite oxz-index-url http://addons.oolite.space/api/1.0/overview<br />
<br />
On future startups the Oolite builtin expansion manager should find the correct index of expansions.<br />
<br />
Further guidance with screenshots available at [https://app.box.com/s/8t5x1sxqlm2zlrtqcws3zwwcv2ow2z17 MacOS Process to update gnustepdefaults file].<br />
<br />
==== For Windows ====<br />
Oolite reads preferences from a file called<br />
<OoliteInstallFolder>\oolite.app\GNUstep\Defaults\.GNUstepDefaults<br />
Make sure you have run the game at least once in order to have this file auto-generated. Then open the file in a text editor and add the following line anywhere inside the "oolite" section:<br />
"oxz-index-url" = "http://addons.oolite.space/api/1.0/overview";<br />
Save and exit and you should now be able to use the in-game Expansion Manager normally.<br />
<br />
==== For Linux ====<br />
Oolite reads preferences from a file called<br />
~\GNUstep\Defaults\.GNUstepDefaults<br />
Make sure you have run the game at least once in order to have this file auto-generated. Then open the file in a text editor and add the following line anywhere inside the "oolite" section:<br />
<key>oxz-index-url</key><br />
<string>http://addons.oolite.space/api/1.0/overview</string><br />
Save and exit and you should now be able to use the in-game Expansion Manager normally.<br />
<br />
<br />
=== Solution 3: Make use of Oolite Starter ===<br />
[[Oolite Starter]] is a wrapper for Oolite that allows managing expansions and more.<br />
<br />
----<br />
<br />
== Precision Flying and the Control Key ==<br />
The precision flying ‘control’ key does not work well on the modern macs -<br />
<br />
Your Oolite window whizzes off to the side, is replaced by another window and you suddenly find that you are looking at something quite different (your cobra may indeed be flying much more precisely - but it's a tad difficult to ascertain this when the appropriate window has jumped into witchspace without you!)<br />
<br />
This is because the more recent MacOS's combine the control key with the arrow keys to activate ‘Mission Control’ (which manages the opened windows on the computer screen).<br />
<br />
=== Solution ===<br />
:1) You need to find the ‘Keyboard’ panel in System Preferences (3rd row down on my machine)<br />
:2) Then select the ‘shortcuts’ button on the top line of the window.<br />
:3) Choose ‘Mission Control’ in the left hand box.<br />
:4) Finally, ‘uncheck’ the relevant shortcuts (Mission Control, Application windows, move left a space, move right a space).<br />
<br />
Things should now work as they should!<br />
<br />
----<br />
== Music/Sound ==<br />
As adumbrated above, the sound now eventually cuts out on an AppleMac.<br />
<br />
What is less known is the iTunes integration. This may no longer work with the newer Macs which have "Music" instead.<br />
See [https://bb.oolite.space/viewtopic.php?f=10&t=19896 iTunes and Oolite v.1.87] for more on this (2018)<br />
<br />
----<br />
== HOTAS and AppleMac ==<br />
Some people find that using a HOTAS is invaluable for dog-fighting (It does not have to be - see [[User:Another_commander|Another_commander]]'s virtuoso display [https://www.youtube.com/watch?v=IHnjUjZVtgk here]). In ''theory'', every HOTAS should work on an AppleMac as AppleMac accepts the recognized standard USB HID devices as Windows and Linux do.<br />
<br />
The problem is with the HOTAS manufacturers adding on bells and whistles which then require software to interpret. They can't be bothered to write the software for Apple (or for the 613 different flavours of Linux), and so things start to fall apart. And Apple has a history of not bothering to document this sort of thing properly for developers:<br />
As for sample code not being updated, documentation being incomplete/outdated/missing, and provided code requiring a lot of effort to build: welcome to Mac systems & driver development. That's unfortunately how it is. I've been doing OS X kernel/driver work for 7 years, and while some things get easier with experience, downloading code from Apple and building it still feels like playing the lottery. (https://stackoverflow.com/questions/41715074/simple-hid-osx-application 2017)<br />
<br />
=== Solutions ===<br />
==== Thrustmaster (TFlight HOTAS 4/TM4) ====<br />
It seems that this is not compatible with the AppleMac, with the twist, throttle and axis on the back of the throttle not seeming functional.<br />
What neither Thrustmaster nor Apple can be bothered to tell you is that you need to keep the '''PS''', '''SHARE''' & '''OPTIONS''' buttons held down while you plug it into your AppleMac. The green light should then come on on your PS button, and you should find it fully functional. <br><br />
This worked for Cholmondely but not for Murgh.<br />
==== VKB (Gladiator Mk II with T-Rudder) ====<br />
These allegedly work with the AppleMac (but the combination needs tweaking). See [http://forum.vkb-sim.pro/viewtopic.php?f=27&t=4456 Gladiator MK 11 connection to T-Rudder] (2020)<br />
----<br />
<br />
== Accessing the Vanilla Game Code ==<br />
=== Solution ===<br />
Download the current '''oolite-1.9?.zip''' from [https://github.com/OoliteProject/oolite/releases GitHub]. This will just expand, rather than install, and you will be able to look at the entire code.<br />
<br />
=== AppleMac peculiarities ===<br />
The so-called Oolite programme is really just an unopenable folder with the programme hidden inside, which starts when you click on the folder wrapping.<br />
<br />
----<br />
== History ==<br />
Oolite was originally written by [[User:Aegidian|Aegidian]] for the AppleMac back in 2003 and then ported by [[User:Winston|Winston]] & [[David Taylor]] to Linux & Windows three years later. Our Second lead developer, [[User:Ahruman|Ahruman]] (2007-13) was also an AppleMac buff. It's been downhill ever since, sadly. So much so, that the introduction of Big Sur (MacOS 11) threatens to make Oolite unplayable once Apple phase out backwards compatibility, due to our lack of developers who know how to make Oolite compatible with Big Sur.<br />
<br />
----<br />
== Links ==<br />
*[[Running Oolite-Mac]] contains notes about Building Oolite from source<br />
*MacOS Version 11+ problem: [https://github.com/OoliteProject/oolite/issues/360 GitHub discussion] & [https://bb.oolite.space/viewtopic.php?f=10&t=20939 BB discussion]<br />
*AppleMac problems (Compilation, Game Sounds ''etc''.): [https://bb.oolite.space/viewtopic.php?f=10&t=20789 BB Index of AppleMac Issues] (2023)<br />
<br />
=== Techniques ===<br />
*[[Terminal Utility]] - an AppleMac utility useful for [[The Dark Side|dark-sided]] deeds of derring-do!<br />
<br />
=== Humour ===<br />
*[https://bb.oolite.space/viewtopic.php?p=235670#p235670 Comparing AppleMac, Windows & Linux] (Cartoon & discussion, 2015)<br />
<br />
[[Category:Oolite]] [[Category:Help pages]]<br />
[[Category:Factual]]</div>Another commanderhttps://wiki.alioth.net/index.php?title=AppleMac&diff=85413AppleMac2025-04-29T16:42:41Z<p>Another commander: /* For Windows */</p>
<hr />
<div>[[File:Late 2016 MacBook Pro.jpg|right|400px]]<br />
Oolite was originally written for the AppleMac.<br />
<br />
== Overview ==<br />
Whilst this meant that those playing Oolite on AppleMacs in the early days had an advantage, the haemorrhaging of AppleMac-friendly developers has led to the inability to fix recent issues (such as the loss of sound) and worries over eventual play on BigSur once backwards compatibility is abandoned by Apple. <br />
<br />
[[File:AppleMac Help.png|thumb|right|200px|AppleMac "help" (" ⌘ ? ") creates this drop-down in a full-screen game]]<br />
=== Advantages ===<br />
Some of the Oolite functionality is "built-in" to the AppleMac. This is most obvious when running the [http://www.oolite.org/download/ OXP developer releases] of Oolite, where the Debug console is built-in to the AppleMac.<br />
<br />
The OpenStep Legacy script is from the AppleMac OS <br />
<br />
=== Disadvantages ===<br />
*As Apple try more and more to suck money out of anything designed to work on an AppleMac, they have made opening an Oolite download on an AppleMac more difficult.<br />
*The ''Load Commander'' option on game start-up is also built in to the AppleMac, so one gets the standard AppleMac "open file" dialogue box, which gives no information about the save files other than their size and date (in Windows, for example, you get details of Elite rank, location and wealth).<br />
*The AppleMac parsing of Javascript is rather more tendentious than that of Windows, so, for example, oxp's will be rejected because of a wonky "quotations mark" which windows would just accept and interpret. On the other hand, if you write an oxp on your AppleMac, it should work happily on any other contraption (if you can ever get it to work on yours!!).<br />
*The newer AppleOS's use the control key for windows management, and this requires disabling if you want to use the control key in-game.<br />
*Many of the HOTAS setups are incompatible with the AppleMac, and thus only partially usable for Oolite.<br />
*The AppleMac OS hides files away from view, so finding your AddOns and Managed AddOns folders can be pains in the unmentionables. As can looking at the vanilla game code.<br />
*There are issues with the game sounds disappearing when playing for any length of time.<br />
<br />
----<br />
== Running your new download of Oolite ==<br />
Newly-downloaded copies of Oolite are not allowed to run under AppleOS, because it’s “from an unidentified developer” (''ie'' none of us paid $300 to get a signature from Apple Inc.).<br />
<br />
=== Solution ===<br />
You can bypass this behaviour as follows:<br />
:Select Oolite in the Finder.<br />
:Hold down the <font color="Red">'''control'''</font> key and click the Oolite icon.<br />
:Select '''Open''' from the pop-up menu.<br />
:You will get the traditional ''This is an application downloaded from the Internet'' warning, and can now choose to open Oolite and start playing!<br />
<br />
----<br />
== Installing expansions on Oolite 1.90 (and previous)==<br />
Oolite can be customized easily by installing expansion packs (OXP directories or OXZ files). There is a builtin expansion manager that downloads and installs expansions you select.<br />
They are accessed from the website oolite.org. Unfortunately the Oolite project has moved to a different domain oolite.space, and the all builds before v1.91 are not aware of this. <br />
<br />
There are several options to overcome this limitation:<br />
<br />
=== Solution 1: Manage expansions manually. It is an effort but is quite possible ===<br />
You need to know where to get downloads from, and you need to know where to drop them on your harddrive.<br />
<br />
To find out the available expansions, go to https://www.oolite.space/#oxp.<br />
You can sort the list by clicking the column header and download it using the icon on the right.<br />
<br />
After downloading, move the file to <br />
~/Library/Application Support/Oolite/Managed Addons<br />
<br />
The tilde character will be replaced by your user home directory. If you prefer, you can as well write<br />
$HOME/Library/Application Support/Oolite/Managed Addons<br />
<br />
{| border="2" style="margin: 1em auto 1em auto;"<br />
|style="background-color: #00aaaa;padding: .6em 3em 1em;"|<br />
<center>'''Note'''</center><br />
The "Managed Addons" folder might not exist immediately after your installation of Oolite. It is created via the expansions manager.<br />
|}<br />
<br />
<br />
In any case, mind the space characters in the directory names. And while we are at it, uninstall expansions by simply removing them from the directory.<br />
<br />
<br />
=== Solution 2: Configure Oolite to access the expansion catalog from the new URL ===<br />
<br />
==== For MacOS ====<br />
Oolite reads preferences from a file called<br />
~/Library/Preferences/org.aegidian.oolite.plist<br />
(see also [[Location of Oolite saved settings]]). The file is in [[Property list]] format, which used to be human-readable but today is binary. <br />
<br />
While Oolite is not running, open a [[Terminal_Utility|terminal window]] (command prompt) and run this command:<br />
defaults write org.aegidian.oolite oxz-index-url http://addons.oolite.space/api/1.0/overview<br />
<br />
On future startups the Oolite builtin expansion manager should find the correct index of expansions.<br />
<br />
Further guidance with screenshots available at [https://app.box.com/s/8t5x1sxqlm2zlrtqcws3zwwcv2ow2z17 MacOS Process to update gnustepdefaults file].<br />
<br />
==== For Windows ====<br />
Oolite reads preferences from a file called<br />
<OoliteInstallFolder>\oolite.app\GNUstep\Defaults\.GNUstepDefaults<br />
Make sure you have run the game at least once in order to have this file auto-generated. Then open the file in a text editor and add the following line anywhere inside the "oolite" section:<br />
"oxz-index-url" = "http://addons.oolite.space/api/1.0/overview";<br />
Save and exit and you should now be able to use the in-game Expansion Manager normally.<br />
<br />
== For Linux ==<br />
Oolite reads preferences from a file called<br />
~\GNUstep\Defaults\.GNUstepDefaults<br />
Make sure you have run the game at least once in order to have this file auto-generated. Then open the file in a text editor and add the following line anywhere inside the "oolite" section:<br />
<key>oxz-index-url</key><br />
<string>http://addons.oolite.space/api/1.0/overview</string><br />
Save and exit and you should now be able to use the in-game Expansion Manager normally.<br />
<br />
<br />
=== Solution 3: Make use of Oolite Starter ===<br />
[[Oolite Starter]] is a wrapper for Oolite that allows managing expansions and more.<br />
<br />
----<br />
<br />
== Precision Flying and the Control Key ==<br />
The precision flying ‘control’ key does not work well on the modern macs -<br />
<br />
Your Oolite window whizzes off to the side, is replaced by another window and you suddenly find that you are looking at something quite different (your cobra may indeed be flying much more precisely - but it's a tad difficult to ascertain this when the appropriate window has jumped into witchspace without you!)<br />
<br />
This is because the more recent MacOS's combine the control key with the arrow keys to activate ‘Mission Control’ (which manages the opened windows on the computer screen).<br />
<br />
=== Solution ===<br />
:1) You need to find the ‘Keyboard’ panel in System Preferences (3rd row down on my machine)<br />
:2) Then select the ‘shortcuts’ button on the top line of the window.<br />
:3) Choose ‘Mission Control’ in the left hand box.<br />
:4) Finally, ‘uncheck’ the relevant shortcuts (Mission Control, Application windows, move left a space, move right a space).<br />
<br />
Things should now work as they should!<br />
<br />
----<br />
== Music/Sound ==<br />
As adumbrated above, the sound now eventually cuts out on an AppleMac.<br />
<br />
What is less known is the iTunes integration. This may no longer work with the newer Macs which have "Music" instead.<br />
See [https://bb.oolite.space/viewtopic.php?f=10&t=19896 iTunes and Oolite v.1.87] for more on this (2018)<br />
<br />
----<br />
== HOTAS and AppleMac ==<br />
Some people find that using a HOTAS is invaluable for dog-fighting (It does not have to be - see [[User:Another_commander|Another_commander]]'s virtuoso display [https://www.youtube.com/watch?v=IHnjUjZVtgk here]). In ''theory'', every HOTAS should work on an AppleMac as AppleMac accepts the recognized standard USB HID devices as Windows and Linux do.<br />
<br />
The problem is with the HOTAS manufacturers adding on bells and whistles which then require software to interpret. They can't be bothered to write the software for Apple (or for the 613 different flavours of Linux), and so things start to fall apart. And Apple has a history of not bothering to document this sort of thing properly for developers:<br />
As for sample code not being updated, documentation being incomplete/outdated/missing, and provided code requiring a lot of effort to build: welcome to Mac systems & driver development. That's unfortunately how it is. I've been doing OS X kernel/driver work for 7 years, and while some things get easier with experience, downloading code from Apple and building it still feels like playing the lottery. (https://stackoverflow.com/questions/41715074/simple-hid-osx-application 2017)<br />
<br />
=== Solutions ===<br />
==== Thrustmaster (TFlight HOTAS 4/TM4) ====<br />
It seems that this is not compatible with the AppleMac, with the twist, throttle and axis on the back of the throttle not seeming functional.<br />
What neither Thrustmaster nor Apple can be bothered to tell you is that you need to keep the '''PS''', '''SHARE''' & '''OPTIONS''' buttons held down while you plug it into your AppleMac. The green light should then come on on your PS button, and you should find it fully functional. <br><br />
This worked for Cholmondely but not for Murgh.<br />
==== VKB (Gladiator Mk II with T-Rudder) ====<br />
These allegedly work with the AppleMac (but the combination needs tweaking). See [http://forum.vkb-sim.pro/viewtopic.php?f=27&t=4456 Gladiator MK 11 connection to T-Rudder] (2020)<br />
----<br />
<br />
== Accessing the Vanilla Game Code ==<br />
=== Solution ===<br />
Download the current '''oolite-1.9?.zip''' from [https://github.com/OoliteProject/oolite/releases GitHub]. This will just expand, rather than install, and you will be able to look at the entire code.<br />
<br />
=== AppleMac peculiarities ===<br />
The so-called Oolite programme is really just an unopenable folder with the programme hidden inside, which starts when you click on the folder wrapping.<br />
<br />
----<br />
== History ==<br />
Oolite was originally written by [[User:Aegidian|Aegidian]] for the AppleMac back in 2003 and then ported by [[User:Winston|Winston]] & [[David Taylor]] to Linux & Windows three years later. Our Second lead developer, [[User:Ahruman|Ahruman]] (2007-13) was also an AppleMac buff. It's been downhill ever since, sadly. So much so, that the introduction of Big Sur (MacOS 11) threatens to make Oolite unplayable once Apple phase out backwards compatibility, due to our lack of developers who know how to make Oolite compatible with Big Sur.<br />
<br />
----<br />
== Links ==<br />
*[[Running Oolite-Mac]] contains notes about Building Oolite from source<br />
*MacOS Version 11+ problem: [https://github.com/OoliteProject/oolite/issues/360 GitHub discussion] & [https://bb.oolite.space/viewtopic.php?f=10&t=20939 BB discussion]<br />
*AppleMac problems (Compilation, Game Sounds ''etc''.): [https://bb.oolite.space/viewtopic.php?f=10&t=20789 BB Index of AppleMac Issues] (2023)<br />
<br />
=== Techniques ===<br />
*[[Terminal Utility]] - an AppleMac utility useful for [[The Dark Side|dark-sided]] deeds of derring-do!<br />
<br />
=== Humour ===<br />
*[https://bb.oolite.space/viewtopic.php?p=235670#p235670 Comparing AppleMac, Windows & Linux] (Cartoon & discussion, 2015)<br />
<br />
[[Category:Oolite]] [[Category:Help pages]]<br />
[[Category:Factual]]</div>Another commanderhttps://wiki.alioth.net/index.php?title=AppleMac&diff=85412AppleMac2025-04-29T16:42:24Z<p>Another commander: /* For MacOS */</p>
<hr />
<div>[[File:Late 2016 MacBook Pro.jpg|right|400px]]<br />
Oolite was originally written for the AppleMac.<br />
<br />
== Overview ==<br />
Whilst this meant that those playing Oolite on AppleMacs in the early days had an advantage, the haemorrhaging of AppleMac-friendly developers has led to the inability to fix recent issues (such as the loss of sound) and worries over eventual play on BigSur once backwards compatibility is abandoned by Apple. <br />
<br />
[[File:AppleMac Help.png|thumb|right|200px|AppleMac "help" (" ⌘ ? ") creates this drop-down in a full-screen game]]<br />
=== Advantages ===<br />
Some of the Oolite functionality is "built-in" to the AppleMac. This is most obvious when running the [http://www.oolite.org/download/ OXP developer releases] of Oolite, where the Debug console is built-in to the AppleMac.<br />
<br />
The OpenStep Legacy script is from the AppleMac OS <br />
<br />
=== Disadvantages ===<br />
*As Apple try more and more to suck money out of anything designed to work on an AppleMac, they have made opening an Oolite download on an AppleMac more difficult.<br />
*The ''Load Commander'' option on game start-up is also built in to the AppleMac, so one gets the standard AppleMac "open file" dialogue box, which gives no information about the save files other than their size and date (in Windows, for example, you get details of Elite rank, location and wealth).<br />
*The AppleMac parsing of Javascript is rather more tendentious than that of Windows, so, for example, oxp's will be rejected because of a wonky "quotations mark" which windows would just accept and interpret. On the other hand, if you write an oxp on your AppleMac, it should work happily on any other contraption (if you can ever get it to work on yours!!).<br />
*The newer AppleOS's use the control key for windows management, and this requires disabling if you want to use the control key in-game.<br />
*Many of the HOTAS setups are incompatible with the AppleMac, and thus only partially usable for Oolite.<br />
*The AppleMac OS hides files away from view, so finding your AddOns and Managed AddOns folders can be pains in the unmentionables. As can looking at the vanilla game code.<br />
*There are issues with the game sounds disappearing when playing for any length of time.<br />
<br />
----<br />
== Running your new download of Oolite ==<br />
Newly-downloaded copies of Oolite are not allowed to run under AppleOS, because it’s “from an unidentified developer” (''ie'' none of us paid $300 to get a signature from Apple Inc.).<br />
<br />
=== Solution ===<br />
You can bypass this behaviour as follows:<br />
:Select Oolite in the Finder.<br />
:Hold down the <font color="Red">'''control'''</font> key and click the Oolite icon.<br />
:Select '''Open''' from the pop-up menu.<br />
:You will get the traditional ''This is an application downloaded from the Internet'' warning, and can now choose to open Oolite and start playing!<br />
<br />
----<br />
== Installing expansions on Oolite 1.90 (and previous)==<br />
Oolite can be customized easily by installing expansion packs (OXP directories or OXZ files). There is a builtin expansion manager that downloads and installs expansions you select.<br />
They are accessed from the website oolite.org. Unfortunately the Oolite project has moved to a different domain oolite.space, and the all builds before v1.91 are not aware of this. <br />
<br />
There are several options to overcome this limitation:<br />
<br />
=== Solution 1: Manage expansions manually. It is an effort but is quite possible ===<br />
You need to know where to get downloads from, and you need to know where to drop them on your harddrive.<br />
<br />
To find out the available expansions, go to https://www.oolite.space/#oxp.<br />
You can sort the list by clicking the column header and download it using the icon on the right.<br />
<br />
After downloading, move the file to <br />
~/Library/Application Support/Oolite/Managed Addons<br />
<br />
The tilde character will be replaced by your user home directory. If you prefer, you can as well write<br />
$HOME/Library/Application Support/Oolite/Managed Addons<br />
<br />
{| border="2" style="margin: 1em auto 1em auto;"<br />
|style="background-color: #00aaaa;padding: .6em 3em 1em;"|<br />
<center>'''Note'''</center><br />
The "Managed Addons" folder might not exist immediately after your installation of Oolite. It is created via the expansions manager.<br />
|}<br />
<br />
<br />
In any case, mind the space characters in the directory names. And while we are at it, uninstall expansions by simply removing them from the directory.<br />
<br />
<br />
=== Solution 2: Configure Oolite to access the expansion catalog from the new URL ===<br />
<br />
==== For MacOS ====<br />
Oolite reads preferences from a file called<br />
~/Library/Preferences/org.aegidian.oolite.plist<br />
(see also [[Location of Oolite saved settings]]). The file is in [[Property list]] format, which used to be human-readable but today is binary. <br />
<br />
While Oolite is not running, open a [[Terminal_Utility|terminal window]] (command prompt) and run this command:<br />
defaults write org.aegidian.oolite oxz-index-url http://addons.oolite.space/api/1.0/overview<br />
<br />
On future startups the Oolite builtin expansion manager should find the correct index of expansions.<br />
<br />
Further guidance with screenshots available at [https://app.box.com/s/8t5x1sxqlm2zlrtqcws3zwwcv2ow2z17 MacOS Process to update gnustepdefaults file].<br />
<br />
== For Windows ==<br />
Oolite reads preferences from a file called<br />
<OoliteInstallFolder>\oolite.app\GNUstep\Defaults\.GNUstepDefaults<br />
Make sure you have run the game at least once in order to have this file auto-generated. Then open the file in a text editor and add the following line anywhere inside the "oolite" section:<br />
"oxz-index-url" = "http://addons.oolite.space/api/1.0/overview";<br />
Save and exit and you should now be able to use the in-game Expansion Manager normally.<br />
<br />
== For Linux ==<br />
Oolite reads preferences from a file called<br />
~\GNUstep\Defaults\.GNUstepDefaults<br />
Make sure you have run the game at least once in order to have this file auto-generated. Then open the file in a text editor and add the following line anywhere inside the "oolite" section:<br />
<key>oxz-index-url</key><br />
<string>http://addons.oolite.space/api/1.0/overview</string><br />
Save and exit and you should now be able to use the in-game Expansion Manager normally.<br />
<br />
<br />
=== Solution 3: Make use of Oolite Starter ===<br />
[[Oolite Starter]] is a wrapper for Oolite that allows managing expansions and more.<br />
<br />
----<br />
<br />
== Precision Flying and the Control Key ==<br />
The precision flying ‘control’ key does not work well on the modern macs -<br />
<br />
Your Oolite window whizzes off to the side, is replaced by another window and you suddenly find that you are looking at something quite different (your cobra may indeed be flying much more precisely - but it's a tad difficult to ascertain this when the appropriate window has jumped into witchspace without you!)<br />
<br />
This is because the more recent MacOS's combine the control key with the arrow keys to activate ‘Mission Control’ (which manages the opened windows on the computer screen).<br />
<br />
=== Solution ===<br />
:1) You need to find the ‘Keyboard’ panel in System Preferences (3rd row down on my machine)<br />
:2) Then select the ‘shortcuts’ button on the top line of the window.<br />
:3) Choose ‘Mission Control’ in the left hand box.<br />
:4) Finally, ‘uncheck’ the relevant shortcuts (Mission Control, Application windows, move left a space, move right a space).<br />
<br />
Things should now work as they should!<br />
<br />
----<br />
== Music/Sound ==<br />
As adumbrated above, the sound now eventually cuts out on an AppleMac.<br />
<br />
What is less known is the iTunes integration. This may no longer work with the newer Macs which have "Music" instead.<br />
See [https://bb.oolite.space/viewtopic.php?f=10&t=19896 iTunes and Oolite v.1.87] for more on this (2018)<br />
<br />
----<br />
== HOTAS and AppleMac ==<br />
Some people find that using a HOTAS is invaluable for dog-fighting (It does not have to be - see [[User:Another_commander|Another_commander]]'s virtuoso display [https://www.youtube.com/watch?v=IHnjUjZVtgk here]). In ''theory'', every HOTAS should work on an AppleMac as AppleMac accepts the recognized standard USB HID devices as Windows and Linux do.<br />
<br />
The problem is with the HOTAS manufacturers adding on bells and whistles which then require software to interpret. They can't be bothered to write the software for Apple (or for the 613 different flavours of Linux), and so things start to fall apart. And Apple has a history of not bothering to document this sort of thing properly for developers:<br />
As for sample code not being updated, documentation being incomplete/outdated/missing, and provided code requiring a lot of effort to build: welcome to Mac systems & driver development. That's unfortunately how it is. I've been doing OS X kernel/driver work for 7 years, and while some things get easier with experience, downloading code from Apple and building it still feels like playing the lottery. (https://stackoverflow.com/questions/41715074/simple-hid-osx-application 2017)<br />
<br />
=== Solutions ===<br />
==== Thrustmaster (TFlight HOTAS 4/TM4) ====<br />
It seems that this is not compatible with the AppleMac, with the twist, throttle and axis on the back of the throttle not seeming functional.<br />
What neither Thrustmaster nor Apple can be bothered to tell you is that you need to keep the '''PS''', '''SHARE''' & '''OPTIONS''' buttons held down while you plug it into your AppleMac. The green light should then come on on your PS button, and you should find it fully functional. <br><br />
This worked for Cholmondely but not for Murgh.<br />
==== VKB (Gladiator Mk II with T-Rudder) ====<br />
These allegedly work with the AppleMac (but the combination needs tweaking). See [http://forum.vkb-sim.pro/viewtopic.php?f=27&t=4456 Gladiator MK 11 connection to T-Rudder] (2020)<br />
----<br />
<br />
== Accessing the Vanilla Game Code ==<br />
=== Solution ===<br />
Download the current '''oolite-1.9?.zip''' from [https://github.com/OoliteProject/oolite/releases GitHub]. This will just expand, rather than install, and you will be able to look at the entire code.<br />
<br />
=== AppleMac peculiarities ===<br />
The so-called Oolite programme is really just an unopenable folder with the programme hidden inside, which starts when you click on the folder wrapping.<br />
<br />
----<br />
== History ==<br />
Oolite was originally written by [[User:Aegidian|Aegidian]] for the AppleMac back in 2003 and then ported by [[User:Winston|Winston]] & [[David Taylor]] to Linux & Windows three years later. Our Second lead developer, [[User:Ahruman|Ahruman]] (2007-13) was also an AppleMac buff. It's been downhill ever since, sadly. So much so, that the introduction of Big Sur (MacOS 11) threatens to make Oolite unplayable once Apple phase out backwards compatibility, due to our lack of developers who know how to make Oolite compatible with Big Sur.<br />
<br />
----<br />
== Links ==<br />
*[[Running Oolite-Mac]] contains notes about Building Oolite from source<br />
*MacOS Version 11+ problem: [https://github.com/OoliteProject/oolite/issues/360 GitHub discussion] & [https://bb.oolite.space/viewtopic.php?f=10&t=20939 BB discussion]<br />
*AppleMac problems (Compilation, Game Sounds ''etc''.): [https://bb.oolite.space/viewtopic.php?f=10&t=20789 BB Index of AppleMac Issues] (2023)<br />
<br />
=== Techniques ===<br />
*[[Terminal Utility]] - an AppleMac utility useful for [[The Dark Side|dark-sided]] deeds of derring-do!<br />
<br />
=== Humour ===<br />
*[https://bb.oolite.space/viewtopic.php?p=235670#p235670 Comparing AppleMac, Windows & Linux] (Cartoon & discussion, 2015)<br />
<br />
[[Category:Oolite]] [[Category:Help pages]]<br />
[[Category:Factual]]</div>Another commanderhttps://wiki.alioth.net/index.php?title=AppleMac&diff=85411AppleMac2025-04-29T16:41:04Z<p>Another commander: /* Solution 3: Make use of Oolite Starter */</p>
<hr />
<div>[[File:Late 2016 MacBook Pro.jpg|right|400px]]<br />
Oolite was originally written for the AppleMac.<br />
<br />
== Overview ==<br />
Whilst this meant that those playing Oolite on AppleMacs in the early days had an advantage, the haemorrhaging of AppleMac-friendly developers has led to the inability to fix recent issues (such as the loss of sound) and worries over eventual play on BigSur once backwards compatibility is abandoned by Apple. <br />
<br />
[[File:AppleMac Help.png|thumb|right|200px|AppleMac "help" (" ⌘ ? ") creates this drop-down in a full-screen game]]<br />
=== Advantages ===<br />
Some of the Oolite functionality is "built-in" to the AppleMac. This is most obvious when running the [http://www.oolite.org/download/ OXP developer releases] of Oolite, where the Debug console is built-in to the AppleMac.<br />
<br />
The OpenStep Legacy script is from the AppleMac OS <br />
<br />
=== Disadvantages ===<br />
*As Apple try more and more to suck money out of anything designed to work on an AppleMac, they have made opening an Oolite download on an AppleMac more difficult.<br />
*The ''Load Commander'' option on game start-up is also built in to the AppleMac, so one gets the standard AppleMac "open file" dialogue box, which gives no information about the save files other than their size and date (in Windows, for example, you get details of Elite rank, location and wealth).<br />
*The AppleMac parsing of Javascript is rather more tendentious than that of Windows, so, for example, oxp's will be rejected because of a wonky "quotations mark" which windows would just accept and interpret. On the other hand, if you write an oxp on your AppleMac, it should work happily on any other contraption (if you can ever get it to work on yours!!).<br />
*The newer AppleOS's use the control key for windows management, and this requires disabling if you want to use the control key in-game.<br />
*Many of the HOTAS setups are incompatible with the AppleMac, and thus only partially usable for Oolite.<br />
*The AppleMac OS hides files away from view, so finding your AddOns and Managed AddOns folders can be pains in the unmentionables. As can looking at the vanilla game code.<br />
*There are issues with the game sounds disappearing when playing for any length of time.<br />
<br />
----<br />
== Running your new download of Oolite ==<br />
Newly-downloaded copies of Oolite are not allowed to run under AppleOS, because it’s “from an unidentified developer” (''ie'' none of us paid $300 to get a signature from Apple Inc.).<br />
<br />
=== Solution ===<br />
You can bypass this behaviour as follows:<br />
:Select Oolite in the Finder.<br />
:Hold down the <font color="Red">'''control'''</font> key and click the Oolite icon.<br />
:Select '''Open''' from the pop-up menu.<br />
:You will get the traditional ''This is an application downloaded from the Internet'' warning, and can now choose to open Oolite and start playing!<br />
<br />
----<br />
== Installing expansions on Oolite 1.90 (and previous)==<br />
Oolite can be customized easily by installing expansion packs (OXP directories or OXZ files). There is a builtin expansion manager that downloads and installs expansions you select.<br />
They are accessed from the website oolite.org. Unfortunately the Oolite project has moved to a different domain oolite.space, and the all builds before v1.91 are not aware of this. <br />
<br />
There are several options to overcome this limitation:<br />
<br />
=== Solution 1: Manage expansions manually. It is an effort but is quite possible ===<br />
You need to know where to get downloads from, and you need to know where to drop them on your harddrive.<br />
<br />
To find out the available expansions, go to https://www.oolite.space/#oxp.<br />
You can sort the list by clicking the column header and download it using the icon on the right.<br />
<br />
After downloading, move the file to <br />
~/Library/Application Support/Oolite/Managed Addons<br />
<br />
The tilde character will be replaced by your user home directory. If you prefer, you can as well write<br />
$HOME/Library/Application Support/Oolite/Managed Addons<br />
<br />
{| border="2" style="margin: 1em auto 1em auto;"<br />
|style="background-color: #00aaaa;padding: .6em 3em 1em;"|<br />
<center>'''Note'''</center><br />
The "Managed Addons" folder might not exist immediately after your installation of Oolite. It is created via the expansions manager.<br />
|}<br />
<br />
<br />
In any case, mind the space characters in the directory names. And while we are at it, uninstall expansions by simply removing them from the directory.<br />
<br />
<br />
=== Solution 2: Configure Oolite to access the expansion catalog from the new URL ===<br />
<br />
== For MacOS ==<br />
Oolite reads preferences from a file called<br />
~/Library/Preferences/org.aegidian.oolite.plist<br />
(see also [[Location of Oolite saved settings]]). The file is in [[Property list]] format, which used to be human-readable but today is binary. <br />
<br />
While Oolite is not running, open a [[Terminal_Utility|terminal window]] (command prompt) and run this command:<br />
defaults write org.aegidian.oolite oxz-index-url http://addons.oolite.space/api/1.0/overview<br />
<br />
On future startups the Oolite builtin expansion manager should find the correct index of expansions.<br />
<br />
Further guidance with screenshots available at [https://app.box.com/s/8t5x1sxqlm2zlrtqcws3zwwcv2ow2z17 MacOS Process to update gnustepdefaults file].<br />
<br />
== For Windows ==<br />
Oolite reads preferences from a file called<br />
<OoliteInstallFolder>\oolite.app\GNUstep\Defaults\.GNUstepDefaults<br />
Make sure you have run the game at least once in order to have this file auto-generated. Then open the file in a text editor and add the following line anywhere inside the "oolite" section:<br />
"oxz-index-url" = "http://addons.oolite.space/api/1.0/overview";<br />
Save and exit and you should now be able to use the in-game Expansion Manager normally.<br />
<br />
== For Linux ==<br />
Oolite reads preferences from a file called<br />
~\GNUstep\Defaults\.GNUstepDefaults<br />
Make sure you have run the game at least once in order to have this file auto-generated. Then open the file in a text editor and add the following line anywhere inside the "oolite" section:<br />
<key>oxz-index-url</key><br />
<string>http://addons.oolite.space/api/1.0/overview</string><br />
Save and exit and you should now be able to use the in-game Expansion Manager normally.<br />
<br />
<br />
=== Solution 3: Make use of Oolite Starter ===<br />
[[Oolite Starter]] is a wrapper for Oolite that allows managing expansions and more.<br />
<br />
----<br />
<br />
== Precision Flying and the Control Key ==<br />
The precision flying ‘control’ key does not work well on the modern macs -<br />
<br />
Your Oolite window whizzes off to the side, is replaced by another window and you suddenly find that you are looking at something quite different (your cobra may indeed be flying much more precisely - but it's a tad difficult to ascertain this when the appropriate window has jumped into witchspace without you!)<br />
<br />
This is because the more recent MacOS's combine the control key with the arrow keys to activate ‘Mission Control’ (which manages the opened windows on the computer screen).<br />
<br />
=== Solution ===<br />
:1) You need to find the ‘Keyboard’ panel in System Preferences (3rd row down on my machine)<br />
:2) Then select the ‘shortcuts’ button on the top line of the window.<br />
:3) Choose ‘Mission Control’ in the left hand box.<br />
:4) Finally, ‘uncheck’ the relevant shortcuts (Mission Control, Application windows, move left a space, move right a space).<br />
<br />
Things should now work as they should!<br />
<br />
----<br />
== Music/Sound ==<br />
As adumbrated above, the sound now eventually cuts out on an AppleMac.<br />
<br />
What is less known is the iTunes integration. This may no longer work with the newer Macs which have "Music" instead.<br />
See [https://bb.oolite.space/viewtopic.php?f=10&t=19896 iTunes and Oolite v.1.87] for more on this (2018)<br />
<br />
----<br />
== HOTAS and AppleMac ==<br />
Some people find that using a HOTAS is invaluable for dog-fighting (It does not have to be - see [[User:Another_commander|Another_commander]]'s virtuoso display [https://www.youtube.com/watch?v=IHnjUjZVtgk here]). In ''theory'', every HOTAS should work on an AppleMac as AppleMac accepts the recognized standard USB HID devices as Windows and Linux do.<br />
<br />
The problem is with the HOTAS manufacturers adding on bells and whistles which then require software to interpret. They can't be bothered to write the software for Apple (or for the 613 different flavours of Linux), and so things start to fall apart. And Apple has a history of not bothering to document this sort of thing properly for developers:<br />
As for sample code not being updated, documentation being incomplete/outdated/missing, and provided code requiring a lot of effort to build: welcome to Mac systems & driver development. That's unfortunately how it is. I've been doing OS X kernel/driver work for 7 years, and while some things get easier with experience, downloading code from Apple and building it still feels like playing the lottery. (https://stackoverflow.com/questions/41715074/simple-hid-osx-application 2017)<br />
<br />
=== Solutions ===<br />
==== Thrustmaster (TFlight HOTAS 4/TM4) ====<br />
It seems that this is not compatible with the AppleMac, with the twist, throttle and axis on the back of the throttle not seeming functional.<br />
What neither Thrustmaster nor Apple can be bothered to tell you is that you need to keep the '''PS''', '''SHARE''' & '''OPTIONS''' buttons held down while you plug it into your AppleMac. The green light should then come on on your PS button, and you should find it fully functional. <br><br />
This worked for Cholmondely but not for Murgh.<br />
==== VKB (Gladiator Mk II with T-Rudder) ====<br />
These allegedly work with the AppleMac (but the combination needs tweaking). See [http://forum.vkb-sim.pro/viewtopic.php?f=27&t=4456 Gladiator MK 11 connection to T-Rudder] (2020)<br />
----<br />
<br />
== Accessing the Vanilla Game Code ==<br />
=== Solution ===<br />
Download the current '''oolite-1.9?.zip''' from [https://github.com/OoliteProject/oolite/releases GitHub]. This will just expand, rather than install, and you will be able to look at the entire code.<br />
<br />
=== AppleMac peculiarities ===<br />
The so-called Oolite programme is really just an unopenable folder with the programme hidden inside, which starts when you click on the folder wrapping.<br />
<br />
----<br />
== History ==<br />
Oolite was originally written by [[User:Aegidian|Aegidian]] for the AppleMac back in 2003 and then ported by [[User:Winston|Winston]] & [[David Taylor]] to Linux & Windows three years later. Our Second lead developer, [[User:Ahruman|Ahruman]] (2007-13) was also an AppleMac buff. It's been downhill ever since, sadly. So much so, that the introduction of Big Sur (MacOS 11) threatens to make Oolite unplayable once Apple phase out backwards compatibility, due to our lack of developers who know how to make Oolite compatible with Big Sur.<br />
<br />
----<br />
== Links ==<br />
*[[Running Oolite-Mac]] contains notes about Building Oolite from source<br />
*MacOS Version 11+ problem: [https://github.com/OoliteProject/oolite/issues/360 GitHub discussion] & [https://bb.oolite.space/viewtopic.php?f=10&t=20939 BB discussion]<br />
*AppleMac problems (Compilation, Game Sounds ''etc''.): [https://bb.oolite.space/viewtopic.php?f=10&t=20789 BB Index of AppleMac Issues] (2023)<br />
<br />
=== Techniques ===<br />
*[[Terminal Utility]] - an AppleMac utility useful for [[The Dark Side|dark-sided]] deeds of derring-do!<br />
<br />
=== Humour ===<br />
*[https://bb.oolite.space/viewtopic.php?p=235670#p235670 Comparing AppleMac, Windows & Linux] (Cartoon & discussion, 2015)<br />
<br />
[[Category:Oolite]] [[Category:Help pages]]<br />
[[Category:Factual]]</div>Another commanderhttps://wiki.alioth.net/index.php?title=AppleMac&diff=85410AppleMac2025-04-29T16:40:47Z<p>Another commander: /* Solution 2: Configure Oolite to access the expansion catalog from the new URL */</p>
<hr />
<div>[[File:Late 2016 MacBook Pro.jpg|right|400px]]<br />
Oolite was originally written for the AppleMac.<br />
<br />
== Overview ==<br />
Whilst this meant that those playing Oolite on AppleMacs in the early days had an advantage, the haemorrhaging of AppleMac-friendly developers has led to the inability to fix recent issues (such as the loss of sound) and worries over eventual play on BigSur once backwards compatibility is abandoned by Apple. <br />
<br />
[[File:AppleMac Help.png|thumb|right|200px|AppleMac "help" (" ⌘ ? ") creates this drop-down in a full-screen game]]<br />
=== Advantages ===<br />
Some of the Oolite functionality is "built-in" to the AppleMac. This is most obvious when running the [http://www.oolite.org/download/ OXP developer releases] of Oolite, where the Debug console is built-in to the AppleMac.<br />
<br />
The OpenStep Legacy script is from the AppleMac OS <br />
<br />
=== Disadvantages ===<br />
*As Apple try more and more to suck money out of anything designed to work on an AppleMac, they have made opening an Oolite download on an AppleMac more difficult.<br />
*The ''Load Commander'' option on game start-up is also built in to the AppleMac, so one gets the standard AppleMac "open file" dialogue box, which gives no information about the save files other than their size and date (in Windows, for example, you get details of Elite rank, location and wealth).<br />
*The AppleMac parsing of Javascript is rather more tendentious than that of Windows, so, for example, oxp's will be rejected because of a wonky "quotations mark" which windows would just accept and interpret. On the other hand, if you write an oxp on your AppleMac, it should work happily on any other contraption (if you can ever get it to work on yours!!).<br />
*The newer AppleOS's use the control key for windows management, and this requires disabling if you want to use the control key in-game.<br />
*Many of the HOTAS setups are incompatible with the AppleMac, and thus only partially usable for Oolite.<br />
*The AppleMac OS hides files away from view, so finding your AddOns and Managed AddOns folders can be pains in the unmentionables. As can looking at the vanilla game code.<br />
*There are issues with the game sounds disappearing when playing for any length of time.<br />
<br />
----<br />
== Running your new download of Oolite ==<br />
Newly-downloaded copies of Oolite are not allowed to run under AppleOS, because it’s “from an unidentified developer” (''ie'' none of us paid $300 to get a signature from Apple Inc.).<br />
<br />
=== Solution ===<br />
You can bypass this behaviour as follows:<br />
:Select Oolite in the Finder.<br />
:Hold down the <font color="Red">'''control'''</font> key and click the Oolite icon.<br />
:Select '''Open''' from the pop-up menu.<br />
:You will get the traditional ''This is an application downloaded from the Internet'' warning, and can now choose to open Oolite and start playing!<br />
<br />
----<br />
== Installing expansions on Oolite 1.90 (and previous)==<br />
Oolite can be customized easily by installing expansion packs (OXP directories or OXZ files). There is a builtin expansion manager that downloads and installs expansions you select.<br />
They are accessed from the website oolite.org. Unfortunately the Oolite project has moved to a different domain oolite.space, and the all builds before v1.91 are not aware of this. <br />
<br />
There are several options to overcome this limitation:<br />
<br />
=== Solution 1: Manage expansions manually. It is an effort but is quite possible ===<br />
You need to know where to get downloads from, and you need to know where to drop them on your harddrive.<br />
<br />
To find out the available expansions, go to https://www.oolite.space/#oxp.<br />
You can sort the list by clicking the column header and download it using the icon on the right.<br />
<br />
After downloading, move the file to <br />
~/Library/Application Support/Oolite/Managed Addons<br />
<br />
The tilde character will be replaced by your user home directory. If you prefer, you can as well write<br />
$HOME/Library/Application Support/Oolite/Managed Addons<br />
<br />
{| border="2" style="margin: 1em auto 1em auto;"<br />
|style="background-color: #00aaaa;padding: .6em 3em 1em;"|<br />
<center>'''Note'''</center><br />
The "Managed Addons" folder might not exist immediately after your installation of Oolite. It is created via the expansions manager.<br />
|}<br />
<br />
<br />
In any case, mind the space characters in the directory names. And while we are at it, uninstall expansions by simply removing them from the directory.<br />
<br />
<br />
=== Solution 2: Configure Oolite to access the expansion catalog from the new URL ===<br />
<br />
== For MacOS ==<br />
Oolite reads preferences from a file called<br />
~/Library/Preferences/org.aegidian.oolite.plist<br />
(see also [[Location of Oolite saved settings]]). The file is in [[Property list]] format, which used to be human-readable but today is binary. <br />
<br />
While Oolite is not running, open a [[Terminal_Utility|terminal window]] (command prompt) and run this command:<br />
defaults write org.aegidian.oolite oxz-index-url http://addons.oolite.space/api/1.0/overview<br />
<br />
On future startups the Oolite builtin expansion manager should find the correct index of expansions.<br />
<br />
Further guidance with screenshots available at [https://app.box.com/s/8t5x1sxqlm2zlrtqcws3zwwcv2ow2z17 MacOS Process to update gnustepdefaults file].<br />
<br />
== For Windows ==<br />
Oolite reads preferences from a file called<br />
<OoliteInstallFolder>\oolite.app\GNUstep\Defaults\.GNUstepDefaults<br />
Make sure you have run the game at least once in order to have this file auto-generated. Then open the file in a text editor and add the following line anywhere inside the "oolite" section:<br />
"oxz-index-url" = "http://addons.oolite.space/api/1.0/overview";<br />
Save and exit and you should now be able to use the in-game Expansion Manager normally.<br />
<br />
== For Linux ==<br />
Oolite reads preferences from a file called<br />
~\GNUstep\Defaults\.GNUstepDefaults<br />
Make sure you have run the game at least once in order to have this file auto-generated. Then open the file in a text editor and add the following line anywhere inside the "oolite" section:<br />
<key>oxz-index-url</key><br />
<string>http://addons.oolite.space/api/1.0/overview</string><br />
Save and exit and you should now be able to use the in-game Expansion Manager normally.<br />
<br />
=== Solution 3: Make use of Oolite Starter ===<br />
[[Oolite Starter]] is a wrapper for Oolite that allows managing expansions and more.<br />
<br />
----<br />
== Precision Flying and the Control Key ==<br />
The precision flying ‘control’ key does not work well on the modern macs -<br />
<br />
Your Oolite window whizzes off to the side, is replaced by another window and you suddenly find that you are looking at something quite different (your cobra may indeed be flying much more precisely - but it's a tad difficult to ascertain this when the appropriate window has jumped into witchspace without you!)<br />
<br />
This is because the more recent MacOS's combine the control key with the arrow keys to activate ‘Mission Control’ (which manages the opened windows on the computer screen).<br />
<br />
=== Solution ===<br />
:1) You need to find the ‘Keyboard’ panel in System Preferences (3rd row down on my machine)<br />
:2) Then select the ‘shortcuts’ button on the top line of the window.<br />
:3) Choose ‘Mission Control’ in the left hand box.<br />
:4) Finally, ‘uncheck’ the relevant shortcuts (Mission Control, Application windows, move left a space, move right a space).<br />
<br />
Things should now work as they should!<br />
<br />
----<br />
== Music/Sound ==<br />
As adumbrated above, the sound now eventually cuts out on an AppleMac.<br />
<br />
What is less known is the iTunes integration. This may no longer work with the newer Macs which have "Music" instead.<br />
See [https://bb.oolite.space/viewtopic.php?f=10&t=19896 iTunes and Oolite v.1.87] for more on this (2018)<br />
<br />
----<br />
== HOTAS and AppleMac ==<br />
Some people find that using a HOTAS is invaluable for dog-fighting (It does not have to be - see [[User:Another_commander|Another_commander]]'s virtuoso display [https://www.youtube.com/watch?v=IHnjUjZVtgk here]). In ''theory'', every HOTAS should work on an AppleMac as AppleMac accepts the recognized standard USB HID devices as Windows and Linux do.<br />
<br />
The problem is with the HOTAS manufacturers adding on bells and whistles which then require software to interpret. They can't be bothered to write the software for Apple (or for the 613 different flavours of Linux), and so things start to fall apart. And Apple has a history of not bothering to document this sort of thing properly for developers:<br />
As for sample code not being updated, documentation being incomplete/outdated/missing, and provided code requiring a lot of effort to build: welcome to Mac systems & driver development. That's unfortunately how it is. I've been doing OS X kernel/driver work for 7 years, and while some things get easier with experience, downloading code from Apple and building it still feels like playing the lottery. (https://stackoverflow.com/questions/41715074/simple-hid-osx-application 2017)<br />
<br />
=== Solutions ===<br />
==== Thrustmaster (TFlight HOTAS 4/TM4) ====<br />
It seems that this is not compatible with the AppleMac, with the twist, throttle and axis on the back of the throttle not seeming functional.<br />
What neither Thrustmaster nor Apple can be bothered to tell you is that you need to keep the '''PS''', '''SHARE''' & '''OPTIONS''' buttons held down while you plug it into your AppleMac. The green light should then come on on your PS button, and you should find it fully functional. <br><br />
This worked for Cholmondely but not for Murgh.<br />
==== VKB (Gladiator Mk II with T-Rudder) ====<br />
These allegedly work with the AppleMac (but the combination needs tweaking). See [http://forum.vkb-sim.pro/viewtopic.php?f=27&t=4456 Gladiator MK 11 connection to T-Rudder] (2020)<br />
----<br />
<br />
== Accessing the Vanilla Game Code ==<br />
=== Solution ===<br />
Download the current '''oolite-1.9?.zip''' from [https://github.com/OoliteProject/oolite/releases GitHub]. This will just expand, rather than install, and you will be able to look at the entire code.<br />
<br />
=== AppleMac peculiarities ===<br />
The so-called Oolite programme is really just an unopenable folder with the programme hidden inside, which starts when you click on the folder wrapping.<br />
<br />
----<br />
== History ==<br />
Oolite was originally written by [[User:Aegidian|Aegidian]] for the AppleMac back in 2003 and then ported by [[User:Winston|Winston]] & [[David Taylor]] to Linux & Windows three years later. Our Second lead developer, [[User:Ahruman|Ahruman]] (2007-13) was also an AppleMac buff. It's been downhill ever since, sadly. So much so, that the introduction of Big Sur (MacOS 11) threatens to make Oolite unplayable once Apple phase out backwards compatibility, due to our lack of developers who know how to make Oolite compatible with Big Sur.<br />
<br />
----<br />
== Links ==<br />
*[[Running Oolite-Mac]] contains notes about Building Oolite from source<br />
*MacOS Version 11+ problem: [https://github.com/OoliteProject/oolite/issues/360 GitHub discussion] & [https://bb.oolite.space/viewtopic.php?f=10&t=20939 BB discussion]<br />
*AppleMac problems (Compilation, Game Sounds ''etc''.): [https://bb.oolite.space/viewtopic.php?f=10&t=20789 BB Index of AppleMac Issues] (2023)<br />
<br />
=== Techniques ===<br />
*[[Terminal Utility]] - an AppleMac utility useful for [[The Dark Side|dark-sided]] deeds of derring-do!<br />
<br />
=== Humour ===<br />
*[https://bb.oolite.space/viewtopic.php?p=235670#p235670 Comparing AppleMac, Windows & Linux] (Cartoon & discussion, 2015)<br />
<br />
[[Category:Oolite]] [[Category:Help pages]]<br />
[[Category:Factual]]</div>Another commanderhttps://wiki.alioth.net/index.php?title=AppleMac&diff=85409AppleMac2025-04-29T16:39:28Z<p>Another commander: /* Solution 2: Configure Oolite to access the expansion catalog from the new URL */</p>
<hr />
<div>[[File:Late 2016 MacBook Pro.jpg|right|400px]]<br />
Oolite was originally written for the AppleMac.<br />
<br />
== Overview ==<br />
Whilst this meant that those playing Oolite on AppleMacs in the early days had an advantage, the haemorrhaging of AppleMac-friendly developers has led to the inability to fix recent issues (such as the loss of sound) and worries over eventual play on BigSur once backwards compatibility is abandoned by Apple. <br />
<br />
[[File:AppleMac Help.png|thumb|right|200px|AppleMac "help" (" ⌘ ? ") creates this drop-down in a full-screen game]]<br />
=== Advantages ===<br />
Some of the Oolite functionality is "built-in" to the AppleMac. This is most obvious when running the [http://www.oolite.org/download/ OXP developer releases] of Oolite, where the Debug console is built-in to the AppleMac.<br />
<br />
The OpenStep Legacy script is from the AppleMac OS <br />
<br />
=== Disadvantages ===<br />
*As Apple try more and more to suck money out of anything designed to work on an AppleMac, they have made opening an Oolite download on an AppleMac more difficult.<br />
*The ''Load Commander'' option on game start-up is also built in to the AppleMac, so one gets the standard AppleMac "open file" dialogue box, which gives no information about the save files other than their size and date (in Windows, for example, you get details of Elite rank, location and wealth).<br />
*The AppleMac parsing of Javascript is rather more tendentious than that of Windows, so, for example, oxp's will be rejected because of a wonky "quotations mark" which windows would just accept and interpret. On the other hand, if you write an oxp on your AppleMac, it should work happily on any other contraption (if you can ever get it to work on yours!!).<br />
*The newer AppleOS's use the control key for windows management, and this requires disabling if you want to use the control key in-game.<br />
*Many of the HOTAS setups are incompatible with the AppleMac, and thus only partially usable for Oolite.<br />
*The AppleMac OS hides files away from view, so finding your AddOns and Managed AddOns folders can be pains in the unmentionables. As can looking at the vanilla game code.<br />
*There are issues with the game sounds disappearing when playing for any length of time.<br />
<br />
----<br />
== Running your new download of Oolite ==<br />
Newly-downloaded copies of Oolite are not allowed to run under AppleOS, because it’s “from an unidentified developer” (''ie'' none of us paid $300 to get a signature from Apple Inc.).<br />
<br />
=== Solution ===<br />
You can bypass this behaviour as follows:<br />
:Select Oolite in the Finder.<br />
:Hold down the <font color="Red">'''control'''</font> key and click the Oolite icon.<br />
:Select '''Open''' from the pop-up menu.<br />
:You will get the traditional ''This is an application downloaded from the Internet'' warning, and can now choose to open Oolite and start playing!<br />
<br />
----<br />
== Installing expansions on Oolite 1.90 (and previous)==<br />
Oolite can be customized easily by installing expansion packs (OXP directories or OXZ files). There is a builtin expansion manager that downloads and installs expansions you select.<br />
They are accessed from the website oolite.org. Unfortunately the Oolite project has moved to a different domain oolite.space, and the all builds before v1.91 are not aware of this. <br />
<br />
There are several options to overcome this limitation:<br />
<br />
=== Solution 1: Manage expansions manually. It is an effort but is quite possible ===<br />
You need to know where to get downloads from, and you need to know where to drop them on your harddrive.<br />
<br />
To find out the available expansions, go to https://www.oolite.space/#oxp.<br />
You can sort the list by clicking the column header and download it using the icon on the right.<br />
<br />
After downloading, move the file to <br />
~/Library/Application Support/Oolite/Managed Addons<br />
<br />
The tilde character will be replaced by your user home directory. If you prefer, you can as well write<br />
$HOME/Library/Application Support/Oolite/Managed Addons<br />
<br />
{| border="2" style="margin: 1em auto 1em auto;"<br />
|style="background-color: #00aaaa;padding: .6em 3em 1em;"|<br />
<center>'''Note'''</center><br />
The "Managed Addons" folder might not exist immediately after your installation of Oolite. It is created via the expansions manager.<br />
|}<br />
<br />
<br />
In any case, mind the space characters in the directory names. And while we are at it, uninstall expansions by simply removing them from the directory.<br />
<br />
=== Solution 2: Configure Oolite to access the expansion catalog from the new URL ===<br />
== For MacOS ==<br />
Oolite reads preferences from a file called<br />
~/Library/Preferences/org.aegidian.oolite.plist<br />
(see also [[Location of Oolite saved settings]]). The file is in [[Property list]] format, which used to be human-readable but today is binary. <br />
<br />
While Oolite is not running, open a [[Terminal_Utility|terminal window]] (command prompt) and run this command:<br />
defaults write org.aegidian.oolite oxz-index-url http://addons.oolite.space/api/1.0/overview<br />
<br />
On future startups the Oolite builtin expansion manager should find the correct index of expansions.<br />
<br />
Further guidance with screenshots available at [https://app.box.com/s/8t5x1sxqlm2zlrtqcws3zwwcv2ow2z17 MacOS Process to update gnustepdefaults file].<br />
<br />
== For Windows ==<br />
Oolite reads preferences from a file called<br />
<OoliteInstallFolder>\oolite.app\GNUstep\Defaults\.GNUstepDefaults<br />
Make sure you have run the game at least once in order to have this file auto-generated. Then open the file in a text editor and add the following line anywhere inside the "oolite" section:<br />
"oxz-index-url" = "http://addons.oolite.space/api/1.0/overview";<br />
Save and exit and you should now be able to use the in-game Expansion Manager normally.<br />
<br />
== For Linux ==<br />
Oolite reads preferences from a file called<br />
~\GNUstep\Defaults\.GNUstepDefaults<br />
Make sure you have run the game at least once in order to have this file auto-generated. Then open the file in a text editor and add the following line anywhere inside the "oolite" section:<br />
<key>oxz-index-url</key><br />
<string>http://addons.oolite.space/api/1.0/overview</string><br />
Save and exit and you should now be able to use the in-game Expansion Manager normally.<br />
<br />
=== Solution 3: Make use of Oolite Starter ===<br />
[[Oolite Starter]] is a wrapper for Oolite that allows managing expansions and more.<br />
<br />
----<br />
== Precision Flying and the Control Key ==<br />
The precision flying ‘control’ key does not work well on the modern macs -<br />
<br />
Your Oolite window whizzes off to the side, is replaced by another window and you suddenly find that you are looking at something quite different (your cobra may indeed be flying much more precisely - but it's a tad difficult to ascertain this when the appropriate window has jumped into witchspace without you!)<br />
<br />
This is because the more recent MacOS's combine the control key with the arrow keys to activate ‘Mission Control’ (which manages the opened windows on the computer screen).<br />
<br />
=== Solution ===<br />
:1) You need to find the ‘Keyboard’ panel in System Preferences (3rd row down on my machine)<br />
:2) Then select the ‘shortcuts’ button on the top line of the window.<br />
:3) Choose ‘Mission Control’ in the left hand box.<br />
:4) Finally, ‘uncheck’ the relevant shortcuts (Mission Control, Application windows, move left a space, move right a space).<br />
<br />
Things should now work as they should!<br />
<br />
----<br />
== Music/Sound ==<br />
As adumbrated above, the sound now eventually cuts out on an AppleMac.<br />
<br />
What is less known is the iTunes integration. This may no longer work with the newer Macs which have "Music" instead.<br />
See [https://bb.oolite.space/viewtopic.php?f=10&t=19896 iTunes and Oolite v.1.87] for more on this (2018)<br />
<br />
----<br />
== HOTAS and AppleMac ==<br />
Some people find that using a HOTAS is invaluable for dog-fighting (It does not have to be - see [[User:Another_commander|Another_commander]]'s virtuoso display [https://www.youtube.com/watch?v=IHnjUjZVtgk here]). In ''theory'', every HOTAS should work on an AppleMac as AppleMac accepts the recognized standard USB HID devices as Windows and Linux do.<br />
<br />
The problem is with the HOTAS manufacturers adding on bells and whistles which then require software to interpret. They can't be bothered to write the software for Apple (or for the 613 different flavours of Linux), and so things start to fall apart. And Apple has a history of not bothering to document this sort of thing properly for developers:<br />
As for sample code not being updated, documentation being incomplete/outdated/missing, and provided code requiring a lot of effort to build: welcome to Mac systems & driver development. That's unfortunately how it is. I've been doing OS X kernel/driver work for 7 years, and while some things get easier with experience, downloading code from Apple and building it still feels like playing the lottery. (https://stackoverflow.com/questions/41715074/simple-hid-osx-application 2017)<br />
<br />
=== Solutions ===<br />
==== Thrustmaster (TFlight HOTAS 4/TM4) ====<br />
It seems that this is not compatible with the AppleMac, with the twist, throttle and axis on the back of the throttle not seeming functional.<br />
What neither Thrustmaster nor Apple can be bothered to tell you is that you need to keep the '''PS''', '''SHARE''' & '''OPTIONS''' buttons held down while you plug it into your AppleMac. The green light should then come on on your PS button, and you should find it fully functional. <br><br />
This worked for Cholmondely but not for Murgh.<br />
==== VKB (Gladiator Mk II with T-Rudder) ====<br />
These allegedly work with the AppleMac (but the combination needs tweaking). See [http://forum.vkb-sim.pro/viewtopic.php?f=27&t=4456 Gladiator MK 11 connection to T-Rudder] (2020)<br />
----<br />
<br />
== Accessing the Vanilla Game Code ==<br />
=== Solution ===<br />
Download the current '''oolite-1.9?.zip''' from [https://github.com/OoliteProject/oolite/releases GitHub]. This will just expand, rather than install, and you will be able to look at the entire code.<br />
<br />
=== AppleMac peculiarities ===<br />
The so-called Oolite programme is really just an unopenable folder with the programme hidden inside, which starts when you click on the folder wrapping.<br />
<br />
----<br />
== History ==<br />
Oolite was originally written by [[User:Aegidian|Aegidian]] for the AppleMac back in 2003 and then ported by [[User:Winston|Winston]] & [[David Taylor]] to Linux & Windows three years later. Our Second lead developer, [[User:Ahruman|Ahruman]] (2007-13) was also an AppleMac buff. It's been downhill ever since, sadly. So much so, that the introduction of Big Sur (MacOS 11) threatens to make Oolite unplayable once Apple phase out backwards compatibility, due to our lack of developers who know how to make Oolite compatible with Big Sur.<br />
<br />
----<br />
== Links ==<br />
*[[Running Oolite-Mac]] contains notes about Building Oolite from source<br />
*MacOS Version 11+ problem: [https://github.com/OoliteProject/oolite/issues/360 GitHub discussion] & [https://bb.oolite.space/viewtopic.php?f=10&t=20939 BB discussion]<br />
*AppleMac problems (Compilation, Game Sounds ''etc''.): [https://bb.oolite.space/viewtopic.php?f=10&t=20789 BB Index of AppleMac Issues] (2023)<br />
<br />
=== Techniques ===<br />
*[[Terminal Utility]] - an AppleMac utility useful for [[The Dark Side|dark-sided]] deeds of derring-do!<br />
<br />
=== Humour ===<br />
*[https://bb.oolite.space/viewtopic.php?p=235670#p235670 Comparing AppleMac, Windows & Linux] (Cartoon & discussion, 2015)<br />
<br />
[[Category:Oolite]] [[Category:Help pages]]<br />
[[Category:Factual]]</div>Another commanderhttps://wiki.alioth.net/index.php?title=Location_of_Oolite_saved_settings&diff=85334Location of Oolite saved settings2025-04-27T16:50:20Z<p>Another commander: /* Windows */</p>
<hr />
<div>Settings are saved in the player's applications default file on all platforms. Generally, you will never need to edit this file, since the settings saved in this file are chosen from places like the F2 in-game menu. The defaults file for Oolite contains things like the selected screen resolution, whether full screen is selected and joystick assignments. A rare occasion where you may need to edit this file is if you discover your hardware does not support Oolite in full screen mode, but no errors are returned to Oolite to tell the game that full screen mode could not be successfully entered. This is a rare occurence, but it is known to occasionally happen. (The defaults file is not removed when the game is uninstalled, so a problem caused by a setting in this file won't go away if you re-install the game).<br />
<br />
== Location of the defaults file ==<br />
<br />
=== Mac OS X ===<br />
<br />
On Mac OS X, your defaults are saved in the following location in your home folder:<br />
<br />
Library/Preferences/org.aegidian.oolite.plist<br />
<br />
Navigate to this location with the Finder, and double click on the 'org.aegidian.oolite.plist' file, and then edit the setting that is causing you trouble.<br />
<br />
=== Linux, *BSD and UNIX ===<br />
<br />
The defaults file is in the following location in your home directory:<br />
<br />
GNUstep/Defaults/.GNUstepDefaults<br />
<br />
Open the file with a text editor. Note that this is a 'dot file', so to see it in a directory listing you need to use 'ls -a', or if you're using GNOME or KDE, you need to set your file browser to display hidden files.<br />
<br />
* See [[Hidden_Settings_in_Oolite#Windows.2C_Linux_and_other_platforms|here]] for details on editting this file.<br />
<br />
=== Windows ===<br />
<br />
The defaults file will be in a sub-folder of the game install location (usually C:\Oolite) under the following path:<br />
<br />
<OoliteInstallLocation>\oolite.app\GNUstep\Defaults\.GNUstepDefaults<br />
<br />
Open the file with a text editor to make changes.<br />
<br />
* See [[Hidden_Settings_in_Oolite#Windows.2C_Linux_and_other_platforms|here]] for details on editting this file.<br />
<br />
[[Category:Oolite]]</div>Another commanderhttps://wiki.alioth.net/index.php?title=Oolite_FAQ&diff=85278Oolite FAQ2025-04-21T12:04:42Z<p>Another commander: /* System Requirements */</p>
<hr />
<div>[[File:Oolite-IconBW.png | right | width=90px | height=90px ]]<br />
== Getting Started ==<br />
<br />
{{FAQ|question=Where do I get the program? And what about the different versions that exist?|answer= The latest 'official' stable release is version 1.90, available on the [https://oolite.space/download oolite.space download page] for OS X, Windows, and Linux(x86). You can download the latest nightly (development version) from [http://terrastorage.no-ip.info/oolite/status_win64.html here], More detailed information can be found on the [https://bb.oolite.space/index.php Oolite Bulletin Board], in the respective sections for [https://bb.oolite.space/viewforum.php?f=10 Oolite-Mac], [https://bb.oolite.space/viewforum.php?f=9 Oolite-Linux] and [https://bb.oolite.space/viewforum.php?f=8 Oolite-PC].<br />
The last stable release made by the original programmer, Giles Williams (a.k.a. Aegidian) was 1.65 and is best available from his website [http://oolite.aegidian.org/ oolite.aegidian.org].}}<br />
<br />
<br />
{{FAQ|question=What's the point of the game?|answer=To fly from planet to planet, buying and selling goods, shooting pirates or committing acts of piracy. There's no goal other than perhaps to achieve the rank of ELITE.}}<br />
<br />
<br />
{{FAQ|question=I'm still confused, how do I play?|answer=It's a good idea to start with the [https://github.com/OoliteProject/oolite/blob/master/Doc/OoliteReadMe.pdf Oolite ReadMe] file for some basic information. For further information you may wish to consult the [http://wiki.alioth.net/index.php/Oolite_Instruction_Manual Oolite Instruction Manual] here on the wiki. A load of helpful information can be obtained from [http://wiki.alioth.net/index.php/Mr_Gimlet Mr Gimlet], the quite talkative dockmaster on Lave Station. If you're a fresh graduate from the Flight Academy on the way to your first ship, you should see him. It's also a good idea to have a look at Ian Bell's [http://www.iancgbell.clara.net/elite/manual.htm Flight Training Manual] for the original BBC Elite, although some of Oolite's control keys are different from the original, so be careful.}}<br />
<br />
<br />
{{FAQ|question=How do I configure my joystick or gamepad for Oolite in Linux?|answer=See [[Joysticks: Guide to Setting Up]].}}<br />
<br />
{{FAQ|question=Where do I find quick reference pages?|answer=See '''OoliteRS''' (Reference Sheets) and '''AdviceforNewCommanders''' which came as .pdfs in your original game download. Probably worth printing out!}}<br />
<br />
== Gameplay ==<br />
<br />
{{FAQ|question=What do the various colors represent on the radar?|answer=White - unpowered items that can't mass-lock the in-system [[Torus Drive|Torus jump-drive]]. Green/Yellow - navigation buoys. Yellow - powered craft. Red - powered craft identified as hostile. Green - space stations. Green/Red - thargoids. Purple - police. Blue/Red - police on intercept. Red/Yellow - active mine (about to detonate). Blue/Cyan - witchspace wormhole. See [[IFF System]]}}<br />
<br />
<br />
{{FAQ|question=I keep crashing when trying to dock. How do I dock manually?|answer=Many young Jamesons have met a sticky end and had to be scraped from the docking port of Lave Station whilst attempting docking. It's fairly easy once you get the hang of it. Check the [[How_to_Dock|How to Dock]] guide from the Galactic Navy Flight Manual. Or you can get the [[Traffic_Control_OXP|Traffic Control OXP]] for friendly instructions given by the station crew as you try to dock. Another good piece of kit is the [[Dock_Assist_System_OXP | Dock Assist System]]}}<br />
<br />
<br />
{{FAQ|question=How do I make decent profits?|answer=Trade between a Poor or Average Agricultural and a Rich or Average Industrial planet. Write down the prices for everything on both planets and find out where you make the most profit per ton. <br />
If you're not in the mood for making notes and calculating, you can download the [[MarketObserver | Market Observer OXP]]. The old-fashioned way would be to use the table of average prices in [https://github.com/OoliteProject/oolite/blob/master/Doc/OoliteRS.pdf Oolite Reference Sheet] to figure out whether you're on a buyers' or a sellers' market. The [http://wiki.alioth.net/images/9/9e/OoliteTradingChart2.zip Trading Chart] allows you to create your own statistics along your way. Pressing the ? key in Star Chart will cycle between a map of governments and tech levels, making it easy to pinpoint Poor Agricultural and Rich Industrial planets. [http://www.box.net/shared/bchkkloi32 This spreadsheet] highlights Poor Agricultural and Rich Industrial planets on a star chart (the spreadsheet is in .xls format and needs the Analysis Toolpak installed). [[GalCop Galactic Registry]] also helps.<br />
<br />
Another option is to fit one or more [http://wiki.alioth.net/index.php/Passenger_Berth Passenger Berths] in your ship and earn credits by transporting individuals who, for one reason or another, prefer not to use the commercial Passenger Liners to reach their destination. As with cargo contracts, you can build your reputation up, which will result in your being offered more lucrative fares. Yet another option is to earn credits by taking cargo contracts - courier goods of varied type and volume between planets near and far. The spreadsheet helps assess whether you will be be able to complete the contract on time, and so build your reputation as an outstanding courier.}}<br />
<br />
<br />
{{FAQ|question=It takes so long to get to the station after each jump. Can I do anything to speed the trip up?|answer=Well, space is huge. It is vast. I mean, have you ever imagined a football-field with an orange in one of the goals and a walnut in the other goal? If you haven't, then don't. It takes you nowhere. As will your ship's engine at normal speed. But then that's what your [[Torus Drive|Torus/jumpdrive]] is for. Hit '''J''', and your journey speeds up. Unfortunately your Torus/jumpdrive doesn't work when other masses, like ships or planets, are nearby. They will 'lock' it. And in the 'corridor' between the witchpoint and the planet you are very likely to meet other ships. On the other hand there is no rule that you have to stick to the corridor. Just leave it sideways in any direction with your jumpdrive engaged for about 10-15 seconds, and head for the planet then. Makes your voyage much smoother. If you're a bounty-hunter and eager to meet lots of pirates, however, this is not your method of choice.}}<br />
<br />
<br />
{{FAQ|question=I have already made my first intergalactic jump to Galaxy 2, but now I remember that I forgot my Zero-G cricket set/food blender/deadly lobstoid/edible arts graduate on Lave/Tionisla/Xeesle/Reesdice! Or I just found out that there are some more missions I'd like to do in the first galaxy. So how can I jump back to Galaxy 1?|answer=You can't. Unfortunately due to their very physical nature intergalactic wormholes allow for one-way travel only. Fortunately, though, the intergalactic wormhole in Galaxy 8 connects back to Galaxy 1. So you can go full circle. And you have to, if you want to return to the first galaxy. Of course that will cost you another 5000 credits for each galactic hyperjump. So the complete 8-Galaxies-Sightseeing-Tour has a pricetag of a total 40000 credits.}}<br />
<br />
<br />
{{FAQ|question=I've got a [[Trumble|trumble]]! First it was cute and fluffy. But then it started to multiply. Even worse, they started to eat everything on board and they are confusing my sights. I don't want them any more! How can I get rid of them? Help!|answer=First of all, don't feel embarrassed. It happens to all commanders sooner or later. I mean, they're really cute and fluffy, aren't they? But seriously, there are several things you could try. E.g. sell them to other unsuspecting noobs. If you don't find enough willing buyers, you could use your escape capsule and abandon your infested ship, hoping that they haven't yet made it into the escape pod, of course. I mean, you can always hope, can't you? If that all doesn't work for you, just remember the old Klingon saying: 'Revenge is a dish that is best served cold.' Now consider that for trumbles it's just the opposite. Want some BBQ-sauce?}}<br />
<br />
<br />
{{FAQ|question=My keyboard doesn't have a particular key used by [[Oolite]], or I even want to change the keyboard layout completely to my liking. What can I do to change the keys?|answer=Oolite reads a key configuration file called keyconfig.plist that you can find at /AddOns/Config/keyconfig.plist; that is the Config-folder that you find inside your AddOns-folder; which is where you put your OXPs. (PC-users have to create the folder /AddOns/Config/ first and then drop a copy of the keyconfig.plist found in /Oolite.app/Contents/Resources/Config/ to this folder.) You can open this file in any text editor and change the ASCII values of the keys used to suit your own preferences. Information on the default keys is also found in the [http://wiki.alioth.net/index.php/Oolite_Keyboard_Controls Oolite Keybord Controls-documentation] here on the wiki.}}<br />
<br />
<br />
{{FAQ|question=I've completed a number of native and [http://wiki.alioth.net/index.php/OXP OXP] missions and my [[Cobra_Mk.3_%28Oolite%29|Cobra Mk. III]] has a number of new and funky pieces of equipment. However, I'm planning a change of ship, what pieces of equipment will I lose as a result?|answer=Many missions award equipment as a result of either accepting or completing them. For the majority of ship equipment, trading ships will result in the equipment being sold as well, with a few exceptions. The '''Cloaking Device''' and the '''Mark Transponder Scanner''', available from the (native) Cloaking Device and (OXP) Assassins missions respectively are transferred to your new ship. The '''Naval Energy Unit''', although awarded with the completion of the (native) Thargoid Plans mission, will be sold when you trade ships. However, completing the mission allows you to buy these units from high TL systems.}}<br />
<br />
<br />
{{FAQ|question=I’m using [[ECM Hardened Missile]]s, but enemies are still able to destroy them! I never seem to be able to destroy enemy hardheads, though. What gives?|answer=ECM-hardened missiles are not ECM-proof. The probability of a hardened missile being destroyed by [[E.C.M. System|ECM]] is 10%–34% depending on range, and if it is destroyed, there’s a 50% chance that it will detonate. This applies equally to hardened missiles fired by computer-controlled ships and those fired by the player. The most effective use of hardened missiles is to use them against relatively slow targets at moderate range, and only use them on nimble ships if you desperately need to force them to break off an attack. Also, don’t use your ECM until a missile is close to blast range (250 metres).<br />
<br />
Specifically, the ECM sends out four pulses with different ranges, at half-second intervals. Each pulse has a 10% chance of destroying each hardhead it encounters. For a missile fired at close range, that’s 1 - 0.9<small><sup>4</sup></small> = 34.39% chance of being destroyed within two seconds.}}<br />
<br />
<br />
{{FAQ|question=If I believe that sizes and distances in [[Oolite]] are given in meters, it is so ''unrealistic''. The planets have a diameter of only 30–50 kilometers, and the suns are only 1000 kilometers away. Can't we get a little more realism in space, please?|answer=First of all, remember that Oolite is a ''game'', not a ''space simulation''. This is because it ''wants to'' be a game, not a sim. So yes, sizes and distances are all messed up. Ships and stations are too big, planets and suns are too small, and too close to each other. But this is ''deliberately'' so, and we are not going to change it.<br />
<br />
The reason is simple: Realistic sizes and distances don't make a good game. In reality space is so huge that you never would meet anybody else on your journey. Imagine the dozen or so ships you meet in the 500 or so kilometers between witchpoint and planet spread over the realistic 150 '''million''' kilometers between Sun and Earth. Even if your direction is only one degree off the perfect line, you would miss them all. And how interesting would that be for the gameplay? And finally, if you had a realistically sized station in front of a realistically sized planet, how would you ever even notice it? A grain of sand in front of a, well, '''planet'''. The result would be players in complete loneliness and virtually no interaction with NPCs. An utterly, utterly boring game. Therefore it was the right decision to screw realism in the layout of the planetary systems in Elite and Oolite. But you may care to look here: [[Distance (Oolite)]]}}<br />
<br />
== Expanding the Game ==<br />
<br />
{{FAQ|question=Speaking of OXPs, I've heard a lot about them. What are they? And where do I find them?|answer=OXP stands for 'Oolite eXpansion Pack'. As the name suggests, an OXP is an expansion to the game. It can contain virtually everything: new graphics for your ship, new ships for the player and/or the NPCs, new stations, new missions, new fun. The easiest way to install an OXP is to use the download expansion manager accessed within the game itself. The manager has access to over 500 expansion packs and will provide information on each one. You can also download and install OXP's manually. To install an OXP you simply have to drag it into your AddOns-folder (only the OXP itself, not the folder it probably comes in). And as for finding them, you're already at the right place. All OXPs are now (or will become) accessible through the [[OXP|OXP-page of the wiki]]. Just follow the link. And if you fancy trying to create an OXP, the modifying Oolite FAQ can be found [[Modifying Oolite Informal FAQ|here]].}}<br />
<br />
<br />
{{FAQ|question=Are there any OXPs that are highly recommended? Or can I get a list of 'must-have' OXPs?|answer=This is a difficult one to answer, because it depends so much on personal taste. There is no list of 'must-have' or necessary OXPs that could be agreed upon by all—or even most—players or contributors. But if you have a look at the [https://bb.oolite.space/index.php Oolite Bulletin Board], especially the [https://bb.oolite.space/viewforum.php?f=2 Discussion]- and the [https://bb.oolite.space/viewforum.php?f=4 Expansion Pack]-forums, you will surely find some topics about this question, and the personal answers of a couple of board members.}}<br />
<br />
== Why does this and that not exist? ==<br />
<br />
{{FAQ|question=Will there ever be an Oolite Massive Multi-player Online Role-Play Game (MMORPG)?|answer=At present Ahruman and Co. (the developers) have no plans to develop either Oolite or a separate branch to accommodate either an MMORPG or an MOG (Multi-player Online Game). This, however, doesn't mean one of you clever bods out there can't try ;-) We suggest you read [https://bb.oolite.space/viewtopic.php?t=6173 this Bulletin Board thread] before you commence though, it may save you a lot of hair-tearing!}}<br />
<br />
<br />
{{FAQ|question=Can the range of hyperspace jumps/my fuel capacity be increased?|answer=No. Jump range in Oolite is hard-coded for a reason. The game would become less challenging and thus less fun. (Although I can imagine hacks that give unlimited fuel.) And don't forget that there are already various ways of refuelling while you are in flight.}}<br />
<br />
<br />
{{FAQ|question=I want Laser Cooling Boosters!|answer=There are none at the moment and the reason is simple. It would unbalance the game too much. If they were available for the player only, things would get too easy. And if the NPCs could get them, too, things would get too hard. It's all about maintaining a reasonable balance. So the ultimate advice on this is: aim carefully; don't waste your laser fire; prevent overheating.}}<br />
<br />
<br />
{{FAQ|question=The other day I got killed when I launched from a Behemoth/Carrier/whatever, and all the profits/kills that I made before were gone. Why couldn't I save there? Why only on main stations or Rock Hermits?|answer=First of all, congratulations to you for having internalized the ''Golden Rule'': save early, save often! There are some limitations in Oolite about where you can save and load a commander from. In the core game (ie, a game with no OXP's installed), that's main stations and Rock Hermits. When it comes to OXP stations, many of them will now allow for saving and loading of game files. But some OXP stations, particularly older ones or carriers that will actively move around in the system, won't have this ability. That's because they aren't 'fixed' objects in space, and they, along with the rest of the system, are populated anew each time you load a game. So chances are that the Behemoth you docked with when saving simply wouldn't exist when you load again, and you would find yourself in nirvana instead of in a safe haven. To prevent odd behavior like this, saving and loading is prohibited anywhere other than in a main station or at Rock Hermits. Some station OXP's will now allow you to save at their location. Alternatively you could install [[Save_Anywhere | Save Anywhere.oxp]], which does exactly what it says on the tin. Note, however, that it is still in beta state so read the documentation first.}}<br />
<br />
<br />
{{FAQ|question=I would like to switch between different ships of mine, e.g. have a nice racer for the weekends, meanwhile leave my freighter docked somewhere and take it back on Monday. Why can't I do this?|answer=It is possible for OXPs to provide this facility in 1.77 or later versions. Check the [[OXP_List|OXP List]] or ask on the forum to find one that suits you.}}<br />
<br />
== Known Issues / Bugs ==<br />
<br />
{{FAQ|question=I am running Oolite on Windows Vista/7 and have installed the game in C:\Program Files\Oolite. I cannot find my saved games, log files, game preferences .GNUstepDefaults file and/or any saved screenshots, although I can see the saved games in the game and use them normally. Where are my files?|answer=You are experiencing file virtualization under Windows. Any application installed in %programfiles%, %systemroot%, %systemdrive% or %programdata that writes files under its folder structure is subject to this. As per Microsoft Support's article KB927387, the resolution for finding your files again is using one of the following methods:<br />
•Click the Compatibility Files button that appears on the Explorer bar to view virtualized files in the folder. The Compatibility Files button appears only if there are virtualized files in the folder.<br />
<br />
•Look in the C:\Users\User_name\AppData\Local\VirtualStore folder to locate files and folders. <br />
<br />
•Save your application's data in a folder under your user profile.}}<br />
<br />
== System Requirements ==<br />
<br />
{{FAQ|question=Does it work on Mac OS X 10.2 (Jaguar) & 10.3 (Panther)?|answer=Sadly, no. The minimum OS requirement for Oolite on the Mac is now Mac OS X 10.4. The previous stable version (1.65) is however compatible with Mac OS X 10.3.9 but no longer works with (for example) Mac OS X 10.15.3}}<br />
<br />
<br />
{{FAQ|question=Does it work on both Intel and PPC Macs?|answer=Yes, since 1.65 Oolite has been Universal Binary. It was PPC only in previous (antiquated) versions.}}<br />
<br />
<br />
{{FAQ|question=What's the latest version?|answer=The last stable release is 1.90. The last stable and latest test versions can be downloaded from [https://oolite.space/download Oolite's homepage]. More information can be found through the [https://bb.oolite.space/viewforum.php?f=1 Oolite forums].}}<br />
<br />
<br />
{{FAQ|question=Is there a port for the PC or Linux?|answer=Yes. Both ports are stable and are at the same level of development as Oolite for the Mac. You can download Oolite for Windows and for Linux PCs from [https://oolite.space/download Oolite's homepage] (click on "show all platforms" if you can't see the version you're looking for). Information on test releases can be found through the Oolite forums, for the [https://bb.oolite.space/viewforum.php?f=9 Linux version], and for the [https://bb.oolite.space/viewforum.php?f=8 Windows version].}}<br />
<br />
== Writing OXPs ==<br />
<br />
{{FAQ|question=I would like to contribute to Oolite and write my own OXP, but unfortunately my knowledge in scripting/programming is limited. How can I get started?|answer=First of all the Oolite community welcomes all efforts to enhance and enrich their favorite game, so be our guest! Many of us have started with very little knowledge, but over time were able to write and release astonishing OXPs, so why shouldn't you? Anyway, scripting can be learned. Currently there are two scripting languages in use for Oolite, plist-scripting (sometimes referred to as legacy-scripting) and JavaScript. For any serious OXP-plans you will have to learn them. A general starting point is the [http://wiki.alioth.net/index.php/OXP_howto OXP howto]-page, which will link you to further documentation. For plist-scripting you should read the [http://wiki.alioth.net/index.php/OXP_howto_plist OXP howto plist]-page, and also the [http://wiki.alioth.net/index.php/Property_list Property list]-intro. Information on the ongoing implementation of scripting with JavaScript can be found in the [http://wiki.alioth.net/index.php/Category:Oolite_scripting Category page for scripting] (work in progress). If you want to design a new ship, you should have a look at the [http://wiki.alioth.net/index.php/OXP_howto_model OXP howto model]-page and the [http://wiki.alioth.net/index.php/OXP_howto_texture OXP howto texture]-page. And if you want to give it a behavior of its own, you should consult the [http://wiki.alioth.net/index.php/OXP_howto_AI OXP howto AI]-page. I suggest you try to read and understand these first. If you still have questions afterwards, there is always the [https://bb.oolite.space/index.php Oolite Bulletin Board], where lots of friendly people usually are very willing to lend a helping hand and to answer lots of questions.}}<br />
<br />
<br />
{{FAQ|question=I want to write an OXP or add content to the Wiki, but some (or all) of the content was written by another author. What copyright issues do I face?|answer=Anything submitted to the Wiki is on the basis that anyone else may edit or fiddle with it. OXPs are submitted under the creative commons licence. The author (strictly speaking) owns the copyright, but licenses users to use or distribute the OXP as long as they don't sell or charge for it. In practice virtually all OXP authors don't assert copyright and are pleased and flattered that somebody thinks their stuff is worth writing about or pinching to use in another OXP (it is good manners to credit the original author in the readme though). I expect the author will be pleased if you want to add some background, but if you are in doubt, send him or her a PM asking him for permission. At the end of the day, Oolite is a fun project and everybody is doing stuff for it on that basis. (nicked wholesale from [https://bb.oolite.space/viewtopic.php?p=44813#44813 Little_Bear's] post on the [https://bb.oolite.space/index.php Oolite Bulletin Board])}}<br />
<br />
== Diagnosing Problems ==<br />
<br />
{{FAQ|question=Someone asked me for my log file. What is that, and where is it?|answer=While Oolite runs, various diagnostic information is written to a file called [[Latest.log]]. Where it is depends on your operating system:<br />
* '''Mac OS X''': Restart Oolite, and select “Show Previous Log” from the “'''Oolite'''” menu in the menu bar. Alternatively, in the Finder, select “Go to Folder…” from the Go menu, and enter “~/Library/Logs/Oolite/”, and find Latest.log.<br />
* '''Windows''': in Oolite’s folder (typically in C:\''Oolite''), there is a folder called ''oolite.app'', which contains a folder called ''Logs''. A shortcut to this folder is created at Oolite's Start Menu entries during installation. If you have installed the game in a folder subject to file virtualization like C:\Program Files\Oolite and encounter difficulty in locating the log files, then please refer to the Known Issues section of this FAQ for information on how to access them.<br />
* '''Linux and other Unix-like systems''': ~/.Oolite/Logs (that is, in the hidden folder ''.Oolite'' in your home folder). If you’re using Nautilus or Konqueror—if you’ve never heard of them, you probably are—select Show Hidden Files from the View menu.}}<br />
<br />
<br />
{{FAQ|question=Why do none of the OXPs I have installed appear to work in the game?|answer=Check you do not have Oolite in 'Strict Play' mode. When docked or paused press F2 and if it says 'Reset to Unrestricted Play' then OXPs will not work. It needs to say 'Reset to Strict Play'. Alternately perhaps you downloaded and extracted an OXP straight to the "add ons" file. Without then checking that the file ending ".oxp" is moved up from any subdirectory folders to the "add ons" folder itself, as Oolite simply ignores folders etc not ending in .OXP in "add ons"}}<br />
<br />
== Other Questions ==<br />
<br />
{{FAQ|question=I have a question not answered here, where can I get help?|answer=Try one of these:<br />
*Post your queries onto [https://bb.oolite.space/index.php the friendliest board this side of Riedquat™]. Satisfaction is not guaranteed, but then what is, in this mixed-up universe? Help keep the board friendly by making sure your question isn't already answered here!<br />
*Check [[How do I ...]] a collection of Help and guide pages on this wiki.<br />
*If you want to report a bug, please read [https://bb.oolite.space/viewtopic.php?t=3778 this]. Yes, all that work is a drag, but if nobody reports the bug it probably won’t get fixed.<br />
*Or join us in #oolite, or #oolite-dev if you're working on Oolite or OXPs, on irc.oftc.net or ipv6.oftc.net.}}<br />
<br />
<br />
[[Category:Oolite]][[Category:Help pages]]</div>Another commanderhttps://wiki.alioth.net/index.php?title=HDR&diff=84494HDR2024-09-23T18:00:40Z<p>Another commander: </p>
<hr />
<div>High Dynamic Range (advanced video display - currently only available for Windows platforms)<br />
<br />
== Overview ==<br />
The current Windows Pre-releases/"nightlies" now support HDR signal output. They can be downloaded from the very bottom of the [https://oolite.space/#download Downloads page] or directly from GitHub, [https://github.com/OoliteProject/oolite/releases here].<br />
<br />
If you have a compatible monitor or TV you can now enjoy vivid, bright and high contrast colors that seem to pop right out of your screen, while maintaining full image details in both highlights and dark areas. Furthermore, colors in HDR mode are 10-bit per RGB component as opposed to 8-bit in SDR and can now exceed the standard Rec709 color space and go well into the DCI-P3 and BT2020 color spaces (see [https://www.benq.com/en-us/business/resource/trends/understanding-color-gamut.html?srsltid=AfmBOop1EleuJqvrAjiH9WEG7rcuOJmG54hUicbStmP8IQK9JSnicLJv here] for more), creating an even more impressive visual experience with 1.07 billion color hues available to you rather than the 16.7 million available in SDR.<br />
<br />
Fine gameplay moments in HDR can be captured in either OpenEXR (.exr) or Radiance RGBE (.hdr) format using the standard Oolite save snapshot key. You can view OpenEXR and Radiance RGBE files at a later time using software like Windows HDR+WCG Viewer (available from the Microsoft Store for free) or the also free and very powerful HDR image viewer utility, [https://cdn.discordapp.com/attachments/792979353117524009/1277053487368241325/SKIV.exe?ex=66cc6cfd&is=66cb1b7d&hm=417a59e377398a4e2d8e12b446dc8881f9498bd21538f2a89e0411ec8e78c3c5& SKIV].<br />
<br />
This has been implemented by our Developer, [[User:Another commander|Another commander]] (who also greatly improved visuals in Oolite versions 1.86, 1.88 & 1.90).<br />
<br />
=== Note ===<br />
Because the changes only affect the display on a HDR screen, there is no way of displaying the improvements on an older SDR screen!<br />
<br />
<br />
<br />
== How to Enable Oolite's HDR Mode ==<br />
After installing the game, a new shortcut will be added to the Start menu group for the game under Windows. Those who use the nightly installers will notice this new icon under the group "Oolite":<br />
<br />
[[file:OoliteHDRIcon.png|200px]]<br />
<br />
You can now use it to launch the game in HDR. Alternatively, you can launch Oolite from a console or the Windows Run dialog using <pre>C:\path\to\game\oolite.app\oolite.exe -hdr</pre><br />
<br />
As a reminder, to be able to run the game in this mode you need:<br />
* Windows 10 or 11 (11 is strongly recommended).<br />
* A monitor that supports HDR output. An OLED monitor or TV is <u>strongly</u> recommended.<br />
* Graphics card that supports HDR, like 10xx NVidia series or higher spec.<br />
* HDMI 2.1 / DisplayPort 1.4 or higher spec cable, so that the HDR bandwidth requirement is satisfied.<br />
* Enabling of HDR in Windows from the Settings -> System -> Display. If your system does not support HDR for whatever reason you will not have the option to enable it.<br />
[[File:OoliteHowToActivateHDRinWindows.png]]<br />
<br />
Attempting to launch the game in HDR mode without satisfying the above requirements will trigger a warning dialog informing the user that it was not possible to detect HDR on the system and asking whether the user would like to proceed with the game rendering as HDR in a non-suitable environment (i.e. looking weird) or abort.<br />
<br />
[[File:OoliteStartInHDRWithoutHDREnabled.jpg|320px]]<br />
<br />
<br />
== Calibration ==<br />
To obtain the most out of your HDR experience, you will have to calibrate the game to generate a display signal suitable for your monitor or TV. Oolite's Game Options menu is slightly different when the game is run in HDR mode, meaning that it has two options not normally appearing in the default menu: HDR Max Brightness and HDR Paper White. The menu in HDR mode will look as seen in the screen below:<br />
[[file:OoliteHDRMenu.png|1000px]]<br />
<br />
By default HDR Max Brightness is set to 1000 nits (or cd/m2) and HDR Paper White is set to 200 nits. You must adjust those values to match your display. At this moment Oolite does not feature an HDR calibration screen so you should get the Max Brightness information for your display from either the manufacturer's website or by running the Windows HDR Calibration utility (available for Windows 11 at the Microsoft Store for free).<br />
<br />
HDR Max Brightness can be set to 400, 500, 600, 800 and 1000 nits, but you can also edit descriptions.plist in your game install and add other values if you want - the game will accept them and use them. To add max brightness values, if so desired, open oolite.app/Resources/descriptions.plist in a text editor (backup the original file first just in case), find the block <pre>hdr_maxBrightness_array =<br />
(<br />
400, 500, 600, 800, 1000<br />
);</pre>and insert your new value in the row with the numbers, making sure it is separated by commas from the rest. Please note that <b>the values of 400 and 1000 nits are in-game limits</b> and <u>any value above or below those limits will either be ignored or result in unexpected behavior, depending on where in the array it is inserted</u>. Save and restart the game with Shift down to enable the edit and you should now have the extra option available. It is important that this value matches as closely as possible the actual max brightness your display can output.<br />
<br />
HDR Paper White indicates how bright a pure diffuse white object will be. You can think of it as a generic brightness slider. The higher you set it, the less headroom for highlights you leave. As a rule of thumb this can be set to about 1/4 of the max brightness, but it is entirely up to you to decide. You can set it to whatever feels comfortable to you. The range of this slider is from 80 to 280 nits.<br />
<br />
Once those are set to their correct / preferred values, you are ready for the HDR experience. The game is still playable even if you skip the calibration step, but the image might look off or clipped, so best if you don't skip it. Be advised that HDR has been designed for low lighting environments, so you should avoid brightly lit rooms when playing for best results.<br />
<br />
<br />
== Choosing Your Preferred HDR Screenshot Format ==<br />
The default HDR screenshot format is OpenEXR. It is chosen for its impressive accuracy and ability to display colors in all color spaces used for HDR displays (Rec709, DCI-P3 and BT2020). Be advised that .exr files can be big though, depending on the image content. If you do not care that much about precise representation of what was on your screen at the time of capture and prefer having smaller size files that can maybe be easier to share online, you can switch the HDR snapshot output format to Radiance RGBE. To do that, make a backup of the file <code><OoliteInstallDir>\oolite.app\GNUstep\Defaults\.GNUstepDefaults</code>, then open it in a text editor and add:<br />
<pre>"hdr-snapshot-format" = .hdr;</pre><br />
The leading dot is optional, Oolite will understand the extension with or without it. If you enter any random string other than the allowed "[.]hdr" and "[.]exr", a warning will be posted in the log and .exr will be selected by default anyway. Save the file and that's it.<br />
<br />
<br />
== Links ==<br />
*[https://bb.oolite.space/viewtopic.php?t=21311 Oolite on HDR Displays] (2022 - date) - this BB thread has the current information<br />
*[https://support.microsoft.com/en-us/windows/calibrate-your-hdr-display-using-the-windows-hdr-calibration-app-f30f4809-3369-43e4-9b02-9eabebd23f19 Windows 11 HDR Calibration App on Microsoft Support]<br />
<br />
[[Category:Oolite]] [[Category:Help pages]]<br />
[[Category:Factual]]</div>Another commanderhttps://wiki.alioth.net/index.php?title=HDR&diff=84474HDR2024-09-20T11:22:01Z<p>Another commander: </p>
<hr />
<div>High Dynamic Range (advanced video display - currently only available for Windows platforms)<br />
<br />
== Overview ==<br />
The current Windows Pre-releases/"nightlies" now support HDR signal output. They can be downloaded from the very bottom of the [https://oolite.space/#download Downloads page] or directly from GitHub, [https://github.com/OoliteProject/oolite/releases here].<br />
<br />
If you have a compatible monitor or TV you can now enjoy vivid, bright and high contrast colors that seem to pop right out of your screen, while maintaining full image details in both highlights and dark areas. Furthermore, colors in HDR mode are 10-bit per RGB component as opposed to 8-bit in SDR and can now exceed the standard Rec709 color space and go well into the DCI-P3 and BT2020 color spaces (see [https://www.benq.com/en-us/business/resource/trends/understanding-color-gamut.html?srsltid=AfmBOop1EleuJqvrAjiH9WEG7rcuOJmG54hUicbStmP8IQK9JSnicLJv here] for more), creating an even more impressive visual experience with 1.07 billion color hues available to you rather than the 16.7 million available in SDR.<br />
<br />
Fine gameplay moments in HDR can be captured in either OpenEXR (.exr) or Radiance RGBE (.hdr) format using the standard Oolite save snapshot key. You can view OpenEXR and Radiance RGBE files at a later time using software like Windows HDR+WCG Viewer (available from the Microsoft Store for free) or the also free and very powerful HDR image viewer utility, [https://cdn.discordapp.com/attachments/792979353117524009/1277053487368241325/SKIV.exe?ex=66cc6cfd&is=66cb1b7d&hm=417a59e377398a4e2d8e12b446dc8881f9498bd21538f2a89e0411ec8e78c3c5& SKIV].<br />
<br />
This has been implemented by our Developer, [[User:Another commander|Another commander]] (who also greatly improved visuals in Oolite versions 1.86, 1.88 & 1.90).<br />
<br />
=== Note ===<br />
Because the changes only affect the display on a HDR screen, there is no way of displaying the improvements on an older SDR screen!<br />
<br />
<br />
<br />
== How to Enable Oolite's HDR Mode ==<br />
After installing the game, a new shortcut will be added to the Start menu group for the game under Windows. Those who use the nightly installers will notice this new icon under the group "Oolite":<br />
<br />
[[file:OoliteHDRIcon.png|200px]]<br />
<br />
You can now use it to launch the game in HDR. Alternatively, you can launch Oolite from a console or the Windows Run dialog using <pre>C:\path\to\game\oolite.app\oolite.exe -hdr</pre><br />
<br />
As a reminder, to be able to run the game in this mode you need:<br />
* Windows 10 or 11 (11 is strongly recommended).<br />
* A monitor that supports HDR output. An OLED monitor or TV is <u>strongly</u> recommended.<br />
* Graphics card that supports HDR, like 10xx NVidia series or higher spec.<br />
* HDMI 2.1 / DisplayPort 1.4 or higher spec cable, so that the HDR bandwidth requirement is satisfied.<br />
* Enabling of HDR in Windows from the Settings -> System -> Display. If your system does not support HDR for whatever reason you will not have the option to enable it.<br />
[[File:OoliteHowToActivateHDRinWindows.png]]<br />
<br />
Attempting to launch the game in HDR mode without satisfying the above requirements will trigger a warning dialog informing the user that it was not possible to detect HDR on the system and asking whether the user would like to proceed with the game rendering as HDR in a non-suitable environment (i.e. looking weird) or abort.<br />
<br />
[[File:OoliteStartInHDRWithoutHDREnabled.jpg|320px]]<br />
<br />
<br />
== Calibration ==<br />
To obtain the most out of your HDR experience, you will have to calibrate the game to generate a display signal suitable for your monitor or TV. Oolite's Game Options menu is slightly different when the game is run in HDR mode, meaning that it has two options not normally appearing in the default menu: HDR Max Brightness and HDR Paper White. The menu in HDR mode will look as seen in the screen below:<br />
[[file:OoliteHDRMenu.png|1000px]]<br />
<br />
By default HDR Max Brightness is set to 1000 nits (or cd/m2) and HDR Paper White is set to 200 nits. You must adjust those values to match your display. At this moment Oolite does not feature an HDR calibration screen so you should get the Max Brightness information for your display from either the manufacturer's website or by running the Windows HDR Calibration utility (available for Windows 11 at the Microsoft Store for free).<br />
<br />
HDR Max Brightness can be set to 400, 500, 600, 800 and 1000 nits, but you can also edit descriptions.plist in your game install and add other values if you want - the game will accept them and use them. To add max brightness values, if so desired, open oolite.app/Resources/descriptions.plist in a text editor (backup the original file first just in case), find the block <pre>hdr_maxBrightness_array =<br />
(<br />
400, 500, 600, 800, 1000<br />
);</pre>and insert your new value in the row with the numbers, making sure it is separated by commas from the rest. Please note that <b>the values of 400 and 1000 nits are in-game limits</b> and <u>any value above or below those limits will either be ignored or result in unexpected behavior, depending on where in the array it is inserted</u>. Save and restart the game with Shift down to enable the edit and you should now have the extra option available. It is important that this value matches as closely as possible the actual max brightness your display can output for a <b>10% screen coverage window</b>.<br />
<br />
HDR Paper White indicates how bright a pure diffuse white object will be. You can think of it as a generic brightness slider. The higher you set it, the less headroom for highlights you leave. As a rule of thumb this can be set to about 1/4 of the max brightness, but it is entirely up to you to decide. You can set it to whatever feels comfortable to you. The range of this slider is from 80 to 280 nits.<br />
<br />
Once those are set to their correct / preferred values, you are ready for the HDR experience. The game is still playable even if you skip the calibration step, but the image might look off or clipped, so best if you don't skip it. Be advised that HDR has been designed for low lighting environments, so you should avoid brightly lit rooms when playing for best results.<br />
<br />
<br />
== Choosing Your Preferred HDR Screenshot Format ==<br />
The default HDR screenshot format is OpenEXR. It is chosen for its impressive accuracy and ability to display colors in all color spaces used for HDR displays (Rec709, DCI-P3 and BT2020). Be advised that .exr files can be big though, depending on the image content. If you do not care that much about precise representation of what was on your screen at the time of capture and prefer having smaller size files that can maybe be easier to share online, you can switch the HDR snapshot output format to Radiance RGBE. To do that, make a backup of the file <code><OoliteInstallDir>\oolite.app\GNUstep\Defaults\.GNUstepDefaults</code>, then open it in a text editor and add:<br />
<pre>"hdr-snapshot-format" = .hdr;</pre><br />
The leading dot is optional, Oolite will understand the extension with or without it. If you enter any random string other than the allowed "[.]hdr" and "[.]exr", a warning will be posted in the log and .exr will be selected by default anyway. Save the file and that's it.<br />
<br />
<br />
== Links ==<br />
*[https://bb.oolite.space/viewtopic.php?t=21311 Oolite on HDR Displays] (2022 - date) - this BB thread has the current information<br />
*[https://support.microsoft.com/en-us/windows/calibrate-your-hdr-display-using-the-windows-hdr-calibration-app-f30f4809-3369-43e4-9b02-9eabebd23f19 Windows 11 HDR Calibration App on Microsoft Support]<br />
<br />
[[Category:Oolite]] [[Category:Help pages]]<br />
[[Category:Factual]]</div>Another commanderhttps://wiki.alioth.net/index.php?title=HDR&diff=84473HDR2024-09-20T11:10:12Z<p>Another commander: </p>
<hr />
<div>High Dynamic Range (advanced video display - currently only available for Windows platforms)<br />
<br />
== Overview ==<br />
The current Windows Pre-releases/"nightlies" now support HDR signal output. They can be downloaded from the very bottom of the [https://oolite.space/#download Downloads page] or directly from GitHub, [https://github.com/OoliteProject/oolite/releases here].<br />
<br />
If you have a compatible monitor or TV you can now enjoy vivid, bright and high contrast colors that seem to pop right out of your screen, while maintaining full image details in both highlights and dark areas. Furthermore, colors in HDR mode are 10-bit per RGB component as opposed to 8-bit in SDR and can now exceed the standard Rec709 color space and go well into the DCI-P3 and BT2020 color spaces (see [https://www.benq.com/en-us/business/resource/trends/understanding-color-gamut.html?srsltid=AfmBOop1EleuJqvrAjiH9WEG7rcuOJmG54hUicbStmP8IQK9JSnicLJv here] for more), creating an even more impressive visual experience with 1.07 billion color hues available to you rather than the 16.7 million available in SDR.<br />
<br />
Fine gameplay moments in HDR can be captured in either OpenEXR (.exr) or Radiance RGBE (.hdr) format using the standard Oolite save snapshot key. You can view OpenEXR and Radiance RGBE files at a later time using software like Windows HDR+WCG Viewer (available from the Microsoft Store for free) or the also free and very powerful HDR image viewer utility, [https://cdn.discordapp.com/attachments/792979353117524009/1277053487368241325/SKIV.exe?ex=66cc6cfd&is=66cb1b7d&hm=417a59e377398a4e2d8e12b446dc8881f9498bd21538f2a89e0411ec8e78c3c5& SKIV].<br />
<br />
This has been implemented by our Developer, [[User:Another commander|Another commander]] (who also greatly improved visuals in Oolite versions 1.86, 1.88 & 1.90).<br />
<br />
=== Note ===<br />
Because the changes only affect the display on a HDR screen, there is no way of displaying the improvements on an older SDR screen!<br />
<br />
<br />
<br />
== How to Enable Oolite's HDR Mode ==<br />
After installing the game, a new shortcut will be added to the Start menu group for the game under Windows. Those who use the nightly installers will notice this new icon under the group "Oolite":<br />
<br />
[[file:OoliteHDRIcon.png|200px]]<br />
<br />
You can now use it to launch the game in HDR. Alternatively, you can launch Oolite from a console or the Windows Run dialog using <pre>C:\path\to\game\oolite.app\oolite.exe -hdr</pre><br />
<br />
As a reminder, to be able to run the game in this mode you need:<br />
* Windows 10 or 11 (11 is strongly recommended).<br />
* A monitor that supports HDR output. An OLED monitor or TV is <u>strongly</u> recommended.<br />
* Graphics card that supports HDR, like 10xx NVidia series or higher spec.<br />
* HDMI 2.1 / DisplayPort 1.4 or higher spec cable, so that the HDR bandwidth requirement is satisfied.<br />
* Enabling of HDR in Windows from the Settings -> System -> Display. If your system does not support HDR for whatever reason you will not have the option to enable it.<br />
[[File:OoliteHowToActivateHDRinWindows.png]]<br />
<br />
Attempting to launch the game in HDR mode without satisfying the above requirements will trigger a warning dialog informing the user that it was not possible to detect HDR on the system and asking whether the user would like to proceed with the game rendering as HDR in a non-suitable environment (i.e. looking weird) or abort.<br />
<br />
[[File:OoliteStartInHDRWithoutHDREnabled.jpg|320px]]<br />
<br />
<br />
== Calibration ==<br />
To obtain the most out of your HDR experience, you will have to calibrate the game to generate a display signal suitable for your monitor or TV. Oolite's Game Options menu is slightly different when the game is run in HDR mode, meaning that it has two options not normally appearing in the default menu: HDR Max Brightness and HDR Paper White. The menu in HDR mode will look as seen in the screen below:<br />
[[file:OoliteHDRMenu.png|1000px]]<br />
<br />
By default HDR Max Brightness is set to 1000 nits (or cd/m2) and HDR Paper White is set to 200 nits. You must adjust those values to match your display. At this moment Oolite does not feature an HDR calibration screen so you should get the Max Brightness information for your display from either the manufacturer's website or by running the Windows HDR Calibration utility (available for Windows 11 at the Microsoft Store for free).<br />
<br />
HDR Max Brightness can be set to 400, 500, 600, 800 and 1000 nits, but you can also edit descriptions.plist in your game install and add other values if you want - the game will accept them and use them. To add max brightness values, if so desired, open oolite.app/Resources/descriptions.plist in a text editor (backup the original file first just in case), find the block <pre>hdr_maxBrightness_array =<br />
(<br />
400, 500, 600, 800, 1000<br />
);</pre>and insert your new value in the row with the numbers, making sure it is separated by commas from the rest. Please note that <b>the values of 400 and 1000 nits are in-game limits</b> and <u>any value above or below those limits will either be ignored or result in unexpected behavior, depending on where in the array it is inserted</u>. Save and restart the game with Shift down to enable the edit and you should now have the extra option available. It is important that this value matches as closely as possible the actual max brightness your display can output for a <b>10% screen coverage window</b>.<br />
<br />
HDR Paper White indicates how bright a pure diffuse white object will be. You can think of it as a generic brightness slider. The higher you set it, the less headroom for highlights you leave. As a rule of thumb this can be set to about 1/4 of the max brightness, but it is entirely up to you to decide. You can set it to whatever feels comfortable to you. The range of this slider is from 80 to 280 nits.<br />
<br />
Once those are set to their correct / preferred values, you are ready for the HDR experience. The game is still playable even if you skip the calibration step, but the image might look off or clipped, so best if you don't skip it. Be advised that HDR has been designed for low lighting environments, so you should avoid brightly lit rooms when playing for best results.<br />
<br />
<br />
== Choosing Your Preferred HDR Screenshot Format ==<br />
The default HDR screenshot format is OpenEXR. It is chosen for its impressive accuracy and ability to display colors in all color spaces used for HDR displays (Rec709, DCI-P3 and BT2020). Be advised that .exr files can be big though, depending on the image content. If you do not care that much about precise representation of what was on your screen at the time of capture and prefer having smaller size files that can maybe be easier to share online, you can switch the HDR snapshot output format to Radiance RGBE. Do do that, make a backup of the file <code><OoliteInstallDir>\oolite.app\GNUstep\Defaults\.GNUstepDefaults</code>, then open it in a text editor and add:<br />
<pre>"hdr-snapshot-format" = .hdr;</pre><br />
The leading dot is optional, Oolite will understand the extension with or without it. If you enter any random string other than the allowed "[.]hdr" and "[.]exr", a warning will be posted in the log and .exr will be selected by default anyway. Save the file and that's it.<br />
<br />
<br />
== Links ==<br />
*[https://bb.oolite.space/viewtopic.php?t=21311 Oolite on HDR Displays] (2022 - date) - this BB thread has the current information<br />
*[https://support.microsoft.com/en-us/windows/calibrate-your-hdr-display-using-the-windows-hdr-calibration-app-f30f4809-3369-43e4-9b02-9eabebd23f19 Windows 11 HDR Calibration App on Microsoft Support]<br />
<br />
[[Category:Oolite]] [[Category:Help pages]]<br />
[[Category:Factual]]</div>Another commanderhttps://wiki.alioth.net/index.php?title=Compiling_on_Windows&diff=84462Compiling on Windows2024-09-13T10:20:42Z<p>Another commander: </p>
<hr />
<div>To successfully compile Oolite on Windows some prerequisites are necessary.<br />
<br />
* You need to have the 'development environment' installed. <br />
* You need to have the Oolite project including submodules checked out. <br />
* You need to set environment variables, then run the makefile.<br />
<br />
All this is nicely scripted in the Github Actions workflow at https://github.com/OoliteProject/oolite/blob/master/.github/workflows/build-all.yml#L130<br />
<br />
<br />
<b>Complete instructions on compiling the Windows port of Oolite can be found [[Developing Oolite#On_Windows_2 | here]].</b></div>Another commanderhttps://wiki.alioth.net/index.php?title=Developing_Oolite&diff=84461Developing Oolite2024-09-13T10:07:20Z<p>Another commander: /* Current way to do it */</p>
<hr />
<div>= Overview =<br />
<br />
This page intends to allow you to setup an environment to develop Oolite.<br />
<br />
== Before you begin ==<br />
<br />
If you do not know Objective C, see [https://bb.oolite.space/viewtopic.php?f=7&t=10525 I want to help develop Oolite] (2011).<br />
<br />
== Cloning or forking? ==<br />
<br />
When developing software, each little modification is tracked independently and assigned a version identifier.<br />
That's called [http://en.wikipedia.com/Software_versioning versioning].<br />
To do this, we use the [http://en.wikipedia.com/Git_(software) git] software.<br />
We used to use a svn repository, but this one isn't maintained anymore.<br />
<br />
It is possible either to fork (create a copy of) your own branch on github, or to only clone locally the master branch.<br />
In both cases, you can hack, try, do whatever takes your fancy :-)<br />
But to have your changes integrated back into the main Oolite, it is easier to setup your own branch. Luckily, you can do this at the end when you are ready to propose your code too.<br />
<br />
== Installing git ==<br />
<br />
We need git for this. <br />
<br />
=== On Linux ===<br />
<br />
Installing git depends on your distribution. For ubuntu:<br />
<code>sudo apt-get install git</code><br />
<br />
= Getting the code by cloning the master branch =<br />
<br />
The Oolite source is available from github. First do<br />
<br />
<code> git clone https://github.com/OoliteProject/oolite </code><br />
<br />
to retrieve. Then, in the directory this creates, do<br />
<br />
<code> git submodule update --init</code><br />
<br />
to pull in various other components such as dependencies, binary resources, and so on. The old SVN repository is no longer being updated.<br />
<br />
Et voila! You've got the source ready to be compiled and/or tweaked.<br />
<br />
= Getting the code by forking your own branch (alternative to cloning the master branch) =<br />
<br />
The Oolite code is hosted on a git-friendly repository: github.<br />
<br />
== Creating a GitHub account ==<br />
<br />
Go to https://github.com/ and create an account.<br />
<br />
== Creating a branch on GitHub ==<br />
<br />
Fork the [https://github.com/OoliteProject/oolite oolite main branch].<br />
<br />
== Fetching your branch ==<br />
<br />
We now repatriate the code locally: we fetch it.<br />
<br />
=== On Linux ===<br />
<br />
<code>git fetch --help</code><br />
<br />
= Documentation =<br />
<br />
The documentation is automatically generated from the source code.<br />
When generated, it's 700mb heavy !<br />
<br />
This documentation is automatically generated on Github whenever the repository changes. The result is published as one of the build artifacts that you can download locally. The latest version is also published on https://ooliteproject.github.io/oolite/.<br />
<br />
== Pre-requisites ==<br />
<br />
Installing Doxygen<br />
<br />
=== On Linux ===<br />
<br />
It depends on your distribution. For Ubuntu:<br />
<code>sudo apt-get install doxygen</code><br />
<br />
=== On Windows ===<br />
<br />
You can download Doxygen binaries from the [https://www.doxygen.nl/download.html ''project's home page''].<br />
<br />
== Generation ==<br />
<br />
The documentation is generated into a html sub-directory.<br />
<br />
=== On Linux & Windows ===<br />
<br />
Just go into your oolite directory and do:<br />
<br />
<code>doxygen Doxyfile</code><br />
Note that this will generate the Mac source documentation by default. For Linux and Windows, you will also have to pass the appropriate defines (e.g. OOLITE_WINDOWS, OOLITE_SDL etc.) to Doxygen.<br />
<br />
If you don't want to install Doxygen and generate it yourself you can download the documentation from Github, or browse it directly on https://ooliteproject.github.io/oolite/.<br />
<br />
= Setting up your development environment =<br />
<br />
== On Linux ==<br />
<br />
Do as you wish :-)<br />
<br />
I use vim + youcompleteme.<br />
<br />
There's no IDE on linux managing objective-c (at least not Eclipse and Intellij).<br />
Auto-completion doesn't work in most of them because the xCode libraries aren't available (they're on OS X).<br />
<br />
The only plugin for objective-c on eclipse is discontinued.<br />
<br />
You can see the call hierarchy in the doxygen documentation at https://ooliteproject.github.io/oolite/<br />
<br />
Some use Emacs.<br />
<br />
= Building =<br />
== On AppleMac ==<br />
At time of writing (Dec 2023), this is impossible with current versions. But see [[Running Oolite-Mac]] for what used to work.<br />
<br />
== On Windows ==<br />
=== Current way to do it ===<br />
<br />
''Let's hear the wise words of another_commander (Updated 18th April 2023)''<br />
<br />
Seeing that, despite the quite comprehensive wiki instructions on how to make an Oolite executable, building from source on Windows is still a quite complicated matter, I have created a package that will hopefully simplify the process a lot and allow even the relatively inexperienced users to have a razor bleeding edge version of the game to play with and test. Please note that bleeding edge versions may cause spontaneous combustion of your computer, so you use them at own risk.<br />
<br />
<br />
The download link to the Oolite Development Environment - Light Edition is this:<br />
https://drive.google.com/file/d/1u1IvBxiQjNvtrFs_2POaRP3IZhAi46N0/view?usp=sharing<br />
The package contains the Objective-C compiler plus Posix environment (MinGW/MSYS), the Git package version 2.16.2 required for checking out and updating the source code and the required gnustep-base 1.20.1 files. No other downloads will be required. <br />
<br />
Alternatively, you can use the same Development Environment we deploy on github to produce the Windows nightly pre-release builds. This is guaranteed to always be the most recent and updated version, but it is a significantly bigger download. You can get it from https://github.com/OoliteProject/oolite-windows-build-env/releases/download/latest/DevelopmentEnvironment.zip<br />
<br />
<br />
Instructions on how to build an Oolite trunk executable from zero:<br />
<br />
<br />
Download the environment and unzip it to a folder of your choice. IMPORTANT: The zip file you downloaded must be decompressed maintaining the folders' path structure, check your unzip program's documentation if you are not sure how to do this. Also note that in the unlikely case that your system is using drive letter O:, you will need to edit the files msys_x2/1.0/msys.bat and msys_x2/1.0/etc/fstab and change the references to o: to an unused drive letter. MORE IMPORTANT: Do not install this in a path containing spaces. We have had cases where the environment failed to work when installed in locations such as My Documents, Program Files etc.<br />
<br />
<br />
Once unzipped, you must run the msys.bat file, found in <RootOfWhereTheEnvironmentWasInstalled>\msys_x2\1.0. You can create a shortcut to desktop for this file if you want. Once run, the environment will start up.<br />
<br />
<br />
Important note: The latest development environment is by default configured for building the 64-bit version of the game, but it contains all files necessary for building the 32-bit flavor as well. To switch to the 32-bit version of the compiler, you need to navigate to the folder Msys_x2/1.0 and rename the following folders like this:<br />
1) Devlibs -> Devlibs64<br />
2) Mingw -> Mingw64<br />
3) Devlibs32 -> Devlibs<br />
4) Mingw32 -> Mingw.<br />
Reverse-rename to return to the 64-bit configuration. Never, ever mix 32-bit Devlibs with 64-bit Mingw or vice-versa. Expect build failure if you do so.<br />
<br />
<br />
The rest of the steps are:<br />
<br />
''1. Create our working directory:''<br />
* <code> mkdir /d/myoolite </code> - to create a folder called myoolite under D:\. This is where we will check out the code, but instead of D: any available drive letter can be used. We will refer to D: here for simplicity.<br />
*<code> cd /d/myoolite </code> - to enter our working directory.<br />
<br />
<br />
''2. Check out the oolite code:''<br />
* <code> git clone https://github.com/OoliteProject/oolite.git </code> - this will start copying the source code from the repository to your working dir. When finished, there will be a folder named oolite under the folder you performed the checkout. Next do a<br />
* <code> cd oolite </code> to enter in the trunk folder, where the actual build will take place. Finally, execute this command to pull in all the binary dependencies needed for the full build (maybe you can take a coffee break here, this takes a while):<br />
* <code> git submodule update --init </code><br />
<br />
<br />
''3. Build the source:''<br />
* <code> make debug=no </code> - That's it! Go get a coffee while it builds, then come back and you will find two new folders under trunk: obj and oolite.app. obj contains the object files produced by the compiler and you don't need to worry too much about it. And of course you all know what oolite.app is.<br />
<br />
<br />
''4. Profit:''<br />
Double click the oolite.exe file that resides in your <code>D:\myoolite\trunk\oolite.app </code> folder. You should see the splash screen followed by the familiar rotating Cobra. Now you can go and improve your Elite rating and give us some feedback from your testing while you're at it.<br />
<br />
If at any later time you would like to update to the code that will be current by then, all you need to do is start up MSYS, then <br />
* <code> cd /d/myoolite/oolite </code><br />
* <code>git pull </code><br />
* <code>git submodule update </code><br />
* <code>make debug=no </code><br />
<br />
<br />
Good luck!<br />
<br />
=== Old Building Oolite from source ===<br />
'''Updated on 09 January 2009 - (left here for reference, please use the instructions above).'''<br />
<br />
'''Acknowledgments and thanks to [[User:Kaks|Kaks]] for providing them:'''<br />
<br />
<br />
'''Important note: It is recommended that all packages for Windows be installed in paths that do not contain spaces. The same recommendation applies for the Windows username of the account the build is performed from. There have been reports of MSYS/make problems in such cases.'''<br />
<br />
# If you have an older version of GNUstep(GNUstep-base-1.11.1-gui-0.10.1-3 - from the wiki howto), uninstall it, then delete its root directory if it's still there(c:\GNUstep). <br />
# Google & download the following 2 packages, and - this is important - install them in this sequence: http://ftpmain.gnustep.org/pub/gnustep/binaries/windows/gnustep-system-0.19.2-setup.exe, http://ftpmain.gnustep.org/pub/gnustep/binaries/windows/gnustep-core-0.19.2-setup.exe<br />
# Google & download tortoiseSVN, install. <br />
# You now need the dependencies files for Windows. Download Local_20090108.zip [ftp://ftp.alioth.net/oolite/Local_20090108.zip].<br />
# Go to the Windows Start menu, navigate to and select ''Start>Programs>GNUstep>Shell''<br />
# At the prompt :<br />
## <code>mkdir /Local </code><br />
## <code>mkdir /Local/oolite </code><br />
## <code>mkdir /Local/oolite/trunk </code>. The first slash & the upper case L are very important! <br />
# From windows, extract the directories inside Local_20090108.zip to <code>C:\GNUstep\Local </code><br />
# Still from windows go to <code>C:\GNUstep\Local\oolite\trunk </code><br />
# It's empty. Right click>SVN checkout. The repository is <code>svn://svn.berlios.de/oolite-linux/trunk </code>. Wait for it to finish. <br />
# From inside the GNUstep shell <br />
## <code>export PATH=$PATH:/Local/bin </code><br />
## <code>cd /Local/oolite/trunk </code><br />
## <code>make debug=no</code><br />
# We're now ready to launch the compiled oolite! From inside the GNUstep shell:<br />
## <code>cd /Local/oolite/trunk </code><br />
## <code>openapp oolite.app </code><br />
<br />
<br />
<br />
''' The instructions below are valid only for versions prior to 1.70, only use them as an alternative if the updated ones fail for whatever reason.'''<br />
<br />
# Download and install the necessary software<br />
## Download and install svn for Windows: [http://subversion.tigris.org/project_packages.html#binary-packages]. Accept all defaults given by the installer.<br />
## Download and install GNUstep for windows: [ftp://ftp.gnustep.org/pub/gnustep/binaries/windows/base-1.11.1-gui-0.10.1/GNUstep-base-1.11.1-gui-0.10.1-3.exe]. Accept all defaults given by the installer.<br />
## Download the SDL files required to build Oolite: [http://prdownload.berlios.de/oolite-pc/Local.zip]<br />
## Unzip this file to <code>c:\GNUstep\Local</code><br />
# Get the source and build it (note, the source comes from the oolite-linux project)<br />
## Start the GNUstep command line (<i>Start -> Programs -> GNUstep Development -> MSYS for GNUstep</i>) and issue the following commands:<br />
## <code>cd $GNUSTEP_LOCAL_ROOT</code><br />
## <code>export PATH=$PATH:$GNUSTEP_LOCAL_ROOT/bin</code><br />
## <code>mkdir oolite</code><br />
## <code>cd oolite</code><br />
## <code>svn checkout svn://svn.berlios.de/oolite-linux/trunk</code><br />
## <code>cd trunk</code><br />
## <code>make</code><br />
# To run the game in the build environment:<br />
## Before running the first time: <code>cp $GNUSTEP_LOCAL_ROOT/bin/*.dll oolite.app</code><br />
## <code>openapp oolite.app</code><br />
<br />
Assuming you have installed one of Nic's releases as detailed above, you can easily keep updating the installation from the latest source. In the <code>$GNUSTEP_LOCAL_ROOT/oolite/trunk</code> directory, issue the commands:<br />
<br />
# <code>export PATH=$PATH:$GNUSTEP_LOCAL_ROOT/bin</code><br />
# <code>svn up</code><br />
# <code>rm -rf oolite.app/Resources; make</code><br />
<br />
You only need to issue the export PATH command when you first start the command line. The rm -rf command before make is required because GNUstep for Windows cannot parse the XML plist file format, and the build fails when it tries to read one of these generated each time the build is performed. This failure is not important, and the process still works, but it is annoying.<br />
<br />
Then use the following script to copy the new files over the existing installation:<br />
<br />
<pre><br />
OA="/c/Program Files/Oolite/oolite.app"<br />
cd $GNUSTEP_LOCAL_ROOT/oolite/trunk<br />
if [ oolite.app/oolite.exe -nt "$OA/oolite.exe" ]; then<br />
echo "Updating oolite.exe"<br />
cp oolite.app/oolite.exe "$OA/oolite.exe"<br />
fi<br />
<br />
for a in AIs Config Images Models Music Sounds Textures; do<br />
for b in Resources/$a/*; do<br />
c=`basename $b`<br />
if [ $b -nt "$OA/Contents/Resources/$a/$c" ]; then<br />
echo "Updating with $b"<br />
cp $b "$OA/Contents/Resources/$a/$c"<br />
fi<br />
done<br />
done<br />
</pre><br />
<br />
If you want to edit the source, Notepad++ has good Objective-C support and is free: [http://notepad-plus.sourceforge.net/]<br />
<br />
Also see the Oolite-PC forum: [https://bb.oolite.space/viewforum.php?f=8]<br />
<br />
== Building Oolite-Linux ==<br />
<br />
=== Dependencies ===<br />
<br />
You will need the following components:<br />
* The GNU Objective-C compiler (gcc-objc). Your distribution should have this available.<br />
* [http://www.gnustep.org GNUstep Startup]. Your distro may provide the appropriate GNUstep development libraries.<br />
* SDL development libraries including SDL_mixer and SDL_image. All Linux distros seem to have the main SDL library, but some do not seem to have SDL_image. This can be downloaded from [http://www.libsdl.org the SDL Library Development website].<br />
* OpenGL development libraries - your distribution will have these.<br />
* To build Autopackages, you will also need the Autopackage development kit, which is available at [http://autopackage.org Autopackage.org]<br />
<br />
The source code for these dependencies is also available at [ftp://ftp.alioth.net]<br />
<br />
You may also want the following optional component:<br />
* espeak, if you want speech (1.73 & later). Your distribution should have this; otherwise, see [http://espeak.sourceforge.net espeak.sourceforge.net].<br />
<br />
=== Building ===<br />
Once you have a source tree, you can build it by just typing 'make'. To run the newly-built code, then type 'openapp oolite'. If you want to build the Autopackage .package file, type 'makeinstaller'. This will leave a .package file in the build directory. You can then run this file to install the game.<br />
<br />
=== Notes about the build process ===<br />
<br />
* The makefile is called GNUmakefile rather than 'Makefile'; this seems to be the convention for GNUstep applications. If you are not using GNUmake, then you will probably need to 'make -f GNUmakefile'. However, it is recommended that you install gmake if you are using a platform (BSD) that doesn't include GNU make (it's a dependency for GNUstep anyway). The build process first builds all the Objective-C source (source code files end in '.m' which is the standard file extension for Objective-C) into the executable oolite.app/oolite and then copies the data into oolite.app/Contents.<br />
<br />
* A new dependency on the SpiderMonkey JavaScript v1.70 library was introduced on SVN revision 1157. This requires some attention regarding the Linux build process. The full instructions on building the game successfully with JavaScript 1.70 on Debian can be found in the following forum post:<br />https://bb.oolite.space/viewtopic.php?p=42188&highlight=#42188<br />
<br />
* As of 1.73, a new 'Makefile' has been added to the project to simplify building Oolite. Assuming your system has all required build dependencies installed (as outlined above), you can build debug and optimised copies of Oolite with the following commands. The included Spidermonkey dependency is automatically built as well. For a full list of targets, use 'make -f Makefile help'.<br />
** make -f Makefile debug<br />
** make -f Makefile release<br />
<br />
=== Notes about GNUstep ===<br />
<br />
Several bugs have been found with gnustep-base1.19.3 which affect Oolite to a greater or lesser extent. As older versions of several popular Linux Distributions ship with this version of GNUstep, it is highly recommended that you compile and install a known good version of GNUstep for development. gnustep-base1.18 is known to be good. The current trunk (gnustep-base1.21.1) appears to also be ok.<br />
<br />
This [https://bb.oolite.space/viewtopic.php?t=8008&highlight= forum post] details how to build and install gnustep for developing Oolite.<br />
<div style="clear:both"></div><br />
<br />
== Objective-C ==<br />
If you’re familiar with OO design concepts, learning Objective-C is about half a day’s work. If not, maybe a few days. Objective-C is a much, much smaller extension to C than C++ is. Take your choice of introductory documents:<br />
*[http://developer.apple.com/documentation/Cocoa/Conceptual/ObjectiveC/index.html The Objective-C Programming Language] – covers OO basics, just about the entire language (including bits not used in Oolite – the Exception Handling and Thread Synchronization chapter in particular) and the runtime library used in Apple’s implementation.<br />
*[http://www.gnustep.org/resources/ObjCFun.html Objective-C is Fun] – covers most of the language in about three pages. (Assumes a knowledge of C.)<br />
*[http://www.otierney.net/objective-c.html Objective-C Beginner’s Guide] – a more hands-on tutorial.<br />
<br />
The biggest roadblock to most people seems to be [http://developer.apple.com/documentation/Cocoa/Conceptual/MemoryMgmt/index.html the memory management model]. (The chapter “Implementing Object Copy” can be considered an advanced topic in the context of Oolite, and the Core Foundation and Zones bit are of no interest.) The section [http://developer.apple.com/documentation/Cocoa/Conceptual/MemoryMgmt/Tasks/MemoryManagementRules.html Memory Management Rules] is the really important bit.<br />
<br />
That said, Oolite is not necessarily the best project to start with; taking a look at [http://developer.apple.com/documentation/Cocoa/Conceptual/ObjCTutorial/index.html Apple’s] or [http://www.gnustep.it/pierre-yves/index.html GNUstep’s] tutorials. (The latter appears to be a rip-off– er, adaptation of the former.) These are geared towards GUI apps, though.<br />
<br />
[[User:Ahruman|Ahruman]], 2007 from [https://bb.oolite.space/viewtopic.php?p=32138#p32138 Learning Objective-C]<br />
<br />
== Links ==<br />
* [https://bb.oolite.space/viewtopic.php?p=270121#p270121 Building Spidermonkey (2020)]<br />
<br />
* [https://bb.oolite.space/viewtopic.php?t=21215 Steam-ready (almost)] (2022-24)<br />
<br />
[[Category:Oolite]] [[Category:Oolite Development| ]]</div>Another commanderhttps://wiki.alioth.net/index.php?title=Developer%27s_Corner&diff=84460Developer's Corner2024-09-13T10:00:35Z<p>Another commander: /* OS Specific parts */</p>
<hr />
<div>Here you will find information that helps understanding the Oolite source code, build and test the project.<br />
<br />
* [[Contributing to the project]]<br />
* [[Release Process]]<br />
* [[Branding]]<br />
* [https://ooliteproject.github.io/oolite/ Oolite API documentation]<br />
<br />
== OS Specific parts ==<br />
<br />
{| class="wikitable" style="margin:auto"<br />
|+ Operating System dependent stuff<br />
|-<br />
! Procedure !! Apple Mac !! Linux !! Windows<br />
|-<br />
| Setting up a development environment || [[Development on Apple Mac]] || [[Development on Linux]] || [[Development on Windows]]<br />
|-<br />
| Compiling || [[Compiling on Apple Mac]] || [[Compiling on Linux]] || [[Developing Oolite#On_Windows_2 | Compiling on Windows]]<br />
|-<br />
| Testing || [[Testing on Apple Mac]] || [[Testing on Linux]] || [[Testing on Windows]]<br />
|-<br />
| Packaging into Installer || [[Installer on Apple Mac]] || [[Installer on Linux]] || [[Installer on Windows]]<br />
|-<br />
| Running || [[Running_Oolite-Mac]] || ||<br />
|}<br />
<br />
[[Category:Oolite Development]]<br />
<br />
== Hints ==<br />
<br />
The code is organized across several git repositories. The main one refers to the others as submodules - but always to a concise commit.<br />
If you need to update submodules you also need to tell update the reference in the main repository. Here you can see that handling submodules can lead to strange effects: https://bb.oolite.space/viewtopic.php?f=3&t=21470<br />
<br />
To learn mode about submodules read the fine manual at https://git-scm.com/book/en/v2/Git-Tools-Submodules</div>Another commanderhttps://wiki.alioth.net/index.php?title=Developer%27s_Corner&diff=84459Developer's Corner2024-09-13T09:53:13Z<p>Another commander: /* OS Specific parts */</p>
<hr />
<div>Here you will find information that helps understanding the Oolite source code, build and test the project.<br />
<br />
* [[Contributing to the project]]<br />
* [[Release Process]]<br />
* [[Branding]]<br />
* [https://ooliteproject.github.io/oolite/ Oolite API documentation]<br />
<br />
== OS Specific parts ==<br />
<br />
{| class="wikitable" style="margin:auto"<br />
|+ Operating System dependent stuff<br />
|-<br />
! Procedure !! Apple Mac !! Linux !! Windows<br />
|-<br />
| Setting up a development environment || [[Development on Apple Mac]] || [[Development on Linux]] || [[Development on Windows]]<br />
|-<br />
| Compiling || [[Compiling on Apple Mac]] || [[Compiling on Linux]] || [https://wiki.alioth.net/index.php/Developing_Oolite#On_Windows_2 Compiling on Windows]<br />
|-<br />
| Testing || [[Testing on Apple Mac]] || [[Testing on Linux]] || [[Testing on Windows]]<br />
|-<br />
| Packaging into Installer || [[Installer on Apple Mac]] || [[Installer on Linux]] || [[Installer on Windows]]<br />
|-<br />
| Running || [[Running_Oolite-Mac]] || ||<br />
|}<br />
<br />
[[Category:Oolite Development]]<br />
<br />
== Hints ==<br />
<br />
The code is organized across several git repositories. The main one refers to the others as submodules - but always to a concise commit.<br />
If you need to update submodules you also need to tell update the reference in the main repository. Here you can see that handling submodules can lead to strange effects: https://bb.oolite.space/viewtopic.php?f=3&t=21470<br />
<br />
To learn mode about submodules read the fine manual at https://git-scm.com/book/en/v2/Git-Tools-Submodules</div>Another commanderhttps://wiki.alioth.net/index.php?title=HDR&diff=84454HDR2024-09-09T08:04:04Z<p>Another commander: </p>
<hr />
<div>High Dynamic Range (advanced video display - currently only available for Windows platforms)<br />
<br />
== Overview ==<br />
The current Windows Pre-releases/"nightlies" now support HDR. They can be downloaded from the very bottom of the [https://oolite.space/#download Downloads page] or directly from GitHub, [https://github.com/OoliteProject/oolite/releases here].<br />
<br />
If you have a compatible monitor or TV you can now enjoy vivid, bright and high contrast colors that seem to pop right out of your screen, while maintaining full image details in both highlights and dark areas. Furthermore, colors in HDR mode are 10-bit per RGB component as opposed to 8-bit in SDR and can now exceed the standard Rec709 color space and go well into the DCI-P3 and BT2020 color spaces (see [https://www.benq.com/en-us/business/resource/trends/understanding-color-gamut.html?srsltid=AfmBOop1EleuJqvrAjiH9WEG7rcuOJmG54hUicbStmP8IQK9JSnicLJv here] for more), creating an even more impressive visual experience with 1.07 billion color hues available to you rather than the 16.7 million available in SDR.<br />
<br />
Fine gameplay moments in HDR can be captured in either OpenEXR (.exr) or Radiance RGBE (.hdr) format using the standard Oolite save snapshot key. You can view OpenEXR and Radiance RGBE files at a later time using software like Windows HDR+WCG Viewer (available from the Microsoft Store for free) or the also free and very powerful HDR image viewer utility, [https://cdn.discordapp.com/attachments/792979353117524009/1277053487368241325/SKIV.exe?ex=66cc6cfd&is=66cb1b7d&hm=417a59e377398a4e2d8e12b446dc8881f9498bd21538f2a89e0411ec8e78c3c5& SKIV].<br />
<br />
This has been implemented by our Developer, [[User:Another commander|Another commander]] (who also greatly improved visuals in Oolite versions 1.86, 1.88 & 1.90).<br />
<br />
=== Note ===<br />
Because the changes only affect the display on a HDR screen, there is no way of displaying the improvements on an older SDR screen!<br />
<br />
<br />
<br />
== How to Enable Oolite's HDR Mode ==<br />
After installing the game, a new shortcut will be added to the Start menu group for the game under Windows. Those who use the nightly installers will notice this new icon under the group "Oolite":<br />
<br />
[[file:OoliteHDRIcon.png|200px]]<br />
<br />
You can now use it to launch the game in HDR. Alternatively, you can launch Oolite from a console or the Windows Run dialog using <pre>C:\path\to\game\oolite.app\oolite.exe -hdr</pre><br />
<br />
As a reminder, to be able to run the game in this mode you need:<br />
* Windows 10 or 11 (11 is strongly recommended).<br />
* A monitor that supports HDR output. An OLED monitor or TV is <u>strongly</u> recommended.<br />
* Graphics card that supports HDR, like 10xx NVidia series or higher spec.<br />
* HDMI 2.1 / DisplayPort 1.4 or higher spec cable, so that the HDR bandwidth requirement is satisfied.<br />
* Enabling of HDR in Windows from the Settings -> System -> Display. If your system does not support HDR for whatever reason you will not have the option to enable it.<br />
[[File:OoliteHowToActivateHDRinWindows.png]]<br />
<br />
Attempting to launch the game in HDR mode without satisfying the above requirements will trigger a warning dialog informing the user that it was not possible to detect HDR on the system and asking whether the user would like to proceed with the game rendering as HDR in a non-suitable environment (i.e. looking weird) or abort.<br />
<br />
[[File:OoliteStartInHDRWithoutHDREnabled.jpg|320px]]<br />
<br />
<br />
== Calibration ==<br />
To obtain the most out of your HDR experience, you will have to calibrate the game to generate a display signal suitable for your monitor or TV. Oolite's Game Options menu is slightly different when the game is run in HDR mode, meaning that it has two options not normally appearing in the default menu: HDR Max Brightness and HDR Paper White. The menu in HDR mode will look as seen in the screen below:<br />
[[file:OoliteHDRMenu.png|1000px]]<br />
<br />
By default HDR Max Brightness is set to 1000 nits (or cd/m2) and HDR Paper White is set to 200 nits. You must adjust those values to match your display. At this moment Oolite does not feature an HDR calibration screen so you should get the Max Brightness information for your display from either the manufacturer's website or by running the Windows HDR Calibration utility (available for Windows 11 at the Microsoft Store for free).<br />
<br />
HDR Max Brightness can be set to 400, 500, 600, 800 and 1000 nits, but you can also edit descriptions.plist in your game install and add other values if you want - the game will accept them and use them. To add max brightness values, if so desired, open oolite.app/Resources/descriptions.plist in a text editor (backup the original file first just in case), find the block <pre>hdr_maxBrightness_array =<br />
(<br />
400, 500, 600, 800, 1000<br />
);</pre>and insert your new value in the row with the numbers, making sure it is separated by commas from the rest. Please note that <b>the values of 400 and 1000 nits are in-game limits</b> and <u>any value above or below those limits will either be ignored or result in unexpected behavior, depending on where in the array it is inserted</u>. Save and restart the game with Shift down to enable the edit and you should now have the extra option available. It is important that this value matches as closely as possible the actual max brightness your display can output for a <b>10% screen coverage window</b>.<br />
<br />
HDR Paper White indicates how bright a pure diffuse white object will be. You can think of it as a generic brightness slider. The higher you set it, the less headroom for highlights you leave. As a rule of thumb this can be set to about 1/4 of the max brightness, but it is entirely up to you to decide. You can set it to whatever feels comfortable to you. The range of this slider is from 80 to 280 nits.<br />
<br />
Once those are set to their correct / preferred values, you are ready for the HDR experience. The game is still playable even if you skip the calibration step, but the image might look off or clipped, so best if you don't skip it. Be advised that HDR has been designed for low lighting environments, so you should avoid brightly lit rooms when playing for best results.<br />
<br />
<br />
== Choosing Your Preferred HDR Screenshot Format ==<br />
The default HDR screenshot format is OpenEXR. It is chosen for its impressive accuracy and ability to display colors in all color spaces used for HDR displays (Rec709, DCI-P3 and BT2020). Be advised that .exr files can be big though, depending on the image content. If you do not care that much about precise representation of what was on your screen at the time of capture and prefer having smaller size files that can maybe be easier to share online, you can switch the HDR snapshot output format to Radiance RGBE. Do do that, make a backup of the file <code><OoliteInstallDir>\oolite.app\GNUstep\Defaults\.GNUstepDefaults</code>, then open it in a text editor and add:<br />
<pre>"hdr-snapshot-format" = .hdr;</pre><br />
The leading dot is optional, Oolite will understand the extension with or without it. If you enter any random string other than the allowed "[.]hdr" and "[.]exr", a warning will be posted in the log and .exr will be selected by default anyway. Save the file and that's it.<br />
<br />
<br />
== Links ==<br />
*[https://bb.oolite.space/viewtopic.php?t=21311 Oolite on HDR Displays] (2022 - date) - this BB thread has the current information<br />
*[https://support.microsoft.com/en-us/windows/calibrate-your-hdr-display-using-the-windows-hdr-calibration-app-f30f4809-3369-43e4-9b02-9eabebd23f19 Windows 11 HDR Calibration App on Microsoft Support]<br />
<br />
[[Category:Oolite]] [[Category:Help pages]]<br />
[[Category:Factual]]</div>Another commanderhttps://wiki.alioth.net/index.php?title=HDR&diff=84453HDR2024-09-09T07:57:02Z<p>Another commander: </p>
<hr />
<div>High Dynamic Range (advanced video display - currently only available for Windows platforms)<br />
<br />
== Overview ==<br />
The current Windows Pre-releases/"nightlies" now support HDR. They can be downloaded from the very bottom of the [https://oolite.space/#download Downloads page] or directly from GitHub, [https://github.com/OoliteProject/oolite/releases here].<br />
<br />
If you have a compatible monitor or TV you can now enjoy vivid, bright and high contrast colors that seem to pop right out of your screen, while maintaining full image details in both highlights and dark areas. Furthermore, colors in HDR mode are 10-bit per RGB component as opposed to 8-bit in SDR and can now exceed the standard Rec709 color space and go well into the DCI-P3 and BT2020 color spaces (see [https://www.benq.com/en-us/business/resource/trends/understanding-color-gamut.html?srsltid=AfmBOop1EleuJqvrAjiH9WEG7rcuOJmG54hUicbStmP8IQK9JSnicLJv here] for more), creating an even more impressive visual experience with 1.07 billion color hues available to you rather than the 16.7 million available in SDR.<br />
<br />
Fine gameplay moments in HDR can be captured in either OpenEXR (.exr) or Radiance RGBE (.hdr) format using the standard Oolite save snapshot key. You can view OpenEXR and Radiance RGBE files at a later time using software like Windows HDR+WCG Viewer (available from the Microsoft Store for free) or the also free and very powerful HDR image viewer utility, [https://cdn.discordapp.com/attachments/792979353117524009/1277053487368241325/SKIV.exe?ex=66cc6cfd&is=66cb1b7d&hm=417a59e377398a4e2d8e12b446dc8881f9498bd21538f2a89e0411ec8e78c3c5& SKIV].<br />
<br />
This has been implemented by our Developer, [[User:Another commander|Another commander]] (who also greatly improved visuals in Oolite versions 1.86, 1.88 & 1.90).<br />
<br />
=== Note ===<br />
Because the changes only affect the display on a HDR screen, there is no way of displaying the improvements on an older SDR screen!<br />
<br />
<br />
<br />
== How to Enable Oolite's HDR Mode ==<br />
After installing the game, a new shortcut will be added to the Start menu group for the game under Windows. Those who use the nightly installers will notice this new icon under the group "Oolite":<br />
<br />
[[file:OoliteHDRIcon.png|200px]]<br />
<br />
You can now use it to launch the game in HDR. Alternatively, you can launch Oolite from a console or the Windows Run dialog using <pre>C:\path\to\game\oolite.app\oolite.exe -hdr</pre><br />
<br />
As a reminder, to be able to run the game in this mode you need:<br />
* Windows 10 or 11 (11 is strongly recommended).<br />
* A monitor that supports HDR output. An OLED monitor or TV is <u>strongly</u> recommended.<br />
* Graphics card that supports HDR, like 10xx NVidia series or higher spec.<br />
* HDMI 2.1 / DisplayPort 1.4 or higher spec cable, so that the HDR bandwidth requirement is satisfied.<br />
* Enabling of HDR in Windows from the Settings -> System -> Display. If your system does not support HDR for whatever reason you will not have the option to enable it.<br />
[[File:OoliteHowToActivateHDRinWindows.png]]<br />
<br />
Attempting to launch the game in HDR mode without satisfying the above requirements will trigger a warning dialog informing the user that it was not possible to detect HDR on the system and asking whether the user would like to proceed with the game rendering as HDR in a non-suitable environment (i.e. looking weird) or abort.<br />
<br />
[[File:OoliteStartInHDRWithoutHDREnabled.jpg|320px]]<br />
<br />
<br />
== Calibration ==<br />
To obtain the most out of your HDR experience, you will have to calibrate the game to generate a display signal suitable for your monitor or TV. Oolite's Game Options menu is slightly different when the game is run in HDR mode, meaning that it has two options not normally appearing in the default menu: HDR Max Brightness and HDR Paper White. The menu in HDR mode will look as seen in the screen below:<br />
[[file:OoliteHDRMenu.png|1000px]]<br />
<br />
By default HDR Max Brightness is set to 1000 nits (or cd/m2) and HDR Paper White is set to 200 nits. You must adjust those values to match your display. At this moment Oolite does not feature an HDR calibration screen so you should get the Max Brightness information for your display from either the manufacturer's website or by running the Windows HDR Calibration utility (available for Windows 11 at the Microsoft Store for free).<br />
<br />
HDR Max Brightness can be set to 400, 500, 600, 800 and 1000 nits, but you can also edit descriptions.plist in your game install and add other values if you want - the game will accept them and use them. To add max brightness values, if so desired, open oolite.app/Resources/descriptions.plist in a text editor (backup the original file first just in case), find the block <pre>hdr_maxBrightness_array =<br />
(<br />
400, 500, 600, 800, 1000<br />
);</pre>and insert your new value in the row with the numbers, making sure it is separated by commas from the rest. Please note that the values of 400 and 1000 nits are in-game limits and if you set anything above or below those limits, it will be ignored. Save and restart the game with Shift down to enable the edit and you should now have the extra option available. It is important that this value matches as closely as possible the actual max brightness your display can output for a <b>10% screen coverage window</b>.<br />
<br />
HDR Paper White indicates how bright a pure diffuse white object will be. You can think of it as a generic brightness slider. The higher you set it, the less headroom for highlights you leave. As a rule of thumb this can be set to about 1/4 of the max brightness, but it is entirely up to you to decide. You can set it to whatever feels comfortable to you. The range of this slider is from 80 to 280 nits.<br />
<br />
Once those are set to their correct / preferred values, you are ready for the HDR experience. The game is still playable even if you skip the calibration step, but the image might look off or clipped, so best if you don't skip it. Be advised that HDR has been designed for low lighting environments, so you should avoid brightly lit rooms when playing for best results.<br />
<br />
<br />
== Choosing Your Preferred HDR Screenshot Format ==<br />
The default HDR screenshot format is OpenEXR. It is chosen for its impressive accuracy and ability to display colors in all color spaces used for HDR displays (Rec709, DCI-P3 and BT2020). Be advised that .exr files can be big though, depending on the image content. If you do not care that much about precise representation of what was on your screen at the time of capture and prefer having smaller size files that can maybe be easier to share online, you can switch the HDR snapshot output format to Radiance RGBE. Do do that, make a backup of the file <code><OoliteInstallDir>\oolite.app\GNUstep\Defaults\.GNUstepDefaults</code>, then open it in a text editor and add:<br />
<pre>"hdr-snapshot-format" = .hdr;</pre><br />
The leading dot is optional, Oolite will understand the extension with or without it. If you enter any random string other than the allowed "[.]hdr" and "[.]exr", a warning will be posted in the log and .exr will be selected by default anyway. Save the file and that's it.<br />
<br />
<br />
== Links ==<br />
*[https://bb.oolite.space/viewtopic.php?t=21311 Oolite on HDR Displays] (2022 - date) - this BB thread has the current information<br />
*[https://support.microsoft.com/en-us/windows/calibrate-your-hdr-display-using-the-windows-hdr-calibration-app-f30f4809-3369-43e4-9b02-9eabebd23f19 Windows 11 HDR Calibration App on Microsoft Support]<br />
<br />
[[Category:Oolite]] [[Category:Help pages]]<br />
[[Category:Factual]]</div>Another commanderhttps://wiki.alioth.net/index.php?title=HDR&diff=84431HDR2024-09-02T14:33:27Z<p>Another commander: </p>
<hr />
<div>High Dynamic Range (advanced video display - currently only available for Windows platforms)<br />
<br />
== Overview ==<br />
The current Windows Pre-releases/"nightlies" now support HDR. They can be downloaded from the very bottom of the [https://oolite.space/#download Downloads page] or directly from GitHub, [https://github.com/OoliteProject/oolite/releases here].<br />
<br />
If you have a compatible monitor or TV you can now enjoy vivid, bright and high contrast colors that seem to pop right out of your screen, while maintaining full image details in both highlights and dark areas. Furthermore, colors in HDR mode are 10-bit per RGB component as opposed to 8-bit in SDR and can now exceed the standard Rec709 color space and go well into the DCI-P3 and BT2020 color spaces (see [https://www.benq.com/en-us/business/resource/trends/understanding-color-gamut.html?srsltid=AfmBOop1EleuJqvrAjiH9WEG7rcuOJmG54hUicbStmP8IQK9JSnicLJv here] for more), creating an even more impressive visual experience with 1.07 billion color hues available to you rather than the 16.7 million available in SDR.<br />
<br />
Fine gameplay moments in HDR can be captured in either OpenEXR (.exr) or Radiance RGBE (.hdr) format using the standard Oolite save snapshot key. You can view OpenEXR and Radiance RGBE files at a later time using software like Windows HDR+WCG Viewer (available from the Microsoft Store for free) or the also free and very powerful HDR image viewer utility, [https://cdn.discordapp.com/attachments/792979353117524009/1277053487368241325/SKIV.exe?ex=66cc6cfd&is=66cb1b7d&hm=417a59e377398a4e2d8e12b446dc8881f9498bd21538f2a89e0411ec8e78c3c5& SKIV].<br />
<br />
This has been implemented by our Developer, [[User:Another commander|Another commander]] (who also greatly improved visuals in Oolite versions 1.86, 1.88 & 1.90).<br />
<br />
=== Note ===<br />
Because the changes only affect the display on a HDR screen, there is no way of displaying the improvements on an older SDR screen!<br />
<br />
<br />
<br />
== How to Enable Oolite's HDR Mode ==<br />
After installing the game, a new shortcut will be added to the Start menu group for the game under Windows. Those who use the nightly installers will notice this new icon under the group "Oolite":<br />
<br />
[[file:OoliteHDRIcon.png|200px]]<br />
<br />
You can now use it to launch the game in HDR. Alternatively, you can launch Oolite from a console or the Windows Run dialog using <pre>C:\path\to\game\oolite.app\oolite.exe -hdr</pre><br />
<br />
As a reminder, to be able to run the game in this mode you need:<br />
* Windows 10 or 11 (11 is strongly recommended).<br />
* A monitor that supports HDR output. An OLED monitor or TV is <u>strongly</u> recommended.<br />
* Graphics card that supports HDR, like 10xx NVidia series or higher spec.<br />
* HDMI 2.1 / DisplayPort 1.4 or higher spec cable, so that the HDR bandwidth requirement is satisfied.<br />
* Enabling of HDR in Windows from the Settings -> System -> Display. If your system does not support HDR for whatever reason you will not have the option to enable it.<br />
[[File:OoliteHowToActivateHDRinWindows.png]]<br />
<br />
Attempting to launch the game in HDR mode without satisfying the above requirements will trigger a warning dialog informing the user that it was not possible to detect HDR on the system and asking whether the user would like to proceed with the game rendering as HDR in a non-suitable environment (i.e. looking weird) or abort.<br />
<br />
[[File:OoliteStartInHDRWithoutHDREnabled.jpg|320px]]<br />
<br />
<br />
== Calibration ==<br />
To obtain the most out of your HDR experience, you will have to calibrate the game to generate a display signal suitable for your monitor or TV. Oolite's Game Options menu is slightly different when the game is run in HDR mode, meaning that it has two options not normally appearing in the default menu: HDR Max Brightness and HDR Paper White. The menu in HDR mode will look as seen in the screen below:<br />
[[file:OoliteHDRMenu.png|1000px]]<br />
<br />
By default HDR Max Brightness is set to 1000 nits (or cd/m2) and HDR Paper White is set to 200 nits. You must adjust those values to match your display. At this moment Oolite does not feature an HDR calibration screen so you should get the Max Brightness information for your display from either the manufacturer's website or by running the Windows HDR Calibration utility (available for Windows 11 at the Microsoft Store for free).<br />
<br />
HDR Max Brightness can be set to 400, 500, 600, 800 and 1000 nits, but you can also edit descriptions.plist in your game install and add other values if you want - the game will accept them and use them. To add max brightness values, if so desired, open oolite.app/Resources/descriptions.plist in a text editor (backup the original file first just in case), find the block <pre>hdr_maxBrightness_array =<br />
(<br />
400, 500, 600, 800, 1000<br />
);</pre>and insert your new value in the row with the numbers, making sure it is separated by commas from the rest. Save and restart the game with Shift down to enable the edit and you should now have the extra option available. It is important that this value matches as closely as possible the actual max brightness your display can output for a <b>10% screen coverage window</b>.<br />
<br />
HDR Paper White indicates how bright a pure diffuse white object will be. You can think of it as a generic brightness slider. The higher you set it, the less headroom for highlights you leave. As a rule of thumb this can be set to about 1/4 of the max brightness, but it is entirely up to you to decide. You can set it to whatever feels comfortable to you. The range of this slider is from 80 to 280 nits.<br />
<br />
Once those are set to their correct / preferred values, you are ready for the HDR experience. The game is still playable even if you skip the calibration step, but the image might look off or clipped, so best if you don't skip it. Be advised that HDR has been designed for low lighting environments, so you should avoid brightly lit rooms when playing for best results.<br />
<br />
<br />
== Choosing Your Preferred HDR Screenshot Format ==<br />
The default HDR screenshot format is OpenEXR. It is chosen for its impressive accuracy and ability to display colors in all color spaces used for HDR displays (Rec709, DCI-P3 and BT2020). Be advised that .exr files can be big though, depending on the image content. If you do not care that much about precise representation of what was on your screen at the time of capture and prefer having smaller size files that can maybe be easier to share online, you can switch the HDR snapshot output format to Radiance RGBE. Do do that, make a backup of the file <code><OoliteInstallDir>\oolite.app\GNUstep\Defaults\.GNUstepDefaults</code>, then open it in a text editor and add:<br />
<pre>"hdr-snapshot-format" = .hdr;</pre><br />
The leading dot is optional, Oolite will understand the extension with or without it. If you enter any random string other than the allowed "[.]hdr" and "[.]exr", a warning will be posted in the log and .exr will be selected by default anyway. Save the file and that's it.<br />
<br />
<br />
== Links ==<br />
*[https://bb.oolite.space/viewtopic.php?t=21311 Oolite on HDR Displays] (2022 - date) - this BB thread has the current information<br />
*[https://support.microsoft.com/en-us/windows/calibrate-your-hdr-display-using-the-windows-hdr-calibration-app-f30f4809-3369-43e4-9b02-9eabebd23f19 Windows 11 HDR Calibration App on Microsoft Support]<br />
<br />
[[Category:Oolite]] [[Category:Help pages]]<br />
[[Category:Factual]]</div>Another commanderhttps://wiki.alioth.net/index.php?title=HDR&diff=84398HDR2024-08-30T09:53:18Z<p>Another commander: </p>
<hr />
<div>High Dynamic Range (advanced video display - currently only available for Windows platforms)<br />
<br />
== Overview ==<br />
The current Windows Pre-releases/"nightlies" now support HDR. They can be downloaded from the very bottom of the [https://oolite.space/#download Downloads page] or directly from GitHub, [https://github.com/OoliteProject/oolite/releases here].<br />
<br />
If you have a compatible monitor or TV you can now enjoy vivid, bright and high contrast colors that seem to pop right out of your screen, while maintaining full image details in both highlights and dark areas. Furthermore, colors in HDR mode are 10-bit per RGB component as opposed to 8-bit in SDR and can now exceed the standard Rec709 color space and go well into the DCI-P3 and BT2020 color spaces (see [https://www.benq.com/en-us/business/resource/trends/understanding-color-gamut.html?srsltid=AfmBOop1EleuJqvrAjiH9WEG7rcuOJmG54hUicbStmP8IQK9JSnicLJv here] for more), creating an even more impressive visual experience with 1.07 billion color hues available to you rather than the 16.7 million available in SDR.<br />
<br />
Fine gameplay moments in HDR can be captured in either OpenEXR (.exr) or Radiance RGBE (.hdr) format using the standard Oolite save snapshot key. You can view OpenEXR and Radiance RGBE files at a later time using software like Windows HDR+WCG Viewer (available from the Microsoft Store for free) or the also free and very powerful HDR image viewer utility, [https://cdn.discordapp.com/attachments/792979353117524009/1277053487368241325/SKIV.exe?ex=66cc6cfd&is=66cb1b7d&hm=417a59e377398a4e2d8e12b446dc8881f9498bd21538f2a89e0411ec8e78c3c5& SKIV].<br />
<br />
This has been implemented by our Developer, [[User:Another commander|Another commander]] (who also greatly improved visuals in Oolite versions 1.86, 1.88 & 1.90).<br />
<br />
=== Note ===<br />
Because the changes only affect the display on a HDR screen, there is no way of displaying the improvements on an older SDR screen!<br />
<br />
<br />
<br />
== How to Enable Oolite's HDR Mode ==<br />
After installing the game, a new shortcut will be added to the Start menu group for the game under Windows. Those who use the nightly installers will notice this new icon under the group "Oolite":<br />
<br />
[[file:OoliteHDRIcon.png|200px]]<br />
<br />
You can now use it to launch the game in HDR. Alternatively, you can launch Oolite from a console or the Windows Run dialog using <pre>C:\path\to\game\oolite.app\oolite.exe -hdr</pre><br />
<br />
As a reminder, to be able to run the game in this mode you need:<br />
* Windows 10 or 11 (11 is strongly recommended).<br />
* A monitor that supports HDR output. An OLED monitor or TV is <u>strongly</u> recommended.<br />
* Graphics card that supports HDR, like 10xx NVidia series or higher spec.<br />
* HDMI 2.1 / DisplayPort 1.4 or higher spec cable, so that the HDR bandwidth requirement is satisfied.<br />
* Enabling of HDR in Windows from the Settings -> System -> Display. If your system does not support HDR for whatever reason you will not have the option to enable it.<br />
[[File:OoliteHowToActivateHDRinWindows.png]]<br />
<br />
Attempting to launch the game in HDR mode without satisfying the above requirements will trigger a warning dialog informing the user that it was not possible to detect HDR on the system and asking whether the user would like to proceed with the game rendering as HDR in a non-suitable environment (i.e. looking weird) or abort.<br />
<br />
[[File:OoliteStartInHDRWithoutHDREnabled.jpg|320px]]<br />
<br />
<br />
== Calibration ==<br />
To obtain the most out of your HDR experience, you will have to calibrate the game to generate a display signal suitable for your monitor or TV. Oolite's Game Options menu is slightly different when the game is run in HDR mode, meaning that it has two options not normally appearing in the default menu: HDR Max Brightness and HDR Paper White. The menu in HDR mode will look as seen in the screen below:<br />
[[file:OoliteHDRMenu.png|1000px]]<br />
<br />
By default HDR Max Brightness is set to 1000 nits (or cd/m2) and HDR Paper White is set to 200 nits. You must adjust those values to match your display. At this moment Oolite does not feature an HDR calibration screen so you should get the Max Brightness information for your display from either the manufacturer's website or by running the Windows HDR Calibration utility (available for Windows 11 at the Microsoft Store for free).<br />
<br />
HDR Max Brightness can be set to 400, 500, 600, 800 and 1000 nits, but you can also edit descriptions.plist in your game install and add other values if you want - the game will accept them and use them. To add max brightness values, if so desired, open oolite.app/Resources/descriptions.plist in a text editor (backup the original file first just in case), find the block <pre>hdr_maxBrightness_array =<br />
(<br />
400, 500, 600, 800, 1000<br />
);</pre>and insert your new value in the row with the numbers, making sure it is separated by commas from the rest. Save and restart the game with Shift down to enable the edit and you should now have the extra option available. It is important that this value matches as closely as possible the actual max brightness your display can output for a <b>10% screen coverage window</b>.<br />
<br />
HDR Paper White indicates how bright a pure diffuse white object will be. You can think of it as a generic brightness slider. The higher you set it, the less headroom for highlights you leave. As a rule of thumb this can be set to about 1/4 of the max brightness, but it is entirely up to you to decide. You can set it to whatever feels comfortable to you. The range of this slider is from 80 to 280 nits.<br />
<br />
Once those are set to their correct / preferred values, you are ready for the HDR experience. The game is still playable even if you skip the calibration step, but the image might look off or clipped, so best if you don't skip it. Be advised that HDR has been designed for low lighting environments, so you should avoid brightly lit rooms when playing for best results.<br />
<br />
<br />
== Choosing Your Preferred HDR Screenshot Format ==<br />
The default HDR screenshot format is OpenEXR. It is chosen for its impressive accuracy and ability to display colors in all color spaces used for HDR displays (Rec709, DCI-P3 and BT2020). Be advised that .exr files are <u>big</u> though. If you do not care that much about precise representation of what was on your screen at the time of capture and prefer having smaller size files that can maybe be easier to share online, you can switch the HDR snapshot output format to Radiance RGBE. Do do that, make a backup of the file <code><OoliteInstallDir>\oolite.app\GNUstep\Defaults\.GNUstepDefaults</code>, then open it in a text editor and add:<br />
<pre>"hdr-snapshot-format" = .hdr;</pre><br />
The leading dot is optional, Oolite will understand the extension with or without it. If you enter any random string other than the allowed "[.]hdr" and "[.]exr", a warning will be posted in the log and .exr will be selected by default anyway. Save the file and that's it.<br />
<br />
<br />
== Links ==<br />
*[https://bb.oolite.space/viewtopic.php?t=21311 Oolite on HDR Displays] (2022 - date) - this BB thread has the current information<br />
*[https://support.microsoft.com/en-us/windows/calibrate-your-hdr-display-using-the-windows-hdr-calibration-app-f30f4809-3369-43e4-9b02-9eabebd23f19 Windows 11 HDR Calibration App on Microsoft Support]<br />
<br />
[[Category:Oolite]] [[Category:Help pages]]<br />
[[Category:Factual]]</div>Another commanderhttps://wiki.alioth.net/index.php?title=HDR&diff=84397HDR2024-08-30T09:50:37Z<p>Another commander: </p>
<hr />
<div>High Dynamic Range (advanced video display - currently only available for Windows platforms)<br />
<br />
== Overview ==<br />
The current Windows Pre-releases/"nightlies" now support HDR. They can be downloaded from the very bottom of the [https://oolite.space/#download Downloads page] or directly from GitHub, [https://github.com/OoliteProject/oolite/releases here].<br />
<br />
If you have a compatible monitor or TV you can now enjoy vivid, bright and high contrast colors that seem to pop right out of your screen, while maintaining full image details in both highlights and dark areas. Furthermore, colors in HDR mode are 10-bit per RGB component as opposed to 8-bit in SDR and can now exceed the standard Rec709 color space and go well into the DCI-P3 and BT2020 color spaces (see [https://www.benq.com/en-us/business/resource/trends/understanding-color-gamut.html?srsltid=AfmBOop1EleuJqvrAjiH9WEG7rcuOJmG54hUicbStmP8IQK9JSnicLJv here] for more), creating an even more impressive visual experience with 1.07 billion color hues available to you rather than the 16.7 million available in SDR.<br />
<br />
Fine gameplay moments in HDR can be captured in either OpenEXR (.exr) or Radiance RGBE (.hdr) format using the standard Oolite save snapshot key. You can view Radiance files at a later time using software like Windows HDR+WCG Viewer (available from the Microsoft Store for free) or the also free and very powerful HDR image viewer utility, [https://cdn.discordapp.com/attachments/792979353117524009/1277053487368241325/SKIV.exe?ex=66cc6cfd&is=66cb1b7d&hm=417a59e377398a4e2d8e12b446dc8881f9498bd21538f2a89e0411ec8e78c3c5& SKIV].<br />
<br />
This has been implemented by our Developer, [[User:Another commander|Another commander]] (who also greatly improved visuals in Oolite versions 1.86, 1.88 & 1.90).<br />
<br />
=== Note ===<br />
Because the changes only affect the display on a HDR screen, there is no way of displaying the improvements on an older SDR screen!<br />
<br />
<br />
<br />
== How to Enable Oolite's HDR Mode ==<br />
After installing the game, a new shortcut will be added to the Start menu group for the game under Windows. Those who use the nightly installers will notice this new icon under the group "Oolite":<br />
<br />
[[file:OoliteHDRIcon.png|200px]]<br />
<br />
You can now use it to launch the game in HDR. Alternatively, you can launch Oolite from a console or the Windows Run dialog using <pre>C:\path\to\game\oolite.app\oolite.exe -hdr</pre><br />
<br />
As a reminder, to be able to run the game in this mode you need:<br />
* Windows 10 or 11 (11 is strongly recommended).<br />
* A monitor that supports HDR output. An OLED monitor or TV is <u>strongly</u> recommended.<br />
* Graphics card that supports HDR, like 10xx NVidia series or higher spec.<br />
* HDMI 2.1 / DisplayPort 1.4 or higher spec cable, so that the HDR bandwidth requirement is satisfied.<br />
* Enabling of HDR in Windows from the Settings -> System -> Display. If your system does not support HDR for whatever reason you will not have the option to enable it.<br />
[[File:OoliteHowToActivateHDRinWindows.png]]<br />
<br />
Attempting to launch the game in HDR mode without satisfying the above requirements will trigger a warning dialog informing the user that it was not possible to detect HDR on the system and asking whether the user would like to proceed with the game rendering as HDR in a non-suitable environment (i.e. looking weird) or abort.<br />
<br />
[[File:OoliteStartInHDRWithoutHDREnabled.jpg|320px]]<br />
<br />
<br />
== Calibration ==<br />
To obtain the most out of your HDR experience, you will have to calibrate the game to generate a display signal suitable for your monitor or TV. Oolite's Game Options menu is slightly different when the game is run in HDR mode, meaning that it has two options not normally appearing in the default menu: HDR Max Brightness and HDR Paper White. The menu in HDR mode will look as seen in the screen below:<br />
[[file:OoliteHDRMenu.png|1000px]]<br />
<br />
By default HDR Max Brightness is set to 1000 nits (or cd/m2) and HDR Paper White is set to 200 nits. You must adjust those values to match your display. At this moment Oolite does not feature an HDR calibration screen so you should get the Max Brightness information for your display from either the manufacturer's website or by running the Windows HDR Calibration utility (available for Windows 11 at the Microsoft Store for free).<br />
<br />
HDR Max Brightness can be set to 400, 500, 600, 800 and 1000 nits, but you can also edit descriptions.plist in your game install and add other values if you want - the game will accept them and use them. To add max brightness values, if so desired, open oolite.app/Resources/descriptions.plist in a text editor (backup the original file first just in case), find the block <pre>hdr_maxBrightness_array =<br />
(<br />
400, 500, 600, 800, 1000<br />
);</pre>and insert your new value in the row with the numbers, making sure it is separated by commas from the rest. Save and restart the game with Shift down to enable the edit and you should now have the extra option available. It is important that this value matches as closely as possible the actual max brightness your display can output for a <b>10% screen coverage window</b>.<br />
<br />
HDR Paper White indicates how bright a pure diffuse white object will be. You can think of it as a generic brightness slider. The higher you set it, the less headroom for highlights you leave. As a rule of thumb this can be set to about 1/4 of the max brightness, but it is entirely up to you to decide. You can set it to whatever feels comfortable to you. The range of this slider is from 80 to 280 nits.<br />
<br />
Once those are set to their correct / preferred values, you are ready for the HDR experience. The game is still playable even if you skip the calibration step, but the image might look off or clipped, so best if you don't skip it. Be advised that HDR has been designed for low lighting environments, so you should avoid brightly lit rooms when playing for best results.<br />
<br />
<br />
== Choosing Your Preferred HDR Screenshot Format ==<br />
The default HDR screenshot format is OpenEXR. It is chosen for its impressive accuracy and ability to display colors in all color spaces used for HDR displays (Rec709, DCI-P3 and BT2020). Be advised that .exr files are <u>big</u> though. If you do not care that much about precise representation of what was on your screen at the time of capture and prefer having smaller size files that can maybe be easier to share online, you can switch the HDR snapshot output format to Radiance RGBE. Do do that, make a backup of the file <code><OoliteInstallDir>\oolite.app\GNUstep\Defaults\.GNUstepDefaults</code>, then open it in a text editor and add:<br />
<pre>"hdr-snapshot-format" = .hdr;</pre><br />
The leading dot is optional, Oolite will understand the extension with or without it. If you enter any random string other than the allowed "[.]hdr" and "[.]exr", a warning will be posted in the log and .exr will be selected by default anyway. Save the file and that's it.<br />
<br />
<br />
== Links ==<br />
*[https://bb.oolite.space/viewtopic.php?t=21311 Oolite on HDR Displays] (2022 - date) - this BB thread has the current information<br />
*[https://support.microsoft.com/en-us/windows/calibrate-your-hdr-display-using-the-windows-hdr-calibration-app-f30f4809-3369-43e4-9b02-9eabebd23f19 Windows 11 HDR Calibration App on Microsoft Support]<br />
<br />
[[Category:Oolite]] [[Category:Help pages]]<br />
[[Category:Factual]]</div>Another commanderhttps://wiki.alioth.net/index.php?title=HDR&diff=84396HDR2024-08-30T09:25:22Z<p>Another commander: </p>
<hr />
<div>High Dynamic Range (advanced video display - currently only available for Windows platforms)<br />
<br />
== Overview ==<br />
The current Windows Pre-releases/"nightlies" now support HDR. They can be downloaded from the very bottom of the [https://oolite.space/#download Downloads page] or directly from GitHub, [https://github.com/OoliteProject/oolite/releases here].<br />
<br />
If you have a compatible monitor or TV you can now enjoy vivid, bright and high contrast colors that seem to pop right out of your screen, while maintaining full image details in both highlights and dark areas. Furthermore, colors in HDR mode are 10-bit per RGB component as opposed to 8-bit in SDR and can now exceed the standard Rec709 color space and go well into the DCI-P3 and BT2020 color spaces (see [https://www.benq.com/en-us/business/resource/trends/understanding-color-gamut.html?srsltid=AfmBOop1EleuJqvrAjiH9WEG7rcuOJmG54hUicbStmP8IQK9JSnicLJv here] for more), creating an even more impressive visual experience with 1.07 billion color hues available to you rather than the 16.7 million available in SDR.<br />
<br />
Fine gameplay moments in HDR can be captured in either OpenEXR (.exr) or Radiance RGBE (.hdr) format using the standard Oolite save snapshot key. You can view Radiance files at a later time using software like Windows HDR+WCG Viewer (available from the Microsoft Store for free) or the also free and very powerful HDR image viewer utility, [https://cdn.discordapp.com/attachments/792979353117524009/1277053487368241325/SKIV.exe?ex=66cc6cfd&is=66cb1b7d&hm=417a59e377398a4e2d8e12b446dc8881f9498bd21538f2a89e0411ec8e78c3c5& SKIV].<br />
<br />
This has been implemented by our Developer, [[User:Another commander|Another commander]] (who also greatly improved visuals in Oolite versions 1.86, 1.88 & 1.90).<br />
<br />
=== Note ===<br />
Because the changes only affect the display on a HDR screen, there is no way of displaying the improvements on an older SDR screen!<br />
<br />
<br />
<br />
== How to Enable Oolite's HDR Mode ==<br />
After installing the game, a new shortcut will be added to the Start menu group for the game under Windows. Those who use the nightly installers will notice this new icon under the group "Oolite":<br />
<br />
[[file:OoliteHDRIcon.png|200px]]<br />
<br />
You can now use it to launch the game in HDR. Alternatively, you can launch Oolite from a console or the Windows Run dialog using <pre>C:\path\to\game\oolite.app\oolite.exe -hdr</pre><br />
<br />
As a reminder, to be able to run the game in this mode you need:<br />
* Windows 10 or 11 (11 is strongly recommended).<br />
* A monitor that supports HDR output. An OLED monitor or TV is <u>strongly</u> recommended.<br />
* Graphics card that supports HDR, like 10xx NVidia series or higher spec.<br />
* HDMI 2.1 / DisplayPort 1.4 or higher spec cable, so that the HDR bandwidth requirement is satisfied.<br />
* Enabling of HDR in Windows from the Settings -> System -> Display. If your system does not support HDR for whatever reason you will not have the option to enable it.<br />
[[File:OoliteHowToActivateHDRinWindows.png]]<br />
<br />
Attempting to launch the game in HDR mode without satisfying the above requirements will trigger a warning dialog informing the user that it was not possible to detect HDR on the system and asking whether the user would like to proceed with the game rendering as HDR in a non-suitable environment (i.e. looking weird) or abort.<br />
<br />
[[File:OoliteStartInHDRWithoutHDREnabled.jpg|320px]]<br />
<br />
<br />
== Calibration ==<br />
To obtain the most out of your HDR experience, you will have to calibrate the game to generate a display signal suitable for your monitor or TV. Oolite's Game Options menu is slightly different when the game is run in HDR mode, meaning that it has two options not normally appearing in the default menu: HDR Max Brightness and HDR Paper White. The menu in HDR mode will look as seen in the screen below:<br />
[[file:OoliteHDRMenu.png|1000px]]<br />
<br />
By default HDR Max Brightness is set to 1000 nits (or cd/m2) and HDR Paper White is set to 200 nits. You must adjust those values to match your display. At this moment Oolite does not feature an HDR calibration screen so you should get the Max Brightness information for your display from either the manufacturer's website or by running the Windows HDR Calibration utility (available for Windows 11 at the Microsoft Store for free).<br />
<br />
HDR Max Brightness can be set to 400, 500, 600, 800 and 1000 nits, but you can also edit descriptions.plist in your game install and add other values if you want - the game will accept them and use them. To add max brightness values, if so desired, open oolite.app/Resources/descriptions.plist in a text editor (backup the original file first just in case), find the block <pre>hdr_maxBrightness_array =<br />
(<br />
400, 500, 600, 800, 1000<br />
);</pre>and insert your new value in the row with the numbers, making sure it is separated by commas from the rest. Save and restart the game with Shift down to enable the edit and you should now have the extra option available. It is important that this value matches as closely as possible the actual max brightness your display can output for a <b>10% screen coverage window</b>.<br />
<br />
HDR Paper White indicates how bright a pure diffuse white object will be. You can think of it as a generic brightness slider. The higher you set it, the less headroom for highlights you leave. As a rule of thumb this can be set to about 1/4 of the max brightness, but it is entirely up to you to decide. You can set it to whatever feels comfortable to you. The range of this slider is from 80 to 280 nits.<br />
<br />
Once those are set to their correct / preferred values, you are ready for the HDR experience. The game is still playable even if you skip the calibration step, but the image might look off or clipped, so best if you don't skip it. Be advised that HDR has been designed for low lighting environments, so you should avoid brightly lit rooms when playing for best results.<br />
<br />
<br />
== Links ==<br />
*[https://bb.oolite.space/viewtopic.php?t=21311 Oolite on HDR Displays] (2022 - date) - this BB thread has the current information<br />
*[https://support.microsoft.com/en-us/windows/calibrate-your-hdr-display-using-the-windows-hdr-calibration-app-f30f4809-3369-43e4-9b02-9eabebd23f19 Windows 11 HDR Calibration App on Microsoft Support]<br />
<br />
[[Category:Oolite]] [[Category:Help pages]]<br />
[[Category:Factual]]</div>Another commanderhttps://wiki.alioth.net/index.php?title=HDR&diff=84389HDR2024-08-26T08:40:44Z<p>Another commander: </p>
<hr />
<div>High Dynamic Range (advanced video display - currently only available for Windows platforms)<br />
<br />
== Overview ==<br />
The current Windows Pre-releases/"nightlies" now support HDR. They can be downloaded from the very bottom of the [https://oolite.space/#download Downloads page] or directly from GitHub, [https://github.com/OoliteProject/oolite/releases here].<br />
<br />
If you have a compatible monitor or TV you can now enjoy vivid, bright and high contrast colors that seem to pop right out of your screen, while maintaining full image details in both highlights and dark areas. Furthermore, colors in HDR mode are 10-bit per RGB component as opposed to 8-bit in SDR and can now exceed the standard Rec709 color space and go well into the DCI-P3 and BT2020 color spaces (see [https://www.benq.com/en-us/business/resource/trends/understanding-color-gamut.html?srsltid=AfmBOop1EleuJqvrAjiH9WEG7rcuOJmG54hUicbStmP8IQK9JSnicLJv here] for more), creating an even more impressive visual experience with 1.07 billion color hues available to you rather than the 16.7 million available in SDR.<br />
<br />
Fine gameplay moments in HDR can be captured in Radiance (.hdr) format using the standard Oolite save snapshot key. You can view Radiance files at a later time using software like Windows HDR+WCG Viewer (available from the Microsoft Store for free) or the also free and very powerful HDR image viewer utility, [https://cdn.discordapp.com/attachments/792979353117524009/1277053487368241325/SKIV.exe?ex=66cc6cfd&is=66cb1b7d&hm=417a59e377398a4e2d8e12b446dc8881f9498bd21538f2a89e0411ec8e78c3c5& SKIV].<br />
<br />
This has been implemented by our Developer, [[User:Another commander|Another commander]] (who also greatly improved visuals in Oolite versions 1.86, 1.88 & 1.90).<br />
<br />
=== Note ===<br />
Because the changes only affect the display on a HDR screen, there is no way of displaying the improvements on an older SDR screen!<br />
<br />
<br />
<br />
== How to Enable Oolite's HDR Mode ==<br />
After installing the game, a new shortcut will be added to the Start menu group for the game under Windows. Those who use the nightly installers will notice this new icon under the group "Oolite":<br />
<br />
[[file:OoliteHDRIcon.png|200px]]<br />
<br />
You can now use it to launch the game in HDR. Alternatively, you can launch Oolite from a console or the Windows Run dialog using <pre>C:\path\to\game\oolite.app\oolite.exe -hdr</pre><br />
<br />
As a reminder, to be able to run the game in this mode you need:<br />
* Windows 10 or 11 (11 is strongly recommended).<br />
* A monitor that supports HDR output. An OLED monitor or TV is <u>strongly</u> recommended.<br />
* Graphics card that supports HDR, like 10xx NVidia series or higher spec.<br />
* HDMI 2.1 / DisplayPort 1.4 or higher spec cable, so that the HDR bandwidth requirement is satisfied.<br />
* Enabling of HDR in Windows from the Settings -> System -> Display. If your system does not support HDR for whatever reason you will not have the option to enable it.<br />
[[File:OoliteHowToActivateHDRinWindows.png]]<br />
<br />
Attempting to launch the game in HDR mode without satisfying the above requirements will trigger a warning dialog informing the user that it was not possible to detect HDR on the system and asking whether the user would like to proceed with the game rendering as HDR in a non-suitable environment (i.e. looking weird) or abort.<br />
<br />
[[File:OoliteStartInHDRWithoutHDREnabled.jpg|320px]]<br />
<br />
<br />
== Calibration ==<br />
To obtain the most out of your HDR experience, you will have to calibrate the game to generate a display signal suitable for your monitor or TV. Oolite's Game Options menu is slightly different when the game is run in HDR mode, meaning that it has two options not normally appearing in the default menu: HDR Max Brightness and HDR Paper White. The menu in HDR mode will look as seen in the screen below:<br />
[[file:OoliteHDRMenu.png|1000px]]<br />
<br />
By default HDR Max Brightness is set to 1000 nits (or cd/m2) and HDR Paper White is set to 200 nits. You must adjust those values to match your display. At this moment Oolite does not feature an HDR calibration screen so you should get the Max Brightness information for your display from either the manufacturer's website or by running the Windows HDR Calibration utility (available for Windows 11 at the Microsoft Store for free).<br />
<br />
HDR Max Brightness can be set to 400, 500, 600, 800 and 1000 nits, but you can also edit descriptions.plist in your game install and add other values if you want - the game will accept them and use them. To add max brightness values, if so desired, open oolite.app/Resources/descriptions.plist in a text editor (backup the original file first just in case), find the block <pre>hdr_maxBrightness_array =<br />
(<br />
400, 500, 600, 800, 1000<br />
);</pre>and insert your new value in the row with the numbers, making sure it is separated by commas from the rest. Save and restart the game with Shift down to enable the edit and you should now have the extra option available. It is important that this value matches as closely as possible the actual max brightness your display can output for a <b>10% screen coverage window</b>.<br />
<br />
HDR Paper White indicates how bright a pure diffuse white object will be. You can think of it as a generic brightness slider. The higher you set it, the less headroom for highlights you leave. As a rule of thumb this can be set to about 1/4 of the max brightness, but it is entirely up to you to decide. You can set it to whatever feels comfortable to you. The range of this slider is from 80 to 280 nits.<br />
<br />
Once those are set to their correct / preferred values, you are ready for the HDR experience. The game is still playable even if you skip the calibration step, but the image might look off or clipped, so best if you don't skip it. Be advised that HDR has been designed for low lighting environments, so you should avoid brightly lit rooms when playing for best results.<br />
<br />
<br />
== Links ==<br />
*[https://bb.oolite.space/viewtopic.php?t=21311 Oolite on HDR Displays] (2022 - date) - this BB thread has the current information<br />
*[https://support.microsoft.com/en-us/windows/calibrate-your-hdr-display-using-the-windows-hdr-calibration-app-f30f4809-3369-43e4-9b02-9eabebd23f19 Windows 11 HDR Calibration App on Microsoft Support]<br />
<br />
[[Category:Oolite]] [[Category:Help pages]]<br />
[[Category:Factual]]</div>Another commanderhttps://wiki.alioth.net/index.php?title=HDR&diff=84388HDR2024-08-26T08:37:20Z<p>Another commander: </p>
<hr />
<div>High Dynamic Range (advanced video display - currently only available for Windows platforms)<br />
<br />
== Overview ==<br />
The current Windows Pre-releases/"nightlies" now support HDR. They can be downloaded from the very bottom of the [https://oolite.space/#download Downloads page] or directly from GitHub, [https://github.com/OoliteProject/oolite/releases here].<br />
<br />
If you have a compatible monitor or TV you can now enjoy vivid, bright and high contrast colors that seem to pop right out of your screen, while maintaining full image details in both highlights and dark areas. Furthermore, colors in HDR mode are 10-bit per RGB component as opposed to 8-bit in SDR and can now exceed the standard Rec709 color space and go well into the DCI-P3 and BT2020 color spaces (see [https://www.benq.com/en-us/business/resource/trends/understanding-color-gamut.html?srsltid=AfmBOop1EleuJqvrAjiH9WEG7rcuOJmG54hUicbStmP8IQK9JSnicLJv here] for more), creating an even more impressive visual experience with 1.07 billion color hues available to you rather than the 16.7 million available in SDR.<br />
<br />
Fine gameplay moments in HDR can be captured in Radiance (.hdr) format using the standard Oolite save snapshot key. You can view Radiance files at a later time using software like Windows HDR+WCG Viewer (available from the Microsoft Store for free) or the also free and very powerful HDR image viewer utility, [https://cdn.discordapp.com/attachments/792979353117524009/1277053487368241325/SKIV.exe?ex=66cc6cfd&is=66cb1b7d&hm=417a59e377398a4e2d8e12b446dc8881f9498bd21538f2a89e0411ec8e78c3c5& SKIV].<br />
<br />
This has been implemented by our Developer, [[User:Another commander|Another commander]] (who also greatly improved visuals in Oolite versions 1.86, 1.88 & 1.90).<br />
<br />
=== Note ===<br />
Because the changes only affect the display on a HDR screen, there is no way of displaying the improvements on an older SDR screen!<br />
<br />
<br />
<br />
== How to Enable Oolite's HDR Mode ==<br />
After installing the game, a new shortcut will be added to the Start menu group for the game under Windows. Those who use the nightly installers will notice this new icon under the group "Oolite":<br />
<br />
[[file:OoliteHDRIcon.png|200px]]<br />
<br />
You can now use it to launch the game in HDR. Alternatively, you can launch Oolite from a console or the Windows Run dialog using <pre>C:\path\to\game\oolite.app\oolite.exe -hdr</pre><br />
<br />
As a reminder, to be able to run the game in this mode you need:<br />
* Windows 10 or 11 (11 is strongly recommended).<br />
* A monitor that supports HDR output. An OLED monitor or TV is <u>strongly</u> recommended.<br />
* Graphics card that supports HDR, like 10xx NVidia series or higher spec.<br />
* HDMI 2.1 / DisplayPort 1.4 or higher spec cable, so that the HDR bandwidth requirement is satisfied.<br />
* Enabling of HDR in Windows from the Settings -> System -> Display. If your system does not support HDR for whatever reason you will not have the option to enable it.<br />
[[File:OoliteHowToActivateHDRinWindows.png]]<br />
<br />
Attempting to launch the game in HDR mode without satisfying the above requirements will trigger a warning dialog informing the user that it was not possible to detect HDR on the system and asking whether the user would like to proceed with the game rendering as HDR in a non-suitable environment (i.e. looking weird) or abort.<br />
<br />
[[File:OoliteStartInHDRWithoutHDREnabled.jpg|320px]]<br />
<br />
<br />
== Calibration ==<br />
To obtain the most out of your HDR experience, you will have to calibrate the game to generate a display signal suitable for your monitor or TV. Oolite's Game Options menu is slightly different when the game is run in HDR mode, meaning that it has two options not normally appearing in the default menu: HDR Max Brightness and HDR Paper White. The menu in HDR mode will look as seen in the screen below:<br />
[[file:OoliteHDRMenu.png]]<br />
<br />
By default HDR Max Brightness is set to 1000 nits (or cd/m2) and HDR Paper White is set to 200 nits. You must adjust those values to match your display. At this moment Oolite does not feature an HDR calibration screen so you should get the Max Brightness information for your display from either the manufacturer's website or by running the Windows HDR Calibration utility (available for Windows 11 at the Microsoft Store for free).<br />
<br />
HDR Max Brightness can be set to 400, 500, 600, 800 and 1000 nits, but you can also edit descriptions.plist in your game install and add other values if you want - the game will accept them and use them. To add max brightness values, if so desired, open oolite.app/Resources/descriptions.plist in a text editor (backup the original file first just in case), find the block <pre>hdr_maxBrightness_array =<br />
(<br />
400, 500, 600, 800, 1000<br />
);</pre>and insert your new value in the row with the numbers, making sure it is separated by commas from the rest. Save and restart the game with Shift down to enable the edit and you should now have the extra option available. It is important that this value matches as closely as possible the actual max brightness your display can output for a <b>10% screen coverage window</b>.<br />
<br />
HDR Paper White indicates how bright a pure diffuse white object will be. You can think of it as a generic brightness slider. The higher you set it, the less headroom for highlights you leave. As a rule of thumb this can be set to about 1/4 of the max brightness, but it is entirely up to you to decide. You can set it to whatever feels comfortable to you. The range of this slider is from 80 to 280 nits.<br />
<br />
Once those are set to their correct / preferred values, you are ready for the HDR experience. The game is still playable even if you skip the calibration step, but the image might look off or clipped, so best if you don't skip it. Be advised that HDR has been designed for low lighting environments, so you should avoid brightly lit rooms when playing for best results.<br />
<br />
<br />
== Links ==<br />
*[https://bb.oolite.space/viewtopic.php?t=21311 Oolite on HDR Displays] (2022 - date) - this BB thread has the current information<br />
*[https://support.microsoft.com/en-us/windows/calibrate-your-hdr-display-using-the-windows-hdr-calibration-app-f30f4809-3369-43e4-9b02-9eabebd23f19 Windows 11 HDR Calibration App on Microsoft Support]<br />
<br />
[[Category:Oolite]] [[Category:Help pages]]<br />
[[Category:Factual]]</div>Another commanderhttps://wiki.alioth.net/index.php?title=HDR&diff=84387HDR2024-08-26T07:15:05Z<p>Another commander: </p>
<hr />
<div>High Dynamic Range (advanced video display - currently only available for Windows platforms)<br />
<br />
== Overview ==<br />
The current Windows Pre-releases/"nightlies" now support HDR. They can be downloaded from the very bottom of the [https://oolite.space/#download Downloads page] or directly from GitHub, [https://github.com/OoliteProject/oolite/releases here].<br />
<br />
If you have a compatible monitor or TV you can now enjoy vivid, bright and high contrast colors that seem to pop right out of your screen, while maintaining full image details in both highlights and dark areas. Furthermore, colors in HDR mode are 10-bit per RGB component as opposed to 8-bit in SDR and can now exceed the standard Rec709 color space and go well into the DCI-P3 and BT2020 color spaces (see [https://www.benq.com/en-us/business/resource/trends/understanding-color-gamut.html?srsltid=AfmBOop1EleuJqvrAjiH9WEG7rcuOJmG54hUicbStmP8IQK9JSnicLJv here] for more), creating an even more impressive visual experience with 1.07 billion color hues available to you rather than the 16.7 million available in SDR.<br />
<br />
Fine gameplay moments in HDR can be captured in Radiance (.hdr) format using the standard Oolite save snapshot key. You can view Radiance files at a later time using software like Windows HDR+WCG Viewer (available from the Microsoft Store for free) or the also free and very powerful HDR image viewer utility, [https://cdn.discordapp.com/attachments/792979353117524009/1277053487368241325/SKIV.exe?ex=66cc6cfd&is=66cb1b7d&hm=417a59e377398a4e2d8e12b446dc8881f9498bd21538f2a89e0411ec8e78c3c5& SKIV].<br />
<br />
This has been implemented by our Developer, [[User:Another commander|Another commander]] (who also greatly improved visuals in Oolite versions 1.86, 1.88 & 1.90).<br />
<br />
=== Note ===<br />
Because the changes only affect the display on a HDR screen, there is no way of displaying the improvements on an older SDR screen!<br />
<br />
<br />
<br />
== How to Enable Oolite's HDR Mode ==<br />
After installing the game, a new shortcut will be added to the Start menu group for the game under Windows. Those who use the nightly installers will notice this new icon under the group "Oolite":<br />
<br />
[[file:OoliteHDRIcon.png|200px]]<br />
<br />
You can now use it to launch the game in HDR. Alternatively, you can launch Oolite from a console or the Windows Run dialog using <pre>C:\path\to\game\oolite.app\oolite.exe -hdr</pre><br />
<br />
As a reminder, to be able to run the game in this mode you need:<br />
* Windows 10 or 11 (11 is strongly recommended).<br />
* A monitor that supports HDR output. An OLED monitor or TV is <u>strongly</u> recommended.<br />
* Graphics card that supports HDR, like 10xx NVidia series or higher spec.<br />
* HDMI 2.1 / DisplayPort 1.4 or higher spec cable, so that the HDR bandwidth requirement is satisfied.<br />
* Enabling of HDR in Windows from the Settings -> System -> Display. If your system does not support HDR for whatever reason you will not have the option to enable it.<br />
[[File:OoliteHowToActivateHDRinWindows.png]]<br />
<br />
Attempting to launch the game in HDR mode without satisfying the above requirements will trigger a warning dialog informing the user that it was not possible to detect HDR on the system and asking whether the user would like to proceed with the game rendering as HDR in a non-suitable environment (i.e. looking weird) or abort.<br />
<br />
[[File:OoliteStartInHDRWithoutHDREnabled.jpg|320px]]<br />
<br />
<br />
== Calibration ==<br />
To obtain the most out of your HDR experience, you will have to calibrate the game to generate a display signal suitable for your monitor or TV. Oolite's Game Options menu is slightly different when the game is run in HDR mode, meaning that it has two options not normally appearing in the default menu: HDR Max Brightness and HDR Paper White. The menu in HDR mode will look as seen in the screen below:<br />
[[file:OoliteHDRMenu.png]]<br />
<br />
By default HDR Max Brightness is set to 1000 nits (or cd/m2) and HDR Paper White is set to 200 nits. You must adjust those values to match your display. At this moment Oolite does not feature an HDR calibration screen so you should get the Max Brightness information for your display from either the manufacturer's website or by running the Windows HDR Calibration utility (available for Windows 11 at the Microsoft Store for free).<br />
<br />
HDR Max Brightness can be set to 400, 500, 600, 800 and 1000 nits, but you can also edit descriptions.plist in your game install and add other values if you want - the game will accept them and use them. To add max brightness values, if so desired, open oolite.app/Resources/descriptions.plist in a text editor (backup the original file first just in case), find the block <pre>hdr_maxBrightness_array =<br />
(<br />
400, 500, 600, 800, 1000<br />
);</pre>and insert your new value in the row with the numbers, making sure it is separated by commas from the rest. Save and restart the game with Shift down to enable the edit and you should now have the extra option available. It is important that this value matches as closely as possible the actual max brightness your display can output for a <b>10% screen coverage window</b>.<br />
<br />
HDR Paper White indicates how bright a pure diffuse white object will be. You can think of it as a generic brightness slider. The higher you set it, the less headroom for highlights you leave. As a rule of thumb this can be set to about 1/4 of the max brightness, but it is entirely up to you to decide. You can set it to whatever feels comfortable to you.<br />
<br />
Once those are set to their correct / preferred values, you are ready for the HDR experience. The game is still playable even if you skip the calibration step, but the image might look off or clipped, so best if you don't skip it. Be advised that HDR has been designed for low lighting environments, so you should avoid brightly lit rooms when playing for best results.<br />
<br />
<br />
== Links ==<br />
*[https://bb.oolite.space/viewtopic.php?t=21311 Oolite on HDR Displays] (2022 - date) - this BB thread has the current information<br />
*[https://support.microsoft.com/en-us/windows/calibrate-your-hdr-display-using-the-windows-hdr-calibration-app-f30f4809-3369-43e4-9b02-9eabebd23f19 Windows 11 HDR Calibration App on Microsoft Support]<br />
<br />
[[Category:Oolite]] [[Category:Help pages]]<br />
[[Category:Factual]]</div>Another commanderhttps://wiki.alioth.net/index.php?title=HDR&diff=84386HDR2024-08-26T06:10:32Z<p>Another commander: </p>
<hr />
<div>High Dynamic Range (advanced video display - currently only available for Windows platforms)<br />
<br />
== Overview ==<br />
The current Windows Pre-releases/"nightlies" now support HDR. They can be downloaded from the very bottom of the [https://oolite.space/#download Downloads page] or directly from GitHub, [https://github.com/OoliteProject/oolite/releases here].<br />
<br />
If you have a compatible monitor or TV you can now enjoy vivid, bright and high contrast colors that seem to pop right out of your screen, while maintaining full image details in both highlights and dark areas. Furthermore, colors in HDR mode are 10-bit per RGB component as opposed to 8-bit in SDR and can now exceed the standard Rec709 color space and go well into the DCI-P3 and BT2020 color spaces (see [https://www.benq.com/en-us/business/resource/trends/understanding-color-gamut.html?srsltid=AfmBOop1EleuJqvrAjiH9WEG7rcuOJmG54hUicbStmP8IQK9JSnicLJv here] for more), creating an even more impressive visual experience with 1.07 billion color hues available to you rather than the 16.7 million available in SDR.<br />
<br />
Fine gameplay moments in HDR can be captured in Radiance (.hdr) format using the standard Oolite save snapshot key. You can view Radiance files at a later time using software like Windows HDR+WCG Viewer (available from the Microsoft Store for free) or the also free and very powerful HDR image viewer utility, [https://cdn.discordapp.com/attachments/792979353117524009/1277053487368241325/SKIV.exe?ex=66cc6cfd&is=66cb1b7d&hm=417a59e377398a4e2d8e12b446dc8881f9498bd21538f2a89e0411ec8e78c3c5& SKIV].<br />
<br />
This has been implemented by our Developer, [[User:Another commander|Another commander]] (who also greatly improved visuals in Oolite versions 1.86, 1.88 & 1.90).<br />
<br />
=== Note ===<br />
Because the changes only affect the display on a HDR screen, there is no way of displaying the improvements on an older SDR screen!<br />
<br />
<br />
<br />
== How to Enable Oolite's HDR Mode ==<br />
After installing the game, a new shortcut will be added to the Start menu group for the game under Windows. Those who use the nightly installers will notice this new icon under the group "Oolite":<br />
<br />
[[file:OoliteHDRIcon.png|200px]]<br />
<br />
You can now use it to launch the game in HDR. Alternatively, you can launch Oolite from a console or the Windows Run dialog using <pre>C:\path\to\game\oolite.app\oolite.exe -hdr</pre><br />
<br />
As a reminder, to be able to run the game in this mode you need:<br />
* Windows 10 or 11 (11 is strongly recommended).<br />
* A monitor that supports HDR output. An OLED monitor or TV is <u>strongly</u> recommended.<br />
* Graphics card that supports HDR, like 10xx NVidia series or higher spec.<br />
* HDMI 2.1 / DisplayPort 1.4 or higher spec cable, so that the HDR bandwidth requirement is satisfied.<br />
* Enabling of HDR in Windows from the Settings -> System -> Display. If your system does not support HDR for whatever reason you will not have the option to enable it.<br />
[[File:OoliteHowToActivateHDRinWindows.png]]<br />
<br />
Attempting to launch the game in HDR mode without satisfying the above requirements will trigger a warning dialog informing the user that it was not possible to detect HDR on the system and asking whether the user would like to proceed with the game rendering as HDR in a non-suitable environment (i.e. looking weird) or abort.<br />
<br />
[[File:OoliteStartInHDRWithoutHDREnabled.jpg|320px]]<br />
<br />
<br />
== Calibration ==<br />
To obtain the most out of your HDR experience, you will have to calibrate the game to generate a display signal suitable for your monitor or TV. Oolite's Game Options menu is slightly different when the game is run in HDR mode, meaning that it has two options not normally appearing in the default menu: HDR Max Brightness and HDR Paper White. The menu in HDR mode will look as seen in the screen below:<br />
[[file:OoliteHDRMenu.png]]<br />
<br />
By default HDR Max Brightness is set to 1000 nits (or cd/m2) and HDR Paper White is set to 200 nits. You must adjust those values to match your display. At this moment Oolite does not feature an HDR calibration screen so you should get the Max Brightness information for your display from either the manufacturer's website or by running the Windows HDR Calibration utility (available for Windows 11 at the Microsoft Store for free).<br />
<br />
HDR Max Brightness can be set to 400, 500, 600, 800 and 1000 nits, but you can also edit descriptions.plist in your game install and add other values if you want - the game will accept them and use them. To add max brightness values, if so desired, open oolite.app/Resources/descriptions.plist in a text editor (backup the original file first just in case), find the block <pre>hdr_maxBrightness_array =<br />
(<br />
400, 500, 600, 800, 1000<br />
);</pre>and insert your new value in the row with the numbers, making sure it is separated by commas from the rest. Save and restart the game with Shift down to enable the edit and you should now have the extra option available. It is important that this value matches as closely as possible the actual max brightness your display can output for a <b>10% screen coverage window</b>.<br />
<br />
HDR Paper White indicates how bright a pure diffuse white object will be. You can think of it as a generic brightness slider. The higher you set it, the less headroom for highlights you leave. As a rule of thumb this can be set to about 1/4 of the max brightness, but it is entirely up to you to decide. You can set it to whatever feels comfortable to you.<br />
<br />
Once those are set to their correct / preferred values, you are ready for the HDR experience. Be dadvised that HDR has been designed for low lighting environments, so you should avoid brightly lit rooms when playing for best results.<br />
<br />
<br />
== Links ==<br />
*[https://bb.oolite.space/viewtopic.php?t=21311 Oolite on HDR Displays] (2022 - date) - this BB thread has the current information<br />
*[https://support.microsoft.com/en-us/windows/calibrate-your-hdr-display-using-the-windows-hdr-calibration-app-f30f4809-3369-43e4-9b02-9eabebd23f19 Windows 11 HDR Calibration App on Microsoft Support]<br />
<br />
[[Category:Oolite]] [[Category:Help pages]]<br />
[[Category:Factual]]</div>Another commanderhttps://wiki.alioth.net/index.php?title=HDR&diff=84385HDR2024-08-26T06:10:07Z<p>Another commander: </p>
<hr />
<div>High Dynamic Range (advanced video display - currently only available for Windows platforms)<br />
<br />
== Overview ==<br />
The current Windows Pre-releases/"nightlies" now support HDR. They can be downloaded from the very bottom of the [https://oolite.space/#download Downloads page] or directly from GitHub, [https://github.com/OoliteProject/oolite/releases here].<br />
<br />
If you have a compatible monitor or TV you can now enjoy vivid, bright and high contrast colors that seem to pop right out of your screen, while maintaining full image details in both highlights and dark areas. Furthermore, colors in HDR mode are 10-bit per RGB component as opposed to 8-bit in SDR and can now exceed the standard Rec709 color space and go well into the DCI-P3 and BT2020 color spaces (see [https://www.benq.com/en-us/business/resource/trends/understanding-color-gamut.html?srsltid=AfmBOop1EleuJqvrAjiH9WEG7rcuOJmG54hUicbStmP8IQK9JSnicLJv here] for more), creating an even more impressive visual experience with 1.07 billion color hues available to you rather than the 16.7 million available in SDR.<br />
<br />
Fine gameplay moments in HDR can be captured in Radiance (.hdr) format using the standard Oolite save snapshot key. You can view Radiance files at a later time using software like Windows HDR+WCG Viewer (available from the Microsoft Store for free) or the also free and very powerful HDR image viewer utility, [https://cdn.discordapp.com/attachments/792979353117524009/1277053487368241325/SKIV.exe?ex=66cc6cfd&is=66cb1b7d&hm=417a59e377398a4e2d8e12b446dc8881f9498bd21538f2a89e0411ec8e78c3c5& SKIV].<br />
<br />
This has been implemented by our Developer, [[User:Another commander|Another commander]] (who also greatly improved visuals in Oolite versions 1.86, 1.88 & 1.90).<br />
<br />
=== Note ===<br />
Because the changes only affect the display on a HDR screen, there is no way of displaying the improvements on an older SDR screen!<br />
<br />
<br />
<br />
== How to Enable Oolite's HDR Mode ==<br />
After installing the game, a new shortcut will be added to the Start menu group for the game under Windows. Those who use the nightly installers will notice this new icon under the group "Oolite":<br />
<br />
[[file:OoliteHDRIcon.png|200px]]<br />
<br />
You can now use it to launch the game in HDR. Alternatively, you can launch Oolite from a console or the Windows Run dialog using <pre>C:\path\to\game\oolite.app\oolite.exe -hdr</pre><br />
<br />
As a reminder, to be able to run the game in this mode you need:<br />
* Windows 10 or 11 (11 is strongly recommended).<br />
* A monitor that supports HDR output. An OLED monitor or TV is <u>strongly</u> recommended.<br />
* Graphics card that supports HDR, like 10xx NVidia series or higher spec.<br />
* HDMI 2.1 / DisplayPort 1.4 or higher spec cable, so that the HDR bandwidth requirement is satisfied.<br />
* Enabling of HDR in Windows from the Settings -> System -> Display. If your system does not support HDR for whatever reason you will not have the option to enable it.<br />
[[File:OoliteHowToActivateHDRinWindows.png]]<br />
<br />
Attempting to launch the game in HDR mode without satisfying the above requirements will trigger a warning dialog informing the user that it was not possible to detect HDR on the system and asking whether the user would like to proceed with the game rendering as HDR in a non-suitable environment (i.e. looking weird) or abort.<br />
<br />
[[File:OoliteStartInHDRWithoutHDREnabled.jpg|320px]]<br />
<br />
<br />
== Calibration ==<br />
To obtain the most out of your HDR experience, you will have to calibrate the game to generate a display signal suitable for your monitor or TV. Oolite's Game Options menu is slightly different when the game is run in HDR mode, meaning that it has two options not normally appearing in the default menu: HDR Max Brightness and HDR Paper White. The menu in HDR mode will look as seen in the screen below:<br />
[[file:OoliteHDRMenu.png]]<br />
<br />
By default HDR Max Brightness is set to 1000 nits (or cd/m2) and HDR Paper White is set to 200 nits. You must adjust those values to match your display. At this moment Oolite does not feature an HDR calibration screen so you should get the Max Brightness information for your display from either the manufacturer's website or by running the Windows HDR Calibration utility (available for Windows 11 at the Microsoft Store for free).<br />
<br />
HDR Max Brightness can be set to 400, 500, 600, 800 and 1000 nits, but you can also edit descriptions.plist in your game install and add other values if you want - the game will accept them and use them. To add max brightness values, if so desired, open oolite.app/Resources/descriptions.plist in a text editor (backup the original file first just in case), find the block <pre>hdr_maxBrightness_array =<br />
(<br />
400, 500, 600, 800, 1000<br />
);</pre>and insert your new value in the row with the numbers, making sure it is separated by commas from the rest. Save and restart the game with Shift down to enable the edit and you should now have the extra option available. It is important that this value matches as closely as possible the actual max brightness your display can output for a <b>10% screen coverage window</b>.<br />
<br />
HDR Paper White indicates how bright a pure diffuse white object will be. You can think of it as a generic brightness slider. The higher you set it, the less headroom for highlights you leave. As a rule of thumb this can be set to about 1/4 of the max brightness, but it is entirely up to you to decide. You can set it to whatever feels comfortable to you.<br />
<br />
Once those are set to their correct / preferred values, you are ready for the HDR experience. Be dadvised that HDR has been designed for low lighting environments, so you should avoid brightly lit rooms when playing for best results.<br />
<br />
== Links ==<br />
*[https://bb.oolite.space/viewtopic.php?t=21311 Oolite on HDR Displays] (2022 - date) - this BB thread has the current information<br />
*[https://support.microsoft.com/en-us/windows/calibrate-your-hdr-display-using-the-windows-hdr-calibration-app-f30f4809-3369-43e4-9b02-9eabebd23f19 Windows 11 HDR Calibration App on Microsoft Support]<br />
<br />
[[Category:Oolite]] [[Category:Help pages]]<br />
[[Category:Factual]]</div>Another commanderhttps://wiki.alioth.net/index.php?title=HDR&diff=84384HDR2024-08-26T06:08:55Z<p>Another commander: /* How to Enable Oolite's HDR Mode */</p>
<hr />
<div>High Dynamic Range (advanced video display - currently only available for Windows platforms)<br />
<br />
== Overview ==<br />
The current Windows Pre-releases/"nightlies" now support HDR. They can be downloaded from the very bottom of the [https://oolite.space/#download Downloads page] or directly from GitHub, [https://github.com/OoliteProject/oolite/releases here].<br />
<br />
If you have a compatible monitor or TV you can now enjoy vivid, bright and high contrast colors that seem to pop right out of your screen, while maintaining full image details in both highlights and dark areas. Furthermore, colors in HDR mode are 10-bit per RGB component as opposed to 8-bit in SDR and can now exceed the standard Rec709 color space and go well into the DCI-P3 and BT2020 color spaces (see [https://www.benq.com/en-us/business/resource/trends/understanding-color-gamut.html?srsltid=AfmBOop1EleuJqvrAjiH9WEG7rcuOJmG54hUicbStmP8IQK9JSnicLJv here] for more), creating an even more impressive visual experience with 1.07 billion color hues available to you rather than the 16.7 million available in SDR.<br />
<br />
Fine gameplay moments in HDR can be captured in Radiance (.hdr) format using the standard Oolite save snapshot key. You can view Radiance files at a later time using software like Windows HDR+WCG Viewer (available from the Microsoft Store for free) or the also free and very powerful HDR image viewer utility, [https://cdn.discordapp.com/attachments/792979353117524009/1277053487368241325/SKIV.exe?ex=66cc6cfd&is=66cb1b7d&hm=417a59e377398a4e2d8e12b446dc8881f9498bd21538f2a89e0411ec8e78c3c5& SKIV].<br />
<br />
This has been implemented by our Developer, [[User:Another commander|Another commander]] (who also greatly improved visuals in Oolite versions 1.86, 1.88 & 1.90).<br />
<br />
=== Note ===<br />
Because the changes only affect the display on a HDR screen, there is no way of displaying the improvements on an older SDR screen!<br />
<br />
<br />
<br />
== How to Enable Oolite's HDR Mode ==<br />
After installing the game, a new shortcut will be added to the Start menu group for the game under Windows. Those who use the nightly installers will notice this new icon under the group "Oolite":<br />
<br />
[[file:OoliteHDRIcon.png|200px]]<br />
<br />
You can now use it to launch the game in HDR. Alternatively, you can launch Oolite from a console or the Windows Run dialog using <pre>C:\path\to\game\oolite.app\oolite.exe -hdr</pre><br />
<br />
As a reminder, to be able to run the game in this mode you need:<br />
* Windows 10 or 11 (11 is strongly recommended).<br />
* A monitor that supports HDR output. An OLED monitor or TV is <u>strongly</u> recommended.<br />
* Graphics card that supports HDR, like 10xx NVidia series or higher spec.<br />
* HDMI 2.1 / DisplayPort 1.4 or higher spec cable, so that the HDR bandwidth requirement is satisfied.<br />
* Enabling of HDR in Windows from the Settings -> System -> Display. If your system does not support HDR for whatever reason you will not have the option to enable it.<br />
[[File:OoliteHowToActivateHDRinWindows.png]]<br />
<br />
Attempting to launch the game in HDR mode without satisfying the above requirements will trigger a warning dialog informing the user that it was not possible to detect HDR on the system and asking whether the user would like to proceed with the game rendering as HDR in a non-suitable environment (i.e. looking weird) or abort.<br />
<br />
[[File:OoliteStartInHDRWithoutHDREnabled.jpg|320px]]<br />
<br />
== Calibration ==<br />
To obtain the most out of your HDR experience, you will have to calibrate the game to generate a display signal suitable for your monitor or TV. Oolite's Game Options menu is slightly different when the game is run in HDR mode, meaning that it has two options not normally appearing in the default menu: HDR Max Brightness and HDR Paper White. The menu in HDR mode will look as seen in the screen below:<br />
[[file:OoliteHDRMenu.png]]<br />
<br />
By default HDR Max Brightness is set to 1000 nits (or cd/m2) and HDR Paper White is set to 200 nits. You must adjust those values to match your display. At this moment Oolite does not feature an HDR calibration screen so you should get the Max Brightness information for your display from either the manufacturer's website or by running the Windows HDR Calibration utility (available for Windows 11 at the Microsoft Store for free).<br />
<br />
HDR Max Brightness can be set to 400, 500, 600, 800 and 1000 nits, but you can also edit descriptions.plist in your game install and add other values if you want - the game will accept them and use them. To add max brightness values, if so desired, open oolite.app/Resources/descriptions.plist in a text editor (backup the original file first just in case), find the block <pre>hdr_maxBrightness_array =<br />
(<br />
400, 500, 600, 800, 1000<br />
);</pre>and insert your new value in the row with the numbers, making sure it is separated by commas from the rest. Save and restart the game with Shift down to enable the edit and you should now have the extra option available. It is important that this value matches as closely as possible the actual max brightness your display can output for a <b>10% screen coverage window</b>.<br />
<br />
HDR Paper White indicates how bright a pure diffuse white object will be. You can think of it as a generic brightness slider. The higher you set it, the less headroom for highlights you leave. As a rule of thumb this can be set to about 1/4 of the max brightness, but it is entirely up to you to decide. You can set it to whatever feels comfortable to you.<br />
<br />
Once those are set to their correct / preferred values, you are ready for the HDR experience. Be dadvised that HDR has been designed for low lighting environments, so you should avoid brightly lit rooms when playing for best results.<br />
<br />
== Links ==<br />
*[https://bb.oolite.space/viewtopic.php?t=21311 Oolite on HDR Displays] (2022 - date) - this BB thread has the current information<br />
*[https://support.microsoft.com/en-us/windows/calibrate-your-hdr-display-using-the-windows-hdr-calibration-app-f30f4809-3369-43e4-9b02-9eabebd23f19 Windows 11 HDR Calibration App on Microsoft Support]<br />
<br />
[[Category:Oolite]] [[Category:Help pages]]<br />
[[Category:Factual]]</div>Another commanderhttps://wiki.alioth.net/index.php?title=HDR&diff=84383HDR2024-08-26T06:08:29Z<p>Another commander: /* How to Enable Oolite's HDR Mode */</p>
<hr />
<div>High Dynamic Range (advanced video display - currently only available for Windows platforms)<br />
<br />
== Overview ==<br />
The current Windows Pre-releases/"nightlies" now support HDR. They can be downloaded from the very bottom of the [https://oolite.space/#download Downloads page] or directly from GitHub, [https://github.com/OoliteProject/oolite/releases here].<br />
<br />
If you have a compatible monitor or TV you can now enjoy vivid, bright and high contrast colors that seem to pop right out of your screen, while maintaining full image details in both highlights and dark areas. Furthermore, colors in HDR mode are 10-bit per RGB component as opposed to 8-bit in SDR and can now exceed the standard Rec709 color space and go well into the DCI-P3 and BT2020 color spaces (see [https://www.benq.com/en-us/business/resource/trends/understanding-color-gamut.html?srsltid=AfmBOop1EleuJqvrAjiH9WEG7rcuOJmG54hUicbStmP8IQK9JSnicLJv here] for more), creating an even more impressive visual experience with 1.07 billion color hues available to you rather than the 16.7 million available in SDR.<br />
<br />
Fine gameplay moments in HDR can be captured in Radiance (.hdr) format using the standard Oolite save snapshot key. You can view Radiance files at a later time using software like Windows HDR+WCG Viewer (available from the Microsoft Store for free) or the also free and very powerful HDR image viewer utility, [https://cdn.discordapp.com/attachments/792979353117524009/1277053487368241325/SKIV.exe?ex=66cc6cfd&is=66cb1b7d&hm=417a59e377398a4e2d8e12b446dc8881f9498bd21538f2a89e0411ec8e78c3c5& SKIV].<br />
<br />
This has been implemented by our Developer, [[User:Another commander|Another commander]] (who also greatly improved visuals in Oolite versions 1.86, 1.88 & 1.90).<br />
<br />
=== Note ===<br />
Because the changes only affect the display on a HDR screen, there is no way of displaying the improvements on an older SDR screen!<br />
<br />
<br />
<br />
== How to Enable Oolite's HDR Mode ==<br />
After installing the game, a new shortcut will be added to the Start menu group for the game under Windows. Those who use the nightly installers, will notice this new icon under the group "Oolite":<br />
<br />
[[file:OoliteHDRIcon.png|200px]]<br />
<br />
You can now use it to launch the game in HDR. Alternatively, you can launch Oolite from a console or the Windows Run dialog using <pre>C:\path\to\game\oolite.app\oolite.exe -hdr</pre><br />
<br />
As a reminder, to be able to run the game in this mode you need:<br />
* Windows 10 or 11 (11 is strongly recommended).<br />
* A monitor that supports HDR output. An OLED monitor or TV is <u>strongly</u> recommended.<br />
* Graphics card that supports HDR, like 10xx NVidia series or higher spec.<br />
* HDMI 2.1 / DisplayPort 1.4 or higher spec cable, so that the HDR bandwidth requirement is satisfied.<br />
* Enabling of HDR in Windows from the Settings -> System -> Display. If your system does not support HDR for whatever reason you will not have the option to enable it.<br />
[[File:OoliteHowToActivateHDRinWindows.png]]<br />
<br />
Attempting to launch the game in HDR mode without satisfying the above requirements will trigger a warning dialog informing the user that it was not possible to detect HDR on the system and asking whether the user would like to proceed with the game rendering as HDR in a non-suitable environment (i.e. looking weird) or abort.<br />
<br />
[[File:OoliteStartInHDRWithoutHDREnabled.jpg|320px]]<br />
<br />
== Calibration ==<br />
To obtain the most out of your HDR experience, you will have to calibrate the game to generate a display signal suitable for your monitor or TV. Oolite's Game Options menu is slightly different when the game is run in HDR mode, meaning that it has two options not normally appearing in the default menu: HDR Max Brightness and HDR Paper White. The menu in HDR mode will look as seen in the screen below:<br />
[[file:OoliteHDRMenu.png]]<br />
<br />
By default HDR Max Brightness is set to 1000 nits (or cd/m2) and HDR Paper White is set to 200 nits. You must adjust those values to match your display. At this moment Oolite does not feature an HDR calibration screen so you should get the Max Brightness information for your display from either the manufacturer's website or by running the Windows HDR Calibration utility (available for Windows 11 at the Microsoft Store for free).<br />
<br />
HDR Max Brightness can be set to 400, 500, 600, 800 and 1000 nits, but you can also edit descriptions.plist in your game install and add other values if you want - the game will accept them and use them. To add max brightness values, if so desired, open oolite.app/Resources/descriptions.plist in a text editor (backup the original file first just in case), find the block <pre>hdr_maxBrightness_array =<br />
(<br />
400, 500, 600, 800, 1000<br />
);</pre>and insert your new value in the row with the numbers, making sure it is separated by commas from the rest. Save and restart the game with Shift down to enable the edit and you should now have the extra option available. It is important that this value matches as closely as possible the actual max brightness your display can output for a <b>10% screen coverage window</b>.<br />
<br />
HDR Paper White indicates how bright a pure diffuse white object will be. You can think of it as a generic brightness slider. The higher you set it, the less headroom for highlights you leave. As a rule of thumb this can be set to about 1/4 of the max brightness, but it is entirely up to you to decide. You can set it to whatever feels comfortable to you.<br />
<br />
Once those are set to their correct / preferred values, you are ready for the HDR experience. Be dadvised that HDR has been designed for low lighting environments, so you should avoid brightly lit rooms when playing for best results.<br />
<br />
== Links ==<br />
*[https://bb.oolite.space/viewtopic.php?t=21311 Oolite on HDR Displays] (2022 - date) - this BB thread has the current information<br />
*[https://support.microsoft.com/en-us/windows/calibrate-your-hdr-display-using-the-windows-hdr-calibration-app-f30f4809-3369-43e4-9b02-9eabebd23f19 Windows 11 HDR Calibration App on Microsoft Support]<br />
<br />
[[Category:Oolite]] [[Category:Help pages]]<br />
[[Category:Factual]]</div>Another commanderhttps://wiki.alioth.net/index.php?title=HDR&diff=84382HDR2024-08-26T06:04:51Z<p>Another commander: /* Calibration */</p>
<hr />
<div>High Dynamic Range (advanced video display - currently only available for Windows platforms)<br />
<br />
== Overview ==<br />
The current Windows Pre-releases/"nightlies" now support HDR. They can be downloaded from the very bottom of the [https://oolite.space/#download Downloads page] or directly from GitHub, [https://github.com/OoliteProject/oolite/releases here].<br />
<br />
If you have a compatible monitor or TV you can now enjoy vivid, bright and high contrast colors that seem to pop right out of your screen, while maintaining full image details in both highlights and dark areas. Furthermore, colors in HDR mode are 10-bit per RGB component as opposed to 8-bit in SDR and can now exceed the standard Rec709 color space and go well into the DCI-P3 and BT2020 color spaces (see [https://www.benq.com/en-us/business/resource/trends/understanding-color-gamut.html?srsltid=AfmBOop1EleuJqvrAjiH9WEG7rcuOJmG54hUicbStmP8IQK9JSnicLJv here] for more), creating an even more impressive visual experience with 1.07 billion color hues available to you rather than the 16.7 million available in SDR.<br />
<br />
Fine gameplay moments in HDR can be captured in Radiance (.hdr) format using the standard Oolite save snapshot key. You can view Radiance files at a later time using software like Windows HDR+WCG Viewer (available from the Microsoft Store for free) or the also free and very powerful HDR image viewer utility, [https://cdn.discordapp.com/attachments/792979353117524009/1277053487368241325/SKIV.exe?ex=66cc6cfd&is=66cb1b7d&hm=417a59e377398a4e2d8e12b446dc8881f9498bd21538f2a89e0411ec8e78c3c5& SKIV].<br />
<br />
This has been implemented by our Developer, [[User:Another commander|Another commander]] (who also greatly improved visuals in Oolite versions 1.86, 1.88 & 1.90).<br />
<br />
=== Note ===<br />
Because the changes only affect the display on a HDR screen, there is no way of displaying the improvements on an older SDR screen!<br />
<br />
<br />
<br />
== How to Enable Oolite's HDR Mode ==<br />
After installing the game, a new shortcut will be added to the Start menu group for the game under Windows. Those who use the nightly installers, will notice this new icon under the group "Oolite":<br />
<br />
[[file:OoliteHDRIcon.png]]<br />
<br />
You can now use it to launch the game in HDR. Alternatively, you can launch Oolite from a console or the Windows Run dialog using <pre>C:\path\to\game\oolite.app\oolite.exe -hdr</pre><br />
<br />
As a reminder, to be able to run the game in this mode you need:<br />
* Windows 10 or 11 (11 is strongly recommended).<br />
* A monitor that supports HDR output. An OLED monitor or TV is <u>strongly</u> recommended.<br />
* Graphics card that supports HDR, like 10xx NVidia series or higher spec.<br />
* HDMI 2.1 / DisplayPort 1.4 or higher spec cable, so that the HDR bandwidth requirement is satisfied.<br />
* Enabling of HDR in Windows from the Settings -> System -> Display. If your system does not support HDR for whatever reason you will not have the option to enable it.<br />
[[File:OoliteHowToActivateHDRinWindows.png]]<br />
<br />
Attempting to launch the game in HDR mode without satisfying the above requirements will trigger a warning dialog informing the user that it was not possible to detect HDR on the system and asking whether the user would like to proceed with the game rendering as HDR in a non-suitable environment (i.e. looking weird) or abort.<br />
<br />
[[File:OoliteStartInHDRWithoutHDREnabled.jpg|320px]]<br />
<br />
<br />
== Calibration ==<br />
To obtain the most out of your HDR experience, you will have to calibrate the game to generate a display signal suitable for your monitor or TV. Oolite's Game Options menu is slightly different when the game is run in HDR mode, meaning that it has two options not normally appearing in the default menu: HDR Max Brightness and HDR Paper White. The menu in HDR mode will look as seen in the screen below:<br />
[[file:OoliteHDRMenu.png]]<br />
<br />
By default HDR Max Brightness is set to 1000 nits (or cd/m2) and HDR Paper White is set to 200 nits. You must adjust those values to match your display. At this moment Oolite does not feature an HDR calibration screen so you should get the Max Brightness information for your display from either the manufacturer's website or by running the Windows HDR Calibration utility (available for Windows 11 at the Microsoft Store for free).<br />
<br />
HDR Max Brightness can be set to 400, 500, 600, 800 and 1000 nits, but you can also edit descriptions.plist in your game install and add other values if you want - the game will accept them and use them. To add max brightness values, if so desired, open oolite.app/Resources/descriptions.plist in a text editor (backup the original file first just in case), find the block <pre>hdr_maxBrightness_array =<br />
(<br />
400, 500, 600, 800, 1000<br />
);</pre>and insert your new value in the row with the numbers, making sure it is separated by commas from the rest. Save and restart the game with Shift down to enable the edit and you should now have the extra option available. It is important that this value matches as closely as possible the actual max brightness your display can output for a <b>10% screen coverage window</b>.<br />
<br />
HDR Paper White indicates how bright a pure diffuse white object will be. You can think of it as a generic brightness slider. The higher you set it, the less headroom for highlights you leave. As a rule of thumb this can be set to about 1/4 of the max brightness, but it is entirely up to you to decide. You can set it to whatever feels comfortable to you.<br />
<br />
Once those are set to their correct / preferred values, you are ready for the HDR experience. Be dadvised that HDR has been designed for low lighting environments, so you should avoid brightly lit rooms when playing for best results.<br />
<br />
== Links ==<br />
*[https://bb.oolite.space/viewtopic.php?t=21311 Oolite on HDR Displays] (2022 - date) - this BB thread has the current information<br />
*[https://support.microsoft.com/en-us/windows/calibrate-your-hdr-display-using-the-windows-hdr-calibration-app-f30f4809-3369-43e4-9b02-9eabebd23f19 Windows 11 HDR Calibration App on Microsoft Support]<br />
<br />
[[Category:Oolite]] [[Category:Help pages]]<br />
[[Category:Factual]]</div>Another commanderhttps://wiki.alioth.net/index.php?title=HDR&diff=84381HDR2024-08-26T06:03:35Z<p>Another commander: /* Calibration */</p>
<hr />
<div>High Dynamic Range (advanced video display - currently only available for Windows platforms)<br />
<br />
== Overview ==<br />
The current Windows Pre-releases/"nightlies" now support HDR. They can be downloaded from the very bottom of the [https://oolite.space/#download Downloads page] or directly from GitHub, [https://github.com/OoliteProject/oolite/releases here].<br />
<br />
If you have a compatible monitor or TV you can now enjoy vivid, bright and high contrast colors that seem to pop right out of your screen, while maintaining full image details in both highlights and dark areas. Furthermore, colors in HDR mode are 10-bit per RGB component as opposed to 8-bit in SDR and can now exceed the standard Rec709 color space and go well into the DCI-P3 and BT2020 color spaces (see [https://www.benq.com/en-us/business/resource/trends/understanding-color-gamut.html?srsltid=AfmBOop1EleuJqvrAjiH9WEG7rcuOJmG54hUicbStmP8IQK9JSnicLJv here] for more), creating an even more impressive visual experience with 1.07 billion color hues available to you rather than the 16.7 million available in SDR.<br />
<br />
Fine gameplay moments in HDR can be captured in Radiance (.hdr) format using the standard Oolite save snapshot key. You can view Radiance files at a later time using software like Windows HDR+WCG Viewer (available from the Microsoft Store for free) or the also free and very powerful HDR image viewer utility, [https://cdn.discordapp.com/attachments/792979353117524009/1277053487368241325/SKIV.exe?ex=66cc6cfd&is=66cb1b7d&hm=417a59e377398a4e2d8e12b446dc8881f9498bd21538f2a89e0411ec8e78c3c5& SKIV].<br />
<br />
This has been implemented by our Developer, [[User:Another commander|Another commander]] (who also greatly improved visuals in Oolite versions 1.86, 1.88 & 1.90).<br />
<br />
=== Note ===<br />
Because the changes only affect the display on a HDR screen, there is no way of displaying the improvements on an older SDR screen!<br />
<br />
<br />
<br />
== How to Enable Oolite's HDR Mode ==<br />
After installing the game, a new shortcut will be added to the Start menu group for the game under Windows. Those who use the nightly installers, will notice this new icon under the group "Oolite":<br />
<br />
[[file:OoliteHDRIcon.png]]<br />
<br />
You can now use it to launch the game in HDR. Alternatively, you can launch Oolite from a console or the Windows Run dialog using <pre>C:\path\to\game\oolite.app\oolite.exe -hdr</pre><br />
<br />
As a reminder, to be able to run the game in this mode you need:<br />
* Windows 10 or 11 (11 is strongly recommended).<br />
* A monitor that supports HDR output. An OLED monitor or TV is <u>strongly</u> recommended.<br />
* Graphics card that supports HDR, like 10xx NVidia series or higher spec.<br />
* HDMI 2.1 / DisplayPort 1.4 or higher spec cable, so that the HDR bandwidth requirement is satisfied.<br />
* Enabling of HDR in Windows from the Settings -> System -> Display. If your system does not support HDR for whatever reason you will not have the option to enable it.<br />
[[File:OoliteHowToActivateHDRinWindows.png]]<br />
<br />
Attempting to launch the game in HDR mode without satisfying the above requirements will trigger a warning dialog informing the user that it was not possible to detect HDR on the system and asking whether the user would like to proceed with the game rendering as HDR in a non-suitable environment (i.e. looking weird) or abort.<br />
<br />
[[File:OoliteStartInHDRWithoutHDREnabled.jpg|320px]]<br />
<br />
<br />
== Calibration ==<br />
To obtain the most out of your HDR experience, you will have to calibrate the game to generate a display signal suitable for your monitor or TV. Oolite's Game Options menu is slightly different when the game is run in HDR mode, meaning that it has two options not normally appearing in the default menu: HDR Max Brightness and HDR Paper White. The menu in HDR mode will look as seen in the screen below:<br />
[[file:OoliteHDRMenu.png]]<br />
<br />
By default HDR Max Brightness is set to 1000 nits and HDR Papaer White is set to 200 nits. You must adjust those values to match your display. At this moment Oolite does not feature an HDR calibration screen so you should get the Max Brightness information for your display from either the manufacturer's website or by running the Windows HDR Calibration utility (available for Windows 11 at the Microsoft Store for free).<br />
<br />
HDR Max Brightness can be set to 400, 500, 600, 800 and 1000 nits, but you can also edit descriptions.plist in your game install and add other values if you want - the game will accept them and use them. To add max brightness values, if so desired, open oolite.app/Resources/descriptions.plist in a text editor (backup the original file first just in case), find the block <pre>hdr_maxBrightness_array =<br />
(<br />
400, 500, 600, 800, 1000<br />
);</pre>and insert your new value in the row with the numbers, making sure it is separated by commas from the rest. Save and restart the game with Shift down to enable the edit and you should now have the extra option available. It is important that this value matches as closely as possible the actual max brightness your display can output for a <b>10% screen coverage window</b>.<br />
<br />
HDR Paper White indicates how bright a pure diffuse white object will be. You can think of it as a generic brightness slider. The higher you set it, the less headroom for highlights you leave. As a rule of thumb this can be set to about 1/4 of the max brightness, but it is entirely up to you to decide. You can set it to whatever feels comfortable to you.<br />
<br />
Once those are set to their correct / preferred values, you are ready for the HDR experience. Be dadvised that HDR has been designed for low lighting environments, so you should avoid brightly lit rooms when playing for best results.<br />
<br />
== Links ==<br />
*[https://bb.oolite.space/viewtopic.php?t=21311 Oolite on HDR Displays] (2022 - date) - this BB thread has the current information<br />
*[https://support.microsoft.com/en-us/windows/calibrate-your-hdr-display-using-the-windows-hdr-calibration-app-f30f4809-3369-43e4-9b02-9eabebd23f19 Windows 11 HDR Calibration App on Microsoft Support]<br />
<br />
[[Category:Oolite]] [[Category:Help pages]]<br />
[[Category:Factual]]</div>Another commanderhttps://wiki.alioth.net/index.php?title=HDR&diff=84380HDR2024-08-26T06:03:15Z<p>Another commander: /* Calibration */</p>
<hr />
<div>High Dynamic Range (advanced video display - currently only available for Windows platforms)<br />
<br />
== Overview ==<br />
The current Windows Pre-releases/"nightlies" now support HDR. They can be downloaded from the very bottom of the [https://oolite.space/#download Downloads page] or directly from GitHub, [https://github.com/OoliteProject/oolite/releases here].<br />
<br />
If you have a compatible monitor or TV you can now enjoy vivid, bright and high contrast colors that seem to pop right out of your screen, while maintaining full image details in both highlights and dark areas. Furthermore, colors in HDR mode are 10-bit per RGB component as opposed to 8-bit in SDR and can now exceed the standard Rec709 color space and go well into the DCI-P3 and BT2020 color spaces (see [https://www.benq.com/en-us/business/resource/trends/understanding-color-gamut.html?srsltid=AfmBOop1EleuJqvrAjiH9WEG7rcuOJmG54hUicbStmP8IQK9JSnicLJv here] for more), creating an even more impressive visual experience with 1.07 billion color hues available to you rather than the 16.7 million available in SDR.<br />
<br />
Fine gameplay moments in HDR can be captured in Radiance (.hdr) format using the standard Oolite save snapshot key. You can view Radiance files at a later time using software like Windows HDR+WCG Viewer (available from the Microsoft Store for free) or the also free and very powerful HDR image viewer utility, [https://cdn.discordapp.com/attachments/792979353117524009/1277053487368241325/SKIV.exe?ex=66cc6cfd&is=66cb1b7d&hm=417a59e377398a4e2d8e12b446dc8881f9498bd21538f2a89e0411ec8e78c3c5& SKIV].<br />
<br />
This has been implemented by our Developer, [[User:Another commander|Another commander]] (who also greatly improved visuals in Oolite versions 1.86, 1.88 & 1.90).<br />
<br />
=== Note ===<br />
Because the changes only affect the display on a HDR screen, there is no way of displaying the improvements on an older SDR screen!<br />
<br />
<br />
<br />
== How to Enable Oolite's HDR Mode ==<br />
After installing the game, a new shortcut will be added to the Start menu group for the game under Windows. Those who use the nightly installers, will notice this new icon under the group "Oolite":<br />
<br />
[[file:OoliteHDRIcon.png]]<br />
<br />
You can now use it to launch the game in HDR. Alternatively, you can launch Oolite from a console or the Windows Run dialog using <pre>C:\path\to\game\oolite.app\oolite.exe -hdr</pre><br />
<br />
As a reminder, to be able to run the game in this mode you need:<br />
* Windows 10 or 11 (11 is strongly recommended).<br />
* A monitor that supports HDR output. An OLED monitor or TV is <u>strongly</u> recommended.<br />
* Graphics card that supports HDR, like 10xx NVidia series or higher spec.<br />
* HDMI 2.1 / DisplayPort 1.4 or higher spec cable, so that the HDR bandwidth requirement is satisfied.<br />
* Enabling of HDR in Windows from the Settings -> System -> Display. If your system does not support HDR for whatever reason you will not have the option to enable it.<br />
[[File:OoliteHowToActivateHDRinWindows.png]]<br />
<br />
Attempting to launch the game in HDR mode without satisfying the above requirements will trigger a warning dialog informing the user that it was not possible to detect HDR on the system and asking whether the user would like to proceed with the game rendering as HDR in a non-suitable environment (i.e. looking weird) or abort.<br />
<br />
[[File:OoliteStartInHDRWithoutHDREnabled.jpg|320px]]<br />
<br />
<br />
== Calibration ==<br />
To obtain the most out of your HDR experience, you will have to calibrate the game to generate a display signal suitable for your monitor's or TV's. Oolite's Game Options menu is slightly different when the game is run in HDR mode, meaning that it has two options not normally appearing in the default menu: HDR Max Brightness and HDR Paper White. The menu in HDR mode will look as seen in the screen below:<br />
[[file:OoliteHDRMenu.png]]<br />
<br />
By default HDR Max Brightness is set to 1000 nits and HDR Papaer White is set to 200 nits. You must adjust those values to match your display. At this moment Oolite does not feature an HDR calibration screen so you should get the Max Brightness information for your display from either the manufacturer's website or by running the Windows HDR Calibration utility (available for Windows 11 at the Microsoft Store for free).<br />
<br />
HDR Max Brightness can be set to 400, 500, 600, 800 and 1000 nits, but you can also edit descriptions.plist in your game install and add other values if you want - the game will accept them and use them. To add max brightness values, if so desired, open oolite.app/Resources/descriptions.plist in a text editor (backup the original file first just in case), find the block <pre>hdr_maxBrightness_array =<br />
(<br />
400, 500, 600, 800, 1000<br />
);</pre>and insert your new value in the row with the numbers, making sure it is separated by commas from the rest. Save and restart the game with Shift down to enable the edit and you should now have the extra option available. It is important that this value matches as closely as possible the actual max brightness your display can output for a <b>10% screen coverage window</b>.<br />
<br />
HDR Paper White indicates how bright a pure diffuse white object will be. You can think of it as a generic brightness slider. The higher you set it, the less headroom for highlights you leave. As a rule of thumb this can be set to about 1/4 of the max brightness, but it is entirely up to you to decide. You can set it to whatever feels comfortable to you.<br />
<br />
Once those are set to their correct / preferred values, you are ready for the HDR experience. Be dadvised that HDR has been designed for low lighting environments, so you should avoid brightly lit rooms when playing for best results.<br />
<br />
== Links ==<br />
*[https://bb.oolite.space/viewtopic.php?t=21311 Oolite on HDR Displays] (2022 - date) - this BB thread has the current information<br />
*[https://support.microsoft.com/en-us/windows/calibrate-your-hdr-display-using-the-windows-hdr-calibration-app-f30f4809-3369-43e4-9b02-9eabebd23f19 Windows 11 HDR Calibration App on Microsoft Support]<br />
<br />
[[Category:Oolite]] [[Category:Help pages]]<br />
[[Category:Factual]]</div>Another commanderhttps://wiki.alioth.net/index.php?title=HDR&diff=84379HDR2024-08-26T06:01:46Z<p>Another commander: </p>
<hr />
<div>High Dynamic Range (advanced video display - currently only available for Windows platforms)<br />
<br />
== Overview ==<br />
The current Windows Pre-releases/"nightlies" now support HDR. They can be downloaded from the very bottom of the [https://oolite.space/#download Downloads page] or directly from GitHub, [https://github.com/OoliteProject/oolite/releases here].<br />
<br />
If you have a compatible monitor or TV you can now enjoy vivid, bright and high contrast colors that seem to pop right out of your screen, while maintaining full image details in both highlights and dark areas. Furthermore, colors in HDR mode are 10-bit per RGB component as opposed to 8-bit in SDR and can now exceed the standard Rec709 color space and go well into the DCI-P3 and BT2020 color spaces (see [https://www.benq.com/en-us/business/resource/trends/understanding-color-gamut.html?srsltid=AfmBOop1EleuJqvrAjiH9WEG7rcuOJmG54hUicbStmP8IQK9JSnicLJv here] for more), creating an even more impressive visual experience with 1.07 billion color hues available to you rather than the 16.7 million available in SDR.<br />
<br />
Fine gameplay moments in HDR can be captured in Radiance (.hdr) format using the standard Oolite save snapshot key. You can view Radiance files at a later time using software like Windows HDR+WCG Viewer (available from the Microsoft Store for free) or the also free and very powerful HDR image viewer utility, [https://cdn.discordapp.com/attachments/792979353117524009/1277053487368241325/SKIV.exe?ex=66cc6cfd&is=66cb1b7d&hm=417a59e377398a4e2d8e12b446dc8881f9498bd21538f2a89e0411ec8e78c3c5& SKIV].<br />
<br />
This has been implemented by our Developer, [[User:Another commander|Another commander]] (who also greatly improved visuals in Oolite versions 1.86, 1.88 & 1.90).<br />
<br />
=== Note ===<br />
Because the changes only affect the display on a HDR screen, there is no way of displaying the improvements on an older SDR screen!<br />
<br />
<br />
<br />
== How to Enable Oolite's HDR Mode ==<br />
After installing the game, a new shortcut will be added to the Start menu group for the game under Windows. Those who use the nightly installers, will notice this new icon under the group "Oolite":<br />
<br />
[[file:OoliteHDRIcon.png]]<br />
<br />
You can now use it to launch the game in HDR. Alternatively, you can launch Oolite from a console or the Windows Run dialog using <pre>C:\path\to\game\oolite.app\oolite.exe -hdr</pre><br />
<br />
As a reminder, to be able to run the game in this mode you need:<br />
* Windows 10 or 11 (11 is strongly recommended).<br />
* A monitor that supports HDR output. An OLED monitor or TV is <u>strongly</u> recommended.<br />
* Graphics card that supports HDR, like 10xx NVidia series or higher spec.<br />
* HDMI 2.1 / DisplayPort 1.4 or higher spec cable, so that the HDR bandwidth requirement is satisfied.<br />
* Enabling of HDR in Windows from the Settings -> System -> Display. If your system does not support HDR for whatever reason you will not have the option to enable it.<br />
[[File:OoliteHowToActivateHDRinWindows.png]]<br />
<br />
Attempting to launch the game in HDR mode without satisfying the above requirements will trigger a warning dialog informing the user that it was not possible to detect HDR on the system and asking whether the user would like to proceed with the game rendering as HDR in a non-suitable environment (i.e. looking weird) or abort.<br />
<br />
[[File:OoliteStartInHDRWithoutHDREnabled.jpg|320px]]<br />
<br />
<br />
== Calibration ==<br />
To obtain the most out of your HDR experience, you will have to calibrate the game to generate a display signal suitable to that of your monitor's or TV's. Oolite's Game Options menu is slightly different when the game is run in HDR mode, meaning that it has two options not normally appearing in the default menu: HDR Max Brightness and HDR Paper White. The menu in HDR mode will look as seen in the screen below:<br />
[[file:OoliteHDRMenu.png]]<br />
<br />
By default HDR Max Brightness is set to 1000 nits and HDR Papaer White is set to 200 nits. You must adjust those values to match your display. At this moment Oolite does not feature an HDR calibration screen so you should get the Max Brightness information for your display from either the manufacturer's website or by running the Windows HDR Calibration utility (available for Windows 11 at the Microsoft Store for free).<br />
<br />
HDR Max Brightness can be set to 400, 500, 600, 800 and 1000 nits, but you can also edit descriptions.plist in your game install and add other values if you want - the game will accept them and use them. To add max brightness values, if so desired, open oolite.app/Resources/descriptions.plist in a text editor (backup the original file first just in case), find the block <pre>hdr_maxBrightness_array =<br />
(<br />
400, 500, 600, 800, 1000<br />
);</pre>and insert your new value in the row with the numbers, making sure it is separated by commas from the rest. Save and restart the game with Shift down to enable the edit and you should now have the extra option available. It is important that this value matches as closely as possible the actual max brightness your display can output for a <b>10% screen coverage window</b>.<br />
<br />
HDR Paper White indicates how bright a pure diffuse white object will be. You can think of it as a generic brightness slider. The higher you set it, the less headroom for highlights you leave. As a rule of thumb this can be set to about 1/4 of the max brightness, but it is entirely up to you to decide. You can set it to whatever feels comfortable to you.<br />
<br />
Once those are set to their correct / preferred values, you are ready for the HDR experience. Be dadvised that HDR has been designed for low lighting environments, so you should avoid brightly lit rooms when playing for best results.<br />
<br />
== Links ==<br />
*[https://bb.oolite.space/viewtopic.php?t=21311 Oolite on HDR Displays] (2022 - date) - this BB thread has the current information<br />
*[https://support.microsoft.com/en-us/windows/calibrate-your-hdr-display-using-the-windows-hdr-calibration-app-f30f4809-3369-43e4-9b02-9eabebd23f19 Windows 11 HDR Calibration App on Microsoft Support]<br />
<br />
[[Category:Oolite]] [[Category:Help pages]]<br />
[[Category:Factual]]</div>Another commanderhttps://wiki.alioth.net/index.php?title=HDR&diff=84378HDR2024-08-26T06:00:39Z<p>Another commander: /* How to Enable Oolite's HDR Mode */</p>
<hr />
<div>High Dynamic Range (advanced video display - currently only available for Windows platforms)<br />
<br />
== Overview ==<br />
The current Windows Pre-releases/"nightlies" now support HDR. They can be downloaded from the very bottom of the [https://oolite.space/#download Downloads page] or directly from GitHub, [https://github.com/OoliteProject/oolite/releases here].<br />
<br />
If you have a compatible monitor or TV you can now enjoy vivid, bright and high contrast colors that seem to pop right out of your screen, while maintaining full image details in both highlights and dark areas. Furthermore, colors in HDR mode are 10-bit per RGB component as opposed to 8-bit in SDR and can now exceed the standard Rec709 color space and go well into the DCI-P3 and BT2020 color spaces (see [https://www.benq.com/en-us/business/resource/trends/understanding-color-gamut.html?srsltid=AfmBOop1EleuJqvrAjiH9WEG7rcuOJmG54hUicbStmP8IQK9JSnicLJv here] for more), creating an even more impressive visual experience with 1.07 billion color hues available to you rather than the 16.7 million available in SDR.<br />
<br />
Fine gameplay moments in HDR can be captured in Radiance (.hdr) format using the standard Oolite save snapshot key. You can view Radiance files at a later time using software like Windows HDR+WCG Viewer (available from the Microsoft Store for free) or the also free and very powerful HDR image viewer utility, [https://cdn.discordapp.com/attachments/792979353117524009/1277053487368241325/SKIV.exe?ex=66cc6cfd&is=66cb1b7d&hm=417a59e377398a4e2d8e12b446dc8881f9498bd21538f2a89e0411ec8e78c3c5& SKIV].<br />
<br />
This has been implemented by our Developer, [[User:Another commander|Another commander]] (who also greatly improved visuals in Oolite versions 1.86, 1.88 & 1.90).<br />
<br />
=== Note ===<br />
Because the changes only affect the display on a HDR screen, there is no way of displaying the improvements on an older SDR screen!<br />
<br />
<br />
<br />
== How to Enable Oolite's HDR Mode ==<br />
After installing the game, a new shortcut will be added to the Start menu group for the game under Windows. Those who use the nightly installers, will notice this new icon under the group "Oolite":<br />
<br />
[[file:OoliteHDRIcon.png]]<br />
<br />
You can now use it to launch the game in HDR. Alternatively, you can launch Oolite from a console or the Windows Run dialog using <pre>C:\path\to\game\oolite.app\oolite.exe -hdr</pre><br />
<br />
As a reminder, to be able to run the game in this mode you need:<br />
* Windows 10 or 11 (11 is strongly recommended).<br />
* A monitor that supports HDR output. An OLED monitor or TV is <u>strongly</u> recommended.<br />
* Graphics card that supports HDR, like 10xx NVidia series or higher spec.<br />
* HDMI 2.1 / DisplayPort 1.4 or higher spec cable, so that the HDR bandwidth requirement is satisfied.<br />
* Enabling of HDR in Windows from the Settings -> System -> Display. If your system does not support HDR for whatever reason you will not have the option to enable it.<br />
[[File:OoliteHowToActivateHDRinWindows.png]]<br />
<br />
Attempting to launch the game in HDR mode without satisfying the above requirements will trigger a warning dialog informing the user that it was not possible to detect HDR on the system and asking whether the user would like to proceed with the game rendering as HDR in a non-suitable environment (i.e. looking weird) or abort.<br />
<br />
[[File:OoliteStartInHDRWithoutHDREnabled.jpg|320px]]<br />
<br />
== Calibration ==<br />
To obtain the most out of your HDR experience, you will have to calibrate the game to generate a display signal suitable to that of your monitor's or TV's. Oolite's Game Options menu is slightly different when the game is run in HDR mode, meaning that it has two options not normally appearing in the default menu: HDR Max Brightness and HDR Paper White. The menu in HDR mode will look as seen in the screen below:<br />
[[file:OoliteHDRMenu.png]]<br />
<br />
By default HDR Max Brightness is set to 1000 nits and HDR Papaer White is set to 200 nits. You must adjust those values to match your display. At this moment Oolite does not feature an HDR calibration screen so you should get the Max Brightness information for your display from either the manufacturer's website or by running the Windows HDR Calibration utility (available for Windows 11 at the Microsoft Store for free).<br />
<br />
HDR Max Brightness can be set to 400, 500, 600, 800 and 1000 nits, but you can also edit descriptions.plist in your game install and add other values if you want - the game will accept them and use them. To add max brightness values, if so desired, open oolite.app/Resources/descriptions.plist in a text editor (backup the original file first just in case), find the block <pre>hdr_maxBrightness_array =<br />
(<br />
400, 500, 600, 800, 1000<br />
);</pre>and insert your new value in the row with the numbers, making sure it is separated by commas from the rest. Save and restart the game with Shift down to enable the edit and you should now have the extra option available. It is important that this value matches as closely as possible the actual max brightness your display can output for a <b>10% screen coverage window</b>.<br />
<br />
HDR Paper White indicates how bright a pure diffuse white object will be. You can think of it as a generic brightness slider. The higher you set it, the less headroom for highlights you leave. As a rule of thumb this can be set to about 1/4 of the max brightness, but it is entirely up to you to decide. You can set it to whatever feels comfortable to you.<br />
<br />
Once those are set to their correct / preferred values, you are ready for the HDR experience. Be dadvised that HDR has been designed for low lighting environments, so you should avoid brightly lit rooms when playing for best results.<br />
<br />
== Links ==<br />
*[https://bb.oolite.space/viewtopic.php?t=21311 Oolite on HDR Displays] (2022 - date) - this BB thread has the current information<br />
*[https://support.microsoft.com/en-us/windows/calibrate-your-hdr-display-using-the-windows-hdr-calibration-app-f30f4809-3369-43e4-9b02-9eabebd23f19 Windows 11 HDR Calibration App on Microsoft Support]<br />
<br />
[[Category:Oolite]] [[Category:Help pages]]<br />
[[Category:Factual]]</div>Another commanderhttps://wiki.alioth.net/index.php?title=File:OoliteStartInHDRWithoutHDREnabled.jpg&diff=84377File:OoliteStartInHDRWithoutHDREnabled.jpg2024-08-26T05:54:32Z<p>Another commander: Another commander uploaded a new version of File:OoliteStartInHDRWithoutHDREnabled.jpg</p>
<hr />
<div></div>Another commanderhttps://wiki.alioth.net/index.php?title=File:OoliteStartInHDRWithoutHDREnabled.jpg&diff=84376File:OoliteStartInHDRWithoutHDREnabled.jpg2024-08-26T05:52:34Z<p>Another commander: </p>
<hr />
<div></div>Another commanderhttps://wiki.alioth.net/index.php?title=HDR&diff=84375HDR2024-08-26T05:48:11Z<p>Another commander: /* How to Enable Oolite's HDR Mode */</p>
<hr />
<div>High Dynamic Range (advanced video display - currently only available for Windows platforms)<br />
<br />
== Overview ==<br />
The current Windows Pre-releases/"nightlies" now support HDR. They can be downloaded from the very bottom of the [https://oolite.space/#download Downloads page] or directly from GitHub, [https://github.com/OoliteProject/oolite/releases here].<br />
<br />
If you have a compatible monitor or TV you can now enjoy vivid, bright and high contrast colors that seem to pop right out of your screen, while maintaining full image details in both highlights and dark areas. Furthermore, colors in HDR mode are 10-bit per RGB component as opposed to 8-bit in SDR and can now exceed the standard Rec709 color space and go well into the DCI-P3 and BT2020 color spaces (see [https://www.benq.com/en-us/business/resource/trends/understanding-color-gamut.html?srsltid=AfmBOop1EleuJqvrAjiH9WEG7rcuOJmG54hUicbStmP8IQK9JSnicLJv here] for more), creating an even more impressive visual experience with 1.07 billion color hues available to you rather than the 16.7 million available in SDR.<br />
<br />
Fine gameplay moments in HDR can be captured in Radiance (.hdr) format using the standard Oolite save snapshot key. You can view Radiance files at a later time using software like Windows HDR+WCG Viewer (available from the Microsoft Store for free) or the also free and very powerful HDR image viewer utility, [https://cdn.discordapp.com/attachments/792979353117524009/1277053487368241325/SKIV.exe?ex=66cc6cfd&is=66cb1b7d&hm=417a59e377398a4e2d8e12b446dc8881f9498bd21538f2a89e0411ec8e78c3c5& SKIV].<br />
<br />
This has been implemented by our Developer, [[User:Another commander|Another commander]] (who also greatly improved visuals in Oolite versions 1.86, 1.88 & 1.90).<br />
<br />
=== Note ===<br />
Because the changes only affect the display on a HDR screen, there is no way of displaying the improvements on an older SDR screen!<br />
<br />
<br />
<br />
== How to Enable Oolite's HDR Mode ==<br />
After installing the game, a new shortcut will be added to the Start menu group for the game under Windows. Those who use the nightly installers, will notice this new icon under the group "Oolite":<br />
<br />
[[file:OoliteHDRIcon.png]]<br />
<br />
You can now use it to launch the game in HDR. Alternatively, you can launch Oolite from a console or the Windows Run dialog using <pre>C:\path\to\game\oolite.app\oolite.exe -hdr</pre><br />
<br />
As a reminder, to be able to run the game in this mode you need:<br />
* Windows 10 or 11 (11 is strongly recommended).<br />
* A monitor that supports HDR output. An OLED monitor or TV is <u>strongly</u> recommended.<br />
* Graphics card that supports HDR, like 10xx NVidia series or higher spec.<br />
* HDMI 2.1 / DisplayPort 1.4 or higher spec cable, so that the HDR bandwidth requirement is satisfied.<br />
* Enabling of HDR in Windows from the Settings -> System -> Display. If your system does not support HDR for whatever reason you will not have the option to enable it.<br />
[[File:OoliteHowToActivateHDRinWindows.png]]<br />
<br />
Attempting to launch the game in HDR mode without satisfying the above requirements will trigger a warning dialog informing the user that it was not possible to detect HDR on the system and asking whether the user would like to proceed with the game rendering as HDR in a non-suitable environment (i.e, looking weird) or abort.<br />
<br />
== Calibration ==<br />
To obtain the most out of your HDR experience, you will have to calibrate the game to generate a display signal suitable to that of your monitor's or TV's. Oolite's Game Options menu is slightly different when the game is run in HDR mode, meaning that it has two options not normally appearing in the default menu: HDR Max Brightness and HDR Paper White. The menu in HDR mode will look as seen in the screen below:<br />
[[file:OoliteHDRMenu.png]]<br />
<br />
By default HDR Max Brightness is set to 1000 nits and HDR Papaer White is set to 200 nits. You must adjust those values to match your display. At this moment Oolite does not feature an HDR calibration screen so you should get the Max Brightness information for your display from either the manufacturer's website or by running the Windows HDR Calibration utility (available for Windows 11 at the Microsoft Store for free).<br />
<br />
HDR Max Brightness can be set to 400, 500, 600, 800 and 1000 nits, but you can also edit descriptions.plist in your game install and add other values if you want - the game will accept them and use them. To add max brightness values, if so desired, open oolite.app/Resources/descriptions.plist in a text editor (backup the original file first just in case), find the block <pre>hdr_maxBrightness_array =<br />
(<br />
400, 500, 600, 800, 1000<br />
);</pre>and insert your new value in the row with the numbers, making sure it is separated by commas from the rest. Save and restart the game with Shift down to enable the edit and you should now have the extra option available. It is important that this value matches as closely as possible the actual max brightness your display can output for a <b>10% screen coverage window</b>.<br />
<br />
HDR Paper White indicates how bright a pure diffuse white object will be. You can think of it as a generic brightness slider. The higher you set it, the less headroom for highlights you leave. As a rule of thumb this can be set to about 1/4 of the max brightness, but it is entirely up to you to decide. You can set it to whatever feels comfortable to you.<br />
<br />
Once those are set to their correct / preferred values, you are ready for the HDR experience. Be dadvised that HDR has been designed for low lighting environments, so you should avoid brightly lit rooms when playing for best results.<br />
<br />
== Links ==<br />
*[https://bb.oolite.space/viewtopic.php?t=21311 Oolite on HDR Displays] (2022 - date) - this BB thread has the current information<br />
*[https://support.microsoft.com/en-us/windows/calibrate-your-hdr-display-using-the-windows-hdr-calibration-app-f30f4809-3369-43e4-9b02-9eabebd23f19 Windows 11 HDR Calibration App on Microsoft Support]<br />
<br />
[[Category:Oolite]] [[Category:Help pages]]<br />
[[Category:Factual]]</div>Another commanderhttps://wiki.alioth.net/index.php?title=HDR&diff=84370HDR2024-08-25T19:09:53Z<p>Another commander: </p>
<hr />
<div>High Dynamic Range (advanced video display - currently only available for Windows platforms)<br />
<br />
== Overview ==<br />
The current Windows Pre-releases/"nightlies" now support HDR. They can be downloaded from the very bottom of the [https://oolite.space/#download Downloads page] or directly from GitHub, [https://github.com/OoliteProject/oolite/releases here].<br />
<br />
If you have a compatible monitor or TV you can now enjoy vivid, bright and high contrast colors that seem to pop right out of your screen, while maintaining full image details in both highlights and dark areas. Furthermore, colors in HDR mode are 10-bit per RGB component as opposed to 8-bit in SDR and can now exceed the standard Rec709 color space and go well into the DCI-P3 and BT2020 color spaces (see [https://www.benq.com/en-us/business/resource/trends/understanding-color-gamut.html?srsltid=AfmBOop1EleuJqvrAjiH9WEG7rcuOJmG54hUicbStmP8IQK9JSnicLJv here] for more), creating an even more impressive visual experience with 1.07 billion color hues available to you rather than the 16.7 million available in SDR.<br />
<br />
Fine gameplay moments in HDR can be captured in Radiance (.hdr) format using the standard Oolite save snapshot key. You can view Radiance files at a later time using software like Windows HDR+WCG Viewer (available from the Microsoft Store for free) or the also free and very powerful HDR image viewer utility, [https://cdn.discordapp.com/attachments/792979353117524009/1277053487368241325/SKIV.exe?ex=66cc6cfd&is=66cb1b7d&hm=417a59e377398a4e2d8e12b446dc8881f9498bd21538f2a89e0411ec8e78c3c5& SKIV].<br />
<br />
This has been implemented by our Developer, [[User:Another commander|Another commander]] (who also greatly improved visuals in Oolite versions 1.86, 1.88 & 1.90).<br />
<br />
=== Note ===<br />
Because the changes only affect the display on a HDR screen, there is no way of displaying the improvements on an older SDR screen!<br />
<br />
<br />
<br />
== How to Enable Oolite's HDR Mode ==<br />
After installing the game, a new shortcut will be added to the Start menu group for the game under Windows. Those who use the nightly installers, will notice this new icon under the group "Oolite":<br />
[[file:OoliteHDRIcon.png]]<br />
<br />
You can now use it to launch the game in HDR. Alternatively, you can launch Oolite from a console or the Windows Run dialog using <pre>C:\path\to\game\oolite.app\oolite.exe -hdr</pre><br />
<br />
As a reminder, to be able to run the game in this mode you need:<br />
* Windows 10 or 11 (11 is strongly recommended).<br />
* A monitor that supports HDR output. An OLED monitor or TV is <u>strongly</u> recommended.<br />
* Graphics card that supports HDR, like 10xx NVidia series or higher spec.<br />
* HDMI 2.1 / DisplayPort 1.4 or higher spec cable, so that the HDR bandwidth requirement is satisfied.<br />
* Enabling of HDR in Windows from the Settings -> System -> Display. If your system does not support HDR for whatever reason you will not have the option to enable it.<br />
[[File:OoliteHowToActivateHDRinWindows.png]]<br />
<br />
Attempting to launch the game in HDR mode without satisfying the above requirements will trigger a warning dialog informing the user that it was not possible to detect HDR on the system and asking whether the user would like to proceed with the game rendering as HDR in a non-suitable environment (i.e, looking weird) or abort.<br />
<br />
== Calibration ==<br />
To obtain the most out of your HDR experience, you will have to calibrate the game to generate a display signal suitable to that of your monitor's or TV's. Oolite's Game Options menu is slightly different when the game is run in HDR mode, meaning that it has two options not normally appearing in the default menu: HDR Max Brightness and HDR Paper White. The menu in HDR mode will look as seen in the screen below:<br />
[[file:OoliteHDRMenu.png]]<br />
<br />
By default HDR Max Brightness is set to 1000 nits and HDR Papaer White is set to 200 nits. You must adjust those values to match your display. At this moment Oolite does not feature an HDR calibration screen so you should get the Max Brightness information for your display from either the manufacturer's website or by running the Windows HDR Calibration utility (available for Windows 11 at the Microsoft Store for free).<br />
<br />
HDR Max Brightness can be set to 400, 500, 600, 800 and 1000 nits, but you can also edit descriptions.plist in your game install and add other values if you want - the game will accept them and use them. To add max brightness values, if so desired, open oolite.app/Resources/descriptions.plist in a text editor (backup the original file first just in case), find the block <pre>hdr_maxBrightness_array =<br />
(<br />
400, 500, 600, 800, 1000<br />
);</pre>and insert your new value in the row with the numbers, making sure it is separated by commas from the rest. Save and restart the game with Shift down to enable the edit and you should now have the extra option available. It is important that this value matches as closely as possible the actual max brightness your display can output for a <b>10% screen coverage window</b>.<br />
<br />
HDR Paper White indicates how bright a pure diffuse white object will be. You can think of it as a generic brightness slider. The higher you set it, the less headroom for highlights you leave. As a rule of thumb this can be set to about 1/4 of the max brightness, but it is entirely up to you to decide. You can set it to whatever feels comfortable to you.<br />
<br />
Once those are set to their correct / preferred values, you are ready for the HDR experience. Be dadvised that HDR has been designed for low lighting environments, so you should avoid brightly lit rooms when playing for best results.<br />
<br />
== Links ==<br />
*[https://bb.oolite.space/viewtopic.php?t=21311 Oolite on HDR Displays] (2022 - date) - this BB thread has the current information<br />
*[https://support.microsoft.com/en-us/windows/calibrate-your-hdr-display-using-the-windows-hdr-calibration-app-f30f4809-3369-43e4-9b02-9eabebd23f19 Windows 11 HDR Calibration App on Microsoft Support]<br />
<br />
[[Category:Oolite]] [[Category:Help pages]]<br />
[[Category:Factual]]</div>Another commanderhttps://wiki.alioth.net/index.php?title=HDR&diff=84369HDR2024-08-25T18:46:14Z<p>Another commander: </p>
<hr />
<div>High Dynamic Range (advanced video display - currently only available for Windows platforms)<br />
<br />
== Overview ==<br />
The current Windows Pre-releases/"nightlies" now support HDR. They can be downloaded from the very bottom of the [https://oolite.space/#download Downloads page] or directly from GitHub, [https://github.com/OoliteProject/oolite/releases here].<br />
<br />
If you have a compatible monitor or TV you can now enjoy vivid, bright and high contrast colors that seem to pop right out of your screen, while maintaining full image details in both highlights and dark areas. Furthermore, colors in HDR mode are 10-bit per RGB component as opposed to 8-bit in SDR and can now exceed the standard Rec709 color space and go well into the DCI-P3 and BT2020 color spaces, creating an even more impressive visual experience with 1.07 billion color hues available to you rather than the 16.7 million available in SDR.<br />
<br />
Fine gameplay moments in HDR can be captured in Radiance (.hdr) format using the standard Oolite save snapshot key. You can view Radiance files at a later time using software like Windows HDR+WCG Viewer (available from the Microsoft Store for free) or the also free and very powerful HDR image viewer utility, [https://cdn.discordapp.com/attachments/792979353117524009/1277053487368241325/SKIV.exe?ex=66cc6cfd&is=66cb1b7d&hm=417a59e377398a4e2d8e12b446dc8881f9498bd21538f2a89e0411ec8e78c3c5& SKIV].<br />
<br />
This has been implemented by our Developer, [[User:Another commander|Another commander]] (who also greatly improved visuals in Oolite versions 1.86, 1.88 & 1.90).<br />
<br />
=== Note ===<br />
Because the changes only affect the display on a HDR screen, there is no way of displaying the improvements on an older SDR screen!<br />
<br />
<br />
<br />
== How to Enable Oolite's HDR Mode ==<br />
After installing the game, a new shortcut will be added to the Start menu group for the game under Windows. Those who use the nightly installers, will notice this new icon under the group "Oolite":<br />
[[file:OoliteHDRIcon.png]]<br />
<br />
You can now use it to launch the game in HDR. Alternatively, you can launch Oolite from a console or the Windows Run dialog using <pre>C:\path\to\game\oolite.app\oolite.exe -hdr</pre><br />
<br />
As a reminder, to be able to run the game in this mode you need:<br />
* Windows 10 or 11 (11 is strongly recommended).<br />
* A monitor that supports HDR output. An OLED monitor or TV is <u>strongly</u> recommended.<br />
* Graphics card that supports HDR, like 10xx NVidia series or higher spec.<br />
* HDMI 2.1 / DisplayPort 1.4 or higher spec cable, so that the HDR bandwidth requirement is satisfied.<br />
* Enabling of HDR in Windows from the Settings -> System -> Display. If your system does not support HDR for whatever reason you will not have the option to enable it.<br />
[[File:OoliteHowToActivateHDRinWindows.png]]<br />
<br />
Attempting to launch the game in HDR mode without satisfying the above requirements will trigger a warning dialog informing the user that it was not possible to detect HDR on the system and asking whether the user would like to proceed with the game rendering as HDR in a non-suitable environment (i.e, looking weird) or abort.<br />
<br />
== Calibration ==<br />
To obtain the most out of your HDR experience, you will have to calibrate the game to generate a display signal suitable to that of your monitor's or TV's. Oolite's Game Options menu is slightly different when the game is run in HDR mode, meaning that it has two options not normally appearing in the default menu: HDR Max Brightness and HDR Paper White. The menu in HDR mode will look as seen in the screen below:<br />
[[file:OoliteHDRMenu.png]]<br />
<br />
By default HDR Max Brightness is set to 1000 nits and HDR Papaer White is set to 200 nits. You must adjust those values to match your display. At this moment Oolite does not feature an HDR calibration screen so you should get the Max Brightness information for your display from either the manufacturer's website or by running the Windows HDR Calibration utility (available for Windows 11 at the Microsoft Store for free).<br />
<br />
HDR Max Brightness can be set to 400, 500, 600, 800 and 1000 nits, but you can also edit descriptions.plist in your game install and add other values if you want - the game will accept them and use them. To add max brightness values, if so desired, open oolite.app/Resources/descriptions.plist in a text editor (backup the original file first just in case), find the block <pre>hdr_maxBrightness_array =<br />
(<br />
400, 500, 600, 800, 1000<br />
);</pre>and insert your new value in the row with the numbers, making sure it is separated by commas from the rest. Save and restart the game with Shift down to enable the edit and you should now have the extra option available. It is important that this value matches as closely as possible the actual max brightness your display can output for a <b>10% screen coverage window</b>.<br />
<br />
HDR Paper White indicates how bright a pure diffuse white object will be. You can think of it as a generic brightness slider. The higher you set it, the less headroom for highlights you leave. As a rule of thumb this can be set to about 1/4 of the max brightness, but it is entirely up to you to decide. You can set it to whatever feels comfortable to you.<br />
<br />
Once those are set to their correct / preferred values, you are ready for the HDR experience. Be dadvised that HDR has been designed for low lighting environments, so you should avoid brightly lit rooms when playing for best results.<br />
<br />
== Links ==<br />
*[https://bb.oolite.space/viewtopic.php?t=21311 Oolite on HDR Displays] (2022 - date) - this BB thread has the current information<br />
*[https://support.microsoft.com/en-us/windows/calibrate-your-hdr-display-using-the-windows-hdr-calibration-app-f30f4809-3369-43e4-9b02-9eabebd23f19 Windows 11 HDR Calibration App on Microsoft Support]<br />
<br />
[[Category:Oolite]] [[Category:Help pages]]<br />
[[Category:Factual]]</div>Another commanderhttps://wiki.alioth.net/index.php?title=HDR&diff=84368HDR2024-08-25T18:45:26Z<p>Another commander: /* How to Enable Oolite's HDR Mode */</p>
<hr />
<div>High Dynamic Range (advanced video display - currently only available for windows platforms)<br />
<br />
== Overview ==<br />
The current Windows Pre-releases/"nightlies" now support HDR. They can be downloaded from the very bottom of the [https://oolite.space/#download Downloads page] or directly from GitHub, [https://github.com/OoliteProject/oolite/releases here].<br />
<br />
If you have a compatible monitor or TV you can now enjoy vivid, bright and high contrast colors that seem to pop right out of your screen, while maintaining full image details in both highlights and dark areas. Furthermore, colors in HDR mode are 10-bit per RGB component as opposed to 8-bit in SDR and can now exceed the standard Rec709 color space and go well into the DCI-P3 and BT2020 color spaces, creating an even more impressive visual experience with 1.07 billion color hues available to you rather than the 16.7 million available in SDR.<br />
<br />
Fine gameplay moments in HDR can be captured in Radiance (.hdr) format using the standard Oolite save snapshot key. You can view Radiance files at a later time using software like Windows HDR+WCG Viewer (available from the Microsoft Store for free) or the also free and very powerful HDR image viewer utility, [https://cdn.discordapp.com/attachments/792979353117524009/1277053487368241325/SKIV.exe?ex=66cc6cfd&is=66cb1b7d&hm=417a59e377398a4e2d8e12b446dc8881f9498bd21538f2a89e0411ec8e78c3c5& SKIV].<br />
<br />
This has been implemented by our Developer, [[User:Another commander|Another commander]] (who also greatly improved visuals in Oolite versions 1.86, 1.88 & 1.90).<br />
<br />
=== Note ===<br />
Because the changes only affect the display on a HDR screen, there is no way of displaying the improvements on an older SDR screen!<br />
<br />
<br />
<br />
== How to Enable Oolite's HDR Mode ==<br />
After installing the game, a new shortcut will be added to the Start menu group for the game under Windows. Those who use the nightly installers, will notice this new icon under the group "Oolite":<br />
[[file:OoliteHDRIcon.png]]<br />
<br />
You can now use it to launch the game in HDR. Alternatively, you can launch Oolite from a console or the Windows Run dialog using <pre>C:\path\to\game\oolite.app\oolite.exe -hdr</pre><br />
<br />
As a reminder, to be able to run the game in this mode you need:<br />
* Windows 10 or 11 (11 is strongly recommended).<br />
* A monitor that supports HDR output. An OLED monitor or TV is <u>strongly</u> recommended.<br />
* Graphics card that supports HDR, like 10xx NVidia series or higher spec.<br />
* HDMI 2.1 / DisplayPort 1.4 or higher spec cable, so that the HDR bandwidth requirement is satisfied.<br />
* Enabling of HDR in Windows from the Settings -> System -> Display. If your system does not support HDR for whatever reason you will not have the option to enable it.<br />
[[File:OoliteHowToActivateHDRinWindows.png]]<br />
<br />
Attempting to launch the game in HDR mode without satisfying the above requirements will trigger a warning dialog informing the user that it was not possible to detect HDR on the system and asking whether the user would like to proceed with the game rendering as HDR in a non-suitable environment (i.e, looking weird) or abort.<br />
<br />
== Calibration ==<br />
To obtain the most out of your HDR experience, you will have to calibrate the game to generate a display signal suitable to that of your monitor's or TV's. Oolite's Game Options menu is slightly different when the game is run in HDR mode, meaning that it has two options not normally appearing in the default menu: HDR Max Brightness and HDR Paper White. The menu in HDR mode will look as seen in the screen below:<br />
[[file:OoliteHDRMenu.png]]<br />
<br />
By default HDR Max Brightness is set to 1000 nits and HDR Papaer White is set to 200 nits. You must adjust those values to match your display. At this moment Oolite does not feature an HDR calibration screen so you should get the Max Brightness information for your display from either the manufacturer's website or by running the Windows HDR Calibration utility (available for Windows 11 at the Microsoft Store for free).<br />
<br />
HDR Max Brightness can be set to 400, 500, 600, 800 and 1000 nits, but you can also edit descriptions.plist in your game install and add other values if you want - the game will accept them and use them. To add max brightness values, if so desired, open oolite.app/Resources/descriptions.plist in a text editor (backup the original file first just in case), find the block <pre>hdr_maxBrightness_array =<br />
(<br />
400, 500, 600, 800, 1000<br />
);</pre>and insert your new value in the row with the numbers, making sure it is separated by commas from the rest. Save and restart the game with Shift down to enable the edit and you should now have the extra option available. It is important that this value matches as closely as possible the actual max brightness your display can output for a <b>10% screen coverage window</b>.<br />
<br />
HDR Paper White indicates how bright a pure diffuse white object will be. You can think of it as a generic brightness slider. The higher you set it, the less headroom for highlights you leave. As a rule of thumb this can be set to about 1/4 of the max brightness, but it is entirely up to you to decide. You can set it to whatever feels comfortable to you.<br />
<br />
Once those are set to their correct / preferred values, you are ready for the HDR experience. Be dadvised that HDR has been designed for low lighting environments, so you should avoid brightly lit rooms when playing for best results.<br />
<br />
== Links ==<br />
*[https://bb.oolite.space/viewtopic.php?t=21311 Oolite on HDR Displays] (2022 - date) - this BB thread has the current information<br />
*[https://support.microsoft.com/en-us/windows/calibrate-your-hdr-display-using-the-windows-hdr-calibration-app-f30f4809-3369-43e4-9b02-9eabebd23f19 Windows 11 HDR Calibration App on Microsoft Support]<br />
<br />
[[Category:Oolite]] [[Category:Help pages]]<br />
[[Category:Factual]]</div>Another commanderhttps://wiki.alioth.net/index.php?title=HDR&diff=84367HDR2024-08-25T16:38:20Z<p>Another commander: /* Calibration */</p>
<hr />
<div>High Dynamic Range (advanced video display - currently only available for windows platforms)<br />
<br />
== Overview ==<br />
The current Windows Pre-releases/"nightlies" now support HDR. They can be downloaded from the very bottom of the [https://oolite.space/#download Downloads page] or directly from GitHub, [https://github.com/OoliteProject/oolite/releases here].<br />
<br />
If you have a compatible monitor or TV you can now enjoy vivid, bright and high contrast colors that seem to pop right out of your screen, while maintaining full image details in both highlights and dark areas. Furthermore, colors in HDR mode are 10-bit per RGB component as opposed to 8-bit in SDR and can now exceed the standard Rec709 color space and go well into the DCI-P3 and BT2020 color spaces, creating an even more impressive visual experience with 1.07 billion color hues available to you rather than the 16.7 million available in SDR.<br />
<br />
Fine gameplay moments in HDR can be captured in Radiance (.hdr) format using the standard Oolite save snapshot key. You can view Radiance files at a later time using software like Windows HDR+WCG Viewer (available from the Microsoft Store for free) or the also free and very powerful HDR image viewer utility, [https://cdn.discordapp.com/attachments/792979353117524009/1277053487368241325/SKIV.exe?ex=66cc6cfd&is=66cb1b7d&hm=417a59e377398a4e2d8e12b446dc8881f9498bd21538f2a89e0411ec8e78c3c5& SKIV].<br />
<br />
This has been implemented by our Developer, [[User:Another commander|Another commander]] (who also greatly improved visuals in Oolite versions 1.86, 1.88 & 1.90).<br />
<br />
=== Note ===<br />
Because the changes only affect the display on a HDR screen, there is no way of displaying the improvements on an older SDR screen!<br />
<br />
<br />
<br />
== How to Enable Oolite's HDR Mode ==<br />
After installing the game, a new shortcut will be added to the Start menu group for the game under Windows. Those who use the nightly installers, will notice this new icon under the group "Oolite":<br />
[[file:OoliteHDRIcon.png]]<br />
<br />
You can now use it to launch the game in HDR. Alternatively, you can launch Oolite from a console or the Windows Run dialog using <pre>C:\path\to\game\oolite.exe -hdr</pre><br />
<br />
As a reminder, to be able to run the game in this mode you need:<br />
* Windows 10 or 11 (11 is strongly recommended).<br />
* A monitor that supports HDR output. An OLED monitor or TV is <u>strongly</u> recommended.<br />
* Graphics card that supports HDR, like 10xx NVidia series or higher spec.<br />
* HDMI 2.1 / DisplayPort 1.4 or higher spec cable, so that the HDR bandwidth requirement is satisfied.<br />
* Enabling of HDR in Windows from the Settings -> System -> Display. If your system does not support HDR for whatever reason you will not have the option to enable it.<br />
[[File:OoliteHowToActivateHDRinWindows.png]]<br />
<br />
Attempting to launch the game in HDR mode without satisfying the above requirements will trigger a warning dialog informing the user that it was not possible to detect HDR on the system and asking whether the user would like to proceed with the game rendering as HDR in a non-suitable environment (i.e, looking weird) or abort.<br />
<br />
<br />
<br />
== Calibration ==<br />
To obtain the most out of your HDR experience, you will have to calibrate the game to generate a display signal suitable to that of your monitor's or TV's. Oolite's Game Options menu is slightly different when the game is run in HDR mode, meaning that it has two options not normally appearing in the default menu: HDR Max Brightness and HDR Paper White. The menu in HDR mode will look as seen in the screen below:<br />
[[file:OoliteHDRMenu.png]]<br />
<br />
By default HDR Max Brightness is set to 1000 nits and HDR Papaer White is set to 200 nits. You must adjust those values to match your display. At this moment Oolite does not feature an HDR calibration screen so you should get the Max Brightness information for your display from either the manufacturer's website or by running the Windows HDR Calibration utility (available for Windows 11 at the Microsoft Store for free).<br />
<br />
HDR Max Brightness can be set to 400, 500, 600, 800 and 1000 nits, but you can also edit descriptions.plist in your game install and add other values if you want - the game will accept them and use them. To add max brightness values, if so desired, open oolite.app/Resources/descriptions.plist in a text editor (backup the original file first just in case), find the block <pre>hdr_maxBrightness_array =<br />
(<br />
400, 500, 600, 800, 1000<br />
);</pre>and insert your new value in the row with the numbers, making sure it is separated by commas from the rest. Save and restart the game with Shift down to enable the edit and you should now have the extra option available. It is important that this value matches as closely as possible the actual max brightness your display can output for a <b>10% screen coverage window</b>.<br />
<br />
HDR Paper White indicates how bright a pure diffuse white object will be. You can think of it as a generic brightness slider. The higher you set it, the less headroom for highlights you leave. As a rule of thumb this can be set to about 1/4 of the max brightness, but it is entirely up to you to decide. You can set it to whatever feels comfortable to you.<br />
<br />
Once those are set to their correct / preferred values, you are ready for the HDR experience. Be dadvised that HDR has been designed for low lighting environments, so you should avoid brightly lit rooms when playing for best results.<br />
<br />
== Links ==<br />
*[https://bb.oolite.space/viewtopic.php?t=21311 Oolite on HDR Displays] (2022 - date) - this BB thread has the current information<br />
*[https://support.microsoft.com/en-us/windows/calibrate-your-hdr-display-using-the-windows-hdr-calibration-app-f30f4809-3369-43e4-9b02-9eabebd23f19 Windows 11 HDR Calibration App on Microsoft Support]<br />
<br />
[[Category:Oolite]] [[Category:Help pages]]<br />
[[Category:Factual]]</div>Another commanderhttps://wiki.alioth.net/index.php?title=HDR&diff=84366HDR2024-08-25T16:33:06Z<p>Another commander: /* Links */</p>
<hr />
<div>High Dynamic Range (advanced video display - currently only available for windows platforms)<br />
<br />
== Overview ==<br />
The current Windows Pre-releases/"nightlies" now support HDR. They can be downloaded from the very bottom of the [https://oolite.space/#download Downloads page] or directly from GitHub, [https://github.com/OoliteProject/oolite/releases here].<br />
<br />
If you have a compatible monitor or TV you can now enjoy vivid, bright and high contrast colors that seem to pop right out of your screen, while maintaining full image details in both highlights and dark areas. Furthermore, colors in HDR mode are 10-bit per RGB component as opposed to 8-bit in SDR and can now exceed the standard Rec709 color space and go well into the DCI-P3 and BT2020 color spaces, creating an even more impressive visual experience with 1.07 billion color hues available to you rather than the 16.7 million available in SDR.<br />
<br />
Fine gameplay moments in HDR can be captured in Radiance (.hdr) format using the standard Oolite save snapshot key. You can view Radiance files at a later time using software like Windows HDR+WCG Viewer (available from the Microsoft Store for free) or the also free and very powerful HDR image viewer utility, [https://cdn.discordapp.com/attachments/792979353117524009/1277053487368241325/SKIV.exe?ex=66cc6cfd&is=66cb1b7d&hm=417a59e377398a4e2d8e12b446dc8881f9498bd21538f2a89e0411ec8e78c3c5& SKIV].<br />
<br />
This has been implemented by our Developer, [[User:Another commander|Another commander]] (who also greatly improved visuals in Oolite versions 1.86, 1.88 & 1.90).<br />
<br />
=== Note ===<br />
Because the changes only affect the display on a HDR screen, there is no way of displaying the improvements on an older SDR screen!<br />
<br />
<br />
<br />
== How to Enable Oolite's HDR Mode ==<br />
After installing the game, a new shortcut will be added to the Start menu group for the game under Windows. Those who use the nightly installers, will notice this new icon under the group "Oolite":<br />
[[file:OoliteHDRIcon.png]]<br />
<br />
You can now use it to launch the game in HDR. Alternatively, you can launch Oolite from a console or the Windows Run dialog using <pre>C:\path\to\game\oolite.exe -hdr</pre><br />
<br />
As a reminder, to be able to run the game in this mode you need:<br />
* Windows 10 or 11 (11 is strongly recommended).<br />
* A monitor that supports HDR output. An OLED monitor or TV is <u>strongly</u> recommended.<br />
* Graphics card that supports HDR, like 10xx NVidia series or higher spec.<br />
* HDMI 2.1 / DisplayPort 1.4 or higher spec cable, so that the HDR bandwidth requirement is satisfied.<br />
* Enabling of HDR in Windows from the Settings -> System -> Display. If your system does not support HDR for whatever reason you will not have the option to enable it.<br />
[[File:OoliteHowToActivateHDRinWindows.png]]<br />
<br />
Attempting to launch the game in HDR mode without satisfying the above requirements will trigger a warning dialog informing the user that it was not possible to detect HDR on the system and asking whether the user would like to proceed with the game rendering as HDR in a non-suitable environment (i.e, looking weird) or abort.<br />
<br />
<br />
<br />
== Calibration ==<br />
To obtain the most out of your HDR experience, you will have to calibrate the game to generate a display signal suitable to that of your monitor's or TV's. Oolite's Game Options menu is slightly different when the game is run in HDR mode, meaning that it has two options not normally appearing in the default menu: HDR Max Brightness and HDR Paper White. The menu in HDR mode will look as seen in the screen below:<br />
[[file:OoliteHDRMenu.png]]<br />
<br />
By default HDR Max Brightness is set to 1000 nits and HDR Papaer White is set to 200 nits. You must adjust those values to match your display. At this moment Oolite does not feature an HDR calibration screen so you should get the Max Brightness information for your display from either the manufacturer's website or by running the Windows HDR Calibration utility (available for Windows 11 at the Microsoft Store for free).<br />
<br />
HDR Max Brightness can be set to 400, 500, 600, 800 and 1000 nits, but you can also edit descriptions.plist in your game install and add other values if you want - the game will accept them and use them. To add max brightness values, if so desired, open oolite.app/Resources/descriptions.plist in a text editor (backup the original file first just in case), find the block <pre>hdr_maxBrightness_array =<br />
(<br />
400, 500, 600, 800, 1000<br />
);</pre>and insert your new value in the row with the numbers, making sure it is separated by commas from the rest. Save and restart the game with Shift down to enable the edit and you should now have the extra option available. It is important that this value matches as closely as possible the actual max brightness your display can output for a <b>10% screen coverage window</b>.<br />
<br />
HDR Paper White indicates how bright a pure diffuse white object will be. You can think of it as a generic brightness slider. The higher you set it, the less headroom for highlights you leave. As a rule of thumb this can be set to about 1/4 of the max brightness, but it is entirely up to you to decide. You can set it to whatever feels comfortable to you.<br />
<br />
Once those are set to their correct / preferred values, you are ready for the HDR experience.<br />
<br />
<br />
<br />
== Links ==<br />
*[https://bb.oolite.space/viewtopic.php?t=21311 Oolite on HDR Displays] (2022 - date) - this BB thread has the current information<br />
*[https://support.microsoft.com/en-us/windows/calibrate-your-hdr-display-using-the-windows-hdr-calibration-app-f30f4809-3369-43e4-9b02-9eabebd23f19 Windows 11 HDR Calibration App on Microsoft Support]<br />
<br />
[[Category:Oolite]] [[Category:Help pages]]<br />
[[Category:Factual]]</div>Another commanderhttps://wiki.alioth.net/index.php?title=HDR&diff=84365HDR2024-08-25T16:30:15Z<p>Another commander: </p>
<hr />
<div>High Dynamic Range (advanced video display - currently only available for windows platforms)<br />
<br />
== Overview ==<br />
The current Windows Pre-releases/"nightlies" now support HDR. They can be downloaded from the very bottom of the [https://oolite.space/#download Downloads page] or directly from GitHub, [https://github.com/OoliteProject/oolite/releases here].<br />
<br />
If you have a compatible monitor or TV you can now enjoy vivid, bright and high contrast colors that seem to pop right out of your screen, while maintaining full image details in both highlights and dark areas. Furthermore, colors in HDR mode are 10-bit per RGB component as opposed to 8-bit in SDR and can now exceed the standard Rec709 color space and go well into the DCI-P3 and BT2020 color spaces, creating an even more impressive visual experience with 1.07 billion color hues available to you rather than the 16.7 million available in SDR.<br />
<br />
Fine gameplay moments in HDR can be captured in Radiance (.hdr) format using the standard Oolite save snapshot key. You can view Radiance files at a later time using software like Windows HDR+WCG Viewer (available from the Microsoft Store for free) or the also free and very powerful HDR image viewer utility, [https://cdn.discordapp.com/attachments/792979353117524009/1277053487368241325/SKIV.exe?ex=66cc6cfd&is=66cb1b7d&hm=417a59e377398a4e2d8e12b446dc8881f9498bd21538f2a89e0411ec8e78c3c5& SKIV].<br />
<br />
This has been implemented by our Developer, [[User:Another commander|Another commander]] (who also greatly improved visuals in Oolite versions 1.86, 1.88 & 1.90).<br />
<br />
=== Note ===<br />
Because the changes only affect the display on a HDR screen, there is no way of displaying the improvements on an older SDR screen!<br />
<br />
<br />
<br />
== How to Enable Oolite's HDR Mode ==<br />
After installing the game, a new shortcut will be added to the Start menu group for the game under Windows. Those who use the nightly installers, will notice this new icon under the group "Oolite":<br />
[[file:OoliteHDRIcon.png]]<br />
<br />
You can now use it to launch the game in HDR. Alternatively, you can launch Oolite from a console or the Windows Run dialog using <pre>C:\path\to\game\oolite.exe -hdr</pre><br />
<br />
As a reminder, to be able to run the game in this mode you need:<br />
* Windows 10 or 11 (11 is strongly recommended).<br />
* A monitor that supports HDR output. An OLED monitor or TV is <u>strongly</u> recommended.<br />
* Graphics card that supports HDR, like 10xx NVidia series or higher spec.<br />
* HDMI 2.1 / DisplayPort 1.4 or higher spec cable, so that the HDR bandwidth requirement is satisfied.<br />
* Enabling of HDR in Windows from the Settings -> System -> Display. If your system does not support HDR for whatever reason you will not have the option to enable it.<br />
[[File:OoliteHowToActivateHDRinWindows.png]]<br />
<br />
Attempting to launch the game in HDR mode without satisfying the above requirements will trigger a warning dialog informing the user that it was not possible to detect HDR on the system and asking whether the user would like to proceed with the game rendering as HDR in a non-suitable environment (i.e, looking weird) or abort.<br />
<br />
<br />
<br />
== Calibration ==<br />
To obtain the most out of your HDR experience, you will have to calibrate the game to generate a display signal suitable to that of your monitor's or TV's. Oolite's Game Options menu is slightly different when the game is run in HDR mode, meaning that it has two options not normally appearing in the default menu: HDR Max Brightness and HDR Paper White. The menu in HDR mode will look as seen in the screen below:<br />
[[file:OoliteHDRMenu.png]]<br />
<br />
By default HDR Max Brightness is set to 1000 nits and HDR Papaer White is set to 200 nits. You must adjust those values to match your display. At this moment Oolite does not feature an HDR calibration screen so you should get the Max Brightness information for your display from either the manufacturer's website or by running the Windows HDR Calibration utility (available for Windows 11 at the Microsoft Store for free).<br />
<br />
HDR Max Brightness can be set to 400, 500, 600, 800 and 1000 nits, but you can also edit descriptions.plist in your game install and add other values if you want - the game will accept them and use them. To add max brightness values, if so desired, open oolite.app/Resources/descriptions.plist in a text editor (backup the original file first just in case), find the block <pre>hdr_maxBrightness_array =<br />
(<br />
400, 500, 600, 800, 1000<br />
);</pre>and insert your new value in the row with the numbers, making sure it is separated by commas from the rest. Save and restart the game with Shift down to enable the edit and you should now have the extra option available. It is important that this value matches as closely as possible the actual max brightness your display can output for a <b>10% screen coverage window</b>.<br />
<br />
HDR Paper White indicates how bright a pure diffuse white object will be. You can think of it as a generic brightness slider. The higher you set it, the less headroom for highlights you leave. As a rule of thumb this can be set to about 1/4 of the max brightness, but it is entirely up to you to decide. You can set it to whatever feels comfortable to you.<br />
<br />
Once those are set to their correct / preferred values, you are ready for the HDR experience.<br />
<br />
<br />
<br />
== Links ==<br />
*[https://bb.oolite.space/viewtopic.php?t=21311 Oolite on HDR Displays] (2022 - date) - this BB thread has the current information<br />
<br />
[[Category:Oolite]] [[Category:Help pages]]<br />
[[Category:Factual]]</div>Another commanderhttps://wiki.alioth.net/index.php?title=HDR&diff=84364HDR2024-08-25T16:29:12Z<p>Another commander: /* Overview */</p>
<hr />
<div>High Dynamic Range (advanced video display - currently only available for windows platforms)<br />
<br />
== Overview ==<br />
The current Windows Pre-releases/"nightlies" now support HDR. They can be downloaded from the very bottom of the [https://oolite.space/#download Downloads page] or directly from GitHub, [https://github.com/OoliteProject/oolite/releases here].<br />
<br />
If you have a compatible monitor or TV you can now enjoy vivid, bright and high contrast colors that seem to pop right out of your screen, while maintaining full image details in both highlights and dark areas. Furthermore, colors in HDR mode are 10-bit per RGB component as opposed to 8-bit in SDR and can now exceed the standard Rec709 color space and go well into the DCI-P3 and BT2020 color spaces, creating an even more impressive visual experience with 1.07 billion color hues available to you rather than the 16.7 million available in SDR.<br />
<br />
Fine gameplay moments in HDR can be captured in Radiance (.hdr) format using the standard Oolite save snapshot key. You can view Radiance files at a later time using software like Windows HDR+WCG Viewer (available from the Microsoft Store for free) or the also free and very powerful HDR image viewer utility, [https://cdn.discordapp.com/attachments/792979353117524009/1277053487368241325/SKIV.exe?ex=66cc6cfd&is=66cb1b7d&hm=417a59e377398a4e2d8e12b446dc8881f9498bd21538f2a89e0411ec8e78c3c5& SKIV].<br />
<br />
This has been implemented by our Developer, [[User:Another commander|Another commander]] (who also greatly improved visuals in Oolite versions 1.86, 1.88 & 1.90).<br />
<br />
=== Note ===<br />
Because the changes only affect the display on a HDR screen, there is no way of displaying the improvements on an older SDR screen!<br />
<br />
== How to Enable Oolite's HDR Mode ==<br />
After installing the game, a new shortcut will be added to the Start menu group for the game under Windows. Those who use the nightly installers, will notice this new icon under the group "Oolite":<br />
[[file:OoliteHDRIcon.png]]<br />
<br />
You can now use it to launch the game in HDR. Alternatively, you can launch Oolite from a console or the Windows Run dialog using <pre>C:\path\to\game\oolite.exe -hdr</pre><br />
<br />
As a reminder, to be able to run the game in this mode you need:<br />
* Windows 10 or 11 (11 is strongly recommended).<br />
* A monitor that supports HDR output. An OLED monitor or TV is <u>strongly</u> recommended.<br />
* Graphics card that supports HDR, like 10xx NVidia series or higher spec.<br />
* HDMI 2.1 / DisplayPort 1.4 or higher spec cable, so that the HDR bandwidth requirement is satisfied.<br />
* Enabling of HDR in Windows from the Settings -> System -> Display. If your system does not support HDR for whatever reason you will not have the option to enable it.<br />
[[File:OoliteHowToActivateHDRinWindows.png]]<br />
<br />
Attempting to launch the game in HDR mode without satisfying the above requirements will trigger a warning dialog informing the user that it was not possible to detect HDR on the system and asking whether the user would like to proceed with the game rendering as HDR in a non-suitable environment (i.e, looking weird) or abort.<br />
<br />
<br />
<br />
== Calibration ==<br />
To obtain the most out of your HDR experience, you will have to calibrate the game to generate a display signal suitable to that of your monitor's or TV's. Oolite's Game Options menu is slightly different when the game is run in HDR mode, meaning that it has two options not normally appearing in the default menu: HDR Max Brightness and HDR Paper White. The menu in HDR mode will look as seen in the screen below:<br />
[[file:OoliteHDRMenu.png]]<br />
<br />
By default HDR Max Brightness is set to 1000 nits and HDR Papaer White is set to 200 nits. You must adjust those values to match your display. At this moment Oolite does not feature an HDR calibration screen so you should get the Max Brightness information for your display from either the manufacturer's website or by running the Windows HDR Calibration utility (available for Windows 11 at the Microsoft Store for free).<br />
<br />
HDR Max Brightness can be set to 400, 500, 600, 800 and 1000 nits, but you can also edit descriptions.plist in your game install and add other values if you want - the game will accept them and use them. To add max brightness values, if so desired, open oolite.app/Resources/descriptions.plist in a text editor (backup the original file first just in case), find the block <pre>hdr_maxBrightness_array =<br />
(<br />
400, 500, 600, 800, 1000<br />
);</pre>and insert your new value in the row with the numbers, making sure it is separated by commas from the rest. Save and restart the game with Shift down to enable the edit and you should now have the extra option available. It is important that this value matches as closely as possible the actual max brightness your display can output for a <b>10% screen coverage window</b>.<br />
<br />
HDR Paper White indicates how bright a pure diffuse white object will be. You can think of it as a generic brightness slider. The higher you set it, the less headroom for highlights you leave. As a rule of thumb this can be set to about 1/4 of the max brightness, but it is entirely up to you to decide. You can set it to whatever feels comfortable to you.<br />
<br />
Once those are set to their correct / preferred values, you are ready for the HDR experience.<br />
<br />
== Links ==<br />
*[https://bb.oolite.space/viewtopic.php?t=21311 Oolite on HDR Displays] (2022 - date) - this BB thread has the current information<br />
<br />
[[Category:Oolite]] [[Category:Help pages]]<br />
[[Category:Factual]]</div>Another commanderhttps://wiki.alioth.net/index.php?title=HDR&diff=84363HDR2024-08-25T16:28:44Z<p>Another commander: </p>
<hr />
<div>High Dynamic Range (advanced video display - currently only available for windows platforms)<br />
<br />
== Overview ==<br />
The current Windows Pre-releases/"nightlies" now support HDR. They can be downloaded from the very bottom of the [https://oolite.space/#download Downloads page] or directly from GitHub, [https://github.com/OoliteProject/oolite/releases here].<br />
<br />
If you have a compatible monitor or TV you can now enjoy vivid, bright and high contrast colors that seem to pop right out of your screen, while maintaining full image details in both highlights and dark areas. Furthermore, colors in HDR mode are 10-bit per RGB component as opposed to 8-bit in SDR and can now exceed the standard Rec709 color space and go well into the DCI-P3 and BT2020 color spaces, creating an even more impressive visual experience with 1.07 billion color hues available to you, rather than the 16.7 million available in SDR.<br />
<br />
Fine gameplay moments in HDR can be captured in Radiance (.hdr) format using the standard Oolite save snapshot key. You can view Radiance files at a later time using software like Windows HDR+WCG Viewer (available from the Microsoft Store for free) or the also free and very powerful HDR image viewer utility, [https://cdn.discordapp.com/attachments/792979353117524009/1277053487368241325/SKIV.exe?ex=66cc6cfd&is=66cb1b7d&hm=417a59e377398a4e2d8e12b446dc8881f9498bd21538f2a89e0411ec8e78c3c5& SKIV].<br />
<br />
This has been implemented by our Developer, [[User:Another commander|Another commander]] (who also greatly improved visuals in Oolite versions 1.86, 1.88 & 1.90).<br />
<br />
=== Note ===<br />
Because the changes only affect the display on a HDR screen, there is no way of displaying the improvements on an older SDR screen!<br />
<br />
<br />
<br />
== How to Enable Oolite's HDR Mode ==<br />
After installing the game, a new shortcut will be added to the Start menu group for the game under Windows. Those who use the nightly installers, will notice this new icon under the group "Oolite":<br />
[[file:OoliteHDRIcon.png]]<br />
<br />
You can now use it to launch the game in HDR. Alternatively, you can launch Oolite from a console or the Windows Run dialog using <pre>C:\path\to\game\oolite.exe -hdr</pre><br />
<br />
As a reminder, to be able to run the game in this mode you need:<br />
* Windows 10 or 11 (11 is strongly recommended).<br />
* A monitor that supports HDR output. An OLED monitor or TV is <u>strongly</u> recommended.<br />
* Graphics card that supports HDR, like 10xx NVidia series or higher spec.<br />
* HDMI 2.1 / DisplayPort 1.4 or higher spec cable, so that the HDR bandwidth requirement is satisfied.<br />
* Enabling of HDR in Windows from the Settings -> System -> Display. If your system does not support HDR for whatever reason you will not have the option to enable it.<br />
[[File:OoliteHowToActivateHDRinWindows.png]]<br />
<br />
Attempting to launch the game in HDR mode without satisfying the above requirements will trigger a warning dialog informing the user that it was not possible to detect HDR on the system and asking whether the user would like to proceed with the game rendering as HDR in a non-suitable environment (i.e, looking weird) or abort.<br />
<br />
<br />
<br />
== Calibration ==<br />
To obtain the most out of your HDR experience, you will have to calibrate the game to generate a display signal suitable to that of your monitor's or TV's. Oolite's Game Options menu is slightly different when the game is run in HDR mode, meaning that it has two options not normally appearing in the default menu: HDR Max Brightness and HDR Paper White. The menu in HDR mode will look as seen in the screen below:<br />
[[file:OoliteHDRMenu.png]]<br />
<br />
By default HDR Max Brightness is set to 1000 nits and HDR Papaer White is set to 200 nits. You must adjust those values to match your display. At this moment Oolite does not feature an HDR calibration screen so you should get the Max Brightness information for your display from either the manufacturer's website or by running the Windows HDR Calibration utility (available for Windows 11 at the Microsoft Store for free).<br />
<br />
HDR Max Brightness can be set to 400, 500, 600, 800 and 1000 nits, but you can also edit descriptions.plist in your game install and add other values if you want - the game will accept them and use them. To add max brightness values, if so desired, open oolite.app/Resources/descriptions.plist in a text editor (backup the original file first just in case), find the block <pre>hdr_maxBrightness_array =<br />
(<br />
400, 500, 600, 800, 1000<br />
);</pre>and insert your new value in the row with the numbers, making sure it is separated by commas from the rest. Save and restart the game with Shift down to enable the edit and you should now have the extra option available. It is important that this value matches as closely as possible the actual max brightness your display can output for a <b>10% screen coverage window</b>.<br />
<br />
HDR Paper White indicates how bright a pure diffuse white object will be. You can think of it as a generic brightness slider. The higher you set it, the less headroom for highlights you leave. As a rule of thumb this can be set to about 1/4 of the max brightness, but it is entirely up to you to decide. You can set it to whatever feels comfortable to you.<br />
<br />
Once those are set to their correct / preferred values, you are ready for the HDR experience.<br />
<br />
== Links ==<br />
*[https://bb.oolite.space/viewtopic.php?t=21311 Oolite on HDR Displays] (2022 - date) - this BB thread has the current information<br />
<br />
[[Category:Oolite]] [[Category:Help pages]]<br />
[[Category:Factual]]</div>Another commanderhttps://wiki.alioth.net/index.php?title=HDR&diff=84362HDR2024-08-25T16:27:29Z<p>Another commander: /* Calibration */</p>
<hr />
<div>High Dynamic Range (advanced video display - currently only available for windows platforms)<br />
<br />
== Overview ==<br />
The current Windows Pre-releases/"nightlies" now support HDR. They can be downloaded from the very bottom of the [https://oolite.space/#download Downloads page] or directly from GitHub, [https://github.com/OoliteProject/oolite/releases here].<br />
<br />
If you have a compatible monitor or TV you can now enjoy vivid, bright and high contrast colors that seem to pop right out of your screen, while maintaining full image details in both highlights and dark areas. Furthermore, colors in HDR mode are 10-bit per RGB component as opposed to 8-bit in SDR and can now exceed the standard Rec709 color space and go well into the DCI-P3 and BT2020 color spaces, creating an even more impressive visual experience with 1.07 billion color hues available to you, rather than the 16.7 million available in SDR.<br />
<br />
Fine gameplay moments in HDR can be captured in Radiance (.hdr) format using the standard Oolite save snapshot key. You can view Radiance files at a later time using software like Windows HDR+WCG Viewer (available from the Windows Store for free) or the also free and very powerful HDR image viewer utility, [https://cdn.discordapp.com/attachments/792979353117524009/1277053487368241325/SKIV.exe?ex=66cc6cfd&is=66cb1b7d&hm=417a59e377398a4e2d8e12b446dc8881f9498bd21538f2a89e0411ec8e78c3c5& SKIV].<br />
<br />
This has been implemented by our Developer, [[User:Another commander|Another commander]] (who also greatly improved visuals in Oolite versions 1.86, 1.88 & 1.90).<br />
<br />
=== Note ===<br />
Because the changes only affect the display on a HDR screen, there is no way of displaying the improvements on an older SDR screen!<br />
<br />
<br />
<br />
== How to Enable Oolite's HDR Mode ==<br />
After installing the game, a new shortcut will be added to the Start menu group for the game under Windows. Those who use the nightly installers, will notice this new icon under the group "Oolite":<br />
[[file:OoliteHDRIcon.png]]<br />
<br />
You can now use it to launch the game in HDR. Alternatively, you can launch Oolite from a console or the Windows Run dialog using <pre>C:\path\to\game\oolite.exe -hdr</pre><br />
<br />
As a reminder, to be able to run the game in this mode you need:<br />
* Windows 10 or 11 (11 is strongly recommended).<br />
* A monitor that supports HDR output. An OLED monitor or TV is <u>strongly</u> recommended.<br />
* Graphics card that supports HDR, like 10xx NVidia series or higher spec.<br />
* HDMI 2.1 / DisplayPort 1.4 or higher spec cable, so that the HDR bandwidth requirement is satisfied.<br />
* Enabling of HDR in Windows from the Settings -> System -> Display. If your system does not support HDR for whatever reason you will not have the option to enable it.<br />
[[File:OoliteHowToActivateHDRinWindows.png]]<br />
<br />
Attempting to launch the game in HDR mode without satisfying the above requirements will trigger a warning dialog informing the user that it was not possible to detect HDR on the system and asking whether the user would like to proceed with the game rendering as HDR in a non-suitable environment (i.e, looking weird) or abort.<br />
<br />
<br />
<br />
== Calibration ==<br />
To obtain the most out of your HDR experience, you will have to calibrate the game to generate a display signal suitable to that of your monitor's or TV's. Oolite's Game Options menu is slightly different when the game is run in HDR mode, meaning that it has two options not normally appearing in the default menu: HDR Max Brightness and HDR Paper White. The menu in HDR mode will look as seen in the screen below:<br />
[[file:OoliteHDRMenu.png]]<br />
<br />
By default HDR Max Brightness is set to 1000 nits and HDR Papaer White is set to 200 nits. You must adjust those values to match your display. At this moment Oolite does not feature an HDR calibration screen so you should get the Max Brightness information for your display from either the manufacturer's website or by running the Windows HDR Calibration utility (available for Windows 11 at the Windoes Store for free).<br />
<br />
HDR Max Brightness can be set to 400, 500, 600, 800 and 1000 nits, but you can also edit descriptions.plist in your game install and add other values if you want - the game will accept them and use them. To add max brightness values, if so desired, open oolite.app/Resources/descriptions.plist in a text editor (backup the original file first just in case), find the block <pre>hdr_maxBrightness_array =<br />
(<br />
400, 500, 600, 800, 1000<br />
);</pre>and insert your new value in the row with the numbers, making sure it is separated by commas from the rest. Save and restart the game with Shift down to enable the edit and you should now have the extra option available. It is important that this value matches as closely as possible the actual max brightness your display can output for a <b>10% screen coverage window</b>.<br />
<br />
HDR Paper White indicates how bright a pure diffuse white object will be. You can think of it as a generic brightness slider. The higher you set it, the less headroom for highlights you leave. As a rule of thumb this can be set to about 1/4 of the max brightness, but it is entirely up to you to decide. You can set it to whatever feels comfortable to you.<br />
<br />
Once those are set to their correct / preferred values, you are ready for the HDR experience.<br />
<br />
== Links ==<br />
*[https://bb.oolite.space/viewtopic.php?t=21311 Oolite on HDR Displays] (2022 - date) - this BB thread has the current information<br />
<br />
[[Category:Oolite]] [[Category:Help pages]]<br />
[[Category:Factual]]</div>Another commanderhttps://wiki.alioth.net/index.php?title=HDR&diff=84361HDR2024-08-25T16:26:00Z<p>Another commander: </p>
<hr />
<div>High Dynamic Range (advanced video display - currently only available for windows platforms)<br />
<br />
== Overview ==<br />
The current Windows Pre-releases/"nightlies" now support HDR. They can be downloaded from the very bottom of the [https://oolite.space/#download Downloads page] or directly from GitHub, [https://github.com/OoliteProject/oolite/releases here].<br />
<br />
If you have a compatible monitor or TV you can now enjoy vivid, bright and high contrast colors that seem to pop right out of your screen, while maintaining full image details in both highlights and dark areas. Furthermore, colors in HDR mode are 10-bit per RGB component as opposed to 8-bit in SDR and can now exceed the standard Rec709 color space and go well into the DCI-P3 and BT2020 color spaces, creating an even more impressive visual experience with 1.07 billion color hues available to you, rather than the 16.7 million available in SDR.<br />
<br />
Fine gameplay moments in HDR can be captured in Radiance (.hdr) format using the standard Oolite save snapshot key. You can view Radiance files at a later time using software like Windows HDR+WCG Viewer (available from the Windows Store for free) or the also free and very powerful HDR image viewer utility, [https://cdn.discordapp.com/attachments/792979353117524009/1277053487368241325/SKIV.exe?ex=66cc6cfd&is=66cb1b7d&hm=417a59e377398a4e2d8e12b446dc8881f9498bd21538f2a89e0411ec8e78c3c5& SKIV].<br />
<br />
This has been implemented by our Developer, [[User:Another commander|Another commander]] (who also greatly improved visuals in Oolite versions 1.86, 1.88 & 1.90).<br />
<br />
=== Note ===<br />
Because the changes only affect the display on a HDR screen, there is no way of displaying the improvements on an older SDR screen!<br />
<br />
<br />
<br />
== How to Enable Oolite's HDR Mode ==<br />
After installing the game, a new shortcut will be added to the Start menu group for the game under Windows. Those who use the nightly installers, will notice this new icon under the group "Oolite":<br />
[[file:OoliteHDRIcon.png]]<br />
<br />
You can now use it to launch the game in HDR. Alternatively, you can launch Oolite from a console or the Windows Run dialog using <pre>C:\path\to\game\oolite.exe -hdr</pre><br />
<br />
As a reminder, to be able to run the game in this mode you need:<br />
* Windows 10 or 11 (11 is strongly recommended).<br />
* A monitor that supports HDR output. An OLED monitor or TV is <u>strongly</u> recommended.<br />
* Graphics card that supports HDR, like 10xx NVidia series or higher spec.<br />
* HDMI 2.1 / DisplayPort 1.4 or higher spec cable, so that the HDR bandwidth requirement is satisfied.<br />
* Enabling of HDR in Windows from the Settings -> System -> Display. If your system does not support HDR for whatever reason you will not have the option to enable it.<br />
[[File:OoliteHowToActivateHDRinWindows.png]]<br />
<br />
Attempting to launch the game in HDR mode without satisfying the above requirements will trigger a warning dialog informing the user that it was not possible to detect HDR on the system and asking whether the user would like to proceed with the game rendering as HDR in a non-suitable environment (i.e, looking weird) or abort.<br />
<br />
<br />
<br />
== Calibration ==<br />
To obtain the most out of your HDR experience, you will have to calibrate the game to generate a display signal suitable to that of your monitor's or TV's. Oolite's Game Options menu is slightly different when the game is run in HDR mode, meaning that it has two options not normally appearing in the default menu: HDR Max Brightness and HDR Paper White. The menu in HDR mode will look as seen in the screen below:<br />
[[file:OoliteHDRMenu.png]]<br />
<br />
By default HDR Max Brightness is set to 1000 nits and HDR Papaer White is set to 200 nits. You must adjust those values to match your display. At this moment Oolite does not feature an HDR calibration screen so you should get the Max Brightness information for your display from either the manufacturer's website or by running the Windows HDR Calibration utility (available at the Windoes Store for free).<br />
<br />
HDR Max Brightness can be set to 400, 500, 600, 800 and 1000 nits, but you can also edit descriptions.plist in your game install and add other values if you want - the game will accept them and use them. To add max brightness values, if so desired, open oolite.app/Resources/descriptions.plist in a text editor (backup the original file first just in case), find the block <pre>hdr_maxBrightness_array =<br />
(<br />
400, 500, 600, 800, 1000<br />
);</pre>and insert your new value in the row with the numbers, making sure it is separated by commas from the rest. Save and restart the game with Shift down to enable the edit and you should now have the extra option available. It is important that this value matches as closely as possible the actual max brightness your display can output for a <b>10% screen coverage window</b>.<br />
<br />
HDR Paper White indicates how bright a pure diffuse white object will be. You can think of it as a generic brightness slider. The higher you set it, the less headroom for highlights you leave. As a rule of thumb this can be set to about 1/4 of the max brightness, but it is entirely up to you to decide. You can set it to whatever feels comfortable to you.<br />
<br />
Once those are set to their correct / preferred values, you are ready for the HDR experience.<br />
<br />
<br />
<br />
== Links ==<br />
*[https://bb.oolite.space/viewtopic.php?t=21311 Oolite on HDR Displays] (2022 - date) - this BB thread has the current information<br />
<br />
[[Category:Oolite]] [[Category:Help pages]]<br />
[[Category:Factual]]</div>Another commanderhttps://wiki.alioth.net/index.php?title=HDR&diff=84360HDR2024-08-25T16:25:16Z<p>Another commander: /* Note */</p>
<hr />
<div>High Dynamic Range (advanced video display - currently only available for windows platforms)<br />
<br />
== Overview ==<br />
The current Windows Pre-releases/"nightlies" now support HDR. They can be downloaded from the very bottom of the [https://oolite.space/#download Downloads page] or directly from GitHub, [https://github.com/OoliteProject/oolite/releases here].<br />
<br />
If you have a compatible monitor or TV you can now enjoy vivid, bright and high contrast colors that seem to pop right out of your screen, while maintaining full image details in both highlights and dark areas. Furthermore, colors in HDR mode are 10-bit per RGB component as opposed to 8-bit in SDR and can now exceed the standard Rec709 color space and go well into the DCI-P3 and BT2020 color spaces, creating an even more impressive visual experience with 1.07 billion color hues available to you, rather than the 16.7 million available in SDR.<br />
<br />
Fine gameplay moments in HDR can be captured in Radiance (.hdr) format using the standard Oolite save snapshot key. You can view Radiance files at a later time using software like Windows HDR+WCG Viewer (available from the Windows Store for free) or the also free and very powerful HDR image viewer utility, [https://cdn.discordapp.com/attachments/792979353117524009/1277053487368241325/SKIV.exe?ex=66cc6cfd&is=66cb1b7d&hm=417a59e377398a4e2d8e12b446dc8881f9498bd21538f2a89e0411ec8e78c3c5& SKIV].<br />
<br />
This has been implemented by our Developer, [[User:Another commander|Another commander]] (who also greatly improved visuals in Oolite versions 1.86, 1.88 & 1.90).<br />
<br />
=== Note ===<br />
Because the changes only affect the display on a HDR screen, there is no way of displaying the improvements on an older SDR screen!<br />
<br />
== How to Enable Oolite's HDR Mode ==<br />
After installing the game, a new shortcut will be added to the Start menu group for the game under Windows. Those who use the nightly installers, will notice this new icon under the group "Oolite":<br />
[[file:OoliteHDRIcon.png]]<br />
<br />
You can now use it to launch the game in HDR. Alternatively, you can launch Oolite from a console or the Windows Run dialog using <pre>C:\path\to\game\oolite.exe -hdr</pre><br />
<br />
As a reminder, to be able to run the game in this mode you need:<br />
* Windows 10 or 11 (11 is strongly recommended).<br />
* A monitor that supports HDR output. An OLED monitor or TV is <u>strongly</u> recommended.<br />
* Graphics card that supports HDR, like 10xx NVidia series or higher spec.<br />
* HDMI 2.1 / DisplayPort 1.4 or higher spec cable, so that the HDR bandwidth requirement is satisfied.<br />
* Enabling of HDR in Windows from the Settings -> System -> Display. If your system does not support HDR for whatever reason you will not have the option to enable it.<br />
[[File:OoliteHowToActivateHDRinWindows.png]]<br />
<br />
Attempting to launch the game in HDR mode without satisfying the above requirements will trigger a warning dialog informing the user that it was not possible to detect HDR on the system and asking whether the user would like to proceed with the game rendering as HDR in a non-suitable environment (i.e, looking weird) or abort.<br />
<br />
<br />
== Calibration ==<br />
To obtain the most out of your HDR experience, you will have to calibrate the game to generate a display signal suitable to that of your monitor's or TV's. Oolite's Game Options menu is slightly different when the game is run in HDR mode, meaning that it has two options not normally appearing in the default menu: HDR Max Brightness and HDR Paper White. The menu in HDR mode will look as seen in the screen below:<br />
[[file:OoliteHDRMenu.png]]<br />
<br />
By default HDR Max Brightness is set to 1000 nits and HDR Papaer White is set to 200 nits. You must adjust those values to match your display. At this moment Oolite does not feature an HDR calibration screen so you should get the Max Brightness information for your display from either the manufacturer's website or by running the Windows HDR Calibration utility (available at the Windoes Store for free).<br />
<br />
HDR Max Brightness can be set to 400, 500, 600, 800 and 1000 nits, but you can also edit descriptions.plist in your game install and add other values if you want - the game will accept them and use them. To add max brightness values, if so desired, open oolite.app/Resources/descriptions.plist in a text editor (backup the original file first just in case), find the block <pre>hdr_maxBrightness_array =<br />
(<br />
400, 500, 600, 800, 1000<br />
);</pre>and insert your new value in the row with the numbers, making sure it is separated by commas from the rest. Save and restart the game with Shift down to enable the edit and you should now have the extra option available. It is important that this value matches as closely as possible the actual max brightness your display can output for a <b>10% screen coverage window</b>.<br />
<br />
HDR Paper White indicates how bright a pure diffuse white object will be. You can think of it as a generic brightness slider. The higher you set it, the less headroom for highlights you leave. As a rule of thumb this can be set to about 1/4 of the max brightness, but it is entirely up to you to decide. You can set it to whatever feels comfortable to you.<br />
<br />
Once those are set to their correct / preferred values, you are ready for the HDR experience.<br />
<br />
== Links ==<br />
*[https://bb.oolite.space/viewtopic.php?t=21311 Oolite on HDR Displays] (2022 - date) - this BB thread has the current information<br />
<br />
[[Category:Oolite]] [[Category:Help pages]]<br />
[[Category:Factual]]</div>Another commanderhttps://wiki.alioth.net/index.php?title=File:ViperBlowingUpBaddies.png&diff=84359File:ViperBlowingUpBaddies.png2024-08-25T16:24:07Z<p>Another commander: </p>
<hr />
<div></div>Another commander