|
|
<!DOCTYPE html><html lang="ru"><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)">
|
|
|
|
|
|
<link rel="stylesheet" href="../resources/lesson.css">
|
|
|
<link rel="stylesheet" href="../resources/lang.css">
|
|
|
<script type="importmap">
|
|
|
{
|
|
|
"imports": {
|
|
|
"three": "../../build/three.module.js"
|
|
|
}
|
|
|
}
|
|
|
</script>
|
|
|
</head>
|
|
|
<body>
|
|
|
<div class="container">
|
|
|
<div class="lesson-title">
|
|
|
<h1>Основы </h1>
|
|
|
</div>
|
|
|
<div class="lesson">
|
|
|
<div class="lesson-main">
|
|
|
<p></p>
|
|
|
<p>Это первая статья в серии статей о three.js.
|
|
|
<a href="https://threejs.org">Three.js</a> это 3D-библиотека, которая максимально
|
|
|
упрощает создание 3D-контента на веб-странице.</p>
|
|
|
<p>Three.js часто путают с WebGL, поскольку чаще всего,
|
|
|
но не всегда, three.js использует WebGL для рисования 3D.
|
|
|
<a href="https://webglfundamentals.org">WebGL - это очень низкоуровневое api, рисующее только точки, линии и треугольники</a>.
|
|
|
Чтобы сделать что-нибудь полезное с WebGL, как правило, требуется немало кода,
|
|
|
и именно здесь приходит Three.js. Он обрабатывает такие вещи, как сцены,
|
|
|
источники света, тени, материалы, текстуры, 3D-математику, все,
|
|
|
что вам нужно было бы написать самостоятельно, если бы вы использовали WebGL напрямую.</p>
|
|
|
<p>В этих руководствах предполагается, что вы уже знаете JavaScript,
|
|
|
и по большей части они будут использовать стандарт ES6+. <a href="prerequisites.html">Смотрите здесь
|
|
|
краткий список вещей, которые вы, как ожидается, уже знаете</a>.
|
|
|
Большинство браузеров, которые поддерживают three.js,
|
|
|
обновляются автоматически, поэтому большинство пользователей
|
|
|
должны иметь возможность запускать этот код. Если вы хотите,
|
|
|
чтобы этот код запускался в действительно старых браузерах,
|
|
|
посмотрите на транспайлер, такой как <a href="http://babeljs.io">Babel</a>.
|
|
|
Конечно, пользователи, использующие действительно старые браузеры,
|
|
|
вероятно, имеют машины, которые не могут запускать three.js.</p>
|
|
|
<p>При изучении большинства языков программирования первое, что делают люди,
|
|
|
это заставляют компьютер напечатать <code class="notranslate" translate="no">"Hello World!"</code>. Для 3D одна из самых
|
|
|
распространенных задач - создать 3D-куб, так что давайте начнем с <code class="notranslate" translate="no">"Hello Cube!"</code></p>
|
|
|
<p>Первое, что нам нужно, это тэг <code class="notranslate" translate="no"><canvas></code>:</p>
|
|
|
<pre class="prettyprint showlinemods notranslate notranslate" translate="no"><body>
|
|
|
<canvas id="c"></canvas>
|
|
|
</body>
|
|
|
</pre><p>Three.js будет рисовать на этом холсте, так что нам нужно найти
|
|
|
его и передать three.js.</p>
|
|
|
<pre class="prettyprint showlinemods notranslate notranslate" translate="no"><script type="module">
|
|
|
import * as THREE from 'three';
|
|
|
|
|
|
function main() {
|
|
|
const canvas = document.querySelector('#c');
|
|
|
const renderer = new THREE.WebGLRenderer({antialias: true, canvas});
|
|
|
...
|
|
|
</script>
|
|
|
</pre><p>Обратите внимание, что здесь есть некоторые не явные детали.
|
|
|
Если вы не передадите холст в three.js, библиотека создаст его за вас,
|
|
|
но затем нужно будет добавить его в DOM. Место добавления
|
|
|
может меняться в зависимости от вашего варианта использования,
|
|
|
и вам придется изменить свой код, поэтому я считаю, что передача canvas
|
|
|
в three.js выглядит немного более гибкой. Я могу поместить холст где угодно,
|
|
|
и код найдет его там, как если бы у меня был код для вставки холста в документ,
|
|
|
и мне, вероятно, пришлось бы изменить этот код, если бы изменился мой вариант
|
|
|
использования.</p>
|
|
|
<p>Когда канвас найден, мы создаем <a href="/docs/#api/en/renderers/WebGLRenderer"><code class="notranslate" translate="no">WebGLRenderer</code></a>. Renderer - это то, что отвечает
|
|
|
за фактическое получение всех предоставленных вами данных и их отрисовку на холст.</p>
|
|
|
<p>Далее нам нужна камера.</p>
|
|
|
<pre class="prettyprint showlinemods notranslate notranslate" translate="no">const fov = 75;
|
|
|
const aspect = 2; // значение для canvas по умолчанию
|
|
|
const near = 0.1;
|
|
|
const far = 5;
|
|
|
const camera = new THREE.PerspectiveCamera(fov, aspect, near, far);
|
|
|
</pre><p><code class="notranslate" translate="no">fov</code> сокращение от <code class="notranslate" translate="no">field of view</code>, <a href="https://en.wikipedia.org/wiki/Field_of_view">поле зрения</a>. В этом случае 75 градусов в
|
|
|
вертикальном измерении. Обратите внимание, что большинство углов в Three.js
|
|
|
указаны в радианах, но по какой-то причине перспективная камера принимает градусы.</p>
|
|
|
<p><code class="notranslate" translate="no">aspect</code> это <a href="https://ru.wikipedia.org/wiki/Соотношение_сторон_экрана">соотношение сторон холста</a> (англ. aspect ratio). Мы рассмотрим детали
|
|
|
в другой статье, но по умолчанию холст имеет размер 300x150 пикселей,
|
|
|
значит соотношение сторон 300/150 или 2.</p>
|
|
|
<p><code class="notranslate" translate="no">near</code> и <code class="notranslate" translate="no">far</code> представляют пространство перед камерой, которое будет отображаться.
|
|
|
Все, что находится до или после этого диапазона, будет обрезано (не нарисовано).</p>
|
|
|
<p>Эти 4 параметра определяют <a href="https://ru.wikipedia.org/wiki/Усечённая_пирамида">усеченную пирамиду</a> <em>"frustum"</em>. <em>Frustum</em> это
|
|
|
название 3D фигуры, напоминающей пирамиду с отсеченной верхушкой. Другими словами,
|
|
|
думайте о слове "frustum" как о трехмерной фигуре,
|
|
|
такой как сфера, куб и призма.</p>
|
|
|
<p><img src="../resources/frustum-3d.svg" width="500" class="threejs_center"></p>
|
|
|
<p>Высота ближней и дальней плоскостей определяется полем зрения (field of view).
|
|
|
Ширина обеих плоскостей определяется полем зрения и соотношением сторон (aspect).</p>
|
|
|
<p>Все, что находится внутри определенного усеченного контура, будет нарисовано.
|
|
|
Снаружи ничего не будет.</p>
|
|
|
<p>По умолчанию камера смотрит вниз по оси -Z и вверх по оси +Y. Мы поместим наш куб
|
|
|
в начало координат (origin), поэтому нам нужно немного отодвинуть камеру назад,
|
|
|
чтобы что-то увидеть.</p>
|
|
|
<pre class="prettyprint showlinemods notranslate notranslate" translate="no">camera.position.z = 2;
|
|
|
</pre><p>Вот как мы её направили.</p>
|
|
|
<p><img src="../resources/scene-down.svg" width="500" class="threejs_center"></p>
|
|
|
<p>На диаграмме выше мы видим, что наша камера находится в <code class="notranslate" translate="no">z = 2</code>. И смотрит вниз по оси -Z.
|
|
|
Усеченная пирамида начинается с 0.1 единицы спереди камеры и до 5 единиц перед камерой.
|
|
|
Поскольку на этой диаграмме мы смотрим вниз, поле зрения (fov) зависит от отношения
|
|
|
сторон (aspect). Так как ширина холста в 2 раза больше высоты, при просмотре поле обзора
|
|
|
будет намного шире, чем указанные нами 75 градусов, которые являются вертикальным
|
|
|
полем зрения.</p>
|
|
|
<p>Далее создадим <a href="/docs/#api/en/scenes/Scene"><code class="notranslate" translate="no">Scene</code></a>. <a href="/docs/#api/en/scenes/Scene"><code class="notranslate" translate="no">Scene</code></a> в three.js корень формы графа сцены.
|
|
|
Все, что вы хотите нарисовать необходимо добавить на сцену. Мы рассмотрим подробнее,
|
|
|
<a href="scenegraph.html">как работают сцены, в следующей статье</a>.</p>
|
|
|
<pre class="prettyprint showlinemods notranslate notranslate" translate="no">const scene = new THREE.Scene();
|
|
|
</pre><p>Далее мы создаем <a href="/docs/#api/en/geometries/BoxGeometry"><code class="notranslate" translate="no">BoxGeometry</code></a> который содержит данные для <a href="https://ru.wikipedia.org/wiki/Прямоугольный_параллелепипед">прямоугольного параллелепипеда</a>.
|
|
|
Почти все, что мы хотим отобразить в Three.js, нуждается в геометрии,
|
|
|
которая определяет вершины нашего трехмерного объекта.</p>
|
|
|
<pre class="prettyprint showlinemods notranslate notranslate" translate="no">const boxWidth = 1;
|
|
|
const boxHeight = 1;
|
|
|
const boxDepth = 1;
|
|
|
const geometry = new THREE.BoxGeometry(boxWidth, boxHeight, boxDepth);
|
|
|
</pre><p>Затем мы создаем основной материал и устанавливаем его цвет.
|
|
|
Цвета могут быть определены с использованием 6-значных шестнадцатеричных
|
|
|
значений цвета, как в CSS.</p>
|
|
|
<pre class="prettyprint showlinemods notranslate notranslate" translate="no">const material = new THREE.MeshBasicMaterial({color: 0x44aa88});
|
|
|
</pre><p>Затем мы создаем <a href="https://ru.wikipedia.org/wiki/Полигональная_сетка">полигональную сетку</a>
|
|
|
<a href="/docs/#api/en/objects/Mesh"><code class="notranslate" translate="no">Mesh</code></a>. <a href="/docs/#api/en/objects/Mesh"><code class="notranslate" translate="no">Mesh</code></a> в three.js представляет комбинацию
|
|
|
формы объекта <code class="notranslate" translate="no">Geometry</code> и <a href="/docs/#api/en/materials/Material"><code class="notranslate" translate="no">Material</code></a> (как нарисовать объект,
|
|
|
блестящий или плоский, какой цвет, какую текстуру(ры) применить и т.д.)
|
|
|
а также положение, ориентацию, и масштаб этого объекта в сцене.</p>
|
|
|
<pre class="prettyprint showlinemods notranslate notranslate" translate="no">const cube = new THREE.Mesh(geometry, material);
|
|
|
</pre><p>И, наконец, мы добавляем <a href="/docs/#api/en/objects/Mesh"><code class="notranslate" translate="no">Mesh</code></a> на сцену</p>
|
|
|
<pre class="prettyprint showlinemods notranslate notranslate" translate="no">scene.add(cube);
|
|
|
</pre><p>Затем мы можем отрендерить сцену, вызвав функцию <code class="notranslate" translate="no">render</code> рендерера
|
|
|
передав ей сцену и камеру.</p>
|
|
|
<pre class="prettyprint showlinemods notranslate notranslate" translate="no">renderer.render(scene, camera);
|
|
|
</pre><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/fundamentals.html"></iframe></div>
|
|
|
<a class="threejs_center" href="/manual/examples/fundamentals.html" target="_blank">нажмите здесь, чтобы открыть в отдельном окне</a>
|
|
|
</div>
|
|
|
|
|
|
<p></p>
|
|
|
<p>Трудно сказать, что это 3D-куб, так как мы видим его непосредственно по оси
|
|
|
-Z, а сам куб выровнен по этой оси, поэтому мы видим только одну грань.</p>
|
|
|
<p>Давайте оживим его, и, надеюсь, это прояснит, что он рисуется в 3D. Для его
|
|
|
анимации мы будем отрисовывать внутри цикла отрисовки, используя
|
|
|
<a href="https://developer.mozilla.org/en-US/docs/Web/API/window/requestAnimationFrame"><code class="notranslate" translate="no">requestAnimationFrame</code></a>.</p>
|
|
|
<p>Вот наш цикл</p>
|
|
|
<pre class="prettyprint showlinemods notranslate notranslate" translate="no">function render(time) {
|
|
|
time *= 0.001; // конвертировать время в секунды
|
|
|
|
|
|
cube.rotation.x = time;
|
|
|
cube.rotation.y = time;
|
|
|
|
|
|
renderer.render(scene, camera);
|
|
|
|
|
|
requestAnimationFrame(render);
|
|
|
}
|
|
|
requestAnimationFrame(render);
|
|
|
</pre><p><code class="notranslate" translate="no">requestAnimationFrame</code> это запрос к браузеру, что вы хотите что-то анимировать.
|
|
|
Вы передаете ему функцию для вызова. В нашем случае эта функция <code class="notranslate" translate="no">render</code>.
|
|
|
Браузер вызовет вашу функцию, и если вы обновите что-либо, связанное с
|
|
|
отображением страницы, браузер выполнит перерисовку страницы.
|
|
|
В нашем случае мы вызываем <code class="notranslate" translate="no">renderer.render</code>, которая нарисует нашу сцену.</p>
|
|
|
<p><code class="notranslate" translate="no">requestAnimationFrame</code> передает время с момента загрузки страницы в нашу функцию.
|
|
|
Это время приходит в миллисекундах. Я считаю, что работать с секундами намного проще,
|
|
|
поэтому здесь мы конвертируем время в секунды.</p>
|
|
|
<p>Затем мы устанавливаем вращение куба по X и Y на текущее время. Эти повороты в
|
|
|
<a href="https://ru.wikipedia.org/wiki/Радиан">радианах</a>. В круге 2 пи радиана,
|
|
|
поэтому наш куб должен повернуться вокруг каждой оси примерно за 6.28
|
|
|
секунд.</p>
|
|
|
<p>Затем мы отрисовываем сцену и запрашиваем еще один кадр анимации,
|
|
|
чтобы продолжить наш цикл.</p>
|
|
|
<p>Вне цикла мы вызываем <code class="notranslate" translate="no">requestAnimationFrame</code> один раз, чтобы запустить цикл.</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/fundamentals-with-animation.html"></iframe></div>
|
|
|
<a class="threejs_center" href="/manual/examples/fundamentals-with-animation.html" target="_blank">нажмите здесь, чтобы открыть в отдельном окне</a>
|
|
|
</div>
|
|
|
|
|
|
<p></p>
|
|
|
<p>Это немного лучше, но все еще трудно увидеть 3d. Что может помочь, так это
|
|
|
добавить немного освещения, поэтому давайте добавим источник света.
|
|
|
В Three.js есть много разных источников света, о которых мы поговорим в
|
|
|
следующей статье. А пока давайте создадим направленный свет.</p>
|
|
|
<pre class="prettyprint showlinemods notranslate notranslate" translate="no">{
|
|
|
const color = 0xFFFFFF;
|
|
|
const intensity = 3;
|
|
|
const light = new THREE.DirectionalLight(color, intensity);
|
|
|
light.position.set(-1, 2, 4);
|
|
|
scene.add(light);
|
|
|
}
|
|
|
</pre><p>Направленные источники имеет положение и цель. Оба по умолчанию равны 0, 0, 0. В нашем
|
|
|
случае мы устанавливаем положение источника света на -1, 2, 4 чтобы оно было немного слева,
|
|
|
сверху и позади нашей камеры. Цель по-прежнему 0, 0, 0, поэтому они будут светить
|
|
|
в направлении начала координат.</p>
|
|
|
<p>Нам также нужно изменить материал. <a href="/docs/#api/en/materials/MeshBasicMaterial"><code class="notranslate" translate="no">MeshBasicMaterial</code></a> не воспреимчив к свету.
|
|
|
Давайте изменим его на <a href="/docs/#api/en/materials/MeshPhongMaterial"><code class="notranslate" translate="no">MeshPhongMaterial</code></a>, который отражает свет.</p>
|
|
|
<pre class="prettyprint showlinemods notranslate notranslate" translate="no">-const material = new THREE.MeshBasicMaterial({color: 0x44aa88}); // greenish blue
|
|
|
+const material = new THREE.MeshPhongMaterial({color: 0x44aa88}); // greenish blue
|
|
|
</pre><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/fundamentals-with-light.html"></iframe></div>
|
|
|
<a class="threejs_center" href="/manual/examples/fundamentals-with-light.html" target="_blank">нажмите здесь, чтобы открыть в отдельном окне</a>
|
|
|
</div>
|
|
|
|
|
|
<p></p>
|
|
|
<p>Теперь должно быть довольно четко видно 3D.</p>
|
|
|
<p>Просто для удовольствия добавим еще 2 кубика.</p>
|
|
|
<p>Мы будем использовать одну и ту же геометрию для каждого куба, но
|
|
|
создадим другой материал, чтобы каждый куб мог иметь свой цвет.</p>
|
|
|
<p>Сначала мы сделаем функцию, которая создает новый материал с указанным цветом.
|
|
|
Затем создает mesh, используя указанную геометрию, добавляет ее к сцене и
|
|
|
устанавливает ей позицию X.</p>
|
|
|
<pre class="prettyprint showlinemods notranslate notranslate" translate="no">function makeInstance(geometry, color, x) {
|
|
|
const material = new THREE.MeshPhongMaterial({color});
|
|
|
|
|
|
const cube = new THREE.Mesh(geometry, material);
|
|
|
scene.add(cube);
|
|
|
|
|
|
cube.position.x = x;
|
|
|
|
|
|
return cube;
|
|
|
}
|
|
|
</pre><p>Затем мы будем вызывать его 3 раза с 3 разными цветами и позициями X,
|
|
|
сохраняя экземпляры <a href="/docs/#api/en/objects/Mesh"><code class="notranslate" translate="no">Mesh</code></a> в массив.</p>
|
|
|
<pre class="prettyprint showlinemods notranslate notranslate" translate="no">const cubes = [
|
|
|
makeInstance(geometry, 0x44aa88, 0),
|
|
|
makeInstance(geometry, 0x8844aa, -2),
|
|
|
makeInstance(geometry, 0xaa8844, 2),
|
|
|
];
|
|
|
</pre><p>Наконец, мы закрутим все 3 куба в нашей функции отрисовки.
|
|
|
Мы рассчитываем немного разные коэффициенты вращения для каждого.</p>
|
|
|
<pre class="prettyprint showlinemods notranslate notranslate" translate="no">function render(time) {
|
|
|
time *= 0.001; // конвертировать время в секунды
|
|
|
|
|
|
cubes.forEach((cube, ndx) => {
|
|
|
const speed = 1 + ndx * .1;
|
|
|
const rot = time * speed;
|
|
|
cube.rotation.x = rot;
|
|
|
cube.rotation.y = rot;
|
|
|
});
|
|
|
|
|
|
...
|
|
|
</pre><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/fundamentals-3-cubes.html"></iframe></div>
|
|
|
<a class="threejs_center" href="/manual/examples/fundamentals-3-cubes.html" target="_blank">нажмите здесь, чтобы открыть в отдельном окне</a>
|
|
|
</div>
|
|
|
|
|
|
<p></p>
|
|
|
<p>Если вы сравните его с диаграммой сверху вниз, вы увидите, что она соответствует
|
|
|
нашим ожиданиям. С кубами в X = -2 и X = +2 они частично находятся вне нашей
|
|
|
усеченной пирамиды. Они также несколько искривлены, так как
|
|
|
поле зрения на холсте очень велико.</p>
|
|
|
<p>Я надеюсь, что это короткое вступление поможет вам начать изучение.
|
|
|
<a href="responsive.html">Далее мы рассмотрим, как сделать отзывчивый дизайн, чтобы код можно было применять
|
|
|
к различным ситуациям</a>.</p>
|
|
|
|
|
|
</div>
|
|
|
</div>
|
|
|
</div>
|
|
|
|
|
|
<script src="../resources/prettify.js"></script>
|
|
|
<script src="../resources/lesson.js"></script>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</body></html> |