QHeightMapSurfaceDataProxy Class
Clase proxy base para « Q3DSurface ». Más...
| Encabezado: | #include <QHeightMapSurfaceDataProxy> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS DataVisualization) target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
| qmake: | QT += datavisualization |
| Desde: | QtDataVisualization 1.0 |
| En QML: | HeightMapSurfaceDataProxy |
| Heredado de: | QSurfaceDataProxy |
| Estado: | Obsoleta |
Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.
Propiedades
|
Funciones públicas
| 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) |
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 manejo de los datos de mapas de altura relacionados con superficies. Proporciona una forma de presentar un mapa de altura para que se visualice 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 Data Visualization: Manejo de datos».
Documentación de propiedades
[since 6.3] 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 ».
Esta enumeración se introdujo en Qt 6.3.
Funciones de acceso:
| bool | autoScaleY() const |
| void | setAutoScaleY(bool enabled) |
Señal de notificador:
| 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 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 | maxXValue() const |
| void | setMaxXValue(float max) |
Señal de notificación:
| void | maxXValueChanged(float value) |
[since 6.3] maxYValue : float
Esta propiedad contiene el valor Y 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.
Esta enumeración se introdujo en Qt 6.3.
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 para 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) |
[since 6.3] minYValue : float
Esta propiedad contiene el valor mínimo de Y 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.
Esta enumeración se introdujo en Qt 6.3.
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 la función ` setHeightMapFile()` con filename.
Véase también heightMapFile.
[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 recomendado 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 una 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 en « 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.