SAOPass.html 8.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214
  1. <!DOCTYPE html>
  2. <html lang="en">
  3. <head>
  4. <meta charset="utf-8">
  5. <title>SAOPass - Three.js Docs</title>
  6. <meta name="viewport" content="width=device-width, user-scalable=no, minimum-scale=1.0, maximum-scale=1.0">
  7. <script src="../scripts/highlight.min.js"></script>
  8. <link type="text/css" rel="stylesheet" href="../styles/highlight-three.css">
  9. <link type="text/css" rel="stylesheet" href="../styles/page.css">
  10. </head>
  11. <body>
  12. <p class="inheritance" translate="no"><a href="Pass.html">Pass</a> → </p>
  13. <h1 translate="no">SAOPass</h1>
  14. <section>
  15. <header>
  16. <div class="class-description"><p>A SAO implementation inspired from @bhouston previous SAO work.</p>
  17. <p><code>SAOPass</code> provides better quality than <a href="SSAOPass.html">SSAOPass</a> but is also more expensive.</p></div>
  18. <h2>Code Example</h2>
  19. <div translate="no"><pre><code class="language-js">const saoPass = new SAOPass( scene, camera );
  20. composer.addPass( saoPass );
  21. </code></pre></div>
  22. </header>
  23. <article>
  24. <h2 class="subsection-title">Import</h2>
  25. <p><span translate="no">SAOPass</span> is an addon, and must be imported explicitly, see <a href="https://threejs.org/manual/#en/installation" target="_blank" rel="noopener">Installation#Addons</a>.</p>
  26. <pre><code class="language-js">import { SAOPass } from 'three/addons/postprocessing/SAOPass.js';</code></pre>
  27. <div class="container-overview">
  28. <h2>Constructor</h2>
  29. <h3 class="name name-method" id="SAOPass" translate="no">new <a href="#SAOPass">SAOPass</a><span class="signature">( scene : <span class="param-type"><a href="Scene.html">Scene</a></span>, camera : <span class="param-type"><a href="Camera.html">Camera</a></span>, resolution : <span class="param-type"><a href="Vector2.html">Vector2</a></span> )</span> </h3>
  30. <div class="method">
  31. <div class="description">
  32. <p>Constructs a new SAO pass.</p>
  33. </div>
  34. <table class="params">
  35. <tbody>
  36. <tr>
  37. <td class="name">
  38. <strong>scene</strong>
  39. </td>
  40. <td class="description last">
  41. <p>The scene to compute the AO for.</p>
  42. </td>
  43. </tr>
  44. <tr>
  45. <td class="name">
  46. <strong>camera</strong>
  47. </td>
  48. <td class="description last">
  49. <p>The camera.</p>
  50. </td>
  51. </tr>
  52. <tr>
  53. <td class="name">
  54. <strong>resolution</strong>
  55. </td>
  56. <td class="description last">
  57. <p>The effect's resolution.</p>
  58. </td>
  59. </tr>
  60. </tbody>
  61. </table>
  62. </div>
  63. </div>
  64. <h2 class="subsection-title">Properties</h2>
  65. <div class="member">
  66. <h3 class="name" id="camera" translate="no">.<a href="#camera">camera</a><span class="type-signature"> : <a href="Camera.html">Camera</a></span> </h3>
  67. <div class="description">
  68. <p>The camera.</p>
  69. </div>
  70. </div>
  71. <div class="member">
  72. <h3 class="name" id="clear" translate="no">.<a href="#clear">clear</a><span class="type-signature"> : boolean</span> </h3>
  73. <div class="description">
  74. <p>Overwritten to perform a clear operation by default.</p>
  75. <p>Default is <code>true</code>.</p>
  76. </div>
  77. <dl class="details">
  78. <dt class="tag-overrides"><strong>Overrides:</strong> <a href="Pass.html#clear">Pass#clear</a></dt>
  79. </dl>
  80. </div>
  81. <div class="member">
  82. <h3 class="name" id="needsSwap" translate="no">.<a href="#needsSwap">needsSwap</a><span class="type-signature"> : boolean</span> </h3>
  83. <div class="description">
  84. <p>Overwritten to disable the swap.</p>
  85. <p>Default is <code>false</code>.</p>
  86. </div>
  87. <dl class="details">
  88. <dt class="tag-overrides"><strong>Overrides:</strong> <a href="Pass.html#needsSwap">Pass#needsSwap</a></dt>
  89. </dl>
  90. </div>
  91. <div class="member">
  92. <h3 class="name" id="params" translate="no">.<a href="#params">params</a><span class="type-signature"> : Object</span> </h3>
  93. <div class="description">
  94. <p>The SAO parameter.</p>
  95. </div>
  96. </div>
  97. <div class="member">
  98. <h3 class="name" id="resolution" translate="no">.<a href="#resolution">resolution</a><span class="type-signature"> : <a href="Vector2.html">Vector2</a></span> </h3>
  99. <div class="description">
  100. <p>The effect's resolution.</p>
  101. <p>Default is <code>(256,256)</code>.</p>
  102. </div>
  103. </div>
  104. <div class="member">
  105. <h3 class="name" id="scene" translate="no">.<a href="#scene">scene</a><span class="type-signature"> : <a href="Scene.html">Scene</a></span> </h3>
  106. <div class="description">
  107. <p>The scene to render the AO for.</p>
  108. </div>
  109. </div>
  110. <h2 class="subsection-title">Methods</h2>
  111. <h3 class="name name-method" id="dispose" translate="no">.<a href="#dispose">dispose</a><span class="signature">()</span> </h3>
  112. <div class="method">
  113. <div class="description">
  114. <p>Frees the GPU-related resources allocated by this instance. Call this
  115. method whenever the pass is no longer used in your app.</p>
  116. </div>
  117. <dl class="details">
  118. <dt class="tag-overrides"><strong>Overrides:</strong> <a href="Pass.html#dispose">Pass#dispose</a></dt>
  119. </dl>
  120. </div>
  121. <h3 class="name name-method" id="render" translate="no">.<a href="#render">render</a><span class="signature">( renderer : <span class="param-type"><a href="WebGLRenderer.html">WebGLRenderer</a></span>, writeBuffer : <span class="param-type"><a href="WebGLRenderTarget.html">WebGLRenderTarget</a></span>, readBuffer : <span class="param-type"><a href="WebGLRenderTarget.html">WebGLRenderTarget</a></span>, deltaTime : <span class="param-type">number</span>, maskActive : <span class="param-type">boolean</span> )</span> </h3>
  122. <div class="method">
  123. <div class="description">
  124. <p>Performs the SAO pass.</p>
  125. </div>
  126. <table class="params">
  127. <tbody>
  128. <tr>
  129. <td class="name">
  130. <strong>renderer</strong>
  131. </td>
  132. <td class="description last">
  133. <p>The renderer.</p>
  134. </td>
  135. </tr>
  136. <tr>
  137. <td class="name">
  138. <strong>writeBuffer</strong>
  139. </td>
  140. <td class="description last">
  141. <p>The write buffer. This buffer is intended as the rendering
  142. destination for the pass.</p>
  143. </td>
  144. </tr>
  145. <tr>
  146. <td class="name">
  147. <strong>readBuffer</strong>
  148. </td>
  149. <td class="description last">
  150. <p>The read buffer. The pass can access the result from the
  151. previous pass from this buffer.</p>
  152. </td>
  153. </tr>
  154. <tr>
  155. <td class="name">
  156. <strong>deltaTime</strong>
  157. </td>
  158. <td class="description last">
  159. <p>The delta time in seconds.</p>
  160. </td>
  161. </tr>
  162. <tr>
  163. <td class="name">
  164. <strong>maskActive</strong>
  165. </td>
  166. <td class="description last">
  167. <p>Whether masking is active or not.</p>
  168. </td>
  169. </tr>
  170. </tbody>
  171. </table>
  172. <dl class="details">
  173. <dt class="tag-overrides"><strong>Overrides:</strong> <a href="Pass.html#render">Pass#render</a></dt>
  174. </dl>
  175. </div>
  176. <h3 class="name name-method" id="setSize" translate="no">.<a href="#setSize">setSize</a><span class="signature">( width : <span class="param-type">number</span>, height : <span class="param-type">number</span> )</span> </h3>
  177. <div class="method">
  178. <div class="description">
  179. <p>Sets the size of the pass.</p>
  180. </div>
  181. <table class="params">
  182. <tbody>
  183. <tr>
  184. <td class="name">
  185. <strong>width</strong>
  186. </td>
  187. <td class="description last">
  188. <p>The width to set.</p>
  189. </td>
  190. </tr>
  191. <tr>
  192. <td class="name">
  193. <strong>height</strong>
  194. </td>
  195. <td class="description last">
  196. <p>The height to set.</p>
  197. </td>
  198. </tr>
  199. </tbody>
  200. </table>
  201. <dl class="details">
  202. <dt class="tag-overrides"><strong>Overrides:</strong> <a href="Pass.html#setSize">Pass#setSize</a></dt>
  203. </dl>
  204. </div>
  205. <h2 class="subsection-title">Source</h2>
  206. <p>
  207. <a href="https://github.com/mrdoob/three.js/blob/master/examples/jsm/postprocessing/SAOPass.js" translate="no" target="_blank" rel="noopener">examples/jsm/postprocessing/SAOPass.js</a>
  208. </p>
  209. </article>
  210. </section>
  211. <script src="../scripts/linenumber.js"></script>
  212. <script src="../scripts/page.js"></script>
  213. </body>
  214. </html>
粤ICP备19079148号