Sur cette page

HeightMapSurfaceDataProxy QML Type

Type de proxy de base pour Surface3D. En savoir plus...

Import Statement: import QtDataVisualization 1.12
Since: QtDataVisualization 1.0
In C++: QHeightMapSurfaceDataProxy
Inherits:

SurfaceDataProxy

Status: Deprecated

Ce type est obsolète. Nous déconseillons fortement de l'utiliser dans du nouveau code.

Propriétés

Description détaillée

HeightMapSurfaceDataProxy gère les données de carte d'altitude liées à une surface. Il permet de visualiser une carte d'altitude sous forme de graphique de surface.

Pour une description plus complète, consultez QHeightMapSurfaceDataProxy.

Voir également «Gestion des données »sur Qt Data Visualization .

Documentation sur les propriétés

autoScaleY : real [since 6.3]

Mise à l'échelle des valeurs de hauteur sur 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 propriété a été introduite dans Qt 6.3.

heightMapFile : string

Fichier contenant une image de carte d'altitude à visualiser. La définition de cette propriété remplace les données actuelles par celles de la carte d'altitude.

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 l'image vous-même avant de la définir. Le format recommandé est QImage::Format_RGB32 en niveaux de gris.

La hauteur de l’image est extraite 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.

Les cartes de hauteur 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 définition de l’une de ces propriétés déclenche un recalcul asynchrone de toute carte de hauteur existante.

Formats non recommandés : tous les formats mono (par exemple QImage::Format_Mono).

maxXValue : real

Valeur X maximale des points de surface générés. La valeur par défaut est 10.0. Lorsque cette propriété est définie, la valeur minimale correspondante est ajustée si nécessaire, afin de garantir que l'intervalle reste valide.

maxYValue : real [since 6.3]

Valeur Y maximale des points de surface générés. La valeur par défaut est « 10.0 ». Lorsque cette propriété est définie, la valeur minimale correspondante est ajustée si nécessaire, afin de garantir que la plage reste valide.

Cette propriété a été introduite dans Qt 6.3.

maxZValue : real

Valeur Z maximale des points de surface générés. La valeur par défaut est « 10.0 ». Lorsque cette propriété est définie, la valeur minimale correspondante est ajustée si nécessaire, afin de garantir que la plage reste valide.

minXValue : real

Valeur X minimale des points de surface générés. La valeur par défaut est 0.0. Lorsque cette propriété est définie, la valeur maximale correspondante est ajustée si nécessaire, afin de garantir que l'intervalle reste valide.

minYValue : real [since 6.3]

Valeur Y minimale des points de surface générés. La valeur par défaut est « 0.0 ». Lorsque cette propriété est définie, la valeur maximale correspondante est ajustée si nécessaire, afin de garantir que l'intervalle reste valide.

Cette propriété a été introduite dans Qt 6.3.

minZValue : real

Valeur Z minimale des points de surface générés. La valeur par défaut est « 0.0 ». Lorsque cette propriété est définie, la valeur maximale correspondante est ajustée si nécessaire, afin de garantir que la plage reste valide.

© 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.