Lightwave scene file for geography explained

I will now explain what I’ve learned so far about the lightwave scene file for geography.

Many, many thanks to Shane for getting me started 🙂

First a little background. The space environment in EoC is organized and controlled by an abstract term called “geography”. Through geography, EoC sets up things like; what you see in the distant background outside your ship, what color light a given star throws off, what planets exist and where they’re positioned, etc. Pretty much everything related to the environment. Geography consists of several files, all of a different type. Most of these files are located in the geog directory of the resource file.

Here we’re going to talk about the Lightwave setup scenes for geography. These setup scene files are each associated with a particular star system and have the same name as that system with a .lws extension. These files can be opened and edited in notepad if you don’t have Lightwave and contain information to control such things as:

• The overall lighting within the system, by controlling the color and intensity of the light coming from the system’s star (but not the color or appearance of the star itself), as well as the color and intensity of the ambient light in the system
• The number and color of the tiny pinpoint stars visible in the background
• The appearance of the background nebula seen far off in the distance
• The color, brightness, position and number of the distant large stars seen in the background (other stars you can usually travel to)
• Misc lightwave information not related to EoC

These files work together with a system’s .map file to provide the look of the system. The .map files generally contain information on the position and composition of all the celestial bodies within a section of space (such as a star system with planets, moons and asteroids), and can themselves be custom created using GrandpaTrout’s excellent geogSDK. You can even associate a custom .lws scene file with a custom .map file by simply giving them the same name.

The .lws scene files provide the above information in coordination with what the various other geography files contribute. For instance; if the .map file says that this system contains a blueish star, then the .lws scene file provides a blueish light to illuminate the scene. If the clusters.ini file says that this system is located between star system A and star system C on the star map, then the .lws file will display a small lens flare of the right color to represent star system A on one side of the system and another lens flare to represent star system B on the other side of the system.

But before we do anything I want to clear up some potential confusion. There’s been a lot of talk lately about the game’s space environment and one term that’s been used a little too interchangeably is the word nebula. When I use the word nebula I mean the fog that blocks your view of distant objects like other ships or stations (such as around Lucretia’s Base). But when I use the term “background nebula” I mean the distant nebula that make up part of the background space scene. These are two distinctly different entities and I don’t want to confuse anyone because I wasn’t clear about it. The .lws files control background nebula. The .map files and/or Pog control regular fog nebula.

For the purposes of this tutorial, I’m going to assume that you don’t have Lightwave and will be editing these files manually in notepad. So. . .

I would also like to give you a little information about Lightwave to make things easier to understand. First; nulls. Nulls are a device used by lightwave to represent the position, rotation and scale of a point in space. Nulls are invisible except within Lightwave itself, and within Lightwave they function as normal objects with regards to animation, orientation and parenting. Which brings me to the next thing; parenting. In Lightwave, parenting is used to link objects together for the purpose of organization and grouping. The term comes from the parent-child relationship between the linked objects. When one object is parented to another object, it (strangely enough) becomes that objects child. The idea behind this is that when the parent is positioned, rotated and scaled, all of its children are positioned, rotated and scaled with it. Nulls and parenting work very well with each other to create groups for organization.

Ready to start?

We’ll use the hoffers_wake.lws as our example. Ok, let’s go through it one section at a time and see what we’ve got:

LWSC
1

FirstFrame 1
LastFrame 60
FrameStep 1
PreviewFirstFrame 1
PreviewLastFrame 60
PreviewFrameStep 1
FramesPerSecond 30.000000This is lightwave proprietary info, it defines what the file is and sets up the animation parameters. As a modder, leave it alone, it has nothing to do with EoC and there’s no need to screw with it.

AddNullObject
ShowObject 8 7
ObjectMotion (unnamed)
9
1
0 0 0 0 0 0 1 1 1
0 0 0 0 0
EndBehavior 1
ShadowOptions 7Ok, here’s our first bit of meaningful info. The first line is the only one you need to pay attention to in this section for modding. It tells lightwave to add a null object to the scene. This null object will represent the center location of our group of pinpoint type background stars. The way that lightwave communicates gamecode information to flux is through the use of special object names. So the info after AddNullObject is actually the null’s name, but it also tells flux how to use the object in the game. The numbers for bright and dim star count affect how many of those tiny pinpoint stars show up in the map. So, in our example there will be 2000 bright stars and 100000 dim stars. This means the entire map, not just what’s in your view. The tint numbers affect the color of those pinpoint stars. They represent the RGB colors, but in an unusual way. Instead of each color having 255 values, each color is represented by a number in a range from 0.0 to 1.0. This means if you want pure red stars you tint them 1.0, 0.0, 0.0, since red is represented by the first number. Green is the middle number and blue the last. I made one system that had green background nebula and red stars, I called it the Christmas system, lol. The other parameters don’t have a use for modding in this section, so leave them be.

AddNullObject
ShowObject 8 7
ObjectMotion (unnamed)
9
1
0 0 0 0 0 0 1 1 1
0 0 0 0 0
EndBehavior 1
ShadowOptions 7Here we’re defining the sky dome, or sphere, since it’s space. The first line in this section adds a null to represent the location of our object. And it’s name tells flux what to use this null for (sky sphere model), and points to an avatar model file in the models directory. So the name of this null actually contains both instructions for flux and a url this time. What this model should be is an inverted sphere mapped with the numbered image files of background nebula in space (I say “should be” because this type of setup is very commonly used in game design for space sims, and the setup looks right). The url specifies a .pso avatar model in this directory, by changing the avatar name from one model to another you change the space nebula background in the game(like from hoffers_wake_nebula to Osprey). If you’re particularly ambitious you might even try making your own background nebula pics, slicing them into 6 sections, saving them as .iff and replacing the images for the models in resources/models/ (this is where the background nebula avatars are stored). Or, if you’re really ambitious, you could even make an entirely new and different type of background environment (like underwater). Again, the other parameters of this section are LW only, and of no use to modders.

AddNullObject SystemParent
ShowObject 8 7
ObjectMotion (unnamed)
9
1
-1695 0 -145 0 0 180 1 1 1
0 0 0 0 0
EndBehavior 1
ShadowOptions 7This section only has meaning to those who are making their own maps. The first line adds a null object and specifies that this null will ( I believe) represent the physical location in space (within the 3D scene) of our system center (defined in our .map file). It has been speculated by mdvalley that this null actually represents the position of the player camera within the scene. This is quite posiible. In either case, your geog .lws scene file must have this entry. It is the base null that all other nulls are parented to. The other parameters of minor interest to us in this section are on line 6, these are the position, rotation and scale of the object (or null in this case). Here’s how they work (Note:These measurements are in meters and degrees):

-1695 = X position in 3D space
0 = Y position
-145 = Z position
0 = X rotation
0 = Y rotation
180 = Z rotation
1 = X scale
1 = Y scale
1 = Z scale
These parameters work the same way in all the other sections, so I won’t mention them again. It is important to note that nulls are only representations of points in space. As such, they are invisible, and scaling will have no visible effect on them. However, anything parented to them will be affected by their position, rotation and scale values.

AddNullObject root
ShowObject 8 7
ObjectMotion (unnamed)
9
1
0 0 0 0 0 0 1 1 1
0 0 0 0 0
EndBehavior 1
ParentObject 3
ShadowOptions 7This null is the root object that all the distant stars represented by lightwave lights are parented to, presumably so that only the root needs to be rotated for adjustment (all the stars will rotate properly with it). Lightwave scenes frequently use a root object for organization.

AmbientColor 255 255 255
AmbIntensity 0.250000This section defines the ambient light color and intensity for lightwave only! It is not used by EoC. The ambient light color and level in the game is controlled by another light I will discuss shortly. So don’t waste your time trying to change it.

AddLight
LightName
ShowLight 1 7
LightMotion (unnamed)
9
1
0 0 0 180 0 0 1 1 1
0 0 0 0 0
EndBehavior 1
LightColor 255 204 128
LgtIntensity 1.500000
LightType 0
ShadowType 1This time line 1 tells lightwave to add a light to the scene and name it . There are only 3 ways to get Lightwave lights to give off light in EoC, name the lights either , or . This light represents the color of the light coming from the system star. It does not represent the color of the system star. The color of the star itself is set in the .map file, which I will explain at the end. So it’s possible to have the star appear one color but light the scene with a different color. Obviously the important lines here are 10 and 11, light color and intensity. Light color is in standard RGB format and intensity is in lightwave units of brightness, with 1.0 being 100% intensity. Lightwave light intensities can be set from negative values (creating darkness) to the thousands, yes thousands! Only of minor interest is line 12, light type, in this case 0 which indicates a distant type light. A distant type light casts all of it’s light rays in a parallel direction, simulating a giant light source; such as the sun. I don’t know yet if changing the shadow type will affect the game shadows, but it’s pretty unlikely. It is important to note that the flare that can be seen around the star in-game is not a lens flare from this light. It is a seperate sprite that uses it’s own grayscale texture. It is not currently known how this sprite gets it’s information for coloring the texture.

Just for fun, the Light Type numbers are as follows:
0 – Distant Light (starlight)
1 – Point Light
2 – Spot Light
3 – Linear Light
4 – Area Light

AddLight
LightName
ShowLight 1 7
LightMotion (unnamed)
9
1
0 0 0 0 0 0 1 1 1
0 0 0 0 0
EndBehavior 1
LightColor 92 172 34
LgtIntensity 0.750000
LightType 0
ShadowType 1Another light object. This light is the light that controls ambient lighting in the game. This light is very important for dramatic effect, it affects how the shadow side of objects in the game look. In this case light color isn’t as important as light intensity. But crank it up to 1.0 anf there would be no shadow side. Everything would be evenly lit from all directions (extremely unrealistic and probably unpleasant). Personally, I think the ambient light in the game is already way to high, so I set the intensity to about 0.050000 and changed the color to white (RGB 255 255 255) for a more realistic space environment. But since in reality there wouldn’t be any ambient light in space choose whatever color suits your fancy, or turn it down to zero. This light type is also 0 (distant).

It is important to remember that only lights named , or glow will actually give off light in the scene. If a light uses any other name, it can only be used to display a lens flare effect. It will not give off any light! No matter what the intensity setting is. It will only display a lens flare effect, as demonstrated by the next light in the list.

AddLight
LightName HoffersWake
ShowLight 1 7
LightMotion (unnamed)
9
1
-1693.9 0 146.9 180 0 0 1 1 1
0 0 0 0 0
EndBehavior 1
ParentObject 4
LightColor 0 196 0
LgtIntensity 1.000000
LightType 1
LensFlare 1
FlareIntensity 0.008000
FlareDissolve 0.000000
LensFlareFade 4
LensFlareOptions 7
FlareRingColor 80 20 10
FlareRingSize 0.220000
FlareStarFilter 2
ShadowType 1Ahhh, now this is interesting. The next nine sections all do exactly the same thing. They add colored lens flares to the scene which represent other distant stars that you can see from your current star system. But that isn’t why I say it’s interesting. It’s interesting because as you may have noticed, this section just added a distant star to be visible from hoffer’s wake, that’s called HoffersWake! Remember, we’re inside the Hoffer’s Wake system now, and this light does not represent our central system star. It represents a visible distant star that we can see from hoffer’s wake. None of the other system scene files do this repetition of names so I suspect that the only reason a distant Hoffer’s Wake star is included inside the Hoffer’s Wake system is because of an oversight by the creator of the file, but I could be wrong. A minor mistake at worst, since some people don’t even notice these stars in the game.

Anyway, some new parameters included in this section are for the addition of lens flares. Lens flares are what make a light object visible. Normally in 3D scenery a light object just emits light without a visible source (unlike reality). In order to make a light visible in a 3D world an effect called a lens flare must be added. These lens flares provide the viewer with all the effects normally associated with looking at a light (rays, corona, etc). These parameters start on line 14, and mean the following:

LensFlare 1 = This light uses a lens flare. 0 for none.

FlareIntensity 0.008000 = How bright or large the flare appears.

FlareDissolve 0.000000 = Unknown. This is a normal LW lensflare setting, but I’ve never seen it used for EoC and I don’t know what it does. If anyone does know, please let me know.

LensFlareFade 4 = How the flare should fade. The numbers are:
4 – Fade Off Screen
8 – Fade Behind Objects
16 – Fade In Fog
2 – Fade With Distance
You can use any combination of these to achieve the desired effect. So say you wanted Fade Off Screen and Fade In Fog, you simply add the two numbers together to get 20, and that’s what you put as a value.
Number 2, Fade With Distance, has an additional parameter that needs to be added:
FlareNominalDistance 1 = The value is the distance in meters at which the flare totally disappears. Add this entry under the flare intensity entry if flare type 2 is used.

LensFlareOptions 7 = Works similar to above, but the LW code numbering system is too convoluted to be explained here. Just use the defaults for now.

FlareRingColor 80 20 10 = This is the color of the Central Ring when that flare option is used. It is in standard RGB format.

FlareRingSize 0.220000 = This is the size of the flare ring expressed as a percentage (22%). I don’t know what this is a percentage of, however.

FlareStarFilter 2 = This is the visible distortion of the flare, how many points it has, etc. Options are:
0 – Off
1 – 2 Point
2 – 2+2 Point
3 – 4 Point
4 – 4+4 Point
5 – 6 Point
6 – 6+6 Point
7 – 8 Point
8 – 8+8 Point
9 – 10 Point
10 – 10+10 Point
You may only select one filter type, no combinations are allowed.

Choose numbers similar to the one’s you see until you get some practice. Also if you look, these lights appear to be adding light to the scene (which they really shouldn’t be doing), keep this in mind when trying to adjust your system lighting. It is important to note that these visible stars are not necessary to include in the scene file. If you don’t want extra stars or don’t care, don’t waste your time creating them, you don’t need to. Conversely, if you do want them, add as many as you like. Chances are you’ll get tired of adding them long before you exceed lightwave’s lens flare abilities. Just follow the format above (and of course give them unique names). I would like to point out a limitation in Lightwave scene lighting though. Lightwave scenes cannot have more than 8 lights total giving off light in each scene file. So, you can add all the lens flares you want, but you’re limited in lighting.

ShowCamera 1 7
CameraMotion (unnamed)
9
1
0 0 0 -1.5 -11.5 0 1 1 1
0 0 0 0 0
EndBehavior 1
ZoomFactor 3.200000
Resolution 1
PixelAspectRatio 2
SegmentMemory 9000000
Antialiasing 0
AdaptiveSampling 1
AdaptiveThreshold 16
FilmSize 2
FieldRendering 0
MotionBlur 0
DepthOfField 0

ViewMode 1
ViewAimpoint 0.000000 0.000000 0.000000
ViewDirection -0.010472 -0.092502 0.000000
ViewZoomFactor 2.692559
GridNumber 40
GridSize 1000.000000
ShowMotionPath 1
ShowBGImage 0
ShowFogRadius 0
ShowRedraw 0
ShowSafeAreas 0
ShowFieldChart 0More proprietary lightwave info. These sections are for lightwave use, not EoC use, and so are pointless to change. Even the camera.

Well that’s it. I hope everyone has a little better understanding of the lightwave scene files as they relate to EoC geography and will have lots of fun making custom systems.

Oh, I almost forgot. Let me tell you what the numbers mean for star color in the .map file. The star color is an integer number in the range from 1 to 11. The way the numbers work is like this, they represent the RGB color scale but backwards (BGR) and without normal divisions. For instance; a star color of 1 represents a pure blue star, while a color of 5 to 6 represents a pure green star, and finally, a color of 11 represents a pure red star. A star color of say 9 will evenly mix green and red to give you a yellow star, and so on. So now you geog.exe users out there know how to get the star color you want.

I hope this post has been helpful and if anyone sees any errors in anything I’ve written please say so right away.

mailto:second_chance@cox.net

http://cartoons.sev.com.au/index.php?catid=4