Тип 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++ Классы.

Документация по свойствам

[с версии QtDataVisualization 1.1] aspectRatio : real

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

Примечание: Не оказывает влияния на Bars3D.

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

См. также horizontalAspectRatio.

[с версии QtDataVisualization 1.1] currentFps : int

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

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

См. также measureFps.

[с версии QtDataVisualization 1.1] customItemList : список<Custom3DItem>

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

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

[с версии QtDataVisualization 1.2] horizontalAspectRatio : real

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

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

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

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

inputHandler : AbstractInputHandler3D

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

[с версии QtDataVisualization 1.2] locale : locale

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

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

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

[с версии QtDataVisualization 1.2] margin : real

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

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

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

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

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

[с версии QtDataVisualization 1.1] measureFps : bool

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

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

См. также currentFps.

msaaSamples : int

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

См. также renderingMode.

[с QtDataVisualization 1.1] optimizationHints : AbstractGraph3D.OptimizationHints

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

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

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

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

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

[с QtDataVisualization 1.1] orthoProjection : bool

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

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

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

[с QtDataVisualization 1.2] polar : bool

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

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

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

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

[с QtDataVisualization 1.2] queriedGraphPosition : vector3d

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

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

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

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

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

[с QtDataVisualization 1.2] radialLabelOffset : real

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

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

См. также polar.

[с QtDataVisualization 1.2] reflection : bool

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

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

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

См. также reflectivity.

[с QtDataVisualization 1.2] reflectivity : real

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

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

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

См. также reflection.

renderingMode : AbstractGraph3D.RenderingMode

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

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

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

См. также msaaSamples.

scene : Scene3D

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

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

[с QtDataVisualization 1.1] 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.

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

[since QtDataVisualization 1.1] int addCustomItem(Custom3DItem item)

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

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

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

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

void clearSelection()

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

[since QtDataVisualization 1.1] void releaseCustomItem(Custom3DItem item)

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

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

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

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

[since QtDataVisualization 1.1] void removeCustomItem(Custom3DItem item)

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

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

[since QtDataVisualization 1.1] void removeCustomItemAt(vector3d position)

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

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

[since QtDataVisualization 1.1] void removeCustomItems()

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

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

[since QtDataVisualization 1.1] Abstract3DAxis selectedAxis()

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

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

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

См. также selectedElement.

[since QtDataVisualization 1.1] Custom3DItem selectedCustomItem()

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

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

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

См. также selectedElement.

[since QtDataVisualization 1.1] int selectedCustomItemIndex()

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

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

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

См. также selectedElement.

[since QtDataVisualization 1.1] int selectedLabelIndex()

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

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

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

См. также selectedElement.