Класс 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.14/qheightmapsurfacedataproxy.html
