ManualMSAARenderPass.js 4.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156
  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. THREE.ManualMSAARenderPass.prototype = {
  42. constructor: THREE.ManualMSAARenderPass,
  43. dispose: function() {
  44. if ( this.sampleRenderTarget ) {
  45. this.sampleRenderTarget.dispose();
  46. this.sampleRenderTarget = null;
  47. }
  48. },
  49. setSize: function ( width, height ) {
  50. if ( this.sampleRenderTarget ) { this.sampleRenderTarget.setSize( width, height ); }
  51. },
  52. render: function ( renderer, writeBuffer, readBuffer, delta, maskActive ) {
  53. var camera = ( this.camera || this.scene.camera );
  54. var jitterOffsets = THREE.ManualMSAARenderPass.JitterVectors[ Math.max( 0, Math.min( this.sampleLevel, 5 ) ) ];
  55. if ( ! this.sampleRenderTarget ) {
  56. this.sampleRenderTarget = new THREE.WebGLRenderTarget( readBuffer.width, readBuffer.height, this.params );
  57. }
  58. var autoClear = renderer.autoClear;
  59. renderer.autoClear = false;
  60. this.compositeUniforms[ "scale" ].value = 1.0 / jitterOffsets.length;
  61. this.compositeUniforms[ "tForeground" ].value = this.sampleRenderTarget.texture;
  62. // render the scene multiple times, each slightly jitter offset from the last and accumulate the results.
  63. for ( var i = 0; i < jitterOffsets.length; i ++ ) {
  64. // only jitters perspective cameras. TODO: add support for jittering orthogonal cameras
  65. var jitterOffset = jitterOffsets[i];
  66. if ( camera.setViewOffset ) {
  67. camera.setViewOffset( readBuffer.width, readBuffer.height,
  68. jitterOffset[ 0 ] * 0.0625, jitterOffset[ 1 ] * 0.0625, // 0.0625 = 1 / 16
  69. readBuffer.width, readBuffer.height );
  70. }
  71. renderer.render( this.scene, camera, this.sampleRenderTarget, true );
  72. renderer.render( this.scene2, this.camera2, writeBuffer, (i === 0) );
  73. }
  74. // reset jitter to nothing. TODO: add support for orthogonal cameras
  75. if ( camera.setViewOffset ) camera.setViewOffset( undefined, undefined, undefined, undefined, undefined, undefined );
  76. renderer.autoClear = autoClear;
  77. }
  78. };
  79. // These jitter vectors are specified in integers because it is easier.
  80. // I am assuming a [-8,8) integer grid, but it needs to be mapped onto [-0.5,0.5)
  81. // before being used, thus these integers need to be scaled by 1/16.
  82. //
  83. // Sample patterns reference: https://msdn.microsoft.com/en-us/library/windows/desktop/ff476218%28v=vs.85%29.aspx?f=255&MSPPError=-2147217396
  84. THREE.ManualMSAARenderPass.JitterVectors = [
  85. [
  86. [ 0, 0 ]
  87. ],
  88. [
  89. [ 4, 4 ], [ - 4, - 4 ]
  90. ],
  91. [
  92. [ - 2, - 6 ], [ 6, - 2 ], [ - 6, 2 ], [ 2, 6 ]
  93. ],
  94. [
  95. [ 1, - 3 ], [ - 1, 3 ], [ 5, 1 ], [ - 3, - 5 ],
  96. [ - 5, 5 ], [ - 7, - 1 ], [ 3, 7 ], [ 7, - 7 ]
  97. ],
  98. [
  99. [ 1, 1 ], [ - 1, - 3 ], [ - 3, 2 ], [ 4, - 1 ],
  100. [ - 5, - 2 ], [ 2, 5 ], [ 5, 3 ], [ 3, - 5 ],
  101. [ - 2, 6 ], [ 0, - 7 ], [ - 4, - 6 ], [ - 6, 4 ],
  102. [ - 8, 0 ], [ 7, - 4 ], [ 6, 7 ], [ - 7, - 8 ]
  103. ],
  104. [
  105. [ - 4, - 7 ], [ - 7, - 5 ], [ - 3, - 5 ], [ - 5, - 4 ],
  106. [ - 1, - 4 ], [ - 2, - 2 ], [ - 6, - 1 ], [ - 4, 0 ],
  107. [ - 7, 1 ], [ - 1, 2 ], [ - 6, 3 ], [ - 3, 3 ],
  108. [ - 7, 6 ], [ - 3, 6 ], [ - 5, 7 ], [ - 1, 7 ],
  109. [ 5, - 7 ], [ 1, - 6 ], [ 6, - 5 ], [ 4, - 4 ],
  110. [ 2, - 3 ], [ 7, - 2 ], [ 1, - 1 ], [ 4, - 1 ],
  111. [ 2, 1 ], [ 6, 2 ], [ 0, 4 ], [ 4, 4 ],
  112. [ 2, 5 ], [ 7, 5 ], [ 5, 6 ], [ 3, 7 ]
  113. ]
  114. ];