Тип QML Custom3DItem

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

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

Свойства

• 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)

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

См. также rotation.