Тип 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(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 : список<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(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.