Класс QAbstract3DGraph

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

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

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

Типы публичного доступа

Свойства

Публичные функции

Сигналы

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

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

Этот класс наследуется от 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>. Он хранит результат побитового ИЛИ комбинации значений OptimizationHint.

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

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

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

перечисление 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());