multiple-scenes.html 30 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615
  1. <!DOCTYPE html><html lang="zh"><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="../resources/lesson.css">
  12. <link rel="stylesheet" href="../resources/lang.css">
  13. <script type="importmap">
  14. {
  15. "imports": {
  16. "three": "../../build/three.module.js"
  17. }
  18. }
  19. </script>
  20. <link rel="stylesheet" href="/manual/zh/lang.css">
  21. </head>
  22. <body>
  23. <div class="container">
  24. <div class="lesson-title">
  25. <h1>多个画布,多个场景</h1>
  26. </div>
  27. <div class="lesson">
  28. <div class="lesson-main">
  29. <p>Three.js中一个老生常谈的问题就是多个场景的渲染。比如当你想制作一个由多个三维图像构成的商业网站时,很容易想到的解决办法就是为每一个三维图像创建一张画布<code class="notranslate" translate="no">(Canvas)</code>,并为每张画布添加一个渲染器<code class="notranslate" translate="no">(Renderer)</code>。</p>
  30. <p>但是,这样你会遇到两个很明显的问题:</p>
  31. <blockquote>
  32. <ol>
  33. <li>浏览器限制了WebGL上下文<code class="notranslate" translate="no">(WebGL contexts)</code>的数量。</li>
  34. </ol>
  35. <p>通常浏览器将其限制为 8 个,一旦超出这个数量,最先创建的WebGL上下文就会被自动弃用。</p>
  36. <ol>
  37. <li>无法在不同的WebGL上下文中共享资源。</li>
  38. </ol>
  39. <p>不同WebGL上下文无法共享任何资源,这就意味着,假设你想要在两个<code class="notranslate" translate="no">Canvas</code>中各加载一个10Mb的模型,并且每个模型都20Mb的纹理,那么这个模型和纹理将分别被加载两次。因此,初始化、着色器编译等都将运行两次,随着<code class="notranslate" translate="no">Canvas</code>数量的增减,情况会变得与来越糟糕。</p>
  40. </blockquote>
  41. <p>那么,我们该如何解决这个问题?</p>
  42. <h2 id="-">基本方法</h2>
  43. <p>解决办法就是用一张<code class="notranslate" translate="no">Canvas</code>在整个背景中填充视口,并利用一些其他元素来代表每个“虚拟画布”<code class="notranslate" translate="no">(virtual canvas)</code>,即只在一张<code class="notranslate" translate="no">Canvas</code>中加载一个<a href="/docs/#api/zh/constants/Renderer"><code class="notranslate" translate="no">Renderer</code></a>,并为每个<code class="notranslate" translate="no">virtual canvas</code>创建一个场景<code class="notranslate" translate="no">(Scene)</code>。这样我们只需要确保每个<code class="notranslate" translate="no">virtual canvas</code>正确的位置,THREE.js就会将它们渲染在屏幕上相应的位置。</p>
  44. <p>利用这个方法,由于我们只添加了一张<code class="notranslate" translate="no">Canvas</code>,也就仅仅使用了一个<code class="notranslate" translate="no">WebGL contexts</code>,因此不仅解决了资源共享问题,且不会引发WebGL上下文数量限制问题。</p>
  45. <p>以一个只有两个<a href="/docs/#api/zh/scenes/Scene"><code class="notranslate" translate="no">Scene</code></a>的简单demo为例。首先,创建HTML结构:</p>
  46. <pre class="prettyprint showlinemods notranslate lang-html" translate="no">&lt;canvas id="c"&gt;&lt;/canvas&gt;
  47. &lt;p&gt;
  48. &lt;span id="box" class="diagram left"&gt;&lt;/span&gt;
  49. I love boxes. Presents come in boxes.
  50. When I find a new box I'm always excited to find out what's inside.
  51. &lt;/p&gt;
  52. &lt;p&gt;
  53. &lt;span id="pyramid" class="diagram right"&gt;&lt;/span&gt;
  54. When I was a kid I dreamed of going on an expedition inside a pyramid
  55. and finding a undiscovered tomb full of mummies and treasure.
  56. &lt;/p&gt;
  57. </pre>
  58. <p>接着为它设置一些基本样式:</p>
  59. <pre class="prettyprint showlinemods notranslate lang-css" translate="no">#c {
  60. position: fixed;
  61. left: 0;
  62. top: 0;
  63. width: 100%;
  64. height: 100%;
  65. display: block;
  66. z-index: -1;
  67. }
  68. .diagram {
  69. display: inline-block;
  70. width: 5em;
  71. height: 3em;
  72. border: 1px solid black;
  73. }
  74. .left {
  75. float: left;
  76. margin-right: .25em;
  77. }
  78. .right {
  79. float: right;
  80. margin-left: .25em;
  81. }
  82. </pre>
  83. <p>我们将<code class="notranslate" translate="no">Canvas</code>画幅设置为充满整个屏幕,并将其<code class="notranslate" translate="no">z-index</code>设置为<code class="notranslate" translate="no">-1</code>,使它始终位于其他元素的后面。当然,我们要给<code class="notranslate" translate="no">virtual canvas</code>设置相应的宽高,因为此时还没有任何内容可以撑起它的大小。</p>
  84. <p>现在,创建两个<a href="/docs/#api/zh/scenes/Scene"><code class="notranslate" translate="no">Scene</code></a>,其中一个添加了立方体,另一个为菱形,并分别为这两个<a href="/docs/#api/zh/scenes/Scene"><code class="notranslate" translate="no">Scene</code></a>添加灯光<code class="notranslate" translate="no">(Light)</code>和相机<code class="notranslate" translate="no">(Camera)</code>。</p>
  85. <pre class="prettyprint showlinemods notranslate lang-js" translate="no">function makeScene(elem) {
  86. const scene = new THREE.Scene();
  87. const fov = 45;
  88. const aspect = 2; // the canvas default
  89. const near = 0.1;
  90. const far = 5;
  91. const camera = new THREE.PerspectiveCamera(fov, aspect, near, far);
  92. camera.position.z = 2;
  93. camera.position.set(0, 1, 2);
  94. camera.lookAt(0, 0, 0);
  95. {
  96. const color = 0xFFFFFF;
  97. const intensity = 1;
  98. const light = new THREE.DirectionalLight(color, intensity);
  99. light.position.set(-1, 2, 4);
  100. scene.add(light);
  101. }
  102. return {scene, camera, elem};
  103. }
  104. function setupScene1() {
  105. const sceneInfo = makeScene(document.querySelector('#box'));
  106. const geometry = new THREE.BoxGeometry(1, 1, 1);
  107. const material = new THREE.MeshPhongMaterial({color: 'red'});
  108. const mesh = new THREE.Mesh(geometry, material);
  109. sceneInfo.scene.add(mesh);
  110. sceneInfo.mesh = mesh;
  111. return sceneInfo;
  112. }
  113. function setupScene2() {
  114. const sceneInfo = makeScene(document.querySelector('#pyramid'));
  115. const radius = .8;
  116. const widthSegments = 4;
  117. const heightSegments = 2;
  118. const geometry = new THREE.SphereGeometry(radius, widthSegments, heightSegments);
  119. const material = new THREE.MeshPhongMaterial({
  120. color: 'blue',
  121. flatShading: true,
  122. });
  123. const mesh = new THREE.Mesh(geometry, material);
  124. sceneInfo.scene.add(mesh);
  125. sceneInfo.mesh = mesh;
  126. return sceneInfo;
  127. }
  128. const sceneInfo1 = setupScene1();
  129. const sceneInfo2 = setupScene2();
  130. </pre>
  131. <p>接着创建一个视图信息获取函数<code class="notranslate" translate="no">renderSceneInfo()</code>和视图渲染函数<code class="notranslate" translate="no">render()</code>,用来渲染那些<code class="notranslate" translate="no">virtual canvas</code>所在的元素出现在了可视区域的<a href="/docs/#api/zh/scenes/Scene"><code class="notranslate" translate="no">Scene</code></a>。只需调用THREE.js的剪裁区域检测<a href="/docs/#api/zh/constants/Renderer.setScissorTest"><code class="notranslate" translate="no">Renderer.setScissorTest</code></a>方法,THREE.js就能实现仅渲染部分画布内容的功能,同时,我们需要调用<a href="/docs/#api/zh/constants/Renderer.setViewport"><code class="notranslate" translate="no">Renderer.setViewport</code></a>和<a href="/docs/#api/zh/constants/Renderer.setScissor"><code class="notranslate" translate="no">Renderer.setScissor</code></a>来分别设定视口大小和剪裁区域。</p>
  132. <p>参数说明如下:
  133. &gt;</p>
  134. <blockquote>
  135. <p>Renderer.setScissorTest( boolean : Boolean ) : null;
  136. // 启用或禁用剪裁检测. 若启用,则只有在所定义的裁剪区域内的像素才会受之后的渲染器影响。
  137. Renderer.setScissor ( x : Integer, y : Integer, width : Integer, height : Integer ) : null;
  138. //将剪裁区域设为(x, y)到(x + width, y + height)
  139. Renderer.### <a href="">setViewport</a> ( x : Integer, y : Integer, width : Integer, height : Integer ) : null
  140. //将视口大小设置为(x, y)到 (x + width, y + height).</p>
  141. </blockquote>
  142. <p>视图信息获取函数如下:</p>
  143. <pre class="prettyprint showlinemods notranslate lang-js" translate="no">function renderSceneInfo(sceneInfo) {
  144. const {scene, camera, elem} = sceneInfo;
  145. // get the viewport relative position of this element
  146. const {left, right, top, bottom, width, height} =
  147. elem.getBoundingClientRect();
  148. const isOffscreen =
  149. bottom &lt; 0 ||
  150. top &gt; renderer.domElement.clientHeight ||
  151. right &lt; 0 ||
  152. left &gt; renderer.domElement.clientWidth;
  153. if (isOffscreen) {
  154. return;
  155. }
  156. camera.aspect = width / height;
  157. camera.updateProjectionMatrix();
  158. const positiveYUpBottom = canvasRect.height - bottom;
  159. renderer.setScissor(left, positiveYUpBottom, width, height);
  160. renderer.setViewport(left, positiveYUpBottom, width, height);
  161. renderer.render(scene, camera);
  162. }
  163. </pre>
  164. <p>视图渲染函数如下:</p>
  165. <pre class="prettyprint showlinemods notranslate lang-js" translate="no">function render(time) {
  166. time *= 0.001;
  167. resizeRendererToDisplaySize(renderer);
  168. renderer.setScissorTest(false);
  169. renderer.clear(true, true);
  170. renderer.setScissorTest(true);
  171. sceneInfo1.mesh.rotation.y = time * .1;
  172. sceneInfo2.mesh.rotation.y = time * .1;
  173. renderSceneInfo(sceneInfo1);
  174. renderSceneInfo(sceneInfo2);
  175. requestAnimationFrame(render);
  176. }
  177. </pre>
  178. <p>最终效果如下:</p>
  179. <p></p><div translate="no" class="threejs_example_container notranslate">
  180. <div><iframe class="threejs_example notranslate" translate="no" style=" " src="/manual/examples/resources/editor.html?url=/manual/examples/multiple-scenes-v1.html"></iframe></div>
  181. <a class="threejs_center" href="/manual/examples/multiple-scenes-v1.html" target="_blank">点击此处在新标签页中打开</a>
  182. </div>
  183. <p></p>
  184. <p>可以看到,两个物体被分别渲染到了对应的位置。</p>
  185. <h2 id="-">同步滚动</h2>
  186. <p>虽然我们已经实现了同时渲染多个场景的功能,但是上面的代码依然存在一个问题,如果<code class="notranslate" translate="no">Scenes</code>过于复杂、或者由于其他原因需要更长时间渲染,那么画布中<code class="notranslate" translate="no">Scenes</code>渲染的位置总是会落后于页面的其他元素,如页面滚动时会出现明显的滞后。</p>
  187. <p>为了更直观的观察这个现象,我们给每个<a href="/docs/#api/zh/scenes/Scene"><code class="notranslate" translate="no">Scene</code></a>加上边框,并设置背景颜色:</p>
  188. <pre class="prettyprint showlinemods notranslate lang-css" translate="no">.diagram {
  189. display: inline-block;
  190. width: 5em;
  191. height: 3em;
  192. + border: 1px solid black;
  193. }
  194. </pre>
  195. <p>给每个场景设置背景颜色</p>
  196. <pre class="prettyprint showlinemods notranslate lang-js" translate="no">const scene = new THREE.Scene();
  197. +scene.background = new THREE.Color('red');
  198. </pre>
  199. <p>此时,我们<a href="../examples/multiple-scenes-v2.html" target="_blank">快速滚动屏幕</a>,就会发现这个问题。屏幕滚动时的动画放慢十倍后的效果如下:</p>
  200. <div class="threejs_center"><img class="border" src="../resources/images/multi-view-skew.gif"></div>
  201. <p>为了解决这个问题,先将<code class="notranslate" translate="no">Canvas</code>的定位方式由<code class="notranslate" translate="no">position: fixed</code> 改为<code class="notranslate" translate="no">position: absolute</code>。</p>
  202. <pre class="prettyprint showlinemods notranslate lang-css" translate="no">#c {
  203. - position: fixed;
  204. + position: absolute;
  205. </pre>
  206. </pre>
  207. <p>然后,我们将设置<code class="notranslate" translate="no">Canvas</code>的<code class="notranslate" translate="no">transform</code>来移动它,使画布的顶部位于页面当前滚动到的任何部分的顶部。</p>
  208. <pre class="prettyprint showlinemods notranslate lang-js" translate="no">function render(time) {
  209. ...
  210. const transform = `translateY(${window.scrollY}px)`;
  211. renderer.domElement.style.transform = transform;
  212. </pre>
  213. <p><code class="notranslate" translate="no">position: fixed</code> 会完全禁用画布的滚动,无论其他元素是否已经滚动经过它;
  214. <code class="notranslate" translate="no">position: absolute</code>则会保持画布与页面的其余部分一起滚动,这意味着我们绘制的任何东西都会与页面一起滚动,就算还未完全渲染出来。当场景完成渲染之后,然后移动画布,场景会与页面被滚动后的位置相匹配,并重新渲染,这就意味着,只有窗口的边缘会显示出一些还未被渲染的数据,当时页面中的场景不会出现这种现象。下面时利用以上方法后的效果(动画同样放慢了10倍)。</p>
  215. <h2 id="-">让它更加通用</h2>
  216. <p>现在,我们已经实现了在一个<code class="notranslate" translate="no">Canvas</code>中渲染多个场景的功能,接下来就来处理一下让它更加好用些。</p>
  217. <p>我们可以封装一个主渲染函数用来管理整个<code class="notranslate" translate="no">Canvas</code>,并定义一个场景元素列表和他们对应的场景初始化函数。对于每个元素,它将检查该元素是否滚动到了可视区域并调用相应的场景初始化函数。这样我们就构建了一个渲染系统,在这个系统中每个独立的<code class="notranslate" translate="no">scenes</code>都会在它们各自定义的空间内独立渲染且不互相影响。</p>
  218. <p>主渲染函数如下:</p>
  219. <pre class="prettyprint showlinemods notranslate lang-js" translate="no">const sceneElements = [];
  220. function addScene(elem, fn) {
  221. sceneElements.push({elem, fn});
  222. }
  223. function render(time) {
  224. time *= 0.001;
  225. resizeRendererToDisplaySize(renderer);
  226. renderer.setScissorTest(false);
  227. renderer.setClearColor(clearColor, 0);
  228. renderer.clear(true, true);
  229. renderer.setScissorTest(true);
  230. const transform = `translateY(${window.scrollY}px)`;
  231. renderer.domElement.style.transform = transform;
  232. for (const {elem, fn} of sceneElements) {
  233. // get the viewport relative position of this element
  234. const rect = elem.getBoundingClientRect();
  235. const {left, right, top, bottom, width, height} = rect;
  236. const isOffscreen =
  237. bottom &lt; 0 ||
  238. top &gt; renderer.domElement.clientHeight ||
  239. right &lt; 0 ||
  240. left &gt; renderer.domElement.clientWidth;
  241. if (!isOffscreen) {
  242. const positiveYUpBottom = renderer.domElement.clientHeight - bottom;
  243. renderer.setScissor(left, positiveYUpBottom, width, height);
  244. renderer.setViewport(left, positiveYUpBottom, width, height);
  245. fn(time, rect);
  246. }
  247. }
  248. requestAnimationFrame(render);
  249. }
  250. </pre>
  251. <p>从中可以看出,这个函数将遍历每一个包含了所有<a href="/docs/#api/zh/scenes/Scene"><code class="notranslate" translate="no">Scene</code></a>元素的数组对象,且每个元素都由各自的<code class="notranslate" translate="no">elem</code>和<code class="notranslate" translate="no">fn</code>属性。</p>
  252. <p>这个函数将检查每个<a href="/docs/#api/zh/scenes/Scene"><code class="notranslate" translate="no">Scene</code></a>元素是否进入可视区域,一旦进入就会调用它的场景初始化函数,并传给它当前的时间和对应的尺寸位置信息。</p>
  253. <p>现在,把每个<a href="/docs/#api/zh/scenes/Scene"><code class="notranslate" translate="no">Scene</code></a>的信息添加到数组列表中:</p>
  254. <pre class="prettyprint showlinemods notranslate lang-js" translate="no">{
  255. const elem = document.querySelector('#box');
  256. const {scene, camera} = makeScene();
  257. const geometry = new THREE.BoxGeometry(1, 1, 1);
  258. const material = new THREE.MeshPhongMaterial({color: 'red'});
  259. const mesh = new THREE.Mesh(geometry, material);
  260. scene.add(mesh);
  261. addScene(elem, (time, rect) =&gt; {
  262. camera.aspect = rect.width / rect.height;
  263. camera.updateProjectionMatrix();
  264. mesh.rotation.y = time * .1;
  265. renderer.render(scene, camera);
  266. });
  267. }
  268. {
  269. const elem = document.querySelector('#pyramid');
  270. const {scene, camera} = makeScene();
  271. const radius = .8;
  272. const widthSegments = 4;
  273. const heightSegments = 2;
  274. const geometry = new THREE.SphereGeometry(radius, widthSegments, heightSegments);
  275. const material = new THREE.MeshPhongMaterial({
  276. color: 'blue',
  277. flatShading: true,
  278. });
  279. const mesh = new THREE.Mesh(geometry, material);
  280. scene.add(mesh);
  281. addScene(elem, (time, rect) =&gt; {
  282. camera.aspect = rect.width / rect.height;
  283. camera.updateProjectionMatrix();
  284. mesh.rotation.y = time * .1;
  285. renderer.render(scene, camera);
  286. });
  287. }
  288. </pre>
  289. <p>至此,我们不再需要分别定义<code class="notranslate" translate="no">sceneInfo1</code> 和 <code class="notranslate" translate="no">sceneInfo2</code>,但每个场景对应的场景初始化函数都已生效。</p>
  290. <p></p><div translate="no" class="threejs_example_container notranslate">
  291. <div><iframe class="threejs_example notranslate" translate="no" style=" " src="/manual/examples/resources/editor.html?url=/manual/examples/multiple-scenes-generic.html"></iframe></div>
  292. <a class="threejs_center" href="/manual/examples/multiple-scenes-generic.html" target="_blank">点击此处在新标签页中打开</a>
  293. </div>
  294. <p></p>
  295. <h3 id="-html-dataset">使用HTML Dataset</h3>
  296. <p>更好用的最后一步就是使用HTML <a href="https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/dataset">dataset</a>,这是一种将自己的数据添加到HTML元素中的方法,我们不再使用<code class="notranslate" translate="no">id="..."</code>,而是使用<code class="notranslate" translate="no">data-diagram="..."</code>,就像这样:</p>
  297. <pre class="prettyprint showlinemods notranslate lang-html" translate="no">&lt;canvas id="c"&gt;&lt;/canvas&gt;
  298. &lt;p&gt;
  299. - &lt;span id="box" class="diagram left"&gt;&lt;/span&gt;
  300. + &lt;span data-diagram="box" class="left"&gt;&lt;/span&gt;
  301. I love boxes. Presents come in boxes.
  302. When I find a new box I'm always excited to find out what's inside.
  303. &lt;/p&gt;
  304. &lt;p&gt;
  305. - &lt;span id="pyramid" class="diagram left"&gt;&lt;/span&gt;
  306. + &lt;span data-diagram="pyramid" class="right"&gt;&lt;/span&gt;
  307. When I was a kid I dreamed of going on an expedition inside a pyramid
  308. and finding a undiscovered tomb full of mummies and treasure.
  309. &lt;/p&gt;
  310. </pre>
  311. <p>同时修改CSS选择器</p>
  312. <pre class="prettyprint showlinemods notranslate lang-css" translate="no">-.diagram
  313. +*[data-diagram] {
  314. display: inline-block;
  315. width: 5em;
  316. height: 3em;
  317. }
  318. </pre>
  319. <p>现在,我们构建一个对象,用来映射每个场景对应的场景初始化函数,并返回一个场景渲染函数。</p>
  320. <pre class="prettyprint showlinemods notranslate lang-js" translate="no">const sceneInitFunctionsByName = {
  321. 'box': () =&gt; {
  322. const {scene, camera} = makeScene();
  323. const geometry = new THREE.BoxGeometry(1, 1, 1);
  324. const material = new THREE.MeshPhongMaterial({color: 'red'});
  325. const mesh = new THREE.Mesh(geometry, material);
  326. scene.add(mesh);
  327. return (time, rect) =&gt; {
  328. mesh.rotation.y = time * .1;
  329. camera.aspect = rect.width / rect.height;
  330. camera.updateProjectionMatrix();
  331. renderer.render(scene, camera);
  332. };
  333. },
  334. 'pyramid': () =&gt; {
  335. const {scene, camera} = makeScene();
  336. const radius = .8;
  337. const widthSegments = 4;
  338. const heightSegments = 2;
  339. const geometry = new THREE.SphereGeometry(radius, widthSegments, heightSegments);
  340. const material = new THREE.MeshPhongMaterial({
  341. color: 'blue',
  342. flatShading: true,
  343. });
  344. const mesh = new THREE.Mesh(geometry, material);
  345. scene.add(mesh);
  346. return (time, rect) =&gt; {
  347. mesh.rotation.y = time * .1;
  348. camera.aspect = rect.width / rect.height;
  349. camera.updateProjectionMatrix();
  350. renderer.render(scene, camera);
  351. };
  352. },
  353. };
  354. </pre>
  355. <p>我们还需要获取所有的<code class="notranslate" translate="no">diagrams</code>,并调用初始化函数。</p>
  356. <pre class="prettyprint showlinemods notranslate lang-js" translate="no">document.querySelectorAll('[data-diagram]').forEach((elem) =&gt; {
  357. const sceneName = elem.dataset.diagram;
  358. const sceneInitFunction = sceneInitFunctionsByName[sceneName];
  359. const sceneRenderFunction = sceneInitFunction(elem);
  360. addScene(elem, sceneRenderFunction);
  361. });
  362. </pre>
  363. <p>经过这番改造,页面的呈现效果没有发生变化,但代码更加通用了。</p>
  364. <p></p>
  365. <h2 id="-">给每个元素增加控制器</h2>
  366. <p>当需要交互时,我们需要为每个场景分别添加交互控件,如<code class="notranslate" translate="no">TrackballControls</code>。首先,需要引入该控件。</p>
  367. <pre class="prettyprint showlinemods notranslate lang-js" translate="no">import {TrackballControls} from 'three/addons/controls/TrackballControls.js';
  368. </pre>
  369. <p>接着给每个元素增加控制器:</p>
  370. <pre class="prettyprint showlinemods notranslate lang-js" translate="no">-function makeScene() {
  371. +function makeScene(elem) {
  372. const scene = new THREE.Scene();
  373. const fov = 45;
  374. const aspect = 2; // the canvas default
  375. const near = 0.1;
  376. const far = 5;
  377. const camera = new THREE.PerspectiveCamera(fov, aspect, near, far);
  378. camera.position.set(0, 1, 2);
  379. camera.lookAt(0, 0, 0);
  380. + scene.add(camera);
  381. + const controls = new TrackballControls(camera, elem);
  382. + controls.noZoom = true;
  383. + controls.noPan = true;
  384. {
  385. const color = 0xFFFFFF;
  386. const intensity = 1;
  387. const light = new THREE.DirectionalLight(color, intensity);
  388. light.position.set(-1, 2, 4);
  389. - scene.add(light);
  390. + camera.add(light);
  391. }
  392. - return {scene, camera};
  393. + return {scene, camera, controls};
  394. }
  395. </pre>
  396. <p>从中可以看到,我们将<code class="notranslate" translate="no">camera</code>添加到<code class="notranslate" translate="no">scene</code>中,而<code class="notranslate" translate="no">light</code>则添加到<code class="notranslate" translate="no">camera</code>上,这样可以保证<code class="notranslate" translate="no">light</code>始终与<code class="notranslate" translate="no">camera</code>相关联。因此,当我们通过控制器旋转<code class="notranslate" translate="no">camera</code>的视角时,<code class="notranslate" translate="no">light</code>会始终照亮这个视角。</p>
  397. <p>我们还需要在渲染函数中更新这些控件:</p>
  398. <pre class="prettyprint showlinemods notranslate lang-js" translate="no">const sceneInitFunctionsByName = {
  399. - 'box': () =&gt; {
  400. - const {scene, camera} = makeScene();
  401. + 'box': (elem) =&gt; {
  402. + const {scene, camera, controls} = makeScene(elem);
  403. const geometry = new THREE.BoxGeometry(1, 1, 1);
  404. const material = new THREE.MeshPhongMaterial({color: 'red'});
  405. const mesh = new THREE.Mesh(geometry, material);
  406. scene.add(mesh);
  407. return (time, rect) =&gt; {
  408. mesh.rotation.y = time * .1;
  409. camera.aspect = rect.width / rect.height;
  410. camera.updateProjectionMatrix();
  411. + controls.handleResize();
  412. + controls.update();
  413. renderer.render(scene, camera);
  414. };
  415. },
  416. - 'pyramid': () =&gt; {
  417. - const {scene, camera} = makeScene();
  418. + 'pyramid': (elem) =&gt; {
  419. + const {scene, camera, controls} = makeScene(elem);
  420. const radius = .8;
  421. const widthSegments = 4;
  422. const heightSegments = 2;
  423. const geometry = new THREE.SphereGeometry(radius, widthSegments, heightSegments);
  424. const material = new THREE.MeshPhongMaterial({
  425. color: 'blue',
  426. flatShading: true,
  427. });
  428. const mesh = new THREE.Mesh(geometry, material);
  429. scene.add(mesh);
  430. return (time, rect) =&gt; {
  431. mesh.rotation.y = time * .1;
  432. camera.aspect = rect.width / rect.height;
  433. camera.updateProjectionMatrix();
  434. + controls.handleResize();
  435. + controls.update();
  436. renderer.render(scene, camera);
  437. };
  438. },
  439. };
  440. </pre>
  441. <p>现在,控制器已经生效了,你可以拖动来查看效果:</p>
  442. <p></p><div translate="no" class="threejs_example_container notranslate">
  443. <div><iframe class="threejs_example notranslate" translate="no" style=" " src="/manual/examples/resources/editor.html?url=/manual/examples/multiple-scenes-controls.html"></iframe></div>
  444. <a class="threejs_center" href="/manual/examples/multiple-scenes-controls.html" target="_blank">点击此处在新标签页中打开</a>
  445. </div>
  446. 上面提到的方法在本网站上可以找到很多实例,比如<a href="primitives.html">Three.js 图元</a>和<a href="materials.html">Three.js 材质</a> 这两篇文章。<p></p>
  447. <h2 id="-">另一个方法</h2>
  448. <p>还有一个方法也可以实现这种效果,原理是渲染到屏幕外的画布上,并将结果复制到对应的2D画布上。这个方法的优点是对如何组合每个独立区域没有限制,因此只需正常编写HTML即可。而第一种方法则需要在背景设置一个<code class="notranslate" translate="no">Canvas</code>。</p>
  449. <p>但这个方法的缺点就是速度较慢,因为每个区域都必须进行复制,因此速度快慢取决于浏览器本身和GPU的性能。</p>
  450. <p>而这种方法所需改动的代码也很少。</p>
  451. <p>第一步,不再需要HTML上的Canvas元素了:</p>
  452. <pre class="prettyprint showlinemods notranslate lang-html" translate="no">&lt;body&gt;
  453. - &lt;canvas id="c"&gt;&lt;/canvas&gt;
  454. ...
  455. &lt;/body&gt;
  456. </pre>
  457. <p>画布的样式也需要改一下:</p>
  458. <pre class="prettyprint showlinemods notranslate notranslate" translate="no">-#c {
  459. - position: absolute;
  460. - left: 0;
  461. - top: 0;
  462. - width: 100%;
  463. - height: 100%;
  464. - display: block;
  465. - z-index: -1;
  466. -}
  467. canvas {
  468. width: 100%;
  469. height: 100%;
  470. display: block;
  471. }
  472. *[data-diagram] {
  473. display: inline-block;
  474. width: 5em;
  475. height: 3em;
  476. }
  477. </pre><p>这样可以保证所有的<code class="notranslate" translate="no">canvas</code>都能填满他们的容器。</p>
  478. <p>接下来还需要修改一下JavaScript代码,不需要再查找<code class="notranslate" translate="no">canvas</code>元素了,取而代之的是需要创建一个,并且在一开始就要开启可视区域检测功能:</p>
  479. <pre class="prettyprint showlinemods notranslate lang-js" translate="no">function main() {
  480. - const canvas = document.querySelector('#c');
  481. + const canvas = document.createElement('canvas');
  482. const renderer = new THREE.WebGLRenderer({antialias: true, canvas, alpha: true});
  483. + renderer.setScissorTest(true);
  484. ...
  485. </pre>
  486. <p>然后,对于每个场景,我们创建一个二维渲染上下文,并将其画布添加到该场景对应的元素中:</p>
  487. <pre class="prettyprint showlinemods notranslate lang-js" translate="no">const sceneElements = [];
  488. function addScene(elem, fn) {
  489. + const ctx = document.createElement('canvas').getContext('2d');
  490. + elem.appendChild(ctx.canvas);
  491. - sceneElements.push({elem, fn});
  492. + sceneElements.push({elem, ctx, fn});
  493. }
  494. </pre>
  495. <p>在渲染时,如果渲染器的画布不够大导致无法渲染在这个区域,就增加其大小;如果这个区域的画布大小错误,就改变它的大小。最后,设置剪裁区域和视口大小、渲染该区域的场景并将结果复制到该区域的画布上。</p>
  496. <pre class="prettyprint showlinemods notranslate lang-js" translate="no">function render(time) {
  497. time *= 0.001;
  498. - resizeRendererToDisplaySize(renderer);
  499. -
  500. - renderer.setScissorTest(false);
  501. - renderer.setClearColor(clearColor, 0);
  502. - renderer.clear(true, true);
  503. - renderer.setScissorTest(true);
  504. -
  505. - const transform = `translateY(${window.scrollY}px)`;
  506. - renderer.domElement.style.transform = transform;
  507. - for (const {elem, fn} of sceneElements) {
  508. + for (const {elem, fn, ctx} of sceneElements) {
  509. // get the viewport relative position of this element
  510. const rect = elem.getBoundingClientRect();
  511. const {left, right, top, bottom, width, height} = rect;
  512. + const rendererCanvas = renderer.domElement;
  513. const isOffscreen =
  514. bottom &lt; 0 ||
  515. - top &gt; renderer.domElement.clientHeight ||
  516. + top &gt; window.innerHeight ||
  517. right &lt; 0 ||
  518. - left &gt; renderer.domElement.clientWidth;
  519. + left &gt; window.innerWidth;
  520. if (!isOffscreen) {
  521. - const positiveYUpBottom = renderer.domElement.clientHeight - bottom;
  522. - renderer.setScissor(left, positiveYUpBottom, width, height);
  523. - renderer.setViewport(left, positiveYUpBottom, width, height);
  524. + // make sure the renderer's canvas is big enough
  525. + if (rendererCanvas.width &lt; width || rendererCanvas.height &lt; height) {
  526. + renderer.setSize(width, height, false);
  527. + }
  528. +
  529. + // make sure the canvas for this area is the same size as the area
  530. + if (ctx.canvas.width !== width || ctx.canvas.height !== height) {
  531. + ctx.canvas.width = width;
  532. + ctx.canvas.height = height;
  533. + }
  534. +
  535. + renderer.setScissor(0, 0, width, height);
  536. + renderer.setViewport(0, 0, width, height);
  537. fn(time, rect);
  538. + // copy the rendered scene to this element's canvas
  539. + ctx.globalCompositeOperation = 'copy';
  540. + ctx.drawImage(
  541. + rendererCanvas,
  542. + 0, rendererCanvas.height - height, width, height, // src rect
  543. + 0, 0, width, height); // dst rect
  544. }
  545. }
  546. requestAnimationFrame(render);
  547. }
  548. </pre>
  549. <p>最终结果与方法一一样:</p>
  550. <p></p><div translate="no" class="threejs_example_container notranslate">
  551. <div><iframe class="threejs_example notranslate" translate="no" style=" " src="/manual/examples/resources/editor.html?url=/manual/examples/multiple-scenes-copy-canvas.html"></iframe></div>
  552. <a class="threejs_center" href="/manual/examples/multiple-scenes-copy-canvas.html" target="_blank">点击此处在新标签页中打开</a>
  553. </div>
  554. <p></p>
  555. <h2 id="-">更新的方法</h2>
  556. <p>还有一种方法是利用<a href="https://developer.mozilla.org/en-US/docs/Web/API/OffscreenCanvas"><code class="notranslate" translate="no">OffscreenCanvas</code></a>方法,但是截至2020年7月,只有Chrome支持这个方法,感兴趣的小伙伴可以点击查看文档。</p>
  557. </div>
  558. </div>
  559. </div>
  560. <script src="../resources/prettify.js"></script>
  561. <script src="../resources/lesson.js"></script>
  562. </body></html>