En esta página

HeightMapSurfaceDataProxy QML Type

Tipo proxy base para Surface3D. Más...

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

SurfaceDataProxy

Propiedades

Señales

Descripción detallada

QHeightMapSurfaceDataProxy se encarga del procesamiento de datos de mapas de altura relacionados con superficies. Proporciona la visualización de un mapa de alturas como un gráfico de superficie.

Para una descripción más completa, véase QHeightMapSurfaceDataProxy.

Véase también Qt Graphs Tratamiento de datos con 3D.

Documentación de Propiedades

autoScaleY : real

Escala los valores de altura al eje Y. 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.

heightMapFile : string

Un archivo con la imagen del mapa de alturas que se va a visualizar. Al establecer esta propiedad se sustituyen los datos actuales por los datos del mapa de alturas.

Hay varios formatos en los que se puede dar el archivo de imagen, pero si no está en un formato directamente utilizable, se realiza una conversión.

Nota: Si el resultado parece erróneo, la conversión automática ha fallado y debe intentar convertir la imagen usted mismo antes de establecerla. El formato preferido es QImage::Format_RGB32 en escala de grises.

La altura de la imagen se lee a partir del componente rojo de los píxeles si la imagen está en escala de grises. En caso contrario, es una media calculada a partir 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.

Dado que los mapas de altura no contienen valores para los ejes X o Z, estos valores deben darse por separado utilizando 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 desencadena una re-resolución asíncrona de cualquier mapa de alturas existente.

Formatos no recomendados: todos los formatos mono (por ejemplo QImage::Format_Mono).

maxXValue : real

El valor X máximo para los puntos de superficie generados. Por defecto es 10.0. Cuando se establece esta propiedad, el valor mínimo correspondiente se ajusta si es necesario, para asegurar que el rango sigue siendo válido.

maxYValue : real

El valor Y máximo para los puntos de superficie generados. Por defecto es 10.0. Cuando se establece esta propiedad, el valor mínimo correspondiente se ajusta si es necesario, para asegurar que el rango sigue siendo válido.

maxZValue : real

El valor máximo de Z para los puntos de superficie generados. Por defecto es 10.0. Al establecer esta propiedad, el valor mínimo correspondiente se ajusta si es necesario, para garantizar que el rango sigue siendo válido.

minXValue : real

El valor X mínimo para los puntos de superficie generados. Por defecto es 0.0. Cuando se establece esta propiedad, el valor máximo correspondiente se ajusta si es necesario, para asegurar que el rango sigue siendo válido.

minYValue : real

El valor Y mínimo para los puntos de superficie generados. Por defecto es 0.0. Cuando se establece esta propiedad, el valor máximo correspondiente se ajusta si es necesario, para asegurar que el rango sigue siendo válido.

minZValue : real

El valor Z mínimo para los puntos de superficie generados. Por defecto es 0.0. Al establecer esta propiedad, el valor máximo correspondiente se ajusta si es necesario, para garantizar que el rango sigue siendo válido.

type : AbstractDataProxy.DataType [read-only]

El tipo de proxy. Uno de los valores de QAbstractDataProxy::DataType.

Documentación de la señal

autoScaleYChanged(bool enabled)

Esta señal se emite cuando autoScaleY cambia a enabled.

Nota: El controlador correspondiente es onAutoScaleYChanged.

heightMapFileChanged(string filename)

Esta señal se emite cuando heightMapFile cambia a filename.

Nota: El controlador correspondiente es onHeightMapFileChanged.

maxXValueChanged(real value)

Esta señal se emite cuando maxXValue cambia a value.

Nota: El controlador correspondiente es onMaxXValueChanged.

maxYValueChanged(real value)

Esta señal se emite cuando maxYValue cambia a value.

Nota: El controlador correspondiente es onMaxYValueChanged.

maxZValueChanged(real value)

Esta señal se emite cuando maxZValue cambia a value.

Nota: El controlador correspondiente es onMaxZValueChanged.

minXValueChanged(real value)

Esta señal se emite cuando minXValue cambia a value.

Nota: El controlador correspondiente es onMinXValueChanged.

minYValueChanged(real value)

Esta señal se emite cuando minYValue cambia a value.

Nota: El controlador correspondiente es onMinYValueChanged.

minZValueChanged(real value)

Esta señal se emite cuando minZValue cambia a value.

Nota: El controlador correspondiente es 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.