Класс 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 не должен быть null или добавлен к другому графику.

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