Three.js

Объекты

Object3D →

Bone

Кость (bone) является частью скелета (Skeleton). Скелет, в свою очередь, используется "сеткой, покрытой кожей" (SkinnedMesh). Кости практически одинаковы с пустым Object3D.

Пример

var root = new THREE.Bone();
var child = new THREE.Bone();

root.add( child );
child.position.y = 5;

Конструктор

Bone( )

Создает новую кость (Bone).

Свойства

Общие свойства смотрите в описании базового класса Object3D.

Методы

Общие методы смотрите в описании базового класса Object3D.

Исходники

Object3D →

Group

Данный объект (группа) практически идентичен Object3D. Его назначение сделать работу с группой объектов синтаксически яснее.

Пример

var geometry = new THREE.BoxBufferGeometry( 1, 1, 1 );
var material = new THREE.MeshBasicMaterial( {color: 0x00ff00} );

var cubeA = new THREE.Mesh( geometry, material );
cubeA.position.set( 100, 100, 0 );

var cubeB = new THREE.Mesh( geometry, material );
cubeA.position.set( -100, -100, 0 );

// create a group and add the two cubes
// These cubes can now be rotated / scaled etc as a group
// создаем группу и добавляем два куба
// Эти кубы теперь можно вращать/масштабировать и т.д. как группу
var group = new THREE.Group();
group.add( cubeA );
group.add( cubeB )

scene.add( group );

Конструктор

Group( )

Создает новую группу объектов.

Свойства

Общие свойства смотрите в описании базового класса Object3D.

Методы

Общие методы смотрите в описании базового класса Object3D.

Исходники

Object3D →

Line

Непрерывная линия.
Это почти то же самое, что и LineSegments; единственное различие заключается в том, что оно отображается с помощью gl.LINE_STRIP, а не gl.LINES.

Пример

var material = new THREE.LineBasicMaterial({
	color: 0x0000ff
});

var geometry = new THREE.Geometry();
geometry.vertices.push(
	new THREE.Vector3( -10, 0, 0 ),
	new THREE.Vector3( 0, 10, 0 ),
	new THREE.Vector3( 10, 0, 0 )
);

var line = new THREE.Line( geometry, material );
scene.add( line );

Конструктор

Line( 
geometry - геометрия, в данном случае
означает геометрический элемент')" onmouseout="hide()">geometry, 
material - материал')" onmouseout="hide()">material )

Если материал не предоставлен, то для объекта будет создан и затем назначен линейный материал, выбранный в случайном порядке.

Свойства

Общие свойства смотрите в описании базового класса Object3D.

Методы

Общие методы смотрите в описании базового класса Object3D.

Исходники

Object3D →   Line →

LineLoop

LineLoop это непрерывная линия, начало которой соединено с её концом, т.е. замкнутая линия.
Это почти то же самое, что и Line; единственное различие заключается в том, что оно отображается с помощью
и соединяет последнюю вершину с первой')" onmouseout="hide()">gl.LINE_LOOP (вместо gl.LINE_STRIP), которая рисует прямую линию к следующей вершине и присоединяет последнюю вершину обратно к первой.

Конструктор

LineLoop( 
geometry - геометрия, в данном случае
означает геометрический элемент')" onmouseout="hide()">geometry, 
material - материал')" onmouseout="hide()">material )

Если материал не предоставлен, то для объекта будет создан и затем назначен линейный материал, выбранный в случайном порядке.

Свойства

Общие свойства смотрите в описании базового класса Line.

Методы

Общие методы смотрите в описании базового класса Line.

Исходники

Object3D →     Line →

LineSegments

Цепочка линий, нарисованных между парами вершин.
Это почти то же самое, что и Line; единственное различие заключается в том, что оно отображается с помощью gl.LINES, а не gl.LINE_STRIP.

Конструктор

LineSegments( 
geometry - геометрия, в данном случае
означает геометрический элемент')" onmouseout="hide()">geometry, 
material - материал')" onmouseout="hide()">material )

Если материал не предоставлен, то для объекта будет создан и затем назначен линейный материал, выбранный в случайном порядке.

Свойства

Общие свойства смотрите в описании базового класса Line.

Методы

Общие методы смотрите в описании базового класса Line.

Исходники

Object3D →

LOD

LOD - это сокращение английских слов level of detail - уровень детализации - показывает полигональные сетки (mesh) с большим или меньшим количеством геометрических элементов в зависимости от расстояния между объектом и камерой.

Пример

var lod = new THREE.LOD();

// Create spheres with 3 levels of detail and create new LOD levels for them
// Создаем сферы с 3 уровнями детализации и создаем новые уровни LOD для них
for( var i = 0; i < 3; i++ ) {
	var geometry = new THREE.IcosahedronBufferGeometry( 10, 3 - i )
	var mesh = new THREE.Mesh( geometry, material );
	lod.addLevel( mesh, i * 75 );
}

scene.add( lod );

Обратите внимание, что LOD переключения между различными уровнями детализации, в цикле визуализации нужно будет вызывать update( camera ). Смотрите подробности в исходном коде этого примера: WebGL / LOD.

Конструктор

LOD()

Создает новый LOD.

Свойства

Общие свойства смотрите в описании базового класса Object3D.

Методы

Общие методы смотрите в описании базового класса Object3D.

Исходники

Object3D →

Mesh

Класс, представляющий объекты на основе треугольной полигональной сетки (polygon mesh). Также выступает в качестве основы для других классов, таких как SkinnedMesh.

Пример

var geometry = new THREE.BoxBufferGeometry( 1, 1, 1 );
var material = new THREE.MeshBasicMaterial( { color: 0xffff00 } );
var mesh = new THREE.Mesh( geometry, material );
scene.add( mesh );

Конструктор

Mesh( 
geometry - геометрия, в данном случае
означает геометрический элемент')" onmouseout="hide()">geometry, 
material - материал')" onmouseout="hide()">material )

Свойства

Общие свойства смотрите в описании базового класса Object3D.

Методы

Общие методы смотрите в описании базового класса Object3D.

Исходники

Object3D →

Points

Класс для отображения точек. Точки отрисовываются WebGLRenderer'ом при помощи gl.POINTS.

Конструктор

Points( 
geometry - геометрия, в данном случае
означает геометрический элемент')" onmouseout="hide()">geometry, 
material - материал')" onmouseout="hide()">material )

Свойства

Общие свойства смотрите в описании базового класса Object3D.

Методы

Общие методы смотрите в описании базового класса Object3D.

Исходники

Skeleton

Объект Skeleton (скелет), созданный из массива костей (Bone), может использоваться SkinnedMesh (полигональной сеткой, покрывающей скелет). Работает только в среде WebGL.

Пример

// Create a simple "arm" (создадим простейшую "руку")

var bones = [];

var shoulder = new THREE.Bone(); // shoulder - плечо
var elbow = new THREE.Bone(); // elbow - локоть
var hand = new THREE.Bone(); // hand - рука

shoulder.add( elbow );
elbow.add( hand );

bones.push( shoulder );
bones.push( elbow );
bones.push( hand );

shoulder.position.y = -5;
elbow.position.y = 0;
hand.position.y = 5;

var armSkeleton = new THREE.Skeleton( bones );

Пример использования со стандартной BufferGeometry смотрите на странице с описанием SkinnedMesh.

Конструктор

Skeleton( bones, boneInverses )

Создает новый объект Skeleton.

Свойства

Методы

Исходники

Object3D →     Mesh →

SkinnedMesh

Полигональная сетка (mesh), имеющая в составе "скелет" с "костями", которую теперь можно использовать для анимации вершин геометрии.

Пример

Конструктор

SkinnedMesh( 
geometry - геометрия, в данном случае
означает геометрический элемент')" onmouseout="hide()">geometry, 
material - материал')" onmouseout="hide()">material )

Свойства

Общие свойства смотрите в описании базового класса Mesh.

Методы

Общие методы смотрите в описании базового класса Mesh.

Исходники

Object3D →

Sprite

Спрайт это плоскость на трехмерной сцене, которая всегда стоит перед камерой.
Спрайты не отбрасывают тени, так что установка castShadow = true не даст никакого эффекта.

Пример

var spriteMap = new THREE.TextureLoader().load( "sprite.png" );
var spriteMaterial = new THREE.SpriteMaterial( { map: spriteMap, color: 0xffffff } );
var sprite = new THREE.Sprite( spriteMaterial );
scene.add( sprite );

Конструктор

Sprite( material )

Создает новый объект Sprite с указанным материалом material.

Свойства

Общие свойства смотрите в описании базового класса Object3D.

Методы

Общие методы смотрите в описании базового класса Object3D.

Исходники