Класс QAbstract3DGraph

Класс QAbstract3DGraph предоставляет окно и цикл отрисовки для графиков. Подробнее...

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

Открытые типы

Свойства

• 16 свойств унаследовано от QWindow
• 1 свойство унаследовано от QObject

Открытые функции

• 80 общедоступные функции, унаследованные от QWindow
• 145 общедоступные функции, унаследованные от QOpenGLFunctions
• 32 общедоступные функции, унаследованные от QObject
• 6 общедоступные функции, унаследованные от QSurface

Сигналы

• 18 сигналов, унаследованных от QWindow
• 2 сигнала, унаследованных от QObject

Связанные нечлены

Дополнительные унаследованные члены

• 22 public слота, унаследованные от QWindow
• 1 public слот, унаследованный от QObject
• 1 статический public член, унаследованный от QWindow
• 11 статических public членов, унаследованных от QObject
• 18 protected функций, унаследованных от QWindow
• 9 protected функций, унаследованных от QObject

Подробное описание

Класс QAbstract3DGraph предоставляет окно и цикл отрисовки для графиков.

Этот класс является подклассом QWindow и предоставляет цикл отрисовки для графиков, которые его наследуют.

Вам не нужно использовать этот класс напрямую, а вместо него следует использовать один из его подклассов.

Антиалиасинг включён по умолчанию в C++, за исключением сред OpenGL ES2, где Qt Data Visualization не поддерживает антиалиасинг. Чтобы указать антиалиасинг, отличный от значения по умолчанию для графика, передайте пользовательский формат поверхности в качестве параметра конструктора. Вы можете использовать вспомогательную функцию QtDataVisualization::qDefaultSurfaceFormat() для создания объекта формата поверхности.

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

Q3DBars *graphWindow = new Q3DBars;
graphWindow->setFlags(graphWindow->flags() ^ Qt::FramelessWindowHint);

См. также Q3DBars, Q3DScatter, Q3DSurface и Qt Data Visualization C++ классы.

Документация по типам членов

перечисление QAbstract3DGraph::ElementType

Тип элемента в графике.

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

перечисление QAbstract3DGraph::OptimizationHintфлаги QAbstract3DGraph::OptimizationHints

Подсказка по оптимизации отрисовки.

Это перечисление было введено или изменено в Qt Data Visualization 1.1.

Тип OptimizationHints является типом-синонимом для QFlags<OptimizationHint>. Он хранит результат объединения по оператору OR значений OptimizationHint.

перечисление QAbstract3DGraph::SelectionFlagфлаги QAbstract3DGraph::SelectionFlags

Режимы выбора элементов. Значения этого перечисления можно комбинировать с оператором OR.

Тип SelectionFlags является typedef для QFlags<SelectionFlag>. Он хранит логическое ИЛИ комбинацию значений SelectionFlag.

enum QAbstract3DGraph::ShadowQuality

Качество теней.

Документация по членам функции

[virtual] QAbstract3DGraph::~QAbstract3DGraph()

Удаляет QAbstract3DGraph.

int QAbstract3DGraph::addCustomItem(QCustom3DItem *item)

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

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

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

Эта функция была добавлена в QtDataVisualization 1.1.

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

void QAbstract3DGraph::addInputHandler(QAbstract3DInputHandler *inputHandler)

Добавляет указанный inputHandler к графику. Обработчики ввода, добавленные с помощью addInputHandler, не используются напрямую. Графику передаётся только владение inputHandler. inputHandler не должен быть нулевым или уже добавленным в другой график.

См. также releaseInputHandler() и setActiveInputHandler().

void QAbstract3DGraph::addTheme(Q3DTheme *theme)

Добавляет указанную theme к графику. Темы, добавленные с помощью addTheme, не используются напрямую. Графику передаётся только владение темой. theme не должен быть нулевым или уже добавленным в другой график.

См. также releaseTheme() и setActiveTheme().

void QAbstract3DGraph::clearSelection()

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

QList<QCustom3DItem *> QAbstract3DGraph::customItems() const

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

Эта функция была добавлена в QtDataVisualization 1.2.

См. также addCustomItem().

bool QAbstract3DGraph::hasContext() const

Возвращает true, если контекст OpenGL графика успешно инициализирован. Попытка использовать график, когда инициализация контекста завершилась неудачей, обычно приводит к сбою. Распространённой причиной неудачи инициализации контекста является недостаточная поддержка OpenGL платформой.

QList<QAbstract3DInputHandler *> QAbstract3DGraph::inputHandlers() const

Возвращает список всех добавленных обработчиков ввода.

См. также addInputHandler().

void QAbstract3DGraph::releaseCustomItem(QCustom3DItem *item)

Возвращает владение указанным элементом item обратно вызывающей стороне и удаляет item из графика.

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

Эта функция была добавлена в QtDataVisualization 1.1.

См. также QCustom3DItem::setTextureImage() и QCustom3DItem::setTextureFile().

void QAbstract3DGraph::releaseInputHandler(QAbstract3DInputHandler *inputHandler)

Освобождает владение inputHandler обратно вызывающей стороне, если он был добавлен в этот график. Если выпущенный inputHandler используется, активного обработчика ввода не будет после этого вызова.

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

См. также addInputHandler() и setActiveInputHandler().

void QAbstract3DGraph::releaseTheme(Q3DTheme *theme)

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

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

См. также addTheme() и setActiveTheme().

void QAbstract3DGraph::removeCustomItem(QCustom3DItem *item)

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

Эта функция была добавлена в QtDataVisualization 1.1.

void QAbstract3DGraph::removeCustomItemAt(const QVector3D &position)

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

Эта функция была добавлена в QtDataVisualization 1.1.

void QAbstract3DGraph::removeCustomItems()

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

Эта функция была добавлена в QtDataVisualization 1.1.

QImage QAbstract3DGraph::renderToImage(int msaaSamples = 0, const QSize &imageSize = QSize())

Отрисовывает текущий кадр в изображение размером imageSize. Размер по умолчанию — размер окна. Изображение отрисовывается с уровнем сглаживания, заданным в msaaSamples. Уровень по умолчанию — 0.

Возвращает отрисованное изображение.

Примечание: OpenGL ES2 не поддерживает сглаживание, поэтому msaaSamples всегда принудительно устанавливается в 0.

Эта функция была добавлена в QtDataVisualization 1.1.

QAbstract3DAxis *QAbstract3DGraph::selectedAxis() const

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

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

Эта функция была добавлена в QtDataVisualization 1.1.

См. также selectedElement.

QCustom3DItem *QAbstract3DGraph::selectedCustomItem() const

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

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

Эта функция была добавлена в QtDataVisualization 1.1.

См. также selectedElement.

int QAbstract3DGraph::selectedCustomItemIndex() const

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

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

Эта функция была добавлена в QtDataVisualization 1.1.

См. также selectedElement.

int QAbstract3DGraph::selectedLabelIndex() const

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

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

Функция была добавлена в QtDataVisualization 1.1.

См. также selectedElement.

void QAbstract3DGraph::setActiveInputHandler(QAbstract3DInputHandler *inputHandler)

Устанавливает inputHandler в качестве активного обработчика ввода для графика. Неявно вызывает addInputHandler() для передачи владения inputHandler этому графику.

Если inputHandler равен null, после вызова активный обработчик ввода будет отсутствовать.

Примечание: Функция-сеттер для свойства activeInputHandler.

См. также activeInputHandler(), addInputHandler() и releaseInputHandler().

void QAbstract3DGraph::setActiveTheme(Q3DTheme *theme)

Устанавливает theme в качестве активной темы для графика. Неявно вызывает addTheme() для передачи владения темой этому графику.

Если theme равен null, создаётся временная тема по умолчанию. Эта временная тема удаляется, если впоследствии будет установлена какая-либо другая тема. Свойства темы можно изменять даже после её установки, изменения вступят в силу немедленно.

Примечание: Функция-сеттер для свойства activeTheme.

См. также activeTheme().

[virtual] bool QAbstract3DGraph::shadowsSupported() const

Возвращает true если тени поддерживаются с текущей конфигурацией. Конфигурации OpenGL ES2 не поддерживают тени.

QList<Q3DTheme *> QAbstract3DGraph::themes() const

Возвращает список всех добавленных тем.

См. также addTheme().

#include <QtDataVisualization/qutils.h>

// ...

Q3DBars *graph = new Q3DBars(QtDataVisualization::qDefaultSurfaceFormat(false));

#include <QtDataVisualization/qutils.h>

// ...

QQuickView viewer;
viewer.setFormat(QtDataVisualization::qDefaultSurfaceFormat());