RealityServer Features

Falsecolor Rendering

In addition to normal rendering the default handler also supports falsecolor rendering. In this case RealityServer performs an untonemapped render and then colors the result with a heatmap to show luminance (or illuminance) results. This form of rendering emphasises lighting features and is frequently used in lighting analysis.

A normal render. A normal render.
The same render as a falsecolor. A falsecolor render.

Falsecolor

Falsecolor rendering is enabled by changing the tonemapper used by the camera to falsecolor. This will switch the render to produce untonemapped, HDR renders and then recolour them to produce a gradient image. The gradient mapping is further controlled by 2 more camera parameters, mif_min and mif_max. These Float32 values give the values that should map to blue and red respectively.

Falsecolor Camera Attributes
Attribute Name Attribute Value Attribute Type Description
tm_tonemapper falsecolor String Set to falsecolor to enable falsecolor renders.
mif_min 0 (the default) Float32 Set to the luminace value to map to blue
mif_max 1 (the default) Float32 Set to the luminace value to map to red

Example: Enable falsecolor and set the range to 5 -> 105 

{
    "method": "element_set_attributes",
    "params": {
        "element_name": "my_camera",
        "attributes": {
            "tm_tonemapper": {
                "value": "falsecolor",
                "type": "String"
            },
            "mif_min": {
                "value": 5,
                "type": "Float32"
            },
            "mif_max": {
                "value": 105,
                "type": "Float32"
            }
        }
        "create": true
    }
}
False color render in range 0 -> 52. False color 0 to 52.
False color render in range 10 -> 40 False color 10 to 40.
Note: See Auto Exposure for details on how to obtain the luminance range of the render to set sensible mif_min and mif_max values.

Irradiance rendering

By default falsecolor mode produces a radiance render, that is it shows the illumination that is being refelected from surfaces. It is also possible to set it to irradiance mode where instead it shows the illumination that is incident to surfaces. In lighting analysis the incoming lighting is often more useful than the outgoing and this mode allows this to be measured.

Irradiance mode is enabled by setting the irradiance handler parameter to on. Any other value uses radiance mode.

Irradiance Handler Properties
Property Key Property Value Description
irradiance on or off Set to on to enable irradiance falsecolor mode. Any other value produces a radiance render.

Example: Enable falsecolor irradiance rendering and set the range to 0 -> 150 

{
    "method": "element_set_attributes",
    "params": {
        "element_name": "my_camera",
        "attributes": {
            "tm_tonemapper": {
                "value": "falsecolor",
                "type": "String"
            },
            "mif_min": {
                "value": 0,
                "type": "Float32"
            },
            "mif_max": {
                "value": 150,
                "type": "Float32"
            }
        }
        "create": true
    },
    {
        "method": "render_loop_set_parameter",
        "params": {
            "render_loop_name": "my_render_loop",
            "key": "irradiance",
            "value": "on",
        }
    }    
}
Irradiance false color render in range 0 -> 150. Note how the area light no longer shows as red since we're seeing the incoming light, not outgoing. Irradiance false color 0 to 150.

Radiance false color render in range 0 -> 52.

 False color 0 to 52.