QHeightMapSurfaceDataProxy Class
Basis-Proxy-Klasse für „ Q3DSurface “. Mehr...
| Header: | #include <QHeightMapSurfaceDataProxy> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS DataVisualization) target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
| qmake: | QT += datavisualization |
| Seit: | QtDataVisualization 1.0 |
| In QML: | HeightMapSurfaceDataProxy |
| Erbt von: | QSurfaceDataProxy |
| Status: | Veraltet |
Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.
Eigenschaften
|
Öffentliche Funktionen
| 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) |
Signale
| 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) |
Ausführliche Beschreibung
QHeightMapSurfaceDataProxy übernimmt die Verarbeitung von höhenkartendaten, die sich auf Oberflächen beziehen. Es bietet eine Möglichkeit, eine Höhenkarte zur Visualisierung als Oberflächendiagramm bereitzustellen.
Da Höhenkarten keine Werte für die X- oder Z-Achse enthalten, müssen diese Werte separat über die Eigenschaften „ minXValue “, „ maxXValue “, „ minZValue “ und „ maxZValue “ angegeben werden. Der X-Wert entspricht der horizontalen Bildrichtung, der Z-Wert der vertikalen. Das Setzen einer dieser Eigenschaften löst eine asynchrone Neuberechnung aller vorhandenen Höhenkarten aus.
Siehe auch „ QSurfaceDataProxy “ und „Qt Data Visualization – Datenverarbeitung“.
Dokumentation zu den Eigenschaften
[since 6.3] autoScaleY : bool
Werte auf die Y-Achse skalieren.
Standardwert ist „ false “.
Wenn diese Eigenschaft auf „ true “ gesetzt ist, werden die Höhenwerte so skaliert, dass sie auf der Y-Achse zwischen „ minYValue “ und „ maxYValue “ liegen.
Diese Aufzählung wurde in Qt 6.3 eingeführt.
Zugriffsfunktionen:
| bool | autoScaleY() const |
| void | setAutoScaleY(bool enabled) |
Notifier-Signal:
| void | autoScaleYChanged(bool enabled) |
Siehe auch „ minYValue “ und „ maxYValue “.
heightMap : QImage
Diese Eigenschaft enthält das Höhenkartenbild, das visualisiert werden soll.
Zugriffsfunktionen:
| QImage | heightMap() const |
| void | setHeightMap(const QImage &image) |
Benachrichtigungssignal:
| void | heightMapChanged(const QImage &image) |
heightMapFile : QString
Diese Eigenschaft enthält den Namen der Datei mit einem Höhenkartenbild, das visualisiert werden soll.
Zugriffsfunktionen:
| QString | heightMapFile() const |
| void | setHeightMapFile(const QString &filename) |
Benachrichtigungssignal:
| void | heightMapFileChanged(const QString &filename) |
maxXValue : float
Diese Eigenschaft enthält den maximalen X-Wert für die generierten Oberflächenpunkte.
Der Standardwert ist „ 10.0 “.
Bei der Einstellung dieser Eigenschaft wird der entsprechende Minimalwert bei Bedarf angepasst, um sicherzustellen, dass der Bereich gültig bleibt.
Zugriffsfunktionen:
| float | maxXValue() const |
| void | setMaxXValue(float max) |
Benachrichtigungssignal:
| void | maxXValueChanged(float value) |
[since 6.3] maxYValue : float
Diese Eigenschaft enthält den maximalen Y-Wert für die generierten Oberflächenpunkte.
Standardwert ist „ 10.0 “.
Beim Festlegen dieser Eigenschaft wird der entsprechende Minimalwert bei Bedarf angepasst, um sicherzustellen, dass der Bereich gültig bleibt.
Diese Aufzählung wurde in Qt 6.3 eingeführt.
Zugriffsfunktionen:
| float | maxYValue() const |
| void | setMaxYValue(float max) |
Notifier-Signal:
| void | maxYValueChanged(float value) |
Siehe auch „ autoScaleY “.
maxZValue : float
Diese Eigenschaft enthält den maximalen Z-Wert für die generierten Oberflächenpunkte.
Der Standardwert ist „ 10.0 “.
Bei der Einstellung dieser Eigenschaft wird der entsprechende Minimalwert bei Bedarf angepasst, um sicherzustellen, dass der Bereich gültig bleibt.
Zugriffsfunktionen:
| float | maxZValue() const |
| void | setMaxZValue(float max) |
Benachrichtigungssignal:
| void | maxZValueChanged(float value) |
minXValue : float
Diese Eigenschaft enthält den minimalen X-Wert für die generierten Oberflächenpunkte.
Der Standardwert ist „ 0.0 “.
Bei der Einstellung dieser Eigenschaft wird der entsprechende Maximalwert bei Bedarf angepasst, um sicherzustellen, dass der Bereich gültig bleibt.
Zugriffsfunktionen:
| float | minXValue() const |
| void | setMinXValue(float min) |
Benachrichtigungssignal:
| void | minXValueChanged(float value) |
[since 6.3] minYValue : float
Diese Eigenschaft enthält den minimalen Y-Wert für die generierten Oberflächenpunkte.
Standardwert ist „ 0.0 “.
Bei der Festlegung dieser Eigenschaft wird der entsprechende Maximalwert bei Bedarf angepasst, um sicherzustellen, dass der Bereich gültig bleibt.
Diese Enumeration wurde in Qt 6.3 eingeführt.
Zugriffsfunktionen:
| float | minYValue() const |
| void | setMinYValue(float min) |
Notifier-Signal:
| void | minYValueChanged(float value) |
Siehe auch autoScaleY.
minZValue : float
Diese Eigenschaft enthält den minimalen Z-Wert für die generierten Oberflächenpunkte.
Standardwert ist „ 0.0 “.
Bei der Einstellung dieser Eigenschaft wird der entsprechende Maximalwert bei Bedarf angepasst, um sicherzustellen, dass der Bereich gültig bleibt.
Zugriffsfunktionen:
| float | minZValue() const |
| void | setMinZValue(float min) |
Benachrichtigungssignal:
| void | minZValueChanged(float value) |
Dokumentation der Mitgliedsfunktionen
[explicit] QHeightMapSurfaceDataProxy::QHeightMapSurfaceDataProxy(QObject *parent = nullptr)
Erstellt ein `QHeightMapSurfaceDataProxy` mit den angegebenen ` parent`.
[explicit] QHeightMapSurfaceDataProxy::QHeightMapSurfaceDataProxy(const QImage &image, QObject *parent = nullptr)
Erstellt ein `QHeightMapSurfaceDataProxy` mit den angegebenen Werten für ` image ` und ` parent`. Die Höhenkarte wird durch Aufruf von ` setHeightMap()` mit ` image` festgelegt.
Siehe auch heightMap.
[explicit] QHeightMapSurfaceDataProxy::QHeightMapSurfaceDataProxy(const QString &filename, QObject *parent = nullptr)
Erstellt ein `QHeightMapSurfaceDataProxy` aus dem angegebenen Bild filename und parent. Die Höhenkarte wird durch Aufruf von ` setHeightMapFile()` mit filename festgelegt.
Siehe auch heightMapFile.
[virtual noexcept] QHeightMapSurfaceDataProxy::~QHeightMapSurfaceDataProxy()
Löscht „ QHeightMapSurfaceDataProxy “.
void QHeightMapSurfaceDataProxy::setHeightMap(const QImage &image)
Ersetzt die aktuellen Daten durch die in „ image “ angegebenen Höhenkartendaten.
image kann in verschiedenen Formaten angegeben werden; sollte es jedoch nicht in einem direkt verwendbaren Format vorliegen, wird eine Konvertierung durchgeführt.
Hinweis: Sollte das Ergebnis falsch erscheinen, ist die automatische Konvertierung fehlgeschlagen, und Sie sollten versuchen, die „ image “ selbst zu konvertieren, bevor Sie sie festlegen. Bevorzugtes Format ist „ QImage::Format_RGB32 “ in Graustufen.
Die Höhe des „ image “ wird aus der Rotkomponente der Pixel ermittelt, wenn das „ image “ in Graustufen vorliegt; andernfalls handelt es sich um einen Mittelwert, der aus den Rot-, Grün- und Blaukomponenten der Pixel berechnet wird. Die Verwendung von Graustufenbildern kann die Geschwindigkeit der Datenkonvertierung bei großen Bildern verbessern.
Nicht empfohlene Formate: alle Mono-Formate (z. B. „ QImage::Format_Mono “).
Die Höhenkarte wird asynchron aufgelöst. „ QSurfaceDataProxy::arrayReset()“ wird ausgelöst, sobald die Daten aufgelöst wurden.
Hinweis: Setter -Funktion für die Eigenschaft ` heightMap`.
Siehe auch „ heightMap()“.
void QHeightMapSurfaceDataProxy::setHeightMapFile(const QString &filename)
Ersetzt die aktuellen Daten durch Höhenkartendaten aus der durch „ filename “ angegebenen Datei.
Hinweis: Setter -Funktion für die Eigenschaft ` heightMapFile`.
Siehe auch „ heightMapFile()“ und „ heightMap “.
void QHeightMapSurfaceDataProxy::setValueRanges(float minX, float maxX, float minZ, float maxZ)
Eine Komfortfunktion zum gleichzeitigen Festlegen aller Minimalwerte (minX und minZ) und Maximalwerte (maxX und maxZ). Die Minimalwerte müssen kleiner sein als der entsprechende Maximalwert. Andernfalls werden die Werte so angepasst, dass sie gültig sind.
© 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.
