Класс QAbstract3DGraph

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

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

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

Свойства

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

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

• 82 public functions inherited from QWindow
• 145 public functions inherited from QOpenGLFunctions
• 31 public functions inherited from QObject
• 6 public functions inherited from QSurface

Сигналы

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

Статические публичные члены

• 1 статический публичный член, унаследованный от QWindow
• 9 статических публичных членов, унаследованных от QObject

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

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

• 24 public slots, унаследованные от QWindow
• 1 public slot, унаследованный от QObject
• 18 защищённых функций, унаследованных от QWindow
• 9 защищённых функций, унаследованных от 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++ Classes.

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

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

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

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

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

Флаг оптимизации для отрисовки.

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

Тип OptimizationHints является псевдонимом для QFlags<OptimizationHint>. Он хранит результат побитового ИЛИ комбинаций значений OptimizationHint.

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

Режимы выбора элементов. Значения этого перечисления можно объединять с помощью операции ИЛИ.

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

enum QAbstract3DGraph::ShadowQuality

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

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

[virtual] QAbstract3DGraph::~QAbstract3DGraph()

Уничтожает QAbstract3DGraph.

int QAbstract3DGraph::addCustomItem(QCustom3DItem *item)

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

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

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

Эта функция была добавлена в 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());