Класс Q3DScatter

Класс Q3DScatter предоставляет методы для визуализации 3D точечных графиков. Подробнее...

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

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

Свойства

• axisX : QValue3DAxis*
• axisY : QValue3DAxis*
• axisZ : QValue3DAxis*
• selectedSeries : QScatter3DSeries* const

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

Сигналы

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

Этот класс позволяет разработчикам визуализировать точечные графики в 3D и просматривать их, свободно поворачивая сцену. Поворот осуществляется нажатием правой кнопки мыши и перемещением курсора. Масштабирование выполняется колесом мыши. Выбор, если он включен, выполняется левой кнопкой мыши. Сцену можно сбросить к стандартному виду камеры, щелкнув колесом мыши. На сенсорных устройствах поворот выполняется с помощью нажатия и перемещения, выбор — с помощью нажатия и удерживания, масштабирование — с помощью сжатия.

Если явно не заданы оси для Q3DScatter, создаются временные стандартные оси без подписей. Эти стандартные оси можно изменить с помощью аксессоров осей, но как только любая ось явно задана для ориентации, стандартная ось для этой ориентации уничтожается.

Q3DScatter поддерживает отображение более одной серии одновременно.

Как создать минимальный график Q3DScatter

Сначала создайте Q3DScatter. Поскольку в этом примере график выполняется как окно верхнего уровня, необходимо сбросить флаг Qt::FramelessWindowHint, который устанавливается по умолчанию:

Q3DScatter scatter;
scatter.setFlags(scatter.flags() ^ Qt::FramelessWindowHint);

Теперь Q3DScatter готов к приёму данных для визуализации. Добавьте одну серию из 3 элементов QVector3D:

QScatter3DSeries *series = new QScatter3DSeries;
QScatterDataArray data;
data << QVector3D(0.5f, 0.5f, 0.5f) << QVector3D(-0.3f, -0.5f, -0.4f) << QVector3D(0.0f, -0.3f, 0.2f);
series->dataProxy()->addItems(data);
scatter.addSeries(series);

Наконец, вам необходимо сделать его видимым:

scatter.show();

Полный код, необходимый для создания и отображения этого графика:

#include <QtDataVisualization>

using namespace QtDataVisualization;

int main(int argc, char **argv)
{
    QGuiApplication app(argc, argv);

    Q3DScatter scatter;
    scatter.setFlags(scatter.flags() ^ Qt::FramelessWindowHint);
    QScatter3DSeries *series = new QScatter3DSeries;
    QScatterDataArray data;
    data << QVector3D(0.5f, 0.5f, 0.5f) << QVector3D(-0.3f, -0.5f, -0.4f) << QVector3D(0.0f, -0.3f, 0.2f);
    series->dataProxy()->addItems(data);
    scatter.addSeries(series);
    scatter.show();

    return app.exec();
}

И вот что эти несколько строк кода производят:

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

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

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

Q3DScatter::Q3DScatter(const QSurfaceFormat *format = nullptr, QWindow *parent = nullptr)

Конструирует новый 3D точечный график с необязательным родительским окном parent и форматированием поверхности format.

[virtual] Q3DScatter::~Q3DScatter()

Уничтожает 3D точечный график.

void Q3DScatter::addAxis(QValue3DAxis *axis)

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

См. также releaseAxis(), setAxisX(), setAxisY() и setAxisZ().

void Q3DScatter::addSeries(QScatter3DSeries *series)

Добавляет series на график. График может содержать несколько серий, но имеет только одну ось. Если вновь добавленная серия указала выбранный элемент, он будет выделен, а любое существующее выделение будет очищено. Только одна добавленная серия может иметь активное выделение.

QList<QValue3DAxis *> Q3DScatter::axes() const

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

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

QValue3DAxis *Q3DScatter::axisZ() const

Возвращает используемую ось Z.

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

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

void Q3DScatter::releaseAxis(QValue3DAxis *axis)

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

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

См. также addAxis(), setAxisX(), setAxisY() и setAxisZ().

void Q3DScatter::removeSeries(QScatter3DSeries *series)

Удаляет series с графика.

QList<QScatter3DSeries *> Q3DScatter::seriesList() const

Возвращает список серий, добавленных в этот график.

void Q3DScatter::setAxisX(QValue3DAxis *axis)

Устанавливает axis как активную ось X. Неявным образом вызывает addAxis() для передачи владения осью данному графику.

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

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

См. также axisX(), addAxis() и releaseAxis().

void Q3DScatter::setAxisY(QValue3DAxis *axis)

Устанавливает axis как активную ось Y. Неявным образом вызывает addAxis() для передачи владения осью данному графику.

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

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

См. также axisY(), addAxis() и releaseAxis().

void Q3DScatter::setAxisZ(QValue3DAxis *axis)

Устанавливает axis как активную ось Z. Неявным образом вызывает addAxis() для передачи владения осью данному графику.

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

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

См. также axisZ(), addAxis() и releaseAxis().