Тип QML AbstractGraph3D

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

• Список всех членов, включая унаследованные

Свойства

• aspectRatio : real
• currentFps : int
• customItemList : список<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(item)
• void clearSelection()
• void releaseCustomItem(item)
• void removeCustomItem(item)
• void removeCustomItemAt(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 : список<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 указывает, что метки должны быть нарисованы рядом с нулевой угловой линией сетки. Значение 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.

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

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

См. также msaaSamples.

scene : Scene3D

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

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

selectedElement : AbstractGraph3D.ElementType

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

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

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

Это свойство было добавлено в 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.

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

int addCustomItem(item)

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

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

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

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

void clearSelection()

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

void releaseCustomItem(item)

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

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

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

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

void removeCustomItem(item)

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

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

void removeCustomItemAt(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.