This is the documentation for Enlighten.

Launching GeoRadiosity


To launch GeoRadiosity, run GeoRadiosity.exe. When GeoRadiosity opens, you can load your scene by clicking the Load Scene... button in the Scene tab. Alternatively, you can use the command line argument (below) to load the scene automatically.

GeoRadiosity command line arguments

Argument

Syntax

Description

-scene

GeoRadiosity.exe -scene:<filename>.scene

Loads the specified scene when GeoRadiosity is launched.

-script

GeoRadiosity.exe -script:<filename>.lua

Loads the specified Lua script when GeoRadiosity is launched.

GeoRadiosity-specific data

When you have loaded your scene in GeoRadiosity, you need to run a precompute from the Precompute tab, even if you have already precomputed the scene in your own pipeline, to generate GeoRadiosity-specific debug files. The GeoRadiosity precompute performs only the steps required to create these files; therefore this precompute should be almost immediate.

If you wish to generate these files yourself so that your scene can be immediately viewed in GeoRadiosity without doing a second precompute, add the following parameter when calling the High Level Build System:

/p:IncludeSampleFrameworkSteps=true

The High Level Build System will create the necessary GeoRadiosity-specific files.

GeoRadiosity adds this parameter to the command-line of GeoPrecompute.

Triggering command line tools

GeoRadiosity uses the command line tools GeoConvert.exe and GeoPrecomp2.exe to do asset conversion and the Enlighten precompute. Both the asset conversion step and the precompute support incremental builds for localised changes, and display a graphical progress monitor while working.

Whenever a scene is loaded in GeoRadiosity, it calls out to an asset conversion script. This determines whether any of the textures have changed since the last time a precompute was run. If so, it uses GeoConvert to process them again. When the Precompute button is pressed, GeoRadiosity spawns GeoPrecomp to precompute the scene.

For power users, GeoRadiosity is automatable through a simple Lua interface. For details, see the Lua bindings reference. The Lua dropdown console can be accessed by pressing the Tab key in GeoRadiosity, and is dismissed by pressing Esc (the cursor must be in the command line).