Content Comparison

Patches

3.10.P1

• Added an option in GeoRadiosity to switch between per pixel or per mesh probe lighting.
• Added documentation for the Sample implementation and the early access Precompute pipeline API.
• Added the IPrecompute::ExtractOctreeProbeSet function to simplify the usage of the low level precompute API for automatic probe placement.
• Deprecated IPrecompInputProbeSet::SetOctreeProbePositions: please use IPrecompute::ExtractOctreeProbeSet instead.
• The Show Scene Report button in the GeoRadiosity Performance tab now correctly opens the scene report when the default browser is Chrome.
• Fixed a precompute error "<name> has zero total surface area across all target geometry" when both terrain and regular instances are automatically grouped into radiosity systems.
• CodeBuildTool now supports building with Visual Studio 2019 with toolset version 14.21 or later. The 2019 configuration builds with toolset 14.21. To build with a different toolset, specify the toolset version: e.g. configuration 1421 builds with the 14.21 toolset. By default, Enlighten builds against Windows SDK 10.0.16229. You can override this in the configuration name: e.g. 1421-16229.
• Enlighten core libraries are now available for Windows and Xbox One compiled with Visual Studio 2017 15.9.2 (VC tools version 14.16)
• Enlighten libraries are now built with PS4 SDK 7.008 and Switch NDK 9.3.1

New features

New documentation and samples to accelerate your implementation of Enlighten.

...

Simplify implementation of the precompute pipeline in your tools: Enlighten Pipeline library (early access).

Faster precompute for massive worlds. 

• New probe region object enables simple and efficient implementation of automatic probe placement in a massive world.
• Group instances, probe regions and cubemaps into zones and limit their radiosity dependencies, to limit the memory usage and time taken by the precompute in a massive world.
• Group instances by zone to automatically generate radiosity systems during the precompute. 

...

• Added prebuilt binaries compiled with Visual Studio 2017 15.7.1 and MSVC tools version 14.14.26428 for Win32, Win64 and XboxOne
• CodeBuildTool now supports building with Visual Studio 2017 with MSVC tools version 14.14 or later.
• Enlighten can now be used in projects compiled with MSVC with the  -std:c++17 option.
• Enlighten static libraries built with Visual Studio now contain debug information embedded in the .lib files. Separate .pdb files for these libraries are no longer required. This does not affect your ability to debug Enlighten code.

...

• The smooth bevels functionality is deprecated. Please refer to the upgrade notes below. To light large complex meshes, we recommend to use per pixel probe lighting.
• The auto probe volume functionality is deprecated. We recommend to use automatic probe placement.
• ProbeSetManagerVoxel is deprecated. We recommend to use per pixel probe lighting.
• The UV parameteriser functionality is deprecated. We recommend to use automatic UV simplification.
• Enlighten3Meta / Enlighten3MetaBuilder library are deprecated. To extract and store lightmap UV data, we recommend to follow the implementation guide.
• Enlighten3PrecomputeLoader / Enlighten3PrecomputeLoaderBuilder are deprecated. To extract and store persistent radiosity data, we recommend to follow the implementation guide.

...

• The high level runtime now uses the entire probe set solver. The entire probe set solver has smaller radiosity data and is significantly faster than the legacy probe solver. To prevent deprecation warnings, leave UpdateManagerProperties::m_UseEntireProbeSetSolver unset.
• By default, the update manager now performs continuous updates for systems, probe sets and cubemaps. Calls to EnqueueSetAllUpdateCounters with INFINITE_UPDATES are now redundant and can be safely removed to reduce runtime overhead. To revert to the previous behaviour, set UpdateManagerProperties::m_UpdateCounterDefault = 0.
• The ILogHandler argument to MultithreadCpuUpdateManager::Create is no longer required. To capture output of warnings and errors from the high level runtime, call GeoAttachLogger before you create the update manager.
• The texture allocator is no longer required. To provide output textures to the high level runtime:
  1. Leave UpdateManagerProperties::m_TextureAllocator unset.
  2. Call GetOutputTextureSize to find the width and height of the output textures for a system.
  3. Call IUpdateManager::AllocateSystem with the result of your previous IGpuTextureAllocator::Create implementation.

  4. Start with the example below, and change the irradiance output format to match IUpdateManagerProperties::m_IrradianceOutputFormat. 

     Code Block
     language cpp
     Enlighten::IGpuTexture* outputTextures[Enlighten::ENLIGHTEN_NUM_OUTPUT_TEXTURE_TYPES] = {     myAllocator.Create(width, height, TextureFormat_A16B16G16R16F), // irradiance: substitute appropriate texture format, see Enlighten::eOutputFormat     myAllocator.Create(width, height, TextureFormat_A8R8G8B8), // directional };

     
     

     Tip
     The SampleRuntime project shows how to provide output textures for systems and cubemaps.

     
     

• The high level runtime now always takes ownership of the output textures you provide. Do not delete the output textures until the high level runtime call your implementation of IGpuTexture::Release.
• To update your existing per pixel probe lighting implementation to used the high level runtime, follow the implementation guide. If you prefer not to use the high level runtime, replace your existing PppiManager instance with PppiWorld.
• BaseProbeSet::m_SelectedLod is now private. Please use BaseProbeSet::SetLod instead.

High level build system:

• When the scene file is badly formed, the build system now reports an error and stops. To continue the precompute anyway, specify /p:Permissive on the command line.
• To simplify the way your implementation groups instances into radiosity systems, allow the precompute to group instances automatically: 
  1. Remove the systemId and systemGuid attributes from each radiosity instance.
  2. Set the zone attribute to group instances into as few groups as possible. If your world is split into chunks for streaming, use the zone attribute to group instances into a single zone for each chunk.
  3. After the precompute, for each zone, load the IPrecompGeneratedSystems object to identify the Enlighten runtime data for each automatically grouped system.
  4. If you need to limit radiosity dependencies to speed up the precompute, add zone dependencies for each zone.
• If you need to limit radiosity dependencies for cubemaps to speed up the precompute:
  1. If your world is split into chunks for streaming, set the zone attribute to group cubemaps into a single zone for each chunk.
  2. Add zone dependencies for each zone.
• If your implementation uses probe octree objects, to quickly and safely update to the new probe region object:
  1. Replace IPrecompInputProbeOctree objects with IPrecompInputProbeRegion objects.
  2. Replace calls to IPrecompInputProbeOctree::Create with IPrecompInputProbeRegion::Create with the same voxelSize value.
  3. Call IPrecompInputProbeRegion::AddVolume, IPrecompInputProbeRegion::AddPoints or IPrecompInputProbeRegion::AddBoxes to specify the same input as previously provided to IPrecompInputProbeOctree::Create. 
  4. Replace each probeOctree element in your Enlighten scene with a probeRegion element that has the same name.
  5. Set the zone attribute of the probeRegion element to the same value as the name attribute.
  6. If you need to limit radiosity dependencies to speed up the precompute, add zone dependencies for each zone.

...