Parametric Cornell Box

Gabriel Cuvillier - Blueprints - Sep 3, 2023
4.5 out of 5 stars(6 ratings)
  • 67%
  • 17%
  • 17%
  • 0%
  • 0%

A parametric Cornell Box Actor blueprint, with fully configurable box geometry, lighting system, walls material, and box content.

  • Supported Platforms
  • Supported Engine Versions
    5.2 - 5.4
  • Download Type
    Asset Pack
    This product contains an assortment of Unreal Engine assets which can be imported into a pre-existing project of your choice.

This product provides a blueprint allowing to create of fully parametric Cornell Boxes.

A Cornell Box is a common test case used by graphics professionals and researchers to measure the quality of a global illumination and light transport method, such as - in the case of Unreal Engine 5 - Lumen, Path Tracing, and Static Lighting.

The purpose of this product is to be used as a tool in the Editor to analyze and understand Lumen behavior (direct lighting, specular lighting, global illumination, reflections/mirrors) in a tightly controlled environment: a Cornell Box. The main effect to observe is the color of the walls "bleeding" on nearby objects (diffuse interreflections). Accuracy of soft-shadowing as well as quality of specular reflections can be analyzed too.

The functionality is exposed in the Editor as a blueprint actor: to instantiate a new Cornell Box, simply drag and drop the BP_CornellBox blueprint (in the Blueprints subfolder) in the scene. The newly instanced Box is then configurable through dedicated attributes in the Details panel of the actor: dimensions, lighting setup, walls material and colors, and box contents.

Boxes are fully reconstructed each time one of their attributes is updated, allowing for interactive modification from within the Editor. This is done automatically by the blueprint construction script. The default Box attributes are set to one of a standard Cornell Box, scaled out 5 times, for practical purposes.

Please have a look at the documentation for a comprehensive list of features and available attributes (you may have a quick overview of them in the fourth screenshot).

An example map is provided in the Maps subfolder: Showcase.umap. This map showcases various features of the plugin through different Cornell Boxes instanced in the scene.

This blueprint is intended to be mostly used with real-time Lumen and Raytracing enabled (including raytraced shadows), as well as with Path Tracing. It is nevertheless possible to use it in Static Lighting scenarios, by changing the mobility attribute in the "Advanced" section of "Lighting" attributes (see the documentation).




Technical Details


  • A parametric Cornell Box blueprint actor

Available attributes :

  • Geometry: box dimensions (depth/width/height), wall thickness, wall visibilities ;
  • Lighting: several light types (None, Rect Light, Emissive Surface, Reflected Light), light attachment wall, light color, intensity, dimensions, position, and a couple of advanced attributes ;
  • Materials: metalness, specularity, roughness, neutral/left/right/external colors ;
  • Contents: several content types (Empty, Classic Cubes, Sample Sphere, User Mesh), transformation

Number of Blueprints: 2

  • 1 blueprint for the Actor + 1 support blueprint function library, and a few additional enumerations/structs used internally ;
  • The blueprint does not use Geometry Scripting (because dynamic meshes are not 100% functional with Lumen), relying instead on instancing and scaling of elementary static meshes (each individual wall, the emissive light source, the sample content, etc.)

Network Replicated: No

Supported Development Platforms: Windows, Mac