SoPathTracerBackgroundLight

InventorModule
author MeVis Medical Solutions AG
package MeVisLab/Standard
dll SoPathTracer
definition SoPathTracer.def

Purpose

The SoPathTracerBackgroundLight module provides background lighting for the SoPathTracer. It supports setting a top, middle, and bottom color or, alternatively, it supports image-based lighting (IBL) using a sphere or cube map. Only one background light can be active for a given SoPathTracer.

A sphere map must be a quadratic 2D RGB color image. A cube map must be a quadratic 2D RGB color image with six z-slices. The z-slice order for the cube map is: positive x, negative x, positive y, negative y, positive z, negative z.

The input image can also be an equirectangular projection image (also known as HDRI), in which case the image must have width = height * 2.

There is an example network with a cube map.

../../../Projects/MeVisPathTracer/SoPathTracer/Modules/mhelp/Images/body3.jpg

In this rendering, a strong environment light is used, evident from the pronounced reflections on the creasing angles.

Windows

Default Panel

../../../Projects/MeVisPathTracer/SoPathTracer/Modules/mhelp/Images/Screenshots/SoPathTracerBackgroundLight._default.png

Input Fields

inHDRLight

name: inHDRLight, type: Image

The sphere or cubemap.

Parameter Fields

Visible Fields

If checked, image-based lighting is enabled.

name: useIBL, type: Bool, default: FALSE

Enable IBL.

Attach To Camera

name: attachToCamera, type: Bool, default: FALSE

If checked, the light is attached to the camera space rather than world space.

Render Source

name: renderSource, type: Bool, default: TRUE

If checked, the background light is rendered for rays that only hit the background.

Render Source Intensity

name: renderSourceIntensity, type: Float, default: 1

Sets the intensity of the background light rendering in the background image.

If checked, the color is convert from sRGB.

name: sRGB, type: Bool, default: TRUE

Enabled

name: enabled, type: Bool, default: TRUE

If checked, the light is enabled.

Intensity

name: intensity, type: Float, default: 2, minimum: 0, maximum: 5e+06

Sets the intensity of the background light.

Top

name: topColor, type: Color, default: 0.333333343267441 0.666666686534882 0.498039215803146

Sets the top color.

Middle

name: middleColor, type: Color, default: 1 0.666666686534882 0.498039215803146

Sets the middle color.

Bottom

name: bottomColor, type: Color, default: 1 0.666666686534882 0

Sets the bottom color.

Rotation

name: rotation, type: Rotation, default: 0 0 1 0

Sets an extra rotation that allows rotating the background light (colors, sphere, cubemap).