Тип QML Custom3DItem

Добавляет пользовательский элемент на график. Подробнее...

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

Свойства

• meshFile : строка
• position : vector3d
• positionAbsolute : логическое
• rotation : quaternion
• scaling : vector3d
• scalingAbsolute : логическое
• shadowCasting : логическое
• textureFile : строка
• visible : логическое

Методы

• 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 : логическое

Определяет, обрабатывается ли положение элемента в координатах данных или в абсолютных координатах. По умолчанию 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.

scalingAbsolute : логическое

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

Примечание: Абсолютное масштабирование поддерживается только для элементов Custom3DLabel или для пользовательских элементов, используемых в диаграммах polar.

Примечание: Сетка пользовательского элемента должна быть нормализована к диапазону [-1 ,1], в противном случае масштабирование данных не будет точным.

Это свойство QML было добавлено в QtDataVisualization 1.2.

См. также scaling и positionAbsolute.

shadowCasting : логическое

Определяет, включено ли отбрасывание тени для элемента. По умолчанию true. Если false, элемент не отбрасывает тени независимо от ShadowQuality.

textureFile : строка

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

Примечание: Для экономии памяти загруженный из файла QImage очищается после создания текстуры.

visible : логическое

Видимость элемента. По умолчанию true.

Документация по методам

void setRotationAxisAndAngle(vector3d axis, real angle)

Функция-удобство для построения поворота quaternion по axis и angle.

См. также rotation.