Класс Q3DScatter

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

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

Свойства

• 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>

int main(int argc, char **argv)
{
    qputenv("QSG_RHI_BACKEND", "opengl");
    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++ Classes.

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

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

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

Q3DScatter::~Q3DScatter()

Уничтожает 3D диаграмму рассеяния.

void Q3DScatter::addAxis(QValue3DAxis *axis)

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

См. также 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().