Класс 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++ классы.

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

enum QAbstract3DGraph::ElementType

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

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

enum QAbstract3DGraph::OptimizationHintflags QAbstract3DGraph::OptimizationHints

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

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

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

enum QAbstract3DGraph::SelectionFlagflags QAbstract3DGraph::SelectionFlags

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

Тип SelectionFlags является псевдонимом для 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());