Класс QHeightMapSurfaceDataProxy
Базовый прокси-класс для Q3DSurface. Подробнее...
| Заголовок: | #include <QHeightMapSurfaceDataProxy> |
| С тех пор: | QtDataVisualization 1.0 |
| Инициализируется: | HeightMapSurfaceDataProxy |
| Наследует: | QSurfaceDataProxy |
Этот класс был представлен в QtDataVisualization 1.0.
Свойства
|
Открытые функции
| QHeightMapSurfaceDataProxy(const QString &filename, QObject *parent = nullptr) | |
| QHeightMapSurfaceDataProxy(const QImage &image, QObject *parent = nullptr) | |
| QHeightMapSurfaceDataProxy(QObject *parent = nullptr) | |
| virtual | ~QHeightMapSurfaceDataProxy() |
| QImage | heightMap() const |
| QString | heightMapFile() const |
| float | maxXValue() const |
| float | maxZValue() const |
| float | minXValue() const |
| float | minZValue() const |
| void | setHeightMap(const QImage &image) |
| void | setHeightMapFile(const QString &filename) |
| void | setMaxXValue(float max) |
| void | setMaxZValue(float max) |
| void | setMinXValue(float min) |
| void | setMinZValue(float min) |
| void | setValueRanges(float minX, float maxX, float minZ, float maxZ) |
Сигналы
| void | heightMapChanged(const QImage &image) |
| void | heightMapFileChanged(const QString &filename) |
| void | maxXValueChanged(float value) |
| void | maxZValueChanged(float value) |
| void | minXValueChanged(float value) |
| void | minZValueChanged(float value) |
Подробное описание
QHeightMapSurfaceDataProxy отвечает за обработку данных высоты карты поверхности. Он предоставляет способ отображения карты высот в виде графической поверхности.
Поскольку карты высот не содержат значений для осей X или Z, эти значения необходимо задавать отдельно, используя свойства minXValue, maxXValue, minZValue и maxZValue. Значение X соответствует горизонтальному направлению изображения, а значение Z — вертикальному. Установка любого из этих свойств запускает асинхронное повторное разрешение любой существующей карты высот.
См. также QSurfaceDataProxy и Обработка данных Qt Data Visualization.
Документация свойств
heightMap : QImage
Это свойство содержит изображение карты высот для визуализации.
Функции доступа:
| QImage | heightMap() const |
| void | setHeightMap(const QImage &image) |
Сигнал уведомления:
| void | heightMapChanged(const QImage &image) |
heightMapFile : QString
Это свойство содержит имя файла с изображением карты высот для визуализации.
Функции доступа:
| QString | heightMapFile() const |
| void | setHeightMapFile(const QString &filename) |
Сигнал уведомления:
| void | heightMapFileChanged(const QString &filename) |
maxXValue : float
Это свойство содержит максимальное значение X для сгенерированных точек поверхности.
По умолчанию 10.0.
При установке этого свойства соответствующее минимальное значение корректируется при необходимости, чтобы диапазон оставался допустимым.
Функции доступа:
| float | maxXValue() const |
| void | setMaxXValue(float max) |
Сигнал уведомления:
| void | maxXValueChanged(float value) |
maxZValue : float
Это свойство содержит максимальное значение Z для сгенерированных точек поверхности.
По умолчанию 10.0.
При установке этого свойства соответствующее минимальное значение корректируется при необходимости, чтобы диапазон оставался допустимым.
Функции доступа:
| float | maxZValue() const |
| void | setMaxZValue(float max) |
Сигнал уведомления:
| void | maxZValueChanged(float value) |
minXValue : float
Это свойство содержит минимальное значение X для сгенерированных точек поверхности.
По умолчанию 0.0.
При установке этого свойства соответствующее максимальное значение корректируется при необходимости, чтобы диапазон оставался допустимым.
Функции доступа:
| float | minXValue() const |
| void | setMinXValue(float min) |
Сигнал уведомления:
| void | minXValueChanged(float value) |
minZValue : float
Это свойство содержит минимальное значение Z для сгенерированных точек поверхности.
По умолчанию 0.0.
При установке этого свойства соответствующее максимальное значение корректируется при необходимости, чтобы диапазон оставался допустимым.
Функции доступа:
| float | minZValue() const |
| void | setMinZValue(float min) |
Сигнал уведомления:
| void | minZValueChanged(float value) |
Документация функций-членов
QHeightMapSurfaceDataProxy::QHeightMapSurfaceDataProxy(const QString &filename, QObject *parent = nullptr)
Создаёт QHeightMapSurfaceDataProxy из заданного файла изображения filename и parent. Карта высот устанавливается вызовом setHeightMapFile() с filename.
См. также heightMapFile.
QHeightMapSurfaceDataProxy::QHeightMapSurfaceDataProxy(const QImage &image, QObject *parent = nullptr)
Создаёт QHeightMapSurfaceDataProxy с заданным изображением image и parent. Карта высот устанавливается вызовом setHeightMap() с image.
См. также heightMap.
QHeightMapSurfaceDataProxy::QHeightMapSurfaceDataProxy(QObject *parent = nullptr)
Создаёт QHeightMapSurfaceDataProxy с заданным parent.
[virtual] QHeightMapSurfaceDataProxy::~QHeightMapSurfaceDataProxy()
Уничтожает QHeightMapSurfaceDataProxy.
void QHeightMapSurfaceDataProxy::setHeightMap(const QImage &image)
Заменяет текущие данные данными карты высот, указанными в image.
Существует несколько форматов, в которых может быть представлено изображение image, но если оно не в непосредственно используемом формате, выполняется преобразование.
Примечание: Если результат кажется неправильным, автоматическое преобразование не удалось, и вы должны попробовать преобразовать image самостоятельно перед его установкой. Предпочтительный формат — QImage::Format_RGB32 в градациях серого.
Высота image считывается из красного компонента пикселей, если image в градациях серого, иначе вычисляется как среднее значение из красного, зелёного и синего компонентов пикселей. Использование изображений в градациях серого может улучшить скорость преобразования данных для больших изображений.
Не рекомендуемые форматы: все моноформаты (например, QImage::Format_Mono).
Карта высот разрешается асинхронно. QSurfaceDataProxy::arrayReset() генерируется, когда данные были обработаны.
Примечание: Функция-установщик для свойства heightMap.
См. также heightMap().
void QHeightMapSurfaceDataProxy::setHeightMapFile(const QString &filename)
Заменяет текущие данные данными карты высот из файла, указанного в filename.
Примечание: Функция-установщик для свойства heightMapFile.
См. также heightMapFile() и heightMap.
void QHeightMapSurfaceDataProxy::setValueRanges(float minX, float maxX, float minZ, float maxZ)
Удобная функция для одновременной установки минимальных (minX и minZ) и максимальных (maxX и maxZ) значений. Минимальные значения должны быть меньше соответствующих максимальных значений. В противном случае значения корректируются для обеспечения их допустимости.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.15/qheightmapsurfacedataproxy.html