Three.js

Анимация

      AnimationAction

AnimationActions планирует (составляет расписание, по которому происходит) выполнение анимаций, которые хранятся в AnimationClips. Обзор различных элементов системы анимации three.js можно найти в статье "Системы анимации" раздела "Следующие шаги" данного руководства.

Конструктор

AnimationAction( 
mixer - микшер, смеситель');" onmouseout="hide()">mixer, clip, localRoot )

Свойства

Методы

События

Есть два события, показывающие когда завершается отдельный цикл действия и, соответственно, все действие целиком. На них можно реагировать с помощью:

mixer.addEventListener( 'loop', function( e ) { …} );
    // properties of e: type, action and loopDelta
    // свойствами для e должны быть тип, действие и loopDelta

mixer.addEventListener( 'finished', function( e ) { …} );
    // properties of e: type, action and direction
    // свойствами для e должны быть тип, действие и направление

Исходники

      AnimationClip

AnimationClip - это многократно используемый набор треков ключевых кадров, представляющих анимацию.
Обзор различных элементов системы анимации three.js можно найти в статье "Системы анимации" раздела "Следующие шаги" данного руководства.

Конструктор

AnimationClip( name, duration, tracks )

Свойства

Методы

Статические методы

Исходники

      AnimationMixer

AnimationMixer - это проигрыватель для анимации конкретного объекта на сцене. Если на сцене независимо анимируется множество объектов, для всех объектов может использоваться один AnimationMixer.
Обзор различных элементов системы анимации three.js можно найти в статье "Системы анимации" раздела "Следующие шаги" данного руководства.

Конструктор

AnimationMixer( 
root object - корневой объект');" onmouseout="hide()">rootObject )

Свойства

Методы

Исходники

      AnimationObjectGroup

Группа объектов, которая получает общее состояние анимации.
Обзор различных элементов системы анимации three.js можно найти в статье "Системы анимации" раздела "Следующие шаги" данного руководства.

Применение

Add objects you would otherwise pass as 'root' to the constructor or the [page:AnimationMixer.clipAction clipAction method of [page:AnimationMixer AnimationMixer and instead pass this object as 'root'.
Обратите внимание, что объекты этого класса в микшере представлены как один объект, поэтому управление кэшем отдельных объектов должен выполняться в группе.

Ограничения

Свойства анимации должны быть совместимы среди всех объектов группы.
Отдельным свойством можно управлять либо через целевую группу, либо непосредственно, но нельзя одновременно и тем и другим способами.

Конструктор

AnimationObjectGroup( obj1, obj2, obj3, ... )

Свойства

Методы

Исходники

      AnimationUtils

Объект с различными функциями для помощи при анимации, используется внутри. An object with various functions to assist with animations, used internally.

Методы

Исходники

      KeyframeTrack

Трек ключевых кадров (KeyframeTrack) это, согласованная по времени показа, последовательность ключевых кадров (keyframes), которые состоят из списков моментов времени и связанных с ними значений, и которые используются для анимации определенного свойства объекта.
Обзор различных элементов системы анимации three.js можно найти в статье "Системы анимации" раздела "Следующие шаги" данного руководства.

В отличие от иерархии анимации модели в формате JSON, KeyframeTrack не сохраняет свои отдельные ключевые кадры как объекты в массиве keys (ключи) (удерживая совместно моменты времени и значения для каждого кадра в одном месте). In contrast to the animation hierarchy of the [link:https://github.com/mrdoob/three.js/wiki/JSON-Model-format-3 JSON model format a *KeyframeTrack* doesn't store its single keyframes as objects in a "keys" array (holding the times and the values for each frame together in one place).

Вместо этого, в KeyframeTrack имеются два массива: массив времён, где хранятся значения времени для всех ключевых кадров данного трека в последовательном порядке, и массив значений, содержащий соответствующие изменяемые значения свойства анимации.

Instead of this there are always two arrays in a *KeyframeTrack*: the [page:.times times array stores the time values for all keyframes of this track in sequential order, and the [page:.values values array contains the corresponding changing values of the animated property.

Отдельное значение, принадлежащее конкретному моменту времени, может быть не только простым числом, но (например) вектором (если анимируется положение объекта) или кватернионом (если анимируется вращение объекта). По этой причине массив значений (который является также плоским массивом) A single value, belonging to a certain point of time, can not only be a simple number, but (for example) a vector (if a position is animated) or a quaternion (if a rotation is animated). For this reason the values array (which is a flat array, too) might be three or four times as long as the times array.

В соответствии с различными возможными типами анимированных значений существует несколько подклассов KeyframeTrack, наследующих большинство свойств и методов:

• BooleanKeyframeTrack
• ColorKeyframeTrack
• NumberKeyframeTrack
• QuaternionKeyframeTrack
• StringKeyframeTrack
• VectorKeyframeTrack

Некоторые примеры создания вручную клипов анимации с разными видами ключевых кадров можно найти в файле. Поскольку явные значения определены только для дискретных точек времени, хранящихся в массиве времен, все промежуточные значения между ними должны быть интерполированы. Since explicit values are only specified for the discrete points of time stored in the times array, all values in between have to be interpolated.

Имя трека важно для соединения данного трека с конкретным свойством анимированного узла (сделанного PropertyBinding). The track's name is important for the connection of this track with a specific property of the animated node (done by [page:PropertyBinding).

Конструктор

KeyframeTrack( name, times, values, interpolation )

Свойства

Методы

Статические методы

Исходники

KeyframeTrack →

BooleanKeyframeTrack

Трек логических значений ключевых кадров.

Конструктор

BooleanKeyframeTrack( name, times, values )

Свойства

Для ознакомления с унаследованными свойствами смотрите описание KeyframeTrack.

Методы

Для ознакомления с унаследованными методами смотрите описание KeyframeTrack.

Исходники

KeyframeTrack →

ColorKeyframeTrack

Трек значений ключевых кадров, представляющих изменения цвета.
Сама по себе основная реализация данного подкласса не имеет ничего особенного. Тем не менее, это место для параметризации цветового пространства.

Конструктор

ColorKeyframeTrack( name, times, values )

Свойства

Для ознакомления с унаследованными свойствами смотрите описание KeyframeTrack.

Методы

Для ознакомления с унаследованными методами смотрите описание KeyframeTrack.

Исходники

KeyframeTrack →

NumberKeyframeTrack

Трек числовых значений ключевых кадров.

Конструктор

NumberKeyframeTrack( name, times, values )

Свойства

Для ознакомления с унаследованными свойствами смотрите описание KeyframeTrack.

Методы

Для ознакомления с унаследованными методами смотрите описание KeyframeTrack.

Исходники

KeyframeTrack →

QuaternionKeyframeTrack

A Track of quaternion keyframe values.

Конструктор

QuaternionKeyframeTrack( name, times, values )

Свойства

Для ознакомления с унаследованными свойствами смотрите описание KeyframeTrack.

Методы

Для ознакомления с унаследованными методами смотрите описание KeyframeTrack.

Исходники

KeyframeTrack →

StringKeyframeTrack

Трек строковых значений ключевых кадров.

Конструктор

StringKeyframeTrack( name, times, values )

Свойства

Для ознакомления с унаследованными свойствами смотрите описание KeyframeTrack.

Методы

Для ознакомления с унаследованными методами смотрите описание KeyframeTrack.

Исходники

KeyframeTrack →

VectorKeyframeTrack

Трек векторных значений ключевых кадров.

Конструктор

VectorKeyframeTrack( name, times, values )

Свойства

Для ознакомления с унаследованными свойствами смотрите описание KeyframeTrack.

Методы

Для ознакомления с унаследованными методами смотрите описание KeyframeTrack.

Исходники

      PropertyBinding

This holds a reference to a real property in the scene graph; used internally.

Конструктор

PropertyBinding( rootNode, path, parsedPath )

Свойства

Методы

Исходники

      PropertyMixer

Buffered scene graph property that allows weighted accumulation; used internally.

Конструктор

PropertyMixer( binding, typeName, valueSize )

Свойства

Методы

Исходники