Тип 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.

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.