Тип QML AbstractGraph3D

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

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

Свойства

• 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 указывает, что метки должны быть нарисованы рядом с нулевым угловым сегментом. Значение 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 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.

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

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.