Класс QSurface3DSeries
Класс QSurface3DSeries представляет серию данных в 3D графике поверхности. Подробнее...
| Заголовок: | #include <QSurface3DSeries> |
| С момента: | QtDataVisualization 1.0 |
| Инициализируется: | Surface3DSeries |
| Наследуется от: | QAbstract3DSeries |
Типы public
| перечисление | DrawFlag { DrawWireframe, DrawSurface, DrawSurfaceAndWireframe } |
| флаги | DrawFlags |
Свойства
|
|
- 17 свойств унаследовано от QAbstract3DSeries
- 1 свойство унаследовано от QObject
Public Функции
| QSurface3DSeries(QObject *parent = nullptr) | |
| QSurface3DSeries(QSurfaceDataProxy *dataProxy, QObject *parent = nullptr) | |
| virtual | ~QSurface3DSeries() |
| QSurfaceDataProxy * | dataProxy() const |
| QSurface3DSeries::DrawFlags | drawMode() const |
| bool | isFlatShadingEnabled() const |
| bool | isFlatShadingSupported() const |
| QPoint | selectedPoint() const |
| void | setDataProxy(QSurfaceDataProxy *proxy) |
| void | setDrawMode(QSurface3DSeries::DrawFlags mode) |
| void | setFlatShadingEnabled(bool enabled) |
| void | setSelectedPoint(const QPoint &position) |
| void | setTexture(const QImage &texture) |
| void | setTextureFile(const QString &filename) |
| QImage | texture() const |
| QString | textureFile() const |
- 33 public функции унаследованы от QAbstract3DSeries
- 34 public функции унаследованы от QObject
Сигналы
| void | dataProxyChanged(QSurfaceDataProxy *proxy) |
| void | drawModeChanged(QSurface3DSeries::DrawFlags mode) |
| void | flatShadingEnabledChanged(bool enable) |
| void | flatShadingSupportedChanged(bool enable) |
| void | selectedPointChanged(const QPoint &position) |
| void | textureChanged(const QImage &image) |
| void | textureFileChanged(const QString &filename) |
- 16 сигналов унаследовано от QAbstract3DSeries
- 2 сигнала унаследовано от QObject
Статические public члены
| QPoint | invalidSelectionPosition() |
- 10 статических public членов унаследовано от QObject
Дополнительные унаследованные члены
- 1 public слот унаследован от QObject
- 1 public переменная унаследована от QObject
- 9 protected функций унаследовано от QObject
- 2 protected переменных унаследовано от QObject
Подробное описание
Класс QSurface3DSeries представляет серию данных в 3D графике поверхности.
Этот класс управляет визуальными элементами, специфичными для серии, а также данными серии (через прокси данных).
Если для серии явно не задан прокси данных, серия создает прокси по умолчанию. Установка другого прокси приведет к уничтожению существующего прокси и всех данных, добавленных в него.
Набор объекта сетки, заданный свойством QAbstract3DSeries::mesh, определяет форму указателя выделения в серии поверхности.
QSurface3DSeries поддерживает следующие теги формата для QAbstract3DSeries::setItemLabelFormat():
| @xTitle | Название по оси x |
| @yTitle | Название по оси y |
| @zTitle | Название по оси z |
| @xLabel | Значение элемента, отформатированное с использованием формата оси x. Для получения дополнительной информации см. QValue3DAxis::setLabelFormat(). |
| @yLabel | Значение элемента, отформатированное с использованием формата оси y. Для получения дополнительной информации см. QValue3DAxis::setLabelFormat(). |
| @zLabel | Значение элемента, отформатированное с использованием формата оси z. Для получения дополнительной информации см. QValue3DAxis::setLabelFormat(). |
| @seriesName | Имя серии |
Например:
proxy->setItemLabelFormat(QStringLiteral("@valueTitle for (@rowLabel, @colLabel): %.1f")); См. также Обработка данных Qt Data Visualization.
Документация типов членов
перечисление QSurface3DSeries::DrawFlagфлаги QSurface3DSeries::DrawFlags
Режим рисования поверхности. Значения этого перечисления могут быть объединены с оператором OR.
| Постоянная | Значение | Описание |
|---|---|---|
QSurface3DSeries::DrawWireframe |
1 |
Рисуется только сетка. |
QSurface3DSeries::DrawSurface |
2 |
Рисуется только поверхность. |
QSurface3DSeries::DrawSurfaceAndWireframe |
DrawWireframe | DrawSurface |
Рисуются и поверхность, и сетка. |
Тип DrawFlags является типом-синонимом для QFlags<DrawFlag>. Он хранит объединение значений DrawFlag с использованием оператора OR.
Документация свойств
dataProxy : QSurfaceDataProxy*
Это свойство содержит активный прокси-сервер данных.
Ряд принимает во владение любой заданный ему прокси и удаляет любой ранее установленный прокси при добавлении нового. Прокси не может быть нулевым или задан другому ряду.
Функции доступа:
| QSurfaceDataProxy * | dataProxy() const |
| void | setDataProxy(QSurfaceDataProxy *proxy) |
Сигнал уведомления:
| void | dataProxyChanged(QSurfaceDataProxy *proxy) |
drawMode : DrawFlags
Режим отрисовки.
Возможные значения — значения перечисления DrawFlag. Очистка всех флагов запрещена.
Функции доступа:
| QSurface3DSeries::DrawFlags | drawMode() const |
| void | setDrawMode(QSurface3DSeries::DrawFlags mode) |
Сигнал уведомления:
| void | drawModeChanged(QSurface3DSeries::DrawFlags mode) |
flatShadingEnabled : bool
Это свойство определяет, включено ли плоское затенение поверхности.
По умолчанию установлено в значение true.
При отключении нормали на поверхности интерполируются, придавая краям сглаженный вид. При включении нормали сохраняются одинаковыми на треугольнике, делая цвет треугольника сплошным. Это повышает читаемость данных из модели.
Примечание: Для поверхностей с плоским затенением требуется по крайней мере GLSL версии 1.2 с расширением GL_EXT_gpu_shader4. Значение свойства flatShadingSupported указывает, поддерживается ли плоское затенение во время выполнения.
Функции доступа:
| bool | isFlatShadingEnabled() const |
| void | setFlatShadingEnabled(bool enabled) |
Сигнал уведомления:
| void | flatShadingEnabledChanged(bool enable) |
flatShadingSupported : const bool
Это свойство определяет, поддерживает ли текущая система плоское затенение поверхности.
Для плоского затенения поверхностей требуется по крайней мере GLSL версии 1.2 с расширением GL_EXT_gpu_shader4. Если true, плоское затенение поверхностей поддерживается.
Примечание: Это свойство только для чтения устанавливается с правильным значением после первого прохода отрисовки. До этого момента оно всегда равно true.
Функции доступа:
| bool | isFlatShadingSupported() const |
Сигнал уведомления:
| void | flatShadingSupportedChanged(bool enable) |
selectedPoint : QPoint
Это свойство содержит точку сетки поверхности, выбранную в ряду.
Функции доступа:
| QPoint | selectedPoint() const |
| void | setSelectedPoint(const QPoint &position) |
Сигнал уведомления:
| void | selectedPointChanged(const QPoint &position) |
texture : QImage
Это свойство содержит текстуру поверхности в виде QImage.
Установка пустого QImage очищает текстуру.
Функции доступа:
| QImage | texture() const |
| void | setTexture(const QImage &texture) |
Сигнал уведомления:
| void | textureChanged(const QImage &image) |
textureFile : QString
Это свойство содержит текстуру поверхности в виде файла.
Установка пустого имени файла очищает текстуру.
Функции доступа:
| QString | textureFile() const |
| void | setTextureFile(const QString &filename) |
Сигнал уведомления:
| void | textureFileChanged(const QString &filename) |
Документация функций-членов
QSurface3DSeries::QSurface3DSeries(QObject *parent = nullptr)
Создаёт ряд поверхностей 3D с родителем parent.
QSurface3DSeries::QSurface3DSeries(QSurfaceDataProxy *dataProxy, QObject *parent = nullptr)
Создаёт ряд поверхностей 3D с прокси-сервером данных dataProxy и родителем parent.
[virtual] QSurface3DSeries::~QSurface3DSeries()
Удаляет ряд поверхностей 3D.
[static] QPoint QSurface3DSeries::invalidSelectionPosition()
Возвращает QPoint, обозначающую недопустимую позицию выделения. Это устанавливается в свойство selectedPoint, чтобы очистить выделение из этого ряда.
См. также QAbstract3DGraph::clearSelection().
void QSurface3DSeries::setSelectedPoint(const QPoint &position)
Выделяет точку сетки поверхности в позиции position в массиве данных ряда, задаваемой строкой и столбцом.
Одновременно может быть выделена только одна точка.
Чтобы очистить выделение из этого ряда, устанавливается invalidSelectionPosition() как position. Если этот ряд добавлен в график, график может настроить выделение в соответствии с взаимодействием пользователя или если оно становится недопустимым.
Удаление строк или вставка строк в ряд перед строкой выделенной точки скорректирует выделение так, чтобы та же точка оставалась выделенной.
Примечание: Функция-сеттер для свойства selectedPoint.
См. также selectedPoint() и QAbstract3DGraph::clearSelection().
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/archives/qt-5.11/qsurface3dseries.html
