EffectComposer.html 5.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158
  1. <!DOCTYPE html>
  2. <html lang="en">
  3. <head>
  4. <meta charset="utf-8" />
  5. <base href="../../../" />
  6. <script src="list.js"></script>
  7. <script src="page.js"></script>
  8. <link type="text/css" rel="stylesheet" href="page.css" />
  9. </head>
  10. <body>
  11. <h1>效果合成器([name])</h1>
  12. <p class="desc">
  13. 用于在three.js中实现后期处理效果。该类管理了产生最终视觉效果的后期处理过程链。
  14. 后期处理过程根据它们添加/插入的顺序来执行,最后一个过程会被自动渲染到屏幕上。
  15. </p>
  16. <h2>示例</h2>
  17. <p>
  18. [example:webgl_postprocessing postprocessing]<br />
  19. [example:webgl_postprocessing_advanced postprocessing advanced]<br />
  20. [example:webgl_postprocessing_backgrounds postprocessing backgrounds]<br />
  21. [example:webgl_postprocessing_crossfade postprocessing crossfade]<br />
  22. [example:webgl_postprocessing_dof postprocessing depth-of-field]<br />
  23. [example:webgl_postprocessing_dof2 postprocessing depth-of-field 2]<br />
  24. [example:webgl_postprocessing_fxaa postprocessing fxaa]<br />
  25. [example:webgl_postprocessing_glitch postprocessing glitch]<br />
  26. [example:webgl_postprocessing_godrays postprocessing godrays]<br />
  27. [example:webgl_postprocessing_masking postprocessing masking]<br />
  28. [example:webgl_postprocessing_nodes postprocessing node material]<br />
  29. [example:webgl_postprocessing_outline postprocessing outline]<br />
  30. [example:webgl_postprocessing_pixel postprocessing pixelate]<br />
  31. [example:webgl_postprocessing_procedural postprocessing procedural]<br />
  32. [example:webgl_postprocessing_rgb_halftone postprocessing rgb halftone]<br />
  33. [example:webgl_postprocessing_sao postprocessing sao]<br />
  34. [example:webgl_postprocessing_smaa postprocessing smaa]<br />
  35. [example:webgl_postprocessing_sobel postprocessing sobel]<br />
  36. [example:webgl_postprocessing_ssaa postprocessing ssaa]<br />
  37. [example:webgl_postprocessing_ssao postprocessing ssao]<br />
  38. [example:webgl_postprocessing_taa postprocessing taa]<br />
  39. [example:webgl_postprocessing_unreal_bloom postprocessing unreal bloom]<br />
  40. [example:webgl_postprocessing_unreal_bloom_selective postprocessing unreal bloom selective]<br />
  41. </p>
  42. <h2>构造函数</h2>
  43. <h3>[name]( [param:WebGLRenderer renderer], [param:WebGLRenderTarget renderTarget] )</h3>
  44. <p>
  45. [page:WebGLRenderer renderer] -- 用于渲染场景的渲染器。<br />
  46. [page:WebGLRenderTarget renderTarget] -- (可选)一个预先配置的渲染目标,内部由 [name] 使用。
  47. </p>
  48. <h2>属性</h2>
  49. <h3>[property:Array passes]</h3>
  50. <p>
  51. 一个用于表示后期处理过程链(包含顺序)的数组。
  52. </p>
  53. <h3>[property:WebGLRendererTarget readBuffer]</h3>
  54. <p>
  55. 内部读缓冲区的引用。过程一般从该缓冲区读取先前的渲染结果。
  56. </p>
  57. <h3>[property:WebGLRenderer renderer]</h3>
  58. <p>
  59. 内部渲染器的引用。
  60. </p>
  61. <h3>[property:Boolean renderToScreen]</h3>
  62. <p>
  63. 最终过程是否被渲染到屏幕(默认帧缓冲区)。
  64. </p>
  65. <h3>[property:WebGLRendererTarget writeBuffer]</h3>
  66. <p>
  67. 内部写缓冲区的引用。过程常将它们的渲染结果写入该缓冲区。
  68. </p>
  69. <h2>方法</h2>
  70. <h3>[method:void addPass]( [param:Pass pass] )</h3>
  71. <p>
  72. pass -- 将被添加到过程链的过程<br /><br />
  73. 将传入的过程添加到过程链。
  74. </p>
  75. <h3>[method:void insertPass]( [param:Pass pass], [param:Integer index] )</h3>
  76. <p>
  77. pass -- 将被插入到过程链的过程。<br />
  78. index -- 定义过程链中过程应插入的位置。<br /><br />
  79. 将传入的过程插入到过程链中所给定的索引处。
  80. </p>
  81. <h3>[method:boolean isLastEnabledPass]( [param:Integer passIndex] )</h3>
  82. <p>
  83. passIndex -- 被用于检查的过程<br /><br />
  84. 如果给定索引的过程在过程链中是最后一个启用的过程,则返回true。
  85. 由[name]所使用,来决定哪一个过程应当被渲染到屏幕上。
  86. </p>
  87. <h3>[method:void render]( [param:Float deltaTime] )</h3>
  88. <p>
  89. deltaTime -- The delta time value.<br /><br />
  90. 执行所有启用的后期处理过程,来产生最终的帧,
  91. </p>
  92. <h3>[method:void reset]( [param:WebGLRenderTarget renderTarget] )</h3>
  93. <p>
  94. [page:WebGLRenderTarget renderTarget] -- (可选)一个预先配置的渲染目标,内部由 [name] 使用。<br /><br />
  95. 重置所有[name]的内部状态。
  96. </p>
  97. <h3>[method:void setPixelRatio]( [param:Float pixelRatio] )</h3>
  98. <p>
  99. pixelRatio -- 设备像素比<br /><br />
  100. 设置设备的像素比。该值通常被用于HiDPI设备,以阻止模糊的输出。
  101. 因此,该方法语义类似于[page:WebGLRenderer.setPixelRatio]()。
  102. </p>
  103. <h3>[method:void setSize]( [param:Integer width], [param:Integer height] )</h3>
  104. <p>
  105. width -- [name]的宽度。<br />
  106. height -- [name]的高度。<br /><br />
  107. 考虑设备像素比,重新设置内部渲染缓冲和过程的大小为(width, height)。
  108. 因此,该方法语义类似于[page:WebGLRenderer.setSize]()。
  109. </p>
  110. <h3>[method:void swapBuffers]()</h3>
  111. <p>交换内部的读/写缓冲。</p>
  112. <h2>源代码</h2>
  113. <p>
  114. [link:https://github.com/mrdoob/three.js/blob/master/examples/js/postprocessing/EffectComposer.js examples/js/postprocessing/EffectComposer.js]
  115. </p>
  116. </body>
  117. </html>