FniSettings
From Alcugs
Note: Anything extracted from any Plasma Resource Files is property of Cyan Worlds, Inc. You may not use these assets without recieving written permission from Cyan Worlds, Inc.
Please read this Notice from Cyan about Age Creation before continuing.
|
Contents |
.fni files settings
Each Age has a ‘.fni’ file associated, this .fni file controls the fog appearance as well as two other settings. The original files are compressed using the ‘whatdoyousee' (xTEA) format and you need to use a specific program to read them. But in fact you can actually create a simple text file and it will work just as well. The first time you export an Age with Blender if you haven’t created a .fni file yet the PyPRP plugin will create one with default settings. In fact the fni settings can (and should) be edited right in Blender (see last section of this tutorial).
A typical .fni file looks like this:
Graphics.Renderer.Setyon 10000 Graphics.Renderer.Fog.SetDefLinear 1 900 2 Graphics.Renderer.Fog.SetDefColor .4 .4 .5 Graphics.Renderer.SetClearColor .4 .4 .5
Note: the settings can be written in any order in the file, as long as they are all on separate lines
Settings
Graphics.Renderer.SetYon
Graphics.Renderer.Setyon Distance
This is the maximum distance Uru will display (value is in feet). Unless your Age is really huge you can leave this at 10000; there is no reason to change it. Do NOT set this to 0, unless you want everything rendered backwards. (It's fun for a while, but it's hard to figure out where things are).
Graphics.Renderer.Fog.SetDefLinear
Graphics.Renderer.Fog.SetDefLinear Start End Density
This sets the Age fog type to ‘linear’, which is the only type of fog you need although there is another fog type (see bellow).
The three values are: Start, End and Density.
Start and End are simply the distances from the camera where the fog starts and where it ends (where it is at maximum opacity). Distances are in feet. The start value can have a negative value so that the fog starts behind the camera and looks a little more opaque. (This is used in Kadish for instance)
Density is just that; the higher, the more opaque the fog will be. If you put it a 0 the fog will not be visible.
Graphics.Renderer.Fog.SetDefExp2
Graphics.Renderer.Fog.SetDefExp2 End
This is another type of fog that is supposedly different from the regular SetDefLinear one. It only uses an ‘end’ value, but beside this the difference with regular fog is unknown. (It is only used in Er’Cana.)
Graphics.Renderer.Fog.SetDefColor
Graphics.Renderer.Fog.SetDefColor red green blue
This sets the fog color. The three values are the Red Green and Blue colors, set on a scale from 0 to 1.
This is like the RGB colors in an picture editing software, but instead of going from 0 to 255 they go from 0 to 1. Also, you may notice that in the original Uru fni files that the 0 is not written when writing a decimal value ( 0.4 = .4). You can write it or not; it works both ways. These are standard writing styles in 3D applications/programing.
Graphics.Renderer.SetClearColor
Graphics.Renderer.SetClearColor red green blue
This sets the ‘clear color’. This is the color that appears on screen when there is nothing to display (which is very rare, and only happen in case of bugs or problems, like when you fall out of the Age or when you can see ‘holes’ in the Age). This is should use the same values as the SetDefColor settings. Again, values are the RGB colors on a scale from 0 to 1.
Using and Testing the settings
While you can edit a fni file with any text editor, you can do it inside Blender and it is better to do it that way. Because the fni settings are actually saved inside the Blender file, if you don’t change them manually when exporting the Age the PyPRP plugin will overwrite any existing fni file with the default content of the Blender fni file (and if you haven’t change those it will use the default settings).
Tip: If if you want (or need) to edit the file out of Blender, you don’t need to quit Uru to change the fni settings of an Age. Just change them whenever you want and reload the Age.
Editing a fni file in Blender
Open a Scripts window and in the Scripts menu go to Add > PyPRP > Set Default Age Fni Settings. This creates a new fni file inside the Blender file. To access it open a Text Editor window. Click the ‘Browse’ button (the little one with two arrows) you should see a ‘init’ entry at the top. This is the fni file.
The content of the file will now be visible. All the lines that start with a # are just comments (ie: they are not actually used) and you can keep them or delete them as you want.
The fni settings are now stored inside the Age Blender file, and they will be used each time you export the Age.
|


