Тип QML модели

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

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

Свойства

• границы : Границы
• отбрасывает тени : bool
• геометрия : Геометрия
• корень экземпляра : QtQuick3D::Узел
• экземпляризация : QtQuick3D::Экземпляризация
• обратные матрицы привязки : Список<матрица4x4>
• материалы : Список<QtQuick3D::Материал>
• морфинговые цели : Список<QtQuick3D::МорфинговаяЦель>
• выделяемый : bool
• получает тени : bool
• скелет : Скелет
• источник : url

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

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

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

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

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

Model {
    source: "#Sphere"
}

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

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

Материалы

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

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

Выбор

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

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

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

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

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

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

отбрасывает тени : bool

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

геометрия : Геометрия

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

корень экземпляра : QtQuick3D::Узел

Это свойство определяет начало системы координат экземпляра.

Подробное объяснение см. в документации по обзору.

См. также экземпляризация и Экземпляризация.

экземпляризация : QtQuick3D::Экземпляризация

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

См. также Экземпляризация.

обратные матрицы привязки : Список<матрица4x4>

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

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

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

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

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

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

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

морфинговые цели : Список<QtQuick3D::МорфинговаяЦель>

Это свойство содержит список MorphTargetов, используемых для рендеринга предоставленной геометрии. Сетки должны иметь как минимум один атрибут среди позиций, нормалей, касательных, бикасательных для морфинговых целей. Quick3D поддерживает максимум 8 морфинговых целей, остальные будут проигнорированы.

Примечание: Первые 2 морфинговые цели могут иметь максимум 4 атрибута среди позиции, нормали, касательной и бикасательной.

Примечание: 3-я и 4-я морфинговые цели могут иметь максимум 2 атрибута среди позиции и нормали.

Примечание: Остальные морфинговые цели могут иметь только атрибут позиции.

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

См. также Морфинговая цель.

выделяемый : bool

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

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

получает тени : bool

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

скелет : Скелет

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

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

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

См. также Model::обратные матрицы привязки и Пример простой склеивания Qt Quick 3D.

источник : url

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

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