Three-js-unbiased-ssaa NPM

Three.js Unbiased SSAA

Simple SSAA pass for three js which fixes the bias issue found in three.js

This development was sponsored by Dualbox (https://www.dualbox.com/).

The issue

Here is a shadow texture processed on the left by this unbiased ssaa, and on the right by the SSAA pass in THREE.JS examples.

unbiasedShadow

THREE.JS Version

Two versions of three.js are tested and marked as compatible for this module: r101 and r122. The respective appropriate version of this module are the x.101.x and x.122.x versions. The module was not tested with other versions of three.js

Requirements

To run this library, you need to load the following three examples:

Pass

Concept

The algorithm is based on the algorithm of THREE.SSAARenderPass. The difference between the two algorithms is how the averaging computation is made: while the THREE.SSAARenderPass does the average of two rendereds at a time, number of samples times, the THREE.SSAAUnbiasedPass does the average of the number of samples in one time, if it is lower or equal to 8, in two times if it is not.

It also provides the possibility to adapt the level of render according to the motion of the scene, as the THREE.TAARenderPass does. The attribute changed allows to control it manually, while the pass can automatically detect the movement of the scene when the attribute autoCheckChange is set to true.