This is a simple OpenColorIO configuration for intermediate to advanced imagers using Blender's Cycles raytracing engine, or the Renderman system as included by default.
This OpenColorIO configuration adds a closer-to-photorealistic view transform for your renders. For imagers working with non-photorealistic rendering, it also will bring significant dynamic range and lighting capabilities to your work, as well as potentially open up correct transforms for rendering to HDR displays and other such forward looking technology. It is as close to a Magic Button™ you can get for an experienced imager. The kit embodies a high dynamic range transfer function and an intensity gamut mapping.
Filmic does two things:
This repository is ready to use right now, with no compilation or special Blender application binaries required.
Because the basic sRGB nonlinear transfer functions (OETF / EOTF) were designed to describe an aspect of device response and never for rendering. This configuration is a step towards providing imagers with a reliable camera rendering transform and a base of aesthetic looks useful for modern raytracing engine CGI, animation, and visual effects work with real-world cameras.
Download the latest version of Filmic Blender. Replace your current OpenColorIO configuration in Blender with this version.
The Blender OpenColorIO configuration directory is located in:
Move the existing
colormanagement directory to a backup location, and place the contents of
this repository into a new
Optionally, instead of replacing the actual directory, use the environment variable to specify where the OCIO configuration lives:
From within the Color Management panel, change the View to your desired contrast level and render.
Once you have Blender utilising the configuration, you are free to render away. You may discover that some of your materials were broken due to exceptionally low lighting levels, and may require reworking. General PBR advice holds true when using wider and more photographic illumination levels.
The current configuration supports:
Due to an unfortunate side effect of the way Blender has thus far integrated colour management, folks pushing pixels on Apple Display P3 devices will need to be careful when encoding images. Loosely:
The basic kit of weaponry includes:
A set of View transforms that include:
A set of Look transforms that include:
Greyscale. This Look is based off of the Filmic Log Encoding Base and will deliver a weighted greyscale version of the image. The weights used are for REC.709 RGB lights, which are the same lights specified in sRGB.
Five contrast base looks for use with the Filmic Log Encoding Base. All map middle grey 0.18 to 0.5 display referred. Each has a smooth roll off on the shoulder and toe. They include:
False Colour. This Look is an extremely useful tool for evaluating your image in terms of the dynamic range and latitude. It is a colour coded "heat map" of your image values, according to the following codes:
|Value||Colour||Scene Referred Value|
|Low Clip||Black||Scene Referred Linear value below 0.0001762728758.|
|-7.5 EV||Purple||Scene Referred Linear value 0.00099436891.|
|-5.0 EV||Blue||Scene Referred Linear value 0.005625.|
|-2.5 EV||Cyan||Scene Linear value 0.005625.|
|-0.01 EV||Green-Cyan||Scene Referred Linear value ~0.178.|
|0 EV||Grey||Scene Referred Linear value 0.18009142.|
|+0.01 EV||Green-Yellow||Scene Referred Linear value ~0.181.|
|+2.17 EV||Yellow||Scene Referred Linear value 0.80779930598.|
|+4.33 EV||Red||Scene Referred Linear value 3.62857262286.|
|High Clip||White||Scene Referred Linear value above 16.29174024.|
Given that images generated under Cycles are scene referred, many nodes in Blender, being broken, will not work properly. This may have been hidden if one used a range that perfectly mapped to the display referred domain such as the sRGB transfer function, however using a proper camera rendering transform exacerbates this brokenness.
There are a good number of nodes that work absolutely fine. For grading, it is highly encouraged to use the ASC CDL node, as it operates on scene referred imagery perfectly well. It is in the Color -> Color Balance node. Do not use the Lift, Gamma, Gain default as it is strictly a display referred formula and will break on scene referred imagery. Instead, change the drop down to ASC CDL and use the Slope, Offset, and Power controls to perform grading.
Almost all of the Adobe PDF specification blend modes in the Mix node are also display referred and are broken for Cycles rendering. That includes but is not limited to Overlay, Screen, and other such modes.
It is important to tag your imagery generated with Filmic with the canonized sRGB ICC for viewing outside of Blender and across applications and the web. Simply assign the profile to your generated image using the tool of your choice. Do not convert.
Filmic was designed to be easily integrated into existing pipelines, and as such, uses the primaries and achromatic white colour outlined in ITU-R BT.709 specification. As a result, the reference space lights match the sRGB specification and are as follows:
Following with the above, the transformation for primaries to the CIE 1931 2 degree standard observer XYZ model, is:
The canonized ground-truth encoding for Filmic is the Filmic Base Log Encoding. The Base Log Encoding is a pure normalized log 2 encoding in two parts, to accomodate the gamut mapping for wide primary ratio intensity gamut mapping. The first portion that is routed through the 3D LUT for the gamut compression at value range
-12.473931188, 12.526068812. The final Base Log Encoding covers the log 2 range of
The contrasts are designed for an idealized sRGB display, with the aforementionned primaries, and an Electro-Optical Transfer Function consisting of a pure 2.2 power function.
Please post any and all issues to the issue tracker at GitHub.