Класс Q3DSurface

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

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

Свойства

• 19 свойств унаследовано от QAbstract3DGraph
• 16 свойств унаследовано от QWindow
• 1 свойство унаследовано от QObject

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

• 54 публичных функций унаследовано от QAbstract3DGraph
• 82 публичных функций унаследовано от QWindow
• 145 публичных функций унаследовано от QOpenGLFunctions
• 31 публичных функций унаследовано от QObject
• 6 публичных функций унаследовано от QSurface

Сигналы

• 18 сигналов унаследовано от QAbstract3DGraph
• 18 сигналов унаследовано от QWindow
• 2 сигналов унаследовано от QObject

Статические публичные члены

• 1 статический публичный член унаследован от QWindow
• 9 статических публичных членов унаследовано от QObject

Дополнительные унаследованные члены

• 24 публичных слота унаследовано от QWindow
• 1 публичный слот унаследован от QObject
• 18 защищённых функций унаследовано от QWindow
• 9 защищённых функций унаследовано от QObject

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

Класс Q3DSurface предоставляет методы для отрисовки 3D-поверхностных графиков.

Этот класс позволяет разработчикам отрисовывать 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().