Класс Q3DSurface

Класс Q3DSurface предоставляет методы для визуализации 3D поверхностей. Подробнее...

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

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

Свойства

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

Сигналы

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

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

Класс Q3DSurface поддерживает выделение, отображая выделенную точку на данных, где пользователь щелкнул левой кнопкой мыши (при использовании обработчика ввода по умолчанию) или выделил с помощью QSurface3DSeries. Указатель выделения сопровождается меткой, которая в стандартном случае отображает значение точки данных и координаты точки.

Диапазон значений и формат метки, отображаемые на оси, можно настроить с помощью класса QValue3DAxis.

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

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

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

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

Q3DSurface surface;
surface.setFlags(surface.flags() ^ Qt::FramelessWindowHint);

Теперь Q3DSurface готов получать данные для отрисовки. Создайте элементы данных для хранения значений:

QSurfaceDataArray *data = new QSurfaceDataArray;
QSurfaceDataRow *dataRow1 = new QSurfaceDataRow;
QSurfaceDataRow *dataRow2 = new QSurfaceDataRow;

Сначала заполните данные элементами строк, а затем добавьте их указатели в элемент данных:

*dataRow1 << QVector3D(0.0f, 0.1f, 0.5f) << QVector3D(1.0f, 0.5f, 0.5f);
*dataRow2 << QVector3D(0.0f, 1.8f, 1.0f) << QVector3D(1.0f, 1.2f, 1.0f);
*data << dataRow1 << dataRow2;

Создайте новую серию и задайте для неё данные:

QSurface3DSeries *series = new QSurface3DSeries;
series->dataProxy()->resetArray(data);
surface.addSeries(series);

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

surface.show();

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

#include <QtDataVisualization>

using namespace QtDataVisualization;

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

    Q3DSurface surface;
    surface.setFlags(surface.flags() ^ Qt::FramelessWindowHint);
    QSurfaceDataArray *data = new QSurfaceDataArray;
    QSurfaceDataRow *dataRow1 = new QSurfaceDataRow;
    QSurfaceDataRow *dataRow2 = new QSurfaceDataRow;

    *dataRow1 << QVector3D(0.0f, 0.1f, 0.5f) << QVector3D(1.0f, 0.5f, 0.5f);
    *dataRow2 << QVector3D(0.0f, 1.8f, 1.0f) << QVector3D(1.0f, 1.2f, 1.0f);
    *data << dataRow1 << dataRow2;

    QSurface3DSeries *series = new QSurface3DSeries;
    series->dataProxy()->resetArray(data);
    surface.addSeries(series);
    surface.show();

    return app.exec();
}

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

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

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

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

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

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

[virtual] Q3DSurface::~Q3DSurface()

Удаляет график 3D поверхности.

void Q3DSurface::addAxis(QValue3DAxis *axis)

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

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

void Q3DSurface::addSeries(QSurface3DSeries *series)

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

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

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

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

void Q3DSurface::releaseAxis(QValue3DAxis *axis)

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

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

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

void Q3DSurface::removeSeries(QSurface3DSeries *series)

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

QList<QSurface3DSeries *> Q3DSurface::seriesList() const

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

void Q3DSurface::setAxisX(QValue3DAxis *axis)

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

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

Эта временная ось уничтожается, если другая ось явно устанавливается для той же ориентации.

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

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

void Q3DSurface::setAxisY(QValue3DAxis *axis)

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

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

Эта временная ось уничтожается, если другая ось явно устанавливается для той же ориентации.

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

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

void Q3DSurface::setAxisZ(QValue3DAxis *axis)

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

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

Эта временная ось уничтожается, если другая ось явно устанавливается для той же ориентации.

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

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