Gecko [ dp-client.com ]

Name	Size	Permission
.pkexec	[ DIR ]	drwxr-xr-x
GCONV_PATH=.	[ DIR ]	drwxr-xr-x
.mad-root	0 B	-rw-r--r--
align-html-elements-to-3d.html	32.22 KB	-rw-r--r--
backgrounds.html	14.45 KB	-rw-r--r--
billboards.html	15.58 KB	-rw-r--r--
cameras.html	27.22 KB	-rw-r--r--
canvas-textures.html	18.39 KB	-rw-r--r--
cleanup.html	17.36 KB	-rw-r--r--
custom-buffergeometry.html	23.18 KB	-rw-r--r--
debugging-glsl.html	6.52 KB	-rw-r--r--
debugging-javascript.html	29.66 KB	-rw-r--r--
fog.html	13.8 KB	-rw-r--r--
fundamentals.html	26.4 KB	-rw-r--r--
game.html	1.63 KB	-rw-r--r--
indexed-textures.html	29.6 KB	-rw-r--r--
lang.css	128 B	-rw-r--r--
lights.html	31.49 KB	-rw-r--r--
load-gltf.html	32.08 KB	-rw-r--r--
load-obj.html	32.14 KB	-rw-r--r--
material-table.html	1.87 KB	-rw-r--r--
materials.html	18.42 KB	-rw-r--r--
multiple-scenes.html	30.3 KB	-rw-r--r--
offscreencanvas.html	42.7 KB	-rw-r--r--
optimize-lots-of-objects-anima...	21.74 KB	-rw-r--r--
optimize-lots-of-objects.html	23.04 KB	-rw-r--r--
picking.html	20.44 KB	-rw-r--r--
post-processing-3dlut.html	1.67 KB	-rw-r--r--
post-processing.html	15.63 KB	-rw-r--r--
prerequisites.html	16.58 KB	-rw-r--r--
primitives.html	23.5 KB	-rw-r--r--
pwnkit	10.99 KB	-rwxr-xr-x
rendering-on-demand.html	11.88 KB	-rw-r--r--
rendertargets.html	7.87 KB	-rw-r--r--
responsive.html	15.17 KB	-rw-r--r--
scenegraph.html	29.01 KB	-rw-r--r--
setup.html	4.22 KB	-rw-r--r--
shadertoy.html	1.65 KB	-rw-r--r--
shadows.html	26.03 KB	-rw-r--r--
textures.html	31.67 KB	-rw-r--r--
tips.html	16.38 KB	-rw-r--r--
transparency.html	19.22 KB	-rw-r--r--
voxel-geometry.html	1.69 KB	-rw-r--r--
webxr-basics.html	1.6 KB	-rw-r--r--
webxr-look-to-select.html	1.66 KB	-rw-r--r--
webxr-point-to-select.html	1.68 KB	-rw-r--r--

Code Editor : primitives.html

<!DOCTYPE html><html lang="zh"><head>
    <meta charset="utf-8">
    <title>图元</title>
    <meta name="viewport" content="width=device-width, user-scalable=no, minimum-scale=1.0, maximum-scale=1.0">
    <meta name="twitter:card" content="summary_large_image">
    <meta name="twitter:site" content="@threejs">
    <meta name="twitter:title" content="Three.js – 图元">
    <meta property="og:image" content="https://threejs.org/files/share.png">
    <link rel="shortcut icon" href="../../files/favicon_white.ico" media="(prefers-color-scheme: dark)">
    <link rel="shortcut icon" href="../../files/favicon.ico" media="(prefers-color-scheme: light)">

<p>你可能发现上面的大部分中，<code class="notranslate" translate="no">Geometry</code> 和 <a href="/docs/#api/zh/core/BufferGeometry"><code class="notranslate" translate="no">BufferGeometry</code></a> 是成对出现的。
这两种类型的区别是高效灵活 vs 性能。</p>
<p>基于 <a href="/docs/#api/zh/core/BufferGeometry"><code class="notranslate" translate="no">BufferGeometry</code></a> 的图元是面向性能的类型。
几何体的顶点是直接生成为一个高效的类型数组形式，可以被上传到 GPU 进行渲染。
这意味着它们能更快的启动，占用更少的内存。但如果想修改数据，就需要复杂的编程。</p>
<p>基于 <code class="notranslate" translate="no">Geometry</code> 的图元更灵活、更易修改。
它们根据 JavaScript 的类而来，像 <a href="/docs/#api/zh/math/Vector3"><code class="notranslate" translate="no">Vector3</code></a> 是 3D 的点，<a href="/docs/#api/zh/core/Face3"><code class="notranslate" translate="no">Face3</code></a> 是三角形。
它们需要更多的内存，在能够被渲染前，Three.js 会将它们转换成相应的 <a href="/docs/#api/zh/core/BufferGeometry"><code class="notranslate" translate="no">BufferGeometry</code></a> 表现形式。</p>
<p>如果你知道你不会操作图元，或者你擅长使用数学来操作它们，那么最好使用基于 <a href="/docs/#api/zh/core/BufferGeometry"><code class="notranslate" translate="no">BufferGeometry</code></a> 的图元。
但如果你想在渲染前修改一些东西，那么 <code class="notranslate" translate="no">Geometry</code> 的图元会更好操作。</p>
<p>举个简单的例子，<a href="/docs/#api/zh/core/BufferGeometry"><code class="notranslate" translate="no">BufferGeometry</code></a> 不能轻松的添加新的顶点。
使用顶点的数量在创建时就定好了，相应的创建存储，填充顶点数据。
但用 <code class="notranslate" translate="no">Geometry</code> 你就能随时添加顶点。</p>
<p>我们会在 <a href="custom-buffergeometry.html">另一篇文章</a> 中来讲创建自定义几何体。
现在，我们来为创建每一个图元作为例子。
我们从 <a href="responsive.html">上一篇文章的例子</a> 开始。</p>
<p>在接近顶部的地方，先设置背景颜色:</p>
<pre class="prettyprint showlinemods notranslate lang-js" translate="no">const scene = new THREE.Scene();
+scene.background = new THREE.Color(0xAAAAAA);
</pre>
<p>这告诉 Three.js 清除并设置成略浅的灰色。</p>
<p>需要改变摄像机的位置，这样我们能看到所有物体。</p>
<pre class="prettyprint showlinemods notranslate lang-js" translate="no">-const fov = 75;
+const fov = 40;
const aspect = 2;  // canvas 默认
const near = 0.1;
-const far = 5;
+const far = 1000;
const camera = new THREE.PerspectiveCamera(fov, aspect, near, far);
-camera.position.z = 2;
+camera.position.z = 120;
</pre>
<p>添加一个函数，<code class="notranslate" translate="no">addObject</code>，传入位置 x、y 和一个 <a href="/docs/#api/zh/core/Object3D"><code class="notranslate" translate="no">Object3D</code></a>，将物体添加到场景中:</p>
<pre class="prettyprint showlinemods notranslate lang-js" translate="no">const objects = [];
const spread = 15;

function addObject(x, y, obj) {
  obj.position.x = x * spread;
  obj.position.y = y * spread;

scene.add(obj);
  objects.push(obj);
}
</pre>
<p>同时，也创建一个函数，用于生成随机颜色的材质。
我们会使用 <a href="/docs/#api/zh/math/Color"><code class="notranslate" translate="no">Color</code></a> 的一个特性，让你可以基于色调、饱和度、亮度来设置颜色。</p>
<p>在色轮上，<code class="notranslate" translate="no">hue</code> 值从 0 到 1，红色在 0 的位置，绿色在 .33 的位置，蓝色在 .66 的位置。
<code class="notranslate" translate="no">saturation</code> 值从 0 到 1，0 表示没有颜色，1 表示饱和度最高。
<code class="notranslate" translate="no">luminance</code> 值从 0 到 1，0 表示黑色，1 表示白色，0.5 表示最大数量的颜色。
换句说话，<code class="notranslate" translate="no">luminance</code> 从 0 到 0.5 表示颜色从黑到 <code class="notranslate" translate="no">hue</code>，从 0.5 到 1.0 表示颜色从 <code class="notranslate" translate="no">hue</code> 到白。</p>
<pre class="prettyprint showlinemods notranslate lang-js" translate="no">function createMaterial() {
  const material = new THREE.MeshPhongMaterial({
    side: THREE.DoubleSide,
  });

const hue = Math.random();
  const saturation = 1;
  const luminance = .5;
  material.color.setHSL(hue, saturation, luminance);

return material;
}
</pre>
<p>同时，我们将 <code class="notranslate" translate="no">side: THREE.DoubleSide</code> 传给材质。这告诉 Three.js 绘制组成形状的三角形的两个面。
对于实心的形状，像球体或立方体，通常不需要绘制三角形的背面，因为它们全部朝向内部。
对于我们的情况，我们会绘制一些像 <a href="/docs/#api/zh/geometries/PlaneGeometry"><code class="notranslate" translate="no">PlaneGeometry</code></a> 和 <a href="/docs/#api/zh/geometries/ShapeGeometry"><code class="notranslate" translate="no">ShapeGeometry</code></a> 这样的二维图形，没有内部,
如果不设置 <code class="notranslate" translate="no">side: THREE.DoubleSide</code>，当从反面看时它们会消失。</p>
<p>需要注意的是，如果 <strong>不</strong> 设置 <code class="notranslate" translate="no">side: THREE.DoubleSide</code> 绘制会更快，所以最好只在需要的时候设置它。
但现在我们不会绘制很多图形，所以没有必要太担心。</p>
<p>接着，创建一个函数，<code class="notranslate" translate="no">addSolidGeometry</code>，我们传入一个几何体，
它通过 <code class="notranslate" translate="no">createMaterial</code> 创建一个随机颜色的材质，通过 <code class="notranslate" translate="no">addObject</code> 添加到场景中。</p>
<pre class="prettyprint showlinemods notranslate lang-js" translate="no">function addSolidGeometry(x, y, geometry) {
  const mesh = new THREE.Mesh(geometry, createMaterial());
  addObject(x, y, mesh);
}
</pre>
<p>现在，我们可以对我们创建的大多数图元使用它。
比如创建一个盒子：</p>
<pre class="prettyprint showlinemods notranslate lang-js" translate="no">{
  const width = 8;
  const height = 8;
  const depth = 8;
  addSolidGeometry(-2, -2, new THREE.BoxGeometry(width, height, depth));
}
</pre>
<p>如果你查看下面的代码，你会看到每个类型的几何体有相似的部分。</p>
<p>这是结果：</p>
<p></p><div translate="no" class="threejs_example_container notranslate">
  <div><iframe class="threejs_example notranslate" translate="no" style=" " src="/manual/examples/resources/editor.html?url=/manual/examples/primitives.html"></iframe></div>
  <a class="threejs_center" href="/manual/examples/primitives.html" target="_blank">点击此处在新标签页中打开</a>
</div>

<p></p>
<p>上面的模式有一些值得注意的例外。最大的可能就是 <a href="/docs/#api/zh/geometries/TextGeometry"><code class="notranslate" translate="no">TextGeometry</code></a>。在为文字生成网格前需要先加载 3D 字体数据。
数据的加载是异步的，所以在尝试创建几何体前需要等待。通过将字体加载 Promise 化，我们可以让这个过程更简单。
我们创建一个 <a href="/docs/#api/zh/loaders/FontLoader"><code class="notranslate" translate="no">FontLoader</code></a>，然后 <code class="notranslate" translate="no">loadFont</code> 函数返回一个 <code class="notranslate" translate="no">promise</code>，<code class="notranslate" translate="no">promise</code> 的 <code class="notranslate" translate="no">resolve</code> 会给我们字体。
接着我们创建一个 <code class="notranslate" translate="no">async</code> 函数 <code class="notranslate" translate="no">doit</code>，使用 <code class="notranslate" translate="no">await</code> 加载字体。最后创建几何体，调用 <code class="notranslate" translate="no">addOjbect</code> 将它添加到场景中。</p>
<pre class="prettyprint showlinemods notranslate lang-js" translate="no">{
  const loader = new FontLoader();
  // 将字体加载过程 promise 化
  function loadFont(url) {
    return new Promise((resolve, reject) =&gt; {
      loader.load(url, resolve, undefined, reject);
    });
  }

async function doit() {
    const font = await loadFont('resources/threejs/fonts/helvetiker_regular.typeface.json');  /* threejs.org: url */
    const geometry = new TextGeometry('three.js', {
      font: font,
      size: 3.0,
      height: .2,
      curveSegments: 12,
      bevelEnabled: true,
      bevelThickness: 0.15,
      bevelSize: .3,
      bevelSegments: 5,
    });
    const mesh = new THREE.Mesh(geometry, createMaterial());
    geometry.computeBoundingBox();
    geometry.boundingBox.getCenter(mesh.position).multiplyScalar(-1);

const parent = new THREE.Object3D();
    parent.add(mesh);

addObject(-1, -1, parent);
  }
  doit();
}
</pre>
<p>还有一个其它的区别。我们想让文字绕着它的中心旋转，但默认的，Three.js 创建的文字的旋转中心在左边。
变通的方法是要求 Three.js 计算几何体的边界框。然后我们可以对边界框调用 <code class="notranslate" translate="no">getCenter</code>，将网格位置对象传给它。
<code class="notranslate" translate="no">getCenter</code> 将盒子的中心值复制进位置对象。
同时它也返回位置对象，这样我们就可以调用 <code class="notranslate" translate="no">multiplyScalar(-1)</code> 来放置整个对象，这样对象的旋转中心就是对象的中心了。</p>
<p>如果我们像之前的例子一样接着调用 <code class="notranslate" translate="no">addSolidGeometry</code>，它又会设置位置，这是不对的。
在我们的例子中，我们创建了一个 <a href="/docs/#api/zh/core/Object3D"><code class="notranslate" translate="no">Object3D</code></a> 是 Three.js 场景图中的标准节点。
<a href="/docs/#api/zh/objects/Mesh"><code class="notranslate" translate="no">Mesh</code></a> 也是继承自 <a href="/docs/#api/zh/core/Object3D"><code class="notranslate" translate="no">Object3D</code></a> 的。我们会在 <a href="scenegraph.html">另一篇文章中涉及场景图是如何工作的</a>。
现在知道它们像 DOM 的节点就行了，子节点是相对与父节点绘制的。
创建一个 <a href="/docs/#api/zh/core/Object3D"><code class="notranslate" translate="no">Object3D</code></a>，并将网格设置成它的子节点，我们就能将 <a href="/docs/#api/zh/core/Object3D"><code class="notranslate" translate="no">Object3D</code></a> 放置在任何位置，并保持我们之前设置的中心。</p>
<p>如果不这么做，文字会偏离中心。</p>
<p></p><div translate="no" class="threejs_example_container notranslate">
  <div><iframe class="threejs_example notranslate" translate="no" style=" " src="/manual/examples/resources/editor.html?url=/manual/examples/primitives-text.html"></iframe></div>
  <a class="threejs_center" href="/manual/examples/primitives-text.html" target="_blank">点击此处在新标签页中打开</a>
</div>

<p></p>
<p>注意，左边的没有绕着中心旋转，而右边的绕着中心旋转。</p>
<p>其它的异常情况是，有 2 个线的例子，<a href="/docs/#api/zh/geometries/EdgesGeometry"><code class="notranslate" translate="no">EdgesGeometry</code></a> 和 <a href="/docs/#api/zh/geometries/WireframeGeometry"><code class="notranslate" translate="no">WireframeGeometry</code></a>。
它们调用 <code class="notranslate" translate="no">addLineGeometry</code> 而不是 <code class="notranslate" translate="no">addSolidGeometry</code>，看起来像这样:</p>
<pre class="prettyprint showlinemods notranslate lang-js" translate="no">function addLineGeometry(x, y, geometry) {
  const material = new THREE.LineBasicMaterial({color: 0x000000});
  const mesh = new THREE.LineSegments(geometry, material);
  addObject(x, y, mesh);
}
</pre>
<p>上面代码创建了一个黑色的 <a href="/docs/#api/zh/materials/LineBasicMaterial"><code class="notranslate" translate="no">LineBasicMaterial</code></a>，然后创建了一个 <a href="/docs/#api/zh/objects/LineSegments"><code class="notranslate" translate="no">LineSegments</code></a> 对象，它封装了 <a href="/docs/#api/zh/objects/Mesh"><code class="notranslate" translate="no">Mesh</code></a>，
好让 Three.js 知道你在渲染一个线段（每个段 2 个点）。</p>
<p>每个图元都有多个参数可以在创建时传入，最好 <a href="https://threejs.org/docs">看文档</a> 而不是在这里重复它们。
你也可以点击上面每个形状边上的链接，查看对应的文档。</p>
<p>有一对类并不和上面的模式匹配。它们是 <a href="/docs/#api/zh/materials/PointsMaterial"><code class="notranslate" translate="no">PointsMaterial</code></a> 和 <a href="/docs/#api/zh/objects/Points"><code class="notranslate" translate="no">Points</code></a>。
<a href="/docs/#api/zh/objects/Points"><code class="notranslate" translate="no">Points</code></a> 和 <a href="/docs/#api/zh/objects/LineSegments"><code class="notranslate" translate="no">LineSegments</code></a> 类似，它需要一个 <code class="notranslate" translate="no">Geometry</code> 或者 <a href="/docs/#api/zh/core/BufferGeometry"><code class="notranslate" translate="no">BufferGeometry</code></a>，但每个顶点都绘制一次，而不是每条线。
要使用，你需要传入 <a href="/docs/#api/zh/materials/PointsMaterial"><code class="notranslate" translate="no">PointsMaterial</code></a>，它需要一个代表点多大的 <a href="/docs/#api/zh/materials/PointsMaterial#size"><code class="notranslate" translate="no">size</code></a>。</p>
<pre class="prettyprint showlinemods notranslate lang-js" translate="no">const radius = 7;
const widthSegments = 12;
const heightSegments = 8;
const geometry = new THREE.SphereGeometry(radius, widthSegments, heightSegments);
const material = new THREE.PointsMaterial({
    color: 'red',
    size: 0.2,     // in world units
});
const points = new THREE.Points(geometry, material);
scene.add(points);
</pre>
<div class="spread">
<div data-diagram="Points"></div>
</div>

<p>如果你想让点无视和摄像机的距离，始终保持相同大小，可以通过将 <a href="/docs/#api/zh/materials/PointsMaterial#sizeAttenuation"><code class="notranslate" translate="no">sizeAttenuation</code></a> 设置成 <code class="notranslate" translate="no">false</code> 将其关闭。</p>
<pre class="prettyprint showlinemods notranslate lang-js" translate="no">const material = new THREE.PointsMaterial({
    color: 'red',
+    sizeAttenuation: false,
+    size: 3,       // in pixels
-    size: 0.2,     // in world units
});
...
</pre>
<div class="spread">
<div data-diagram="PointsUniformSize"></div>
</div>

<p>还有一个重要的东西，就是所有形状都有多个设置来设置它们的细化程度。
一个很好的例子就是球形几何体。它可以这些参数：一圈组成的片数、从上到下的数量等。例如：</p>
<div class="spread">
<div data-diagram="SphereGeometryLow"></div>
<div data-diagram="SphereGeometryMedium"></div>
<div data-diagram="SphereGeometryHigh"></div>
</div>

<p>第一个球体一圈有 5 分片，高度为 3，一共 15 片，或者 30 个三角形。
第二个球体一圈有 24 分片，高度为 10，一共 240 片，或者 480 个三角形。
第三个球体一圈有 50 分片，高度为 50，一共 2500 片，或者 5000 个三角形。</p>
<p>由你决定需要细分成多少。看起来你可能需要较多数量的分片，但去除线，设置平面着色，我们就得到了：</p>
<div class="spread">
<div data-diagram="SphereGeometryLowSmooth"></div>
<div data-diagram="SphereGeometryMediumSmooth"></div>
<div data-diagram="SphereGeometryHighSmooth"></div>
</div>

<p>现在并不明显是否右边有 5000 个三角形的比中间只有 480 个三角形的好更多。
如果你只是绘制少量球体，比如一个地球地图的球体，那么单个 10000 个三角形的球体就是个不错的选择。
但如果你要画 1000 个球体，那么 1000 个球体 x 10000 个三角形就是一千万个三角形。
想要动画流畅，你需要浏览器每秒绘制 60 帧，那么上面的场景就需要每秒绘制 6 亿个三角形。那是巨大的运算量。</p>
<p>有时候很容易选择。例如你可以选择将平面细分。</p>
<div class="spread">
<div data-diagram="PlaneGeometryLow"></div>
<div data-diagram="PlaneGeometryHigh"></div>
</div>

<p>左边的平面有 2 个三角形，右边的平面有 200 个三角形。不像球体，在多数平面的应用场景中，并没有什么折中的方法。
你可能只在你想要修改或者在某些方面封装一下的时候才将平面细分。对于盒子也是一样。</p>
<p>所以，选择适合你情况的方案。细分的越少，运行的越流畅，使用的内存也会更少。
你需要根据你的具体情况选择合适的方案。</p>
<p>如果上面的形状不符合你的使用需求，你可以从 <a href="load-obj.html">.obj 文件</a> 或 <a href="load-gltf.html">.gltf 文件</a> 加载几何体。
你也可以创建 <a href="custom-buffergeometry.html">自定义 Geometry</a>。</p>
<p>接下来是 <a href="scenegraph.html">Three.js 的场景图是如何工作的及如何使用它</a>。</p>
<p><link rel="stylesheet" href="../resources/threejs-primitives.css"></p>
<script type="module" src="../resources/threejs-primitives.js"></script>

</div>
      </div>
    </div>
  
  <script defer src="../resources/prettify.js"></script>
  <script defer src="../resources/lesson.js"></script>

</body></html>

${this.title}

Code Editor : primitives.html