Класс QCustom3DItem

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

meshFile : QString

Это свойство содержит имя файла модели элемента.

Элемент в файле должен быть в формате Wavefront OBJ и включать вершины, нормали и UV-координаты. Также он должен быть представлен треугольниками.

Функции доступа:

QString	meshFile() const
void	setMeshFile(const QString &meshFile)

Сигнал уведомления:

void	meshFileChanged(const QString &meshFile)

position : QVector3D

Это свойство содержит положение элемента в виде QVector3D.

По умолчанию QVector3D(0.0, 0.0, 0.0).

Положение элемента задается либо в координатах данных, либо в абсолютных координатах, в зависимости от свойства positionAbsolute. При использовании абсолютных координат значения должны находиться в диапазонах осей, между -1.0...1.0.

Примечание: Элементы, расположенные за пределами диапазонов осей, не будут отображаться, если positionAbsolute равно false, за исключением элементов типа QCustom3DVolume, которые могут быть частично видны, и scalingAbsolute также равно false. В этом случае видимая часть объема будет отображена.

Функции доступа:

QVector3D	position() const
void	setPosition(const QVector3D &position)

Сигнал уведомления:

void	positionChanged(const QVector3D &position)

См. также positionAbsolute.

positionAbsolute : bool

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

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

Функции доступа:

bool	isPositionAbsolute() const
void	setPositionAbsolute(bool positionAbsolute)

Сигнал уведомления:

void	positionAbsoluteChanged(bool positionAbsolute)

См. также position.

rotation : QQuaternion

Это свойство содержит вращение элемента в виде QQuaternion.

По умолчанию QQuaternion(0.0, 0.0, 0.0, 0.0).

Функции доступа:

QQuaternion	rotation()
void	setRotation(const QQuaternion &rotation)

Сигнал уведомления:

void	rotationChanged(const QQuaternion &rotation)

scaling : QVector3D

Это свойство содержит масштабирование элемента в виде QVector3D.

По умолчанию QVector3D(0.1, 0.1, 0.1).

Масштабирование элемента задается либо в значениях данных, либо в абсолютных значениях, в зависимости от свойства scalingAbsolute. По умолчанию вектор интерпретируется как абсолютные значения, устанавливая элемент на 10% от высоты графика, при условии, что модель элемента нормализована, а соотношения сторон графика не изменены.

Функции доступа:

QVector3D	scaling() const
void	setScaling(const QVector3D &scaling)

Сигнал уведомления:

void	scalingChanged(const QVector3D &scaling)

См. также scalingAbsolute.

[since QtDataVisualization 1.2] scalingAbsolute : bool

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

По умолчанию true.

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

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

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

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

Функции доступа:

bool	isScalingAbsolute() const
void	setScalingAbsolute(bool scalingAbsolute)

Сигнал уведомления:

void	scalingAbsoluteChanged(bool scalingAbsolute)

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

shadowCasting : bool

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

По умолчанию true. Если false, элемент не отбрасывает тени, независимо от QAbstract3DGraph::ShadowQuality.

Функции доступа:

bool	isShadowCasting() const
void	setShadowCasting(bool enabled)

Сигнал уведомления:

void	shadowCastingChanged(bool shadowCasting)

textureFile : QString

Это свойство содержит имя файла текстуры для элемента.

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

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

Функции доступа:

QString	textureFile() const
void	setTextureFile(const QString &textureFile)

Сигнал уведомления:

void	textureFileChanged(const QString &textureFile)

visible : bool

Это свойство содержит видимость элемента.

По умолчанию true.

Функции доступа:

bool	isVisible() const
void	setVisible(bool visible)

Сигнал уведомления:

void	visibleChanged(bool visible)