Planetinfo.plist on the wiki

[Wildeblood]

This page http://wiki.alioth.net/index.php/Planetinfo.plist is IMNPHO, a bit of a mess. Things appear to be listed in a purely random order. I suspect in the order they were actually added to Oolite. Certainly not alphabetical, nor in logical groups.

Will anyone scream if I completely re-arrange the page to put them into groups of properties that affect the station, the planet, the "sun" and the background sky?

EDIT: I see it now, the first ten listed are the ones that appear on the System Data screen, then the others are in alphabetical order after that.

[Diziet Sma]

Hmmm.. it is a bit all over the place, eh?

Will anyone scream if I completely re-arrange the page to put them into groups of properties that affect the station, the planet, the "sun" and the background sky?

Nope.. not me.. I may, however, applaud.

[Smivs]

...completely re-arrange the page to put them into groups of properties that affect the station, the planet, the "sun" and the background sky?

Sounds sensible - go for it

[Eric Walch]

Things appear to be listed in a purely random order. I suspect in the order they were actually added to Oolite. Certainly not alphabetical, nor in logical groups.

Much to improve there.

They are not completely random. The new added stuff was all added alphabetical, but the old entries that are shown in Oolite on the F7 page, are still 'unordered' at the top.

[Wildeblood]

In Resources/Config/planetinfo.plist is this comment:-

/* This setting controls the minimum charge level of the energy banks
before the shields start charging. It's taken as a percentage value
from 0.0 (0%) to 1.0 (100%). If the energy banks are less than this,
energy is first used to charge the banks, and only then the shields.
Default: 0.0
*/
//shield_charge_energybank_threshold = 0.75;

Is this setting actually implemented, or is the comment an "aspirational" statement? If it actually works, it should be mentioned on the wiki page, and would "Properties of the Player Ship" be an appropriate heading to group this and the galactic hyper-drive settings under? (It sounds a bit naff to me, but I can't think how else one would describe them.)

The same questions apply to these:-

hyperspace_tunnel_color_1 = (1.0, 1.0, 1.0, 0.7); // R, G, B, A values 0.0 to 1.0

//hyperspace_tunnel_color_1 = (1.0, 0.0, 0.0, 0.5); // fallback value, same as docking tunnel
//hyperspace_tunnel_color_2 = (0.0, 0.0, 1.0, 0.25); // fallback value, same as docking tunnel

[Eric Walch]

It is implemented. In the code, I find for the player energy recharge:

Code: Select all

	if( (forward_shield > fwdMax * 0.25) && (aft_shield > aftMax * 0.25) )
	{
		// TODO: Can this be cached anywhere sensibly (without adding another member variable)?
		float minEnergyBankLevel = [[UNIVERSE planetInfo] oo_floatForKey:@"shield_charge_energybank_threshold" defaultValue:0.25];
		energyForShields = MAX(0.0, energy -0.1 - (maxEnergy * minEnergyBankLevel)); // NB: The - 0.1 ensures the energy value does not 'bounce' across the critical energy message and causes spurious energy-low warnings
	}

Only the default seems to be different now. I am not sure how intentionally this all is. It could have been a leftover from some testing and probably should become a player-ship key at some point when useful. Don't bet on it to stay in planetInfo.

For 1.76, the energy recharge has bee fine-tuned. Hardly noticeable for normal ships, but essential for something like an added with very week energy banks.

[Wildeblood]

So... I've been editing the wiki page... I did not add shield_charge_energybank_threshold; we'll all just pretend we don't know it exists... I added two new headings, changed four existing headings to sub-headings, and added three more sub-headings... Blah, blah, what? ...It now reads likes this:-

1 Where Settings Apply
1.1 Universal Settings
1.2 Interstellar Space
1.3 Specific Systems
1.4 Specific Interstellar Spaces

7 Hyperspace Travel
7.1 Galactic Hyperspace Behaviour
7.2 Galactic Hyperspace Fixed Coords
7.3 Hyperspace Tunnel Color

[Wildeblood]

Texture HSB Color

This changes the overall hue of the replacement texture.
Example:
"texture_hsb_color" = "0.0..1.0 0.0..1.0 0.0..1.0";

Some of my coloured suns are spoiling the appearance of the nifty Povray Planets textures with a strong colour cast, particularly the red and magenta ones, which are half of all. I assume this setting exists to counter-act this problem? But I have no idea how HSB colours are defined.

1. Can someone inform me of the appropriate values, or how to calculate them, to get the texture half-way back to white, from its too red cast to a slightly red cast?

2. If I set this property and someone uses it without textured planets, will Bad Things happen?