Класс QHeightMapSurfaceDataProxy
Базовый класс-прокси для Q3DSurface. Подробнее...
| Заголовок: | #include <QHeightMapSurfaceDataProxy> |
| С момента: | QtDataVisualization 1.0 |
| Создаётся: | HeightMapSurfaceDataProxy |
| Наследуется от: | QSurfaceDataProxy |
Свойства
|
Открытые функции
| 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-6.2/qheightmapsurfacedataproxy.html