QHeightMapSurfaceDataProxy Class
Classe proxy de base pour Q3DSurfaceWidgetItem. Plus...
| En-tête : | #include <QHeightMapSurfaceDataProxy> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Graphs)target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake : | QT += graphs |
| En QML : | HeightMapSurfaceDataProxy |
| Héritages : | QSurfaceDataProxy |
- Liste de tous les membres, y compris les membres hérités
- QHeightMapSurfaceDataProxy fait partie de Qt Graphs C++ Classes for 3D.
Propriétés
|
Fonctions publiques
| QHeightMapSurfaceDataProxy(QObject *parent = nullptr) | |
| QHeightMapSurfaceDataProxy(const QImage &image, QObject *parent = nullptr) | |
| QHeightMapSurfaceDataProxy(const QString &filename, QObject *parent = nullptr) | |
| virtual | ~QHeightMapSurfaceDataProxy() override |
| bool | autoScaleY() const |
| QImage | heightMap() const |
| QString | heightMapFile() const |
| float | maxXValue() const |
| float | maxYValue() const |
| float | maxZValue() const |
| float | minXValue() const |
| float | minYValue() const |
| float | minZValue() const |
| void | setAutoScaleY(bool enabled) |
| void | setHeightMap(const QImage &image) |
| void | setHeightMapFile(const QString &filename) |
| void | setMaxXValue(float max) |
| void | setMaxYValue(float max) |
| void | setMaxZValue(float max) |
| void | setMinXValue(float min) |
| void | setMinYValue(float min) |
| void | setMinZValue(float min) |
| void | setValueRanges(float minX, float maxX, float minZ, float maxZ) |
Signaux
| void | autoScaleYChanged(bool enabled) |
| void | heightMapChanged(const QImage &image) |
| void | heightMapFileChanged(const QString &filename) |
| void | maxXValueChanged(float value) |
| void | maxYValueChanged(float value) |
| void | maxZValueChanged(float value) |
| void | minXValueChanged(float value) |
| void | minYValueChanged(float value) |
| void | minZValueChanged(float value) |
Description détaillée
QHeightMapSurfaceDataProxy prend en charge le traitement des données des cartes d'altitude liées aux surfaces. Il permet de visualiser une carte d'altitude sous la forme d'un tracé de surface.
Comme les cartes d'altitude ne contiennent pas de valeurs pour les axes X et Z, ces valeurs doivent être fournies séparément à l'aide des propriétés minXValue, maxXValue, minZValue, et maxZValue. La valeur X correspond à la direction horizontale de l'image et la valeur Z à la direction verticale. La définition de l'une de ces propriétés déclenche une résolution asynchrone de toute carte d'altitude existante.
Voir également QSurfaceDataProxy et Qt Graphs Data Handling with 3D.
Documentation sur les propriétés
autoScaleY : bool
Échelle des valeurs de hauteur sur l'axe des ordonnées.
La valeur par défaut est false.
Lorsque cette propriété est définie sur true, les valeurs de hauteur sont mises à l'échelle pour s'adapter à l'axe Y entre minYValue et maxYValue.
Fonctions d'accès :
| bool | autoScaleY() const |
| void | setAutoScaleY(bool enabled) |
Signal de notification :
| void | autoScaleYChanged(bool enabled) |
Voir également minYValue et maxYValue.
heightMap : QImage
Cette propriété contient l'image de la carte en hauteur à visualiser.
Fonctions d'accès :
| QImage | heightMap() const |
| void | setHeightMap(const QImage &image) |
Signal de notification :
| void | heightMapChanged(const QImage &image) |
heightMapFile : QString
Cette propriété contient le nom du fichier contenant l'image de la carte des hauteurs à visualiser.
Fonctions d'accès :
| QString | heightMapFile() const |
| void | setHeightMapFile(const QString &filename) |
Signal de notification :
| void | heightMapFileChanged(const QString &filename) |
maxXValue : float
Cette propriété contient la valeur X maximale pour les points de surface générés.
La valeur par défaut est 10.0.
Lors du réglage de cette propriété, la valeur minimale correspondante est ajustée si nécessaire, afin de garantir la validité de la plage.
Fonctions d'accès :
| float | maxXValue() const |
| void | setMaxXValue(float max) |
Signal de notification :
| void | maxXValueChanged(float value) |
maxYValue : float
Cette propriété contient la valeur maximale de Y pour les points de surface générés.
La valeur par défaut est 10.0.
Lors du réglage de cette propriété, la valeur minimale correspondante est ajustée si nécessaire, afin de garantir la validité de la plage.
Fonctions d'accès :
| float | maxYValue() const |
| void | setMaxYValue(float max) |
Signal de notification :
| void | maxYValueChanged(float value) |
Voir également autoScaleY.
maxZValue : float
Cette propriété contient la valeur maximale de Z pour les points de surface générés.
La valeur par défaut est 10.0.
Lors du réglage de cette propriété, la valeur minimale correspondante est ajustée si nécessaire, afin de garantir la validité de la plage.
Fonctions d'accès :
| float | maxZValue() const |
| void | setMaxZValue(float max) |
Signal de notification :
| void | maxZValueChanged(float value) |
minXValue : float
Cette propriété contient la valeur X minimale pour les points de surface générés.
La valeur par défaut est 0.0.
Lors du réglage de cette propriété, la valeur maximale correspondante est ajustée si nécessaire, afin de s'assurer que la plage reste valide.
Fonctions d'accès :
| float | minXValue() const |
| void | setMinXValue(float min) |
Signal de notification :
| void | minXValueChanged(float value) |
minYValue : float
Cette propriété contient la valeur minimale de Y pour les points de surface générés.
La valeur par défaut est 0.0.
Lors du réglage de cette propriété, la valeur maximale correspondante est ajustée si nécessaire, afin de garantir la validité de la plage.
Fonctions d'accès :
| float | minYValue() const |
| void | setMinYValue(float min) |
Signal de notification :
| void | minYValueChanged(float value) |
Voir également autoScaleY.
minZValue : float
Cette propriété contient la valeur minimale de Z pour les points de surface générés.
La valeur par défaut est 0.0.
Lors du réglage de cette propriété, la valeur maximale correspondante est ajustée si nécessaire, afin de garantir la validité de la plage.
Fonctions d'accès :
| float | minZValue() const |
| void | setMinZValue(float min) |
Signal Notificateur :
| void | minZValueChanged(float value) |
Member Function Documentation
[explicit] QHeightMapSurfaceDataProxy::QHeightMapSurfaceDataProxy(QObject *parent = nullptr)
Construit QHeightMapSurfaceDataProxy avec l'adresse parent.
[explicit] QHeightMapSurfaceDataProxy::QHeightMapSurfaceDataProxy(const QImage &image, QObject *parent = nullptr)
Construit QHeightMapSurfaceDataProxy avec les données image et parent. La carte des hauteurs est définie en appelant setHeightMap() avec image.
Voir également heightMap.
[explicit] QHeightMapSurfaceDataProxy::QHeightMapSurfaceDataProxy(const QString &filename, QObject *parent = nullptr)
Construit QHeightMapSurfaceDataProxy à partir des images données filename et parent. La carte des hauteurs est définie en appelant setHeightMapFile() avec filename.
Voir également heightMapFile.
[override virtual noexcept] QHeightMapSurfaceDataProxy::~QHeightMapSurfaceDataProxy()
Détruit QHeightMapSurfaceDataProxy.
void QHeightMapSurfaceDataProxy::setHeightMap(const QImage &image)
Remplace les données actuelles par les données de la carte d'altitude spécifiée par image.
Il existe plusieurs formats dans lesquels image peut être fourni, mais s'il n'est pas dans un format directement utilisable, une conversion est effectuée.
Remarque : si le résultat semble erroné, la conversion automatique a échoué et vous devez essayer de convertir le site image vous-même avant de le paramétrer. Le format préféré est QImage::Format_RGB32 en niveaux de gris.
La hauteur de image est lue à partir de la composante rouge des pixels si image est en niveaux de gris. Sinon, il s'agit d'une moyenne calculée à partir des composantes rouge, verte et bleue des pixels. L'utilisation d'images en niveaux de gris peut améliorer la vitesse de conversion des données pour les images de grande taille.
Formats non recommandés : tous les formats mono (par exemple QImage::Format_Mono).
La carte des hauteurs est résolue de manière asynchrone. QSurfaceDataProxy::arrayReset() est émis lorsque les données ont été résolues.
Remarque : fonction de définition de la propriété heightMap.
Voir également heightMap().
void QHeightMapSurfaceDataProxy::setHeightMapFile(const QString &filename)
Remplace les données actuelles par les données de la carte des hauteurs provenant du fichier spécifié par filename.
Remarque : fonction de définition de la propriété heightMapFile.
Voir également heightMapFile() et heightMap.
void QHeightMapSurfaceDataProxy::setValueRanges(float minX, float maxX, float minZ, float maxZ)
Fonction pratique permettant de définir simultanément toutes les valeurs minimales (minX et minZ) et maximales (maxX et maxZ). Les valeurs minimales doivent être inférieures à la valeur maximale correspondante. Dans le cas contraire, les valeurs sont ajustées de manière à être valides.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
