Page 1 of 1

Planetinfo.plist on the wiki

Posted: Mon Nov 12, 2012 2:10 pm
by 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.

Re: Planetinfo.plist on the wiki

Posted: Mon Nov 12, 2012 2:38 pm
by Diziet Sma
Hmmm.. it is a bit all over the place, eh? :roll:
Wildeblood wrote:
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. 8)

Re: Planetinfo.plist on the wiki

Posted: Mon Nov 12, 2012 2:41 pm
by Smivs
Wildeblood wrote:
...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 :)

Re: Planetinfo.plist on the wiki

Posted: Mon Nov 12, 2012 2:50 pm
by Eric Walch
Wildeblood wrote:
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.

Re: Planetinfo.plist on the wiki

Posted: Sun Dec 09, 2012 1:13 pm
by 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

Re: Planetinfo.plist on the wiki

Posted: Sun Dec 09, 2012 3:39 pm
by 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. :lol:

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.

Re: Planetinfo.plist on the wiki

Posted: Mon Dec 10, 2012 8:20 am
by 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

Re: Planetinfo.plist on the wiki

Posted: Tue Dec 11, 2012 7:54 pm
by 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?