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

Field Index

Attach To Camera: Bool

Render Source Intensity: Float

Bottom: Color

Rotation: Rotation

Enabled: Bool

Top: Color

If checked, image-based lighting is enabled.: Bool

If checked, the color is convert from sRGB.: Bool

Intensity: Float

Middle: Color

Render Source: Bool

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).