FniSettings

From Alcugs

Jump to: navigation, search

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.

Previous: Panic Linking Contents Next: Soft Volumes

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

Text Editor Browse Menu
Text Editor Browse Menu
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.

Previous: Panic Linking Contents Next: Soft Volumes
Personal tools