QHeightMapSurfaceDataProxy Class
Classe proxy de base pour Q3DSurface. En savoir plus...
| En-tête : | #include <QHeightMapSurfaceDataProxy> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS DataVisualization) target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
| qmake : | QT += datavisualization |
| Depuis : | QtDataVisualization 1.0 |
| En QML : | HeightMapSurfaceDataProxy |
| Hérite de : | QSurfaceDataProxy |
| Statut : | Obsolète |
Cette classe est obsolète. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.
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() |
| 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 gère les données de carte d'altitude liées à une surface. Il permet de fournir une carte d'altitude destinée à être visualisée sous forme de graphique de surface.
Les cartes d'altitude ne contenant pas de valeurs pour les axes X ou Z, celles-ci 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 modification de l'une de ces propriétés déclenche une nouvelle résolution asynchrone de toute carte d'altitude existante.
Voir également QSurfaceDataProxy et Qt Data Visualization Gestion des données.
Documentation sur les propriétés
[since 6.3] autoScaleY : bool
Mettre les valeurs de hauteur à l'échelle de l'axe Y.
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 ».
Cette énumération a été introduite dans Qt 6.3.
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 d'altitude à afficher.
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 de hauteur à afficher.
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 des points de surface générés.
La valeur par défaut est « 10.0 ».
Lors de la définition de cette propriété, la valeur minimale correspondante est ajustée si nécessaire, afin de garantir que la plage reste valide.
Fonctions d'accès :
| float | maxXValue() const |
| void | setMaxXValue(float max) |
Signal de notification :
| void | maxXValueChanged(float value) |
[since 6.3] maxYValue : float
Cette propriété contient la valeur Y maximale des points de surface générés.
La valeur par défaut est 10.0.
Lors de la définition de cette propriété, la valeur minimale correspondante est ajustée si nécessaire, afin de garantir que la plage reste valide.
Cette énumération a été introduite dans Qt 6.3.
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 Z maximale des points de surface générés.
La valeur par défaut est 10.0.
Lors de la définition de cette propriété, la valeur minimale correspondante est ajustée si nécessaire, afin de garantir que la plage reste valide.
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 des points de surface générés.
La valeur par défaut est « 0.0 ».
Lors de la définition de cette propriété, la valeur maximale correspondante est ajustée si nécessaire, afin de garantir que la plage reste valide.
Fonctions d'accès :
| float | minXValue() const |
| void | setMinXValue(float min) |
Signal de notification :
| void | minXValueChanged(float value) |
[since 6.3] minYValue : float
Cette propriété contient la valeur Y minimale des points de surface générés.
La valeur par défaut est 0.0.
Lors de la définition de cette propriété, la valeur maximale correspondante est ajustée si nécessaire, afin de garantir que la plage reste valide.
Cette énumération a été introduite dans Qt 6.3.
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 Z minimale des points de surface générés.
La valeur par défaut est « 0.0 ».
Lors de la définition de cette propriété, la valeur maximale correspondante est ajustée si nécessaire, afin de garantir que la plage reste valide.
Fonctions d'accès :
| float | minZValue() const |
| void | setMinZValue(float min) |
Signal de notification :
| void | minZValueChanged(float value) |
Documentation des fonctions membres
[explicit] QHeightMapSurfaceDataProxy::QHeightMapSurfaceDataProxy(QObject *parent = nullptr)
Construit un objet `QHeightMapSurfaceDataProxy` à partir de l'parent` fourni.
[explicit] QHeightMapSurfaceDataProxy::QHeightMapSurfaceDataProxy(const QImage &image, QObject *parent = nullptr)
Construit un objet `QHeightMapSurfaceDataProxy` à partir des paramètres ` image ` et ` parent` fournis. La carte de hauteur est définie en appelant la méthode ` setHeightMap()` avec le paramètre ` image`.
Voir également heightMap.
[explicit] QHeightMapSurfaceDataProxy::QHeightMapSurfaceDataProxy(const QString &filename, QObject *parent = nullptr)
Construit un objet `QHeightMapSurfaceDataProxy` à partir de l'image fournie filename et parent. La carte d'altitude est définie en appelant la fonction ` setHeightMapFile()` avec l'argument filename.
Voir également heightMapFile.
[virtual noexcept] QHeightMapSurfaceDataProxy::~QHeightMapSurfaceDataProxy()
Supprime QHeightMapSurfaceDataProxy.
void QHeightMapSurfaceDataProxy::setHeightMap(const QImage &image)
Remplace les données actuelles par les données de la carte d'altitude spécifiées par image.
Le fichier image peut être fourni dans plusieurs formats, mais s'il n'est pas dans un format directement utilisable, une conversion est effectuée.
Remarque : si le résultat semble incorrect, cela signifie que la conversion automatique a échoué et que vous devriez essayer de convertir vous-même l'image avant de la définir. Le format recommandé est QImage::Format_RGB32 en niveaux de gris.
La hauteur de l’ image est déterminée à partir de la composante rouge des pixels si l’ image est en niveaux de gris ; sinon, elle correspond à 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 monochromes (par exemple QImage::Format_Mono).
La carte de hauteur est traitée de manière asynchrone. L'événement QSurfaceDataProxy::arrayReset() est déclenché lorsque les données ont été traitées.
Remarque : fonctionde définition pour 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 d'altitude provenant du fichier spécifié par filename.
Remarque : fonctionde définition de la propriété ` heightMapFile`.
Voir également heightMapFile() et heightMap.
void QHeightMapSurfaceDataProxy::setValueRanges(float minX, float maxX, float minZ, float maxZ)
Une 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 afin d’ê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.
