QHeightMapSurfaceDataProxy Class
Basis-Proxyklasse für Q3DSurfaceWidgetItem. Mehr...
| Kopfzeile: | #include <QHeightMapSurfaceDataProxy> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Graphs)target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake: | QT += graphs |
| In QML: | HeightMapSurfaceDataProxy |
| Vererbt: | QSurfaceDataProxy |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QHeightMapSurfaceDataProxy ist Teil von Qt Graphs C++ Classes for 3D.
Eigenschaften
|
Öffentliche Funktionen
| 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) |
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) |
Detaillierte Beschreibung
QHeightMapSurfaceDataProxy kümmert sich um die Verarbeitung von Höhenkartendaten in Verbindung mit Oberflächen. Er ermöglicht die Visualisierung einer Höhenkarte als Oberflächenplot.
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 und der Z-Wert der vertikalen. Das Setzen einer dieser Eigenschaften löst eine asynchrone Neuauflösung einer vorhandenen Höhenkarte aus.
Siehe auch QSurfaceDataProxy und Qt Graphs Datenverarbeitung mit 3D.
Dokumentation der Eigenschaften
autoScaleY : bool
Skalierung der Höhenwerte auf die Y-Achse.
Die Standardeinstellung ist false.
Wenn diese Eigenschaft auf true eingestellt ist, werden die Höhenwerte so skaliert, dass sie auf die Y-Achse zwischen minYValue und maxYValue passen.
Zugriffsfunktionen:
| bool | autoScaleY() const |
| void | setAutoScaleY(bool enabled) |
Benachrichtigungssignal:
| void | autoScaleYChanged(bool enabled) |
Siehe auch minYValue und maxYValue.
heightMap : QImage
Diese Eigenschaft enthält das zu visualisierende Höhenkartenbild.
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 dem zu visualisierenden Höhenkartenbild.
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 erzeugten Oberflächenpunkte.
Der Standardwert ist 10.0.
Beim Setzen dieser Eigenschaft wird gegebenenfalls der entsprechende Minimalwert angepasst, um sicherzustellen, dass der Bereich gültig bleibt.
Zugriffsfunktionen:
| float | maxXValue() const |
| void | setMaxXValue(float max) |
Melder-Signal:
| void | maxXValueChanged(float value) |
maxYValue : float
Diese Eigenschaft enthält den maximalen Y-Wert für die erzeugten Oberflächenpunkte.
Der Standardwert ist 10.0.
Beim Setzen dieser Eigenschaft wird gegebenenfalls der entsprechende Minimalwert angepasst, um sicherzustellen, dass der Bereich gültig bleibt.
Zugriffsfunktionen:
| float | maxYValue() const |
| void | setMaxYValue(float max) |
Melder-Signal:
| void | maxYValueChanged(float value) |
Siehe auch autoScaleY.
maxZValue : float
Diese Eigenschaft enthält den maximalen Z-Wert für die erzeugten Oberflächenpunkte.
Der Standardwert ist 10.0.
Beim Setzen dieser Eigenschaft wird gegebenenfalls der entsprechende Minimalwert angepasst, um sicherzustellen, dass der Bereich gültig bleibt.
Zugriffsfunktionen:
| float | maxZValue() const |
| void | setMaxZValue(float max) |
Melder-Signal:
| void | maxZValueChanged(float value) |
minXValue : float
Diese Eigenschaft enthält den minimalen X-Wert für die erzeugten Oberflächenpunkte.
Der Standardwert ist 0.0.
Beim Setzen dieser Eigenschaft wird der entsprechende Maximalwert gegebenenfalls angepasst, um sicherzustellen, dass der Bereich gültig bleibt.
Zugriffsfunktionen:
| float | minXValue() const |
| void | setMinXValue(float min) |
Melder-Signal:
| void | minXValueChanged(float value) |
minYValue : float
Diese Eigenschaft enthält den minimalen Y-Wert für die erzeugten Oberflächenpunkte.
Der Standardwert ist 0.0.
Beim Setzen dieser Eigenschaft wird der entsprechende Maximalwert gegebenenfalls angepasst, um sicherzustellen, dass der Bereich gültig bleibt.
Zugriffsfunktionen:
| float | minYValue() const |
| void | setMinYValue(float min) |
Melder-Signal:
| void | minYValueChanged(float value) |
Siehe auch autoScaleY.
minZValue : float
Diese Eigenschaft enthält den minimalen Z-Wert für die erzeugten Oberflächenpunkte.
Der Standardwert ist 0.0.
Beim Setzen dieser Eigenschaft wird der entsprechende Maximalwert gegebenenfalls angepasst, um sicherzustellen, dass der Bereich gültig bleibt.
Zugriffsfunktionen:
| float | minZValue() const |
| void | setMinZValue(float min) |
Notifier-Signal:
| void | minZValueChanged(float value) |
Member Function Dokumentation
[explicit] QHeightMapSurfaceDataProxy::QHeightMapSurfaceDataProxy(QObject *parent = nullptr)
Konstruiert QHeightMapSurfaceDataProxy mit der angegebenen parent.
[explicit] QHeightMapSurfaceDataProxy::QHeightMapSurfaceDataProxy(const QImage &image, QObject *parent = nullptr)
Konstruiert QHeightMapSurfaceDataProxy mit den angegebenen image und parent. Die Höhenkarte wird durch den Aufruf von setHeightMap() mit image gesetzt.
Siehe auch heightMap.
[explicit] QHeightMapSurfaceDataProxy::QHeightMapSurfaceDataProxy(const QString &filename, QObject *parent = nullptr)
Konstruiert QHeightMapSurfaceDataProxy aus dem angegebenen Bild filename und parent. Die Höhenkarte wird durch den Aufruf von setHeightMapFile() mit filename gesetzt.
Siehe auch heightMapFile.
[override virtual noexcept] QHeightMapSurfaceDataProxy::~QHeightMapSurfaceDataProxy()
Zerstört QHeightMapSurfaceDataProxy.
void QHeightMapSurfaceDataProxy::setHeightMap(const QImage &image)
Ersetzt die aktuellen Daten durch die von image angegebenen Höhenkartendaten.
Es gibt mehrere Formate, in denen image angegeben werden kann, aber wenn es nicht in einem direkt verwendbaren Format vorliegt, wird eine Konvertierung vorgenommen.
Hinweis: Wenn das Ergebnis falsch erscheint, ist die automatische Konvertierung fehlgeschlagen und Sie sollten versuchen, die image selbst zu konvertieren, bevor Sie sie einstellen. Das bevorzugte Format ist QImage::Format_RGB32 in Graustufen.
Die Höhe von image wird aus dem Rotanteil der Pixel gelesen, wenn image in Graustufen vorliegt. Andernfalls handelt es sich um einen Durchschnittswert, der aus den Rot-, Grün- und Blauanteilen der Pixel berechnet wird. Die Verwendung von Graustufenbildern kann die Geschwindigkeit der Datenkonvertierung für große Bilder verbessern.
Nicht empfohlene Formate: alle Monoformate (zum Beispiel QImage::Format_Mono).
Die Höhenkarte wird asynchron aufgelöst. QSurfaceDataProxy::arrayReset() wird ausgegeben, wenn 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 Setzen aller Minimal- (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.
© 2025 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.
