Тип QML AbstractGraph3D

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

Заявление импорта:	import QtDataVisualization 1.15
С тех пор:	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
renderingMode : AbstractGraph3D.RenderingMode
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++.

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

aspectRatio : real

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

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

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

См. также horizontalAspectRatio.

currentFps : int

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

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

См. также measureFps.

customItemList : list<Custom3DItem>

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

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

horizontalAspectRatio : real

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

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

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

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

inputHandler : AbstractInputHandler3D

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

locale : locale

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

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

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

margin : real

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

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

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

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

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

measureFps : bool

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

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

См. также currentFps.

msaaSamples : int

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

См. также renderingMode.

optimizationHints : AbstractGraph3D.OptimizationHints

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

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

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

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

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

orthoProjection : bool

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

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

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

polar : bool

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

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

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

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

queriedGraphPosition : vector3d

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

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

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

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

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

radialLabelOffset : real

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

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

См. также polar.

reflection : bool

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

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

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

См. также reflectivity.

reflectivity : real

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

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

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

См. также reflection.

renderingMode : AbstractGraph3D.RenderingMode

Как будет отображаться график. По умолчанию RenderIndirect.

Константа	Описание
`RenderDirectToBackground`	Указывает, что график будет отображаться непосредственно на фоне окна. Очищает всё окно перед отрисовкой графика, включая области за пределами графика. Поскольку графики в этом режиме отрисовки рисуются на фоне окна под другими элементами QML, обычная очистка окна QML перед отрисовкой подавляется. Графики обрабатывают очистку сами. Если формат поверхности окна поддерживает сглаживание, оно будет использоваться (см. `QtDataVisualization::qDefaultSurfaceFormat()`). Этот режим отрисовки обеспечивает наилучшую производительность в ущерб стандартному поведению QML. Например, графики не подчиняются порядку z элементов QML, а значение непрозрачности не оказывает на них никакого влияния.
`RenderDirectToBackground_NoClear`	Аналогично режиму `RenderDirectToBackground`, за исключением того, что график не будет очищать всё окно перед отрисовкой графика. Этот режим лучше подходит для окон, где помимо графиков есть и другие пользовательские элементы, которые также рисуются на фоне окна. В этом случае вам необходимо либо самостоятельно позаботиться об очистке окна, либо убедиться, что все области окна полностью покрыты непрозрачными элементами. Если один график в окне использует любой из режимов прямой отрисовки, то все другие графики в том же окне, также нарисованные в режимах прямой отрисовки, должны использовать точно тот же режим прямой отрисовки. В противном случае некоторые графики могут не отображаться, в зависимости от порядка отрисовки графиков.
`RenderIndirect`	Указывает, что график сначала будет отрисован на внеэкранной поверхности, которая затем будет нарисована во время обычной отрисовки элементов QML. Отображаемое изображение будет сглажено с помощью метода многократного сэмплирования, если он поддерживается в текущей среде, и значение свойства msaaSamples больше нуля. Этот режим отрисовки обеспечивает хорошее качество и обычное поведение элементов QML в ущерб производительности.

Примечание: Сглаживание не поддерживается в средах OpenGL ES2 ни в одном режиме отрисовки.

Примечание: Установка свойства antialiasing графика ничего не делает. Однако оно устанавливается самим графиком, если текущий режим отрисовки использует сглаживание.

См. также msaaSamples.

scene : Scene3D

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

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

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.

END_OF_DOCUMENT_MARKER

shadowsSupported : bool

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

theme : Theme3D

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

См. также Theme3D.

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

int addCustomItem(Custom3DItem item)

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

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

Этот метод был представлен в QtDataVisualization 1.1.

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

void clearSelection()

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

void releaseCustomItem(Custom3DItem item)

Возвращает владение item и удаляет item с графика.

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

Этот метод был представлен в QtDataVisualization 1.1.

См. также Custom3DItem::textureFile.

void removeCustomItem(Custom3DItem item)

Удаляет пользовательский item. Удаляет выделенные ресурсы.

Этот метод был представлен в QtDataVisualization 1.1.

void removeCustomItemAt(vector3d position)

Удаляет все пользовательские элементы в position. Удаляет выделенные ресурсы.

Этот метод был представлен в QtDataVisualization 1.1.

void removeCustomItems()

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

Этот метод был представлен в QtDataVisualization 1.1.

Abstract3DAxis selectedAxis()

Может использоваться для получения выбранной оси после получения сигнала selectedElementChanged с любым типом метки. Выделение действует до следующего сигнала selectedElementChanged.

Возвращает выбранную ось или null.

Этот метод был представлен в QtDataVisualization 1.1.

См. также selectedElement.

Custom3DItem selectedCustomItem()

Может использоваться для получения выбранного пользовательского элемента после получения сигнала selectedElementChanged с типом ElementCustomItem. Владение элементом остается у графика. Выделение действует до следующего сигнала selectedElementChanged.

Возвращает выбранный пользовательский элемент или null.

Этот метод был представлен в QtDataVisualization 1.1.

См. также selectedElement.

int selectedCustomItemIndex()

Можно использовать для запроса индекса выбранного пользовательского элемента после получения сигнала selectedElementChanged с типом ElementCustomItem. Выделение действует до следующего сигнала selectedElementChanged.

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

Этот метод был представлен в QtDataVisualization 1.1.

См. также selectedElement.

int selectedLabelIndex()

Может использоваться для запроса индекса выделенной метки после получения сигнала selectedElementChanged с любым типом метки. Выделение действует до следующего сигнала selectedElementChanged.

Возвращает индекс выделенной метки или -1.

Этот метод был представлен в QtDataVisualization 1.1.

См. также selectedElement.

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.15/qml-qtdatavisualization-abstractgraph3d.html