Тип QML Custom3DItem
Добавляет пользовательский элемент на график. Подробнее...
| Заявление импорта: | import QtDataVisualization |
| С момента: | QtDataVisualization 1.1 |
| Инициализирует: | QCustom3DItem |
| Наследуется: |
Свойства
- meshFile : строка
- position : vector3d
- positionAbsolute : bool
- rotation : quaternion
- scaling : vector3d
- scalingAbsolute : bool
- shadowCasting : bool
- textureFile : строка
- visible : bool
Методы
- void setRotationAxisAndAngle(vector3d axis, real angle)
Подробное описание
Пользовательский элемент имеет пользовательскую сетку, положение, масштабирование, вращение и (необязательную) текстуру.
Документация по свойствам
meshFile : строка
Имя файла сетки элемента. Элемент в файле должен быть в формате Wavefront OBJ и содержать вершины, нормали и UV. Он также должен быть представлен треугольниками.
position : vector3d
Положение элемента в виде типа vector3d. По умолчанию vector3d(0.0, 0.0, 0.0).
Положение элемента задается либо в координатах данных, либо в абсолютных координатах, в зависимости от значения свойства positionAbsolute. При использовании абсолютных координат значения между -1.0...1.0 находятся в диапазонах осей.
Примечание: Элементы, расположенные за пределами диапазона любой оси, не отображаются, если positionAbsolute равно false, за исключением случаев, когда элемент является Custom3DVolume, который будет частично виден, и scalingAbsolute также равно false. В этом случае видимая часть объема будет отображена.
См. также positionAbsolute и scalingAbsolute.
positionAbsolute : bool
Определяет, обрабатывается ли положение элемента в координатах данных или в абсолютных координатах. По умолчанию false. Элементы с абсолютными координатами всегда будут отображаться, тогда как элементы с координатами данных отображаются только в том случае, если они находятся в диапазонах осей.
См. также position.
rotation : quaternion
Вращение элемента в виде quaternion. По умолчанию quaternion(0.0, 0.0, 0.0, 0.0).
scaling : vector3d
Масштабирование элемента в виде типа vector3d. По умолчанию vector3d(0.1, 0.1, 0.1).
Масштабирование элемента задается либо в значениях данных, либо в абсолютных значениях, в зависимости от значения свойства scalingAbsolute. По умолчанию вектор интерпретируется как абсолютные значения, устанавливая размер элемента на 10% высоты графика, при условии, что сетка элемента нормализована, а пропорции графика не изменены от значений по умолчанию.
См. также scalingAbsolute.
[с QtDataVisualization 1.2] scalingAbsolute : bool
Определяет, обрабатывается ли масштабирование элемента в значениях данных или в абсолютных значениях. По умолчанию true. Элементы с абсолютным масштабированием будут отображаться с одинаковым размером независимо от диапазонов осей. Элементы с масштабированием по данным будут изменять свой видимый размер в зависимости от диапазонов осей. Если positionAbsolute равно true, это свойство игнорируется, и масштабирование интерпретируется как абсолютное значение. Если у элемента есть вращение, масштабирование по данным вычисляется для невращающегося элемента. Аналогично для элементов Custom3DVolume привязка диапазона выполняется для невращающегося элемента.
Примечание: Абсолютное масштабирование поддерживается только для элементов Custom3DLabel или для пользовательских элементов, используемых в полярных графиках (polar).
Примечание: Сетка пользовательского элемента должна быть нормализована в диапазон [-1 ,1], иначе масштабирование по данным не будет точным.
Это свойство было добавлено в QtDataVisualization 1.2.
См. также scaling и positionAbsolute.
shadowCasting : bool
Определяет, включено ли создание тени для элемента. По умолчанию true. Если false, элемент не создает тени независимо от ShadowQuality.
textureFile : строка
Имя файла текстуры для элемента. Если не задано, будет использоваться однотонная серая текстура.
Примечание: Для экономии памяти загруженное из файла изображение QImage очищается после создания текстуры.
visible : bool
Видимость элемента. По умолчанию true.
Документация по методам
void setRotationAxisAndAngle(vector3d axis, real angle)
Функция-помощник для построения оси вращения quaternion из axis и angle.
См. также rotation.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.2/qml-qtdatavisualization-custom3ditem.html