Класс 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.

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)