Loader →

GLTFLoader

Загрузчик для ресурсов glTF 2.0.

glTF (GL Transmission Format) - это спецификация открытого формата для эффективной доставки и загрузки 3Д-контента. Ассеты могут предоставляться как в формате JSON (.gltf), так и в бинарном формате (.glb). Внешние файлы хранят текстуры (.jpg, .png, ...) и дополнительные двоичные данные (.bin). Ассет glTF может предоставлять одну или несколько сцен, включая сетки, материалы, текстуры, скины, скелеты, morph-targets, анимацию, свет и/или камеры.

Расширения

GLTFLoader поддерживает следующие расширения glTF:

S8S_v3d_animation_data
S8S_v3d_data
S8S_v3d_camera_data
S8S_v3d_material_data
S8S_v3d_mesh_data
S8S_v3d_node_data
S8S_v3d_scene_data
S8S_v3d_texture_data

Пример


    // Instantiate a loader
    var loader = new v3d.GLTFLoader();

    // Load a glTF resource
    loader.load('models/gltf/duck/duck.gltf', function(gltf) {
      app.scene.add(gltf.scene);

      gltf.animations; // Array<v3d.AnimationClip>
      gltf.scene;      // v3d.Scene
      gltf.scenes;     // Array<v3d.Scene>
      gltf.cameras;    // Array<v3d.Camera>
    });

Конструктор

GLTFLoader(manager)

manager — loadingManager для использования загрузчиком. По умолчанию v3d.DefaultLoadingManager.

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

Свойства

Методы

# .load(url, onLoad, onProgress, onError) → null

url — необходим
onLoad — Будет вызван после завершения загрузки. Аргументом будет загруженный JSON-отклик, возвращенный из parse.
onProgress — Вызывается во время загрузки. Аргументом будет экземпляр XMLHttpRequest, содержащий байты .total и .loaded.
onError — Вызывается при ошибках загрузки.

Начните загрузку из url и вызовите функцию обратного вызова с разобранным содержимым отклика.

# .setPath(path) → null

path — Базовый путь для загрузки дополнительных ресурсов, например, текстур и данных .bin.

Установите базовый путь для дополнительных ресурсов.

# .setCrossOrigin(value) → null

value — Строка crossOrigin для выполнения CORS для загрузки url из другого домена, который разрешает CORS.

# .parse(json, callBack, path) → null

json — JSON объект для парсинга.
callBack — Будет вызван после завершения парсинга.
path — Базовый путь, по которому можно найти последующие ресурсы glTF, такие как текстуры и файлы данных .bin.

Разберите структуры JSON на основе glTF и выполните callback по завершении. Аргументом callback будет object, содержащий загруженные части: .scene, .scenes, .cameras и .animations.

Исходный файл

О том как получить исходный код этого модуля читайте тут.