Класс QAbstract3DGraph

Q3DBars *graphWindow = new Q3DBars;
graphWindow->setFlags(graphWindow->flags() ^ Qt::FramelessWindowHint);

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

activeInputHandler : QAbstract3DInputHandler*

Это свойство содержит активный обработчик ввода, используемый в графике.

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

QAbstract3DInputHandler *	activeInputHandler() const
void	setActiveInputHandler(QAbstract3DInputHandler *inputHandler)

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

void	activeInputHandlerChanged(QAbstract3DInputHandler *inputHandler)

activeTheme : Q3DTheme*

Это свойство содержит активную тему графика.

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

Q3DTheme *	activeTheme() const
void	setActiveTheme(Q3DTheme *theme)

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

void	activeThemeChanged(Q3DTheme *theme)

[since QtDataVisualization 1.1] aspectRatio : qreal

Это свойство содержит отношение масштабирования графика между самой длинной осью на горизонтальной плоскости и осью y.

Значение по умолчанию 2.0.

Примечание: Не оказывает влияния на Q3DBars.

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

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

qreal	aspectRatio() const
void	setAspectRatio(qreal ratio)

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

void	aspectRatioChanged(qreal ratio)

См. также horizontalAspectRatio.

[read-only, since QtDataVisualization 1.1] currentFps : const qreal

Это свойство содержит результаты рендеринга за последнюю секунду.

Результаты сохраняются в этом свойстве для чтения только при включенном измерении FPS. Значение обновляется не ранее чем через секунду после активации измерения.

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

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

qreal

currentFps() const

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

void	currentFpsChanged(qreal fps)

См. также measureFps.

[since QtDataVisualization 1.2] horizontalAspectRatio : qreal

Это свойство содержит отношение масштабирования графика между осями x и z.

Значение 0.0 указывает на автоматическое масштабирование в соответствии с диапазонами осей. Значение по умолчанию 0.0.

Не оказывает влияния на Q3DBars, который обрабатывает масштабирование на горизонтальной плоскости через свойства barThickness и barSpacing. Полярные графики также игнорируют это свойство.

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

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

qreal	horizontalAspectRatio() const
void	setHorizontalAspectRatio(qreal ratio)

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

void	horizontalAspectRatioChanged(qreal ratio)

См. также aspectRatio, polar, Q3DBars::barThickness и Q3DBars::barSpacing.

[since QtDataVisualization 1.2] locale : QLocale

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

Значение по умолчанию — "C" локаль.

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

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

QLocale	locale() const
void	setLocale(const QLocale &locale)

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

void	localeChanged(const QLocale &locale)

См. также QValue3DAxis::labelFormat.

[since QtDataVisualization 1.2] margin : qreal

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

Если значение margin отрицательное, отступы определяются автоматически и могут изменяться в зависимости от размера элементов в рядах и типа графика. Значение интерпретируется как доля диапазона оси y, если пропорции графика не изменены от значений по умолчанию. Значение по умолчанию -1.0.

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

Примечание: На графиках рассеяния и поверхностей, если отступ мал по сравнению с размером метки оси, позиции крайних меток осей корректируются для предотвращения перекрытия с крайними метками соседних осей.

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

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

qreal	margin() const
void	setMargin(qreal margin)

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

void	marginChanged(qreal margin)

[since QtDataVisualization 1.1] measureFps : bool

Это свойство указывает, выполняется ли рендеринг непрерывно, а не по запросу.

Если true, рендеринг выполняется непрерывно, и значение свойства currentFps обновляется. Значение по умолчанию false.

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

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

bool	measureFps() const
void	setMeasureFps(bool enable)

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

void	measureFpsChanged(bool enabled)

См. также currentFps.

optimizationHints : OptimizationHints

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

Режим по умолчанию предоставляет полный набор функций с приемлемым уровнем производительности. Статический режим оптимизирует рендеринг графика и идеально подходит для больших неизменяемых наборов данных. Он медленнее при динамических изменениях данных и поворотах элементов. Выбор не оптимизирован, поэтому использование статического режима с массивами данных не рекомендуется. Статическая оптимизация работает только с точечными графиками. Значение по умолчанию OptimizationDefault.

Примечание: На некоторых средах большие графики, использующие статическую оптимизацию, могут не отображаться, поскольку все элементы рендерятся с помощью одного вызова отрисовки, и разные графические драйверы поддерживают разные максимальные количества вершин на вызов. Это в основном проблема на 32-битных и OpenGL ES2 платформах. Чтобы обойти эту проблему, выберите сетку элементов с низким количеством вершин или используйте сетку точек.

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

QAbstract3DGraph::OptimizationHints	optimizationHints() const
void	setOptimizationHints(QAbstract3DGraph::OptimizationHints hints)

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

void	optimizationHintsChanged(QAbstract3DGraph::OptimizationHints hints)

См. также QAbstract3DSeries::mesh.

[since QtDataVisualization 1.1] orthoProjection : bool

Это свойство указывает, используется ли ортогональная проекция для отображения графика.

Если true, используется ортогональная проекция для создания 2D графиков путём замены стандартного обработчика ввода на обработчик, не позволяющий вращать график, и установкой камеры для просмотра графика со стороны или сверху. Также, метки осей, как правило, необходимо вращать при просмотре графика со стороны. По умолчанию false.

Примечание: Тени будут отключены, когда установлено true.

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

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

bool	isOrthoProjection() const
void	setOrthoProjection(bool enable)

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

void	orthoProjectionChanged(bool enabled)

См. также QAbstract3DAxis::labelAutoRotation и Q3DCamera::cameraPreset.

[since QtDataVisualization 1.2] polar : bool

Это свойство указывает, преобразуются ли горизонтальные оси в полярные.

Если true, ось X становится угловой осью, а ось Z — радиальной осью. Режим полярных координат недоступен для столбчатых графиков.

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

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

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

bool	isPolar() const
void	setPolar(bool enable)

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

void	polarChanged(bool enabled)

См. также orthoProjection и radialLabelOffset.

[read-only, since QtDataVisualization 1.2] queriedGraphPosition : const QVector3D

Это свойство содержит последние запрошенные значения положения графика вдоль каждой оси.

Это свойство только для чтения, содержащее результаты из Q3DScene::graphPositionQuery. Значения нормализованы к диапазону [-1, 1]. Если запрошенное положение было вне границ графика, значения не будут отражать реальное положение, а вместо этого укажут неопределённое положение за пределами диапазона [-1, 1]. Значение будет неопределённым до тех пор, пока запрос не будет выполнен.

Нет единственной правильной 3D координаты, соответствующей определённому положению на экране, поэтому для согласованности запросы всегда выполняются по отношению к внутренним границам невидимой рамки вокруг графика.

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

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

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

QVector3D

queriedGraphPosition() const

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

void	queriedGraphPositionChanged(const QVector3D &data)

См. также Q3DScene::graphPositionQuery.

[since QtDataVisualization 1.2] radialLabelOffset : float

Это свойство содержит нормализованное горизонтальное смещение меток осей радиальной полярной оси.

Значение 0.0 указывает, что метки должны быть нарисованы рядом с линией сетки угловой оси 0 градусов. Значение 1.0 указывает, что метки рисуются в их обычном месте на краю фона графика. По умолчанию 1.0.

Это свойство игнорируется, если значение свойства polar равно false.

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

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

float	radialLabelOffset() const
void	setRadialLabelOffset(float offset)

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

void	radialLabelOffsetChanged(float offset)

См. также polar.

[since QtDataVisualization 1.2] reflection : bool

Это свойство указывает, включены или выключены отражения пола.

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

Влияет только на Q3DBars. Однако в графиках Q3DBars, содержащих как положительные, так и отрицательные значения, отражения не поддерживаются для пользовательских элементов, пересекающих плоскость пола. В этом случае отражения следует выключать, чтобы избежать неправильного рендеринга.

При использовании пользовательского формата поверхности, буфер трафарета должен быть определён (QSurfaceFormat::setStencilBufferSize()), чтобы отражения работали.

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

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

bool	isReflection() const
void	setReflection(bool enable)

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

void	reflectionChanged(bool enabled)

См. также reflectivity.

[since QtDataVisualization 1.2] reflectivity : qreal

Отражающая способность пола.

Более высокие значения делают пол более отражающим. Допустимый диапазон [0...1]. По умолчанию 0.5.

Примечание: Влияет только на Q3DBars.

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

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

qreal	reflectivity() const
void	setReflectivity(qreal reflectivity)

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

void	reflectivityChanged(qreal reflectivity)

См. также reflection.

[read-only] scene : Q3DScene* const

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

Это свойство только для чтения.

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

Q3DScene *

scene() const

[read-only, since QtDataVisualization 1.1] selectedElement : const ElementType

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

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

Сигнал может быть использован, например, для реализации пользовательских обработчиков ввода, как показано в примере Перетаскивание Диапазона Осей с Метками Примера.

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

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

QAbstract3DGraph::ElementType

selectedElement() const

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

void	selectedElementChanged(QAbstract3DGraph::ElementType type)

См. также selectedLabelIndex(), selectedAxis(), selectedCustomItemIndex(), selectedCustomItem(), Q3DBars::selectedSeries(), Q3DScatter::selectedSeries(), Q3DSurface::selectedSeries(), и Q3DScene::setSelectionQueryPosition().

selectionMode : SelectionFlags

Режим выбора элементов.

Сочетание флагов SelectionFlags. По умолчанию SelectionItem. Разные типы графиков поддерживают разные режимы выбора.

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

QAbstract3DGraph::SelectionFlags	selectionMode() const
void	setSelectionMode(QAbstract3DGraph::SelectionFlags mode)

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

void	selectionModeChanged(QAbstract3DGraph::SelectionFlags mode)

См. также SelectionFlags.

shadowQuality : ShadowQuality

Данное свойство определяет качество теней.

Одно из значений перечисления ShadowQuality. По умолчанию ShadowQualityMedium.

Примечание: Если установка качества теней на определенный уровень не удается, уровень снижается до тех пор, пока установка не будет успешной. Сигнал shadowQualityChanged генерируется каждый раз при изменении.

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

QAbstract3DGraph::ShadowQuality	shadowQuality() const
void	setShadowQuality(QAbstract3DGraph::ShadowQuality quality)

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

void	shadowQualityChanged(QAbstract3DGraph::ShadowQuality quality)

См. также ShadowQuality.

#include <QtDataVisualization/qutils.h>

// ...

Q3DBars *graph = new Q3DBars(qDefaultSurfaceFormat(false));

#include <QtDataVisualization/qutils.h>

// ...

QQuickView viewer;
viewer.setFormat(qDefaultSurfaceFormat(true));