Тип QML модели

Позволяет загрузить данные 3D-модели. Подробнее...

• Список всех членов, включая наследуемые члены

Свойства

• bounds : Границы
• castsShadows : bool
• geometry : Геометрия
• inverseBindPoses : Список<matrix4x4>
• materials : Список<QtQuick3D::Материал>
• pickable : bool
• receivesShadows : bool
• skeleton : Скелет
• source : url

Подробное описание

Элемент Model позволяет загрузить меш и изменить его визуализацию, добавив к нему материалы. Для визуализации модели необходим хотя бы меш и материал.

Формат меша и встроенные примитивы

Модель может загружать статические меши из хранилища или один из встроенных типов примитивов. Используемый формат меша — это формат выполнения, родной для движка, но с помощью инструмента импорта ресурсов Balsam поддерживаются дополнительные форматы. Balsam.

Встроенные примитивы можно загрузить, установив свойство source на одно из этих значений: #Rectangle, #Sphere, #Cube, #Cylinder or #Cone.

Model {
    source: "#Sphere"
}

Пользовательская геометрия

Помимо использования статических мешей, можно реализовать поставщик пользовательской геометрии, который предоставляет модели пользовательские данные вершин во время выполнения. См. пример Пример пользовательской геометрии для примера создания и использования пользовательского материала с вашей моделью.

Материалы

Модель может состоять из нескольких подмешей, каждая из которых может иметь собственный материал. Подмешь использует материал из списка materials, соответствующий его индексу. Если количество материалов меньше, чем подмешей, для последующих подмешей используется последний материал в списке. Это показано в примере подмешей.

В настоящее время существуют три разных материала, которые можно использовать с элементом модели: PrincipledMaterial, DefaultMaterial и CustomMaterial.

Выбор

Выбор — это процесс отправки луча через сцену от некоторой начальной позиции, чтобы найти модели, пересекающие луч. В QtQuick3D луч обычно отправляется из представления с использованием 2D-координат, полученных в результате нажатия или события мыши. Если луч попал в модель, будет возвращён PickResult с указанием на модель и информацией о том, где луч попал в модель. Для моделей, использующих пользовательскую геометрию, выбор менее точен, чем для данных статического меша, так как выбор выполняется только по объёму модели.

Если луч проходит через более чем одну модель, выбирается ближайшая pickable модель. Обратите внимание, что модели по умолчанию не являются pickable, поэтому, чтобы можно было выбрать модель в сцене, ей нужно сделать себя видимой, установив свойство pickable в значение true. Посетите пример выбора в Qt Quick 3D, чтобы увидеть, как можно включить выбор.

Документация по свойствам

[только чтение] bounds : Границы

Границы модели описывают пределы ограничивающего объема вокруг модели.

Примечание: Границы могут быть недоступны немедленно, если модели необходимо загрузить сначала.

castsShadows : bool

Когда это свойство true, геометрия этой модели используется при отрисовке теней.

geometry : Геометрия

Укажите пользовательскую геометрию для модели. Свойство Model::source должно быть пустым, когда используется пользовательская геометрия.

inverseBindPoses : Список<matrix4x4>

Это свойство содержит список матриц обратной связки, используемых для скелетной анимации. Каждая матрица inverseBindPose означает обратную глобальную трансформацию соответствующего индекса узла в скелете, который будет использоваться изначально.

Примечание: Это свойство используется только если Model::skeleton валиден.

Примечание: Если некоторые матрицы не установлены, будут использоваться значения по умолчанию.

См. также индекс узла.

materials : Список<QtQuick3D::Материал>

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

См. также Пример подмешей Qt Quick 3D.

pickable : bool

Это свойство управляет тем, является ли модель выбираемой. Установите это свойство в true чтобы сделать модель выбираемой. Модели по умолчанию не выбираемые.

См. также View3D::pick.

receivesShadows : bool

Когда это свойство установлено в true, материалы модели учитывают вклад теней от источников света, отбрасывающих тени.

skeleton : Скелет

Содержит скелет модели. Скелет используется вместе с inverseBindPoses для скиннинга.

Примечание: Меши модели должны иметь атрибуты как суставы, так и веса.

Примечание: Если это свойство установлено, анимация скиннинга включена. Это означает, что модель преобразуется на основе скелета, игнорируя глобальное преобразование модели.

См. также Model::inverseBindPoses и Пример простого скиннинга Qt Quick 3D.

source : url

Это свойство определяет расположение файла меша, содержащего геометрию этой модели или один из встроенных примитивных мешей, перечисленных ниже, как описано в формате меша и встроенных примитивах.

• "#Прямоугольник"
• "#Сфера"
• "#Куб"
• "#Конус"
• "#Цилиндр"