rendertargets.html 9.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156
  1. <!DOCTYPE html><html lang="ru"><head>
  2. <meta charset="utf-8">
  3. <title>Цели рендеринга</title>
  4. <meta name="viewport" content="width=device-width, user-scalable=no, minimum-scale=1.0, maximum-scale=1.0">
  5. <meta name="twitter:card" content="summary_large_image">
  6. <meta name="twitter:site" content="@threejs">
  7. <meta name="twitter:title" content="Three.js – Цели рендеринга">
  8. <meta property="og:image" content="https://threejs.org/files/share.png">
  9. <link rel="shortcut icon" href="/files/favicon_white.ico" media="(prefers-color-scheme: dark)">
  10. <link rel="shortcut icon" href="/files/favicon.ico" media="(prefers-color-scheme: light)">
  11. <link rel="stylesheet" href="/manual/resources/lesson.css">
  12. <link rel="stylesheet" href="/manual/resources/lang.css">
  13. </head>
  14. <body>
  15. <div class="container">
  16. <div class="lesson-title">
  17. <h1>Цели рендеринга</h1>
  18. </div>
  19. <div class="lesson">
  20. <div class="lesson-main">
  21. <p>Цель рендеринга в three.js - это в основном текстура, которую вы можете рендерить. После рендеринга вы можете использовать эту текстуру как любую другую текстуру. </p>
  22. <p>Давайте сделаем простой пример. Начнем с примера <a href="responsive.html">статьи об отзывчивости</a>.</p>
  23. <p>Рендеринг к цели рендеринга практически идентичен обычному рендерингу. Сначала мы создаем <a href="/docs/#api/en/renderers/WebGLRenderTarget"><code class="notranslate" translate="no">WebGLRenderTarget</code></a>. </p>
  24. <pre class="prettyprint showlinemods notranslate lang-js" translate="no">const rtWidth = 512;
  25. const rtHeight = 512;
  26. const renderTarget = new THREE.WebGLRenderTarget(rtWidth, rtHeight);
  27. </pre>
  28. <p>Затем нам нужна <a href="/docs/#api/en/cameras/Camera"><code class="notranslate" translate="no">Camera</code></a> и <a href="/docs/#api/en/scenes/Scene"><code class="notranslate" translate="no">Scene</code></a> </p>
  29. <pre class="prettyprint showlinemods notranslate lang-js" translate="no">const rtFov = 75;
  30. const rtAspect = rtWidth / rtHeight;
  31. const rtNear = 0.1;
  32. const rtFar = 5;
  33. const rtCamera = new THREE.PerspectiveCamera(rtFov, rtAspect, rtNear, rtFar);
  34. rtCamera.position.z = 2;
  35. const rtScene = new THREE.Scene();
  36. rtScene.background = new THREE.Color('red');
  37. </pre>
  38. <p>Обратите внимание, что мы устанавливаем aspect для aspect рендеринга, а не для canvas. Правильный aspect зависит от того, для чего мы выполняем рендеринг.
  39. В этом случае мы будем использовать текстуру цели рендеринга на стороне куба. Поскольку грани куба являются квадратными, мы хотим, чтобы aspect = 1.0. </p>
  40. <p>Мы заполняем сцену материалом. В этом случае мы используем свет и 3 куба <a href="responsive.html">из предыдущей статьи</a>.</p>
  41. <pre class="prettyprint showlinemods notranslate lang-js" translate="no">{
  42. const color = 0xFFFFFF;
  43. const intensity = 1;
  44. const light = new THREE.DirectionalLight(color, intensity);
  45. light.position.set(-1, 2, 4);
  46. * rtScene.add(light);
  47. }
  48. const boxWidth = 1;
  49. const boxHeight = 1;
  50. const boxDepth = 1;
  51. const geometry = new THREE.BoxGeometry(boxWidth, boxHeight, boxDepth);
  52. function makeInstance(geometry, color, x) {
  53. const material = new THREE.MeshPhongMaterial({color});
  54. const cube = new THREE.Mesh(geometry, material);
  55. * rtScene.add(cube);
  56. cube.position.x = x;
  57. return cube;
  58. }
  59. *const rtCubes = [
  60. makeInstance(geometry, 0x44aa88, 0),
  61. makeInstance(geometry, 0x8844aa, -2),
  62. makeInstance(geometry, 0xaa8844, 2),
  63. ];
  64. </pre>
  65. <p><a href="/docs/#api/en/scenes/Scene"><code class="notranslate" translate="no">Scene</code></a> и <a href="/docs/#api/en/cameras/Camera"><code class="notranslate" translate="no">Camera</code></a> из предыдущей статьи все еще там. Мы будем использовать их для рендеринга на холст. Нам просто нужно добавить материал для рендеринга. </p>
  66. <p>Давайте добавим куб, который использует текстуру цели рендеринга.</p>
  67. <pre class="prettyprint showlinemods notranslate lang-js" translate="no">const material = new THREE.MeshPhongMaterial({
  68. map: renderTarget.texture,
  69. });
  70. const cube = new THREE.Mesh(geometry, material);
  71. scene.add(cube);
  72. </pre>
  73. <p>Теперь во время рендеринга сначала мы рендерим целевую сцену рендеринга в цель рендеринга. </p>
  74. <pre class="prettyprint showlinemods notranslate lang-js" translate="no">function render(time) {
  75. time *= 0.001;
  76. ...
  77. // rotate all the cubes in the render target scene
  78. rtCubes.forEach((cube, ndx) =&gt; {
  79. const speed = 1 + ndx * .1;
  80. const rot = time * speed;
  81. cube.rotation.x = rot;
  82. cube.rotation.y = rot;
  83. });
  84. // draw render target scene to render target
  85. renderer.setRenderTarget(renderTarget);
  86. renderer.render(rtScene, rtCamera);
  87. renderer.setRenderTarget(null);
  88. </pre>
  89. <p>Затем мы визуализируем сцену с помощью одного куба, который использует текстуру цели рендеринга для холста. </p>
  90. <pre class="prettyprint showlinemods notranslate lang-js" translate="no"> // rotate the cube in the scene
  91. cube.rotation.x = time;
  92. cube.rotation.y = time * 1.1;
  93. // render the scene to the canvas
  94. renderer.render(scene, camera);
  95. </pre>
  96. <p>И вуаля </p>
  97. <p></p><div translate="no" class="threejs_example_container notranslate">
  98. <div><iframe class="threejs_example notranslate" translate="no" style=" " src="/manual/examples/resources/editor.html?url=/manual/examples/render-target.html"></iframe></div>
  99. <a class="threejs_center" href="/manual/examples/render-target.html" target="_blank">нажмите здесь, чтобы открыть в отдельном окне</a>
  100. </div>
  101. <p></p>
  102. <p>Куб красный, потому что мы установили <code class="notranslate" translate="no">background</code> <code class="notranslate" translate="no">rtScene</code> на красный, чтобы текстура цели рендеринга была очищена до красного. </p>
  103. <p>Цели рендеринга используются для всех видов вещей. <a href="shadows.html">Тени</a> используют цели рендеринга.
  104. <a href="picking.html">Сбор может использовать цель рендеринга</a>. Различные виды
  105. <a href="post-processing.html">эффектов постобработки</a> требуют целей рендеринга.
  106. Для рендеринга зеркала заднего вида в автомобиле или просмотра в реальном времени на мониторе в 3D-сцене может использоваться цель рендеринга. </p>
  107. <p>Несколько замечаний по использованию <a href="/docs/#api/en/renderers/WebGLRenderTarget"><code class="notranslate" translate="no">WebGLRenderTarget</code></a>. </p>
  108. <ul>
  109. <li><p>По умолчанию <a href="/docs/#api/en/renderers/WebGLRenderTarget"><code class="notranslate" translate="no">WebGLRenderTarget</code></a> создает 2 текстуры. Цветная текстура и текстура глубины / трафарета. Если вам не нужны текстуры глубины или трафарета, вы можете попросить не создавать их, передав параметры. Пример: </p>
  110. <pre class="prettyprint showlinemods notranslate lang-js" translate="no"> const rt = new THREE.WebGLRenderTarget(width, height, {
  111. depthBuffer: false,
  112. stencilBuffer: false,
  113. });
  114. </pre>
  115. </li>
  116. <li><p>Возможно, вам придется изменить размер цели рендеринга </p>
  117. <p>В приведенном выше примере мы делаем цель рендеринга фиксированного размера, 512x512. Для таких вещей, как постобработка, вам обычно нужно сделать цель рендеринга того же размера, что и ваш холст. В нашем коде это означало бы, что при изменении размера холста мы также обновляли бы и размер цели рендеринга, и камеру, которую мы используем при рендеринге, цели рендеринга. Пример: </p>
  118. <pre class="prettyprint showlinemods notranslate notranslate" translate="no">function render(time) {
  119. time *= 0.001;
  120. if (resizeRendererToDisplaySize(renderer)) {
  121. const canvas = renderer.domElement;
  122. camera.aspect = canvas.clientWidth / canvas.clientHeight;
  123. camera.updateProjectionMatrix();
  124. + renderTarget.setSize(canvas.width, canvas.height);
  125. + rtCamera.aspect = camera.aspect;
  126. + rtCamera.updateProjectionMatrix();
  127. }
  128. </pre></li>
  129. </ul>
  130. </div>
  131. </div>
  132. </div>
  133. <script src="/manual/resources/prettify.js"></script>
  134. <script src="/manual/resources/lesson.js"></script>
  135. </body></html>