Тип QML AbstractGraph3D

Базовый тип для 3D визуализаций. Подробнее...

Заявление об импорте:	import QtDataVisualization
С момента:	QtDataVisualization 1.0
Наследуется от:	Bars3D, Scatter3D и Surface3D

Свойства

aspectRatio : real
currentFps : int
customItemList : list<Custom3DItem>
horizontalAspectRatio : real
inputHandler : AbstractInputHandler3D
locale : locale
margin : real
measureFps : bool
msaaSamples : int
optimizationHints : AbstractGraph3D.OptimizationHints
orthoProjection : bool
polar : bool
queriedGraphPosition : vector3d
radialLabelOffset : real
reflection : bool
reflectivity : real
scene : Scene3D
selectedElement : AbstractGraph3D.ElementType
selectionMode : AbstractGraph3D.SelectionMode
shadowQuality : AbstractGraph3D.ShadowQuality
shadowsSupported : bool
theme : Theme3D

Методы

int addCustomItem(Custom3DItem item)
void clearSelection()
void releaseCustomItem(Custom3DItem item)
void removeCustomItem(Custom3DItem item)
void removeCustomItemAt(vector3d position)
void removeCustomItems()
Abstract3DAxis selectedAxis()
Custom3DItem selectedCustomItem()
int selectedCustomItemIndex()
int selectedLabelIndex()

Подробное описание

Базовый тип для всех 3D визуализаций в QtDataVisualization.

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

См. также Bars3D, Scatter3D, Surface3D и Qt Data Visualization C++ классы.

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

[с QtDataVisualization 1.1] aspectRatio : real

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

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

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

См. также horizontalAspectRatio.

[с QtDataVisualization 1.1] currentFps : int

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

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

См. также measureFps.

[с QtDataVisualization 1.1] customItemList : list<Custom3DItem>

Список элементов Custom3DItem, добавленных на график. График берет на себя ответственность за добавленные элементы.

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

[с QtDataVisualization 1.2] horizontalAspectRatio : real

Соотношение масштабирования графика между осями x и z. Значение 0.0 указывает на автоматическое масштабирование в соответствии с диапазонами осей. По умолчанию 0.0.

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

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

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

inputHandler : AbstractInputHandler3D

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

[с QtDataVisualization 1.2] locale : locale

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

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

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

[с QtDataVisualization 1.2] margin : real

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

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

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

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

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

[с QtDataVisualization 1.1] measureFps : bool

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

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

См. также currentFps.

msaaSamples : int

Количество образцов, используемых в многообразцовой антиалиасинге при renderingMode RenderIndirect. При renderingMode RenderDirectToBackground или RenderDirectToBackground_NoClear, это свойство является только для чтения и возвращает количество образцов, указанное форматом поверхности окна. По умолчанию 4.

См. такжеrenderingMode.

[since QtDataVisualization 1.1] optimizationHints : AbstractGraph3D.OptimizationHints

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

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

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

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

См. такжеAbstract3DSeries::mesh и QAbstract3DGraph::OptimizationHint.

[since QtDataVisualization 1.1] orthoProjection : bool

Если true, для отображения графика будет использоваться ортогональная проекция. По умолчанию false.

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

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

[since QtDataVisualization 1.2] polar : bool

Если true, горизонтальные оси будут изменены на полярные оси. Ось x станет угловой осью, а ось z станет радиальной осью. Полярный режим недоступен для столбчатых графиков.

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

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

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

[since QtDataVisualization 1.2] queriedGraphPosition : vector3d

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

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

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

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

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

[since QtDataVisualization 1.2] radialLabelOffset : real

Это свойство задаёт нормализованное горизонтальное смещение для меток осей радиальной полярной оси. Значение 0.0 указывает, что метки должны быть нарисованы рядом с нулевым угловым линией сетки. Значение 1.0 указывает, что метки нарисованы в своем обычном месте на краю фона графика. Это свойство игнорируется, если значение свойства polar равно false. По умолчанию 1.0.

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

См. такжеpolar.

[since QtDataVisualization 1.2] reflection : bool

Включает или отключает отражения пола. По умолчанию false.

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

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

См. такжеreflectivity.

[since QtDataVisualization 1.2] reflectivity : real

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

Примечание: Воздействует только на Bars3D.

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

См. такжеreflection.

scene : Scene3D

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

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

[since QtDataVisualization 1.1] selectedElement : AbstractGraph3D.ElementType

Выбранный элемент на графике.

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

Сигнал может использоваться, например, для реализации настраиваемой обработки ввода, как показано в примере Qt Quick 2 Axis Dragging Example.

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

См. такжеselectedLabelIndex(), selectedAxis(), selectedCustomItemIndex(), selectedCustomItem(), Bars3D::selectedSeries, Scatter3D::selectedSeries, Scene3D::selectionQueryPosition и QAbstract3DGraph::ElementType.

selectionMode : AbstractGraph3D.SelectionMode

Активный режим выбора в визуализации. Одно из значений перечисления QAbstract3DGraph::SelectionFlag.

См. такжеQAbstract3DGraph::SelectionFlag.

shadowQuality : AbstractGraph3D.ShadowQuality

Качество теней. Одно из значений перечисления QAbstract3DGraph::ShadowQuality.

См. такжеQAbstract3DGraph::ShadowQuality.

shadowsSupported : bool

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

theme : Theme3D

Активная тема графика.

См. такжеTheme3D.

Методы документации

`[since QtDataVisualization 1.1]` int addCustomItem(Custom3DItem item)

Добавляет Custom3DItem item на график. График берет на себя ответственность за добавленный элемент.

Возвращает индекс добавленного элемента, если добавление прошло успешно, -1, если пытались добавить null-элемент, и индекс элемента, если пытались добавить уже добавленный элемент.

Этот метод был введён в QtDataVisualization 1.1.

См. такжеremoveCustomItems(), removeCustomItem() и removeCustomItemAt().

void clearSelection()

Очищает выбор со всех присоединённых рядов.

`[since QtDataVisualization 1.1]` void releaseCustomItem(Custom3DItem item)

Получает владение элементом обратно и удаляет элемент из графа.

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