ManualMSAARenderPass.js 4.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153
  1. /**
  2. *
  3. * Manual Multi-Sample Anti-Aliasing Render Pass
  4. *
  5. * @author bhouston / http://clara.io/
  6. *
  7. * This manual approach to MSAA re-renders the scene ones for each sample with camera jitter and accumulates the results.
  8. *
  9. * References: https://en.wikipedia.org/wiki/Multisample_anti-aliasing
  10. *
  11. */
  12. THREE.ManualMSAARenderPass = function ( scene, camera, params ) {
  13. THREE.Pass.call( this );
  14. this.scene = scene;
  15. this.camera = camera;
  16. this.sampleLevel = 4; // specified as n, where the number of samples is 2^n, so sampleLevel = 4, is 2^4 samples, 16.
  17. this.params = params || { minFilter: THREE.NearestFilter, magFilter: THREE.NearestFilter, format: THREE.RGBAFormat };
  18. this.params.minFilter = THREE.NearestFilter;
  19. this.params.maxFilter = THREE.NearestFilter;
  20. if ( THREE.CompositeShader === undefined ) {
  21. console.error( "THREE.ManualMSAARenderPass relies on THREE.CompositeShader" );
  22. }
  23. var compositeShader = THREE.CompositeShader;
  24. this.compositeUniforms = THREE.UniformsUtils.clone( compositeShader.uniforms );
  25. this.materialComposite = new THREE.ShaderMaterial( {
  26. uniforms: this.compositeUniforms,
  27. vertexShader: compositeShader.vertexShader,
  28. fragmentShader: compositeShader.fragmentShader,
  29. premultipliedAlpha: true,
  30. transparent: true,
  31. blending: THREE.AdditiveBlending,
  32. depthTest: false,
  33. depthWrite: false
  34. } );
  35. this.camera2 = new THREE.OrthographicCamera( - 1, 1, 1, - 1, 0, 1 );
  36. this.scene2 = new THREE.Scene();
  37. this.quad2 = new THREE.Mesh( new THREE.PlaneGeometry( 2, 2 ), this.materialComposite );
  38. this.scene2.add( this.quad2 );
  39. };
  40. THREE.ManualMSAARenderPass.prototype = Object.create( THREE.Pass.prototype );
  41. Object.assign( THREE.ManualMSAARenderPass.prototype, {
  42. dispose: function() {
  43. if ( this.sampleRenderTarget ) {
  44. this.sampleRenderTarget.dispose();
  45. this.sampleRenderTarget = null;
  46. }
  47. },
  48. setSize: function ( width, height ) {
  49. if ( this.sampleRenderTarget ) this.sampleRenderTarget.setSize( width, height );
  50. },
  51. render: function ( renderer, writeBuffer, readBuffer, delta, maskActive ) {
  52. var camera = ( this.camera || this.scene.camera );
  53. var jitterOffsets = THREE.ManualMSAARenderPass.JitterVectors[ Math.max( 0, Math.min( this.sampleLevel, 5 ) ) ];
  54. if ( ! this.sampleRenderTarget ) {
  55. this.sampleRenderTarget = new THREE.WebGLRenderTarget( readBuffer.width, readBuffer.height, this.params );
  56. }
  57. var autoClear = renderer.autoClear;
  58. renderer.autoClear = false;
  59. this.compositeUniforms[ "scale" ].value = 1.0 / jitterOffsets.length;
  60. this.compositeUniforms[ "tForeground" ].value = this.sampleRenderTarget.texture;
  61. // render the scene multiple times, each slightly jitter offset from the last and accumulate the results.
  62. for ( var i = 0; i < jitterOffsets.length; i ++ ) {
  63. // only jitters perspective cameras. TODO: add support for jittering orthogonal cameras
  64. var jitterOffset = jitterOffsets[i];
  65. if ( camera.setViewOffset ) {
  66. camera.setViewOffset( readBuffer.width, readBuffer.height,
  67. jitterOffset[ 0 ] * 0.0625, jitterOffset[ 1 ] * 0.0625, // 0.0625 = 1 / 16
  68. readBuffer.width, readBuffer.height );
  69. }
  70. renderer.render( this.scene, camera, this.sampleRenderTarget, true );
  71. renderer.render( this.scene2, this.camera2, writeBuffer, (i === 0) );
  72. }
  73. // reset jitter to nothing. TODO: add support for orthogonal cameras
  74. if ( camera.setViewOffset ) camera.setViewOffset( undefined, undefined, undefined, undefined, undefined, undefined );
  75. renderer.autoClear = autoClear;
  76. }
  77. } );
  78. // These jitter vectors are specified in integers because it is easier.
  79. // I am assuming a [-8,8) integer grid, but it needs to be mapped onto [-0.5,0.5)
  80. // before being used, thus these integers need to be scaled by 1/16.
  81. //
  82. // Sample patterns reference: https://msdn.microsoft.com/en-us/library/windows/desktop/ff476218%28v=vs.85%29.aspx?f=255&MSPPError=-2147217396
  83. THREE.ManualMSAARenderPass.JitterVectors = [
  84. [
  85. [ 0, 0 ]
  86. ],
  87. [
  88. [ 4, 4 ], [ - 4, - 4 ]
  89. ],
  90. [
  91. [ - 2, - 6 ], [ 6, - 2 ], [ - 6, 2 ], [ 2, 6 ]
  92. ],
  93. [
  94. [ 1, - 3 ], [ - 1, 3 ], [ 5, 1 ], [ - 3, - 5 ],
  95. [ - 5, 5 ], [ - 7, - 1 ], [ 3, 7 ], [ 7, - 7 ]
  96. ],
  97. [
  98. [ 1, 1 ], [ - 1, - 3 ], [ - 3, 2 ], [ 4, - 1 ],
  99. [ - 5, - 2 ], [ 2, 5 ], [ 5, 3 ], [ 3, - 5 ],
  100. [ - 2, 6 ], [ 0, - 7 ], [ - 4, - 6 ], [ - 6, 4 ],
  101. [ - 8, 0 ], [ 7, - 4 ], [ 6, 7 ], [ - 7, - 8 ]
  102. ],
  103. [
  104. [ - 4, - 7 ], [ - 7, - 5 ], [ - 3, - 5 ], [ - 5, - 4 ],
  105. [ - 1, - 4 ], [ - 2, - 2 ], [ - 6, - 1 ], [ - 4, 0 ],
  106. [ - 7, 1 ], [ - 1, 2 ], [ - 6, 3 ], [ - 3, 3 ],
  107. [ - 7, 6 ], [ - 3, 6 ], [ - 5, 7 ], [ - 1, 7 ],
  108. [ 5, - 7 ], [ 1, - 6 ], [ 6, - 5 ], [ 4, - 4 ],
  109. [ 2, - 3 ], [ 7, - 2 ], [ 1, - 1 ], [ 4, - 1 ],
  110. [ 2, 1 ], [ 6, 2 ], [ 0, 4 ], [ 4, 4 ],
  111. [ 2, 5 ], [ 7, 5 ], [ 5, 6 ], [ 3, 7 ]
  112. ]
  113. ];