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

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