En esta página

QHeightMapSurfaceDataProxy Class

Clase proxy base para « Q3DSurfaceWidgetItem ». Más...

Encabezado: #include <QHeightMapSurfaceDataProxy>
CMake: find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake: QT += graphs
En QML: HeightMapSurfaceDataProxy
Heredan de: QSurfaceDataProxy

Propiedades

Funciones públicas

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)

Señales

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)

Descripción detallada

QHeightMapSurfaceDataProxy se encarga del procesamiento de los datos de mapas de altura relacionados con superficies. Permite visualizar un mapa de altura como un gráfico de superficie.

Dado que los mapas de altura no contienen valores para los ejes X o Z, dichos valores deben especificarse por separado mediante las propiedades minXValue, maxXValue, minZValue y maxZValue. El valor X corresponde a la dirección horizontal de la imagen y el valor Z, a la vertical. Al establecer cualquiera de estas propiedades, se activa una re-resolución asíncrona de cualquier mapa de altura existente.

Véase también QSurfaceDataProxy y Qt Graphs: «Manejo de datos en 3D».

Documentación de propiedades

autoScaleY : bool

Escalar los valores de altura al eje Y.

El valor por defecto es « false ».

Cuando esta propiedad se establece en « true », los valores de altura se escalan para ajustarse al eje Y entre « minYValue » y « maxYValue ».

Funciones de acceso:

bool autoScaleY() const
void setAutoScaleY(bool enabled)

Señal de notificación:

void autoScaleYChanged(bool enabled)

Véase también minYValue y maxYValue.

heightMap : QImage

Esta propiedad contiene la imagen del mapa de alturas que se va a visualizar.

Funciones de acceso:

QImage heightMap() const
void setHeightMap(const QImage &image)

Señal de notificación:

void heightMapChanged(const QImage &image)

heightMapFile : QString

Esta propiedad contiene el nombre del archivo con la imagen del mapa de altitud que se va a visualizar.

Funciones de acceso:

QString heightMapFile() const
void setHeightMapFile(const QString &filename)

Señal de notificación:

void heightMapFileChanged(const QString &filename)

maxXValue : float

Esta propiedad contiene el valor máximo de X de los puntos de superficie generados.

El valor por defecto es « 10.0 ».

Al configurar esta propiedad, el valor mínimo correspondiente se ajusta si es necesario, para garantizar que el rango siga siendo válido.

Funciones de acceso:

float maxXValue() const
void setMaxXValue(float max)

Señal de notificación:

void maxXValueChanged(float value)

maxYValue : float

Esta propiedad contiene el valor máximo de Y de los puntos de la superficie generada.

El valor por defecto es « 10.0 ».

Al configurar esta propiedad, el valor mínimo correspondiente se ajusta si es necesario, para garantizar que el rango siga siendo válido.

Funciones de acceso:

float maxYValue() const
void setMaxYValue(float max)

Señal de notificación:

void maxYValueChanged(float value)

Véase también autoScaleY.

maxZValue : float

Esta propiedad contiene el valor Z máximo de los puntos de la superficie generada.

El valor por defecto es « 10.0 ».

Al configurar esta propiedad, el valor mínimo correspondiente se ajusta si es necesario, para garantizar que el rango siga siendo válido.

Funciones de acceso:

float maxZValue() const
void setMaxZValue(float max)

Señal de notificación:

void maxZValueChanged(float value)

minXValue : float

Esta propiedad contiene el valor mínimo de X de los puntos de la superficie generada.

El valor por defecto es « 0.0 ».

Al configurar esta propiedad, el valor máximo correspondiente se ajusta si es necesario, para garantizar que el rango siga siendo válido.

Funciones de acceso:

float minXValue() const
void setMinXValue(float min)

Señal de notificación:

void minXValueChanged(float value)

minYValue : float

Esta propiedad contiene el valor Y mínimo de los puntos de la superficie generada.

El valor predeterminado es 0.0.

Al configurar esta propiedad, el valor máximo correspondiente se ajusta si es necesario, para garantizar que el rango siga siendo válido.

Funciones de acceso:

float minYValue() const
void setMinYValue(float min)

Señal de notificación:

void minYValueChanged(float value)

Véase también autoScaleY.

minZValue : float

Esta propiedad contiene el valor Z mínimo de los puntos de la superficie generada.

El valor por defecto es 0.0.

Al configurar esta propiedad, el valor máximo correspondiente se ajusta si es necesario, para garantizar que el rango siga siendo válido.

Funciones de acceso:

float minZValue() const
void setMinZValue(float min)

Señal de notificación:

void minZValueChanged(float value)

Documentación de funciones de miembro

[explicit] QHeightMapSurfaceDataProxy::QHeightMapSurfaceDataProxy(QObject *parent = nullptr)

Crea un objeto `QHeightMapSurfaceDataProxy` con el ` parent` proporcionado.

[explicit] QHeightMapSurfaceDataProxy::QHeightMapSurfaceDataProxy(const QImage &image, QObject *parent = nullptr)

Crea un objeto `QHeightMapSurfaceDataProxy` con los valores proporcionados ` image ` y ` parent`. El mapa de altura se establece llamando a ` setHeightMap()` con ` image`.

Véase también heightMap.

[explicit] QHeightMapSurfaceDataProxy::QHeightMapSurfaceDataProxy(const QString &filename, QObject *parent = nullptr)

Crea un objeto `QHeightMapSurfaceDataProxy` a partir de la imagen proporcionada: filename y parent. El mapa de altura se establece llamando a ` setHeightMapFile()` con filename.

Véase también heightMapFile.

[override virtual noexcept] QHeightMapSurfaceDataProxy::~QHeightMapSurfaceDataProxy()

Destruye « QHeightMapSurfaceDataProxy ».

void QHeightMapSurfaceDataProxy::setHeightMap(const QImage &image)

Sustituye los datos actuales por los datos del mapa de altitud especificados en image.

El archivo « image » puede presentarse en varios formatos, pero si no está en un formato directamente utilizable, se realiza una conversión.

Nota: Si el resultado parece incorrecto, la conversión automática ha fallado y deberías intentar convertir tú mismo el « image » antes de configurarlo. El formato preferido es « QImage::Format_RGB32 » en escala de grises.

La altura de la imagen « image » se obtiene a partir del componente rojo de los píxeles si la imagen « image » está en escala de grises. En caso contrario, se calcula como la media de los componentes rojo, verde y azul de los píxeles. El uso de imágenes en escala de grises puede mejorar la velocidad de conversión de datos en el caso de imágenes de gran tamaño.

Formatos no recomendados: todos los formatos monocromáticos (por ejemplo, QImage::Format_Mono).

El mapa de altura se resuelve de forma asíncrona. Se emite QSurfaceDataProxy::arrayReset() cuando se han resuelto los datos.

Nota: Funciónde configuración para la propiedad heightMap.

Véase también heightMap().

void QHeightMapSurfaceDataProxy::setHeightMapFile(const QString &filename)

Sustituye los datos actuales por los datos del mapa de altitud del archivo especificado mediante ` filename`.

Nota: Funciónde asignación para la propiedad heightMapFile.

Véase también ` heightMapFile()` y ` heightMap`.

void QHeightMapSurfaceDataProxy::setValueRanges(float minX, float maxX, float minZ, float maxZ)

Una función práctica para establecer todos los valores mínimos (minX y minZ) y máximos (maxX y maxZ) al mismo tiempo. Los valores mínimos deben ser menores que el valor máximo correspondiente. De lo contrario, los valores se ajustarán para que sean válidos.

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