Back to Qt.io
Contact Us Blog Download Qt
Auf dieser Seite

HeightMapSurfaceDataProxy QML Type

Basis-Proxy-Typ für „ Surface3D “. Mehr...

Import Statement: import QtGraphs
In C++: QHeightMapSurfaceDataProxy
Inherits:

SurfaceDataProxy

Eigenschaften

Signale

Ausführliche Beschreibung

QHeightMapSurfaceDataProxy übernimmt die Verarbeitung von Höhenkartendaten, die sich auf Oberflächen beziehen. Es ermöglicht die Visualisierung einer Höhenkarte als Oberflächendiagramm.

Eine ausführlichere Beschreibung finden Sie unter QHeightMapSurfaceDataProxy.

Siehe auch Qt Graphs Datenverarbeitung mit 3D.

Dokumentation zu den Eigenschaften

autoScaleY : real

Höhenwerte 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.

heightMapFile : string

Eine Datei mit einem Höhenkartenbild, das visualisiert werden soll. Durch das Festlegen dieser Eigenschaft werden die aktuellen Daten durch die Höhenkartendaten ersetzt.

Die Bilddatei kann in verschiedenen Formaten vorliegen; sollte sie jedoch nicht in einem direkt verwendbaren Format vorliegen, wird eine Konvertierung durchgeführt.

Hinweis: Wenn das Ergebnis falsch erscheint, ist die automatische Konvertierung fehlgeschlagen, und Sie sollten versuchen, das Bild selbst zu konvertieren, bevor Sie es einstellen. Bevorzugtes Format ist „ QImage::Format_RGB32 “ in Graustufen.

Die Höhe des Bildes wird aus der Rotkomponente der Pixel ausgelesen, wenn das Bild in Graustufen vorliegt. Andernfalls handelt es sich um einen Durchschnittswert, 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.

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 Richtung des Bildes, der Z-Wert der vertikalen. Das Festlegen einer dieser Eigenschaften löst eine asynchrone Neuauflösung aller vorhandenen Höhenkarten aus.

Nicht empfohlene Formate: alle Monoformate (zum Beispiel QImage::Format_Mono).

maxXValue : real

Der maximale X-Wert für die generierten Oberflächenpunkte. Der Standardwert ist „ 10.0 “. Bei der Festlegung dieser Eigenschaft wird der entsprechende Mindestwert bei Bedarf angepasst, um sicherzustellen, dass der Bereich gültig bleibt.

maxYValue : real

Der maximale Y-Wert für die generierten Oberflächenpunkte. Der Standardwert ist „ 10.0 “. Bei der Festlegung dieser Eigenschaft wird der entsprechende Mindestwert bei Bedarf angepasst, um sicherzustellen, dass der Bereich gültig bleibt.

maxZValue : real

Der maximale Z-Wert für die generierten Oberflächenpunkte. Der Standardwert lautet „ 10.0 “. Bei der Einstellung dieser Eigenschaft wird der entsprechende Mindestwert bei Bedarf angepasst, um sicherzustellen, dass der Bereich gültig bleibt.

minXValue : real

Der minimale X-Wert für die generierten Oberflächenpunkte. Der Standardwert lautet „ 0.0 “. Bei der Festlegung dieser Eigenschaft wird der entsprechende Maximalwert gegebenenfalls angepasst, um sicherzustellen, dass der Bereich gültig bleibt.

minYValue : real

Der minimale Y-Wert für die generierten Oberflächenpunkte. Der Standardwert ist „ 0.0 “. Bei der Festlegung dieser Eigenschaft wird der entsprechende Maximalwert bei Bedarf angepasst, um sicherzustellen, dass der Bereich gültig bleibt.

minZValue : real

Der minimale Z-Wert für die generierten Oberflächenpunkte. Der Standardwert ist „ 0.0 “. Bei der Festlegung dieser Eigenschaft wird der entsprechende Maximalwert bei Bedarf angepasst, um sicherzustellen, dass der Bereich gültig bleibt.

type : AbstractDataProxy.DataType [read-only]

Der Typ des Proxys. Einer der Werte „ QAbstractDataProxy::DataType “.

Signal-Dokumentation

autoScaleYChanged(bool enabled)

Dieses Signal wird ausgelöst, wenn sich autoScaleY in enabled ändert.

Hinweis: Der zugehörige Handler lautet „ onAutoScaleYChanged “.

heightMapFileChanged(string filename)

Dieses Signal wird ausgelöst, wenn sich heightMapFile in filename ändert.

Hinweis: Der entsprechende Handler lautet onHeightMapFileChanged.

maxXValueChanged(real value)

Dieses Signal wird ausgelöst, wenn sich „ maxXValue “ in „ value “ ändert.

Hinweis: Der zugehörige Handler lautet onMaxXValueChanged.

maxYValueChanged(real value)

Dieses Signal wird ausgelöst, wenn sich „ maxYValue “ in „ value “ ändert.

Hinweis: Der entsprechende Handler lautet onMaxYValueChanged.

maxZValueChanged(real value)

Dieses Signal wird ausgelöst, wenn sich maxZValue in value ändert.

Hinweis: Der entsprechende Handler lautet onMaxZValueChanged.

minXValueChanged(real value)

Dieses Signal wird ausgelöst, wenn sich minXValue in value ändert.

Hinweis: Der zugehörige Handler lautet onMinXValueChanged.

minYValueChanged(real value)

Dieses Signal wird ausgelöst, wenn sich „ minYValue “ in „ value “ ändert.

Hinweis: Der entsprechende Handler lautet onMinYValueChanged.

minZValueChanged(real value)

Dieses Signal wird ausgelöst, wenn sich minZValue in value ändert.

Hinweis: Der entsprechende Handler ist onMinZValueChanged.

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