Тип 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.

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

См. также horizontalAspectRatio.

currentFps : int

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

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

См. также measureFps.

customItemList : список<Custom3DItem>

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

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

horizontalAspectRatio : real

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

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

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

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

inputHandler : AbstractInputHandler3D

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

locale : locale

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

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

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

margin : real

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

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

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

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

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

measureFps : bool

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

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

См. также currentFps.

msaaSamples : int

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

См. также renderingMode.

optimizationHints : AbstractGraph3D.OptimizationHints

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

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

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

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

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

orthoProjection : bool

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

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

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

polar : bool

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

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

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

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

queriedGraphPosition : vector3d

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

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

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

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

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

radialLabelOffset : real

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

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

См. также polar.

reflection : bool

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

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

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

См. также reflectivity.

reflectivity : real

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

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

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

См. также reflection.

renderingMode : AbstractGraph3D.RenderingMode

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

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

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

См. также msaaSamples.

scene : Scene3D

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

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

selectedElement : AbstractGraph3D.ElementType

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

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

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

Это свойство QML было добавлено в 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-элемент, и индекс элемента, если пытались добавить уже добавленный элемент.

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

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

void clearSelection()

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

void releaseCustomItem(Custom3DItem item)

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

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

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

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

void removeCustomItem(Custom3DItem item)

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

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

void removeCustomItemAt(vector3d position)

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

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

void removeCustomItems()

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

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

Abstract3DAxis selectedAxis()

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

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

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

См. также selectedElement.

Custom3DItem selectedCustomItem()

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

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

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

См. также selectedElement.

int selectedCustomItemIndex()

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

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

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

См. также selectedElement.

int selectedLabelIndex()

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

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

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

См. также selectedElement.