QQuick3DTextureProviderExtension Class
Clase abstracta para implementar extensiones del proveedor de texturas por parte del usuario. Más...
| Header: | #include <QQuick3DTextureProviderExtension> |
| Since: | Qt 6.11 |
| In QML: | TextureProviderExtension |
| Inherits: | QQuick3DRenderExtension |
Tipos públicos
| enum class | SamplerHint { Sampler2D, Sampler2DArray, Sampler3D, SamplerCube, SamplerCubeArray, SamplerBuffer } |
Propiedades
(since 6.11)samplerHint : SamplerHint
Funciones públicas
| QQuick3DTextureProviderExtension::SamplerHint | samplerHint() const |
| void | setSamplerHint(QQuick3DTextureProviderExtension::SamplerHint newSamplerHint) |
Señales
| void | samplerHintChanged() |
(since 6.12) void | surfaceChanged() |
Funciones protegidas reimplementadas
| virtual QSSGRenderGraphObject * | updateSpatialNode(QSSGRenderGraphObject *node) override |
Descripción detallada
Esta es la parte de interfaz de usuario de una extensión de proveedor de texturas. La parte de fondo se implementa en QSSGRenderExtension. La clase `QQuick3DTextureProviderExtension` es una especialización de la clase ` QQuick3DRenderExtension ` que se utiliza para crear una extensión de proveedor de texturas personalizada capaz tanto de proporcionar metadatos adicionales sobre el tipo de textura que se va a ofrecer como de registrar automáticamente la extensión en el grafo de escena de ` QtQuick3D `. Esto significa que no es necesario añadir manualmente la extensión a la lista de extensiones que se van a utilizar con un ` View3D`, y basta con utilizar la propiedad `textureProvider` del componente `Texture` para que se ejecute el código de la extensión cuando sea necesario.
La clase `QQuick3DTextureProviderExtension` es una clase abstracta que debe subclasificarse y exponerse a QML. La subclase debe implementar la función ` QQuick3DRenderExtension::updateSpatialNode()` y devolver una instancia de ` QSSGRenderExtension ` que contenga el código que debe ejecutarse.
Véase también QSSGRenderExtension.
Documentación sobre los tipos de miembros
enum class QQuick3DTextureProviderExtension::SamplerHint
Especifica una indicación sobre el tipo de textura que proporcionará la extensión.
| Constante | Valor | Descripción |
|---|---|---|
QQuick3DTextureProviderExtension::SamplerHint::Sampler2D | 0 | Una textura 2D |
QQuick3DTextureProviderExtension::SamplerHint::Sampler2DArray | 1 | Una textura de matriz |
QQuick3DTextureProviderExtension::SamplerHint::Sampler3D | 2 | Una textura 3D |
QQuick3DTextureProviderExtension::SamplerHint::SamplerCube | 3 | Una textura de mapa cúbico |
QQuick3DTextureProviderExtension::SamplerHint::SamplerCubeArray | 4 | Una matriz de texturas de mapa cúbico |
QQuick3DTextureProviderExtension::SamplerHint::SamplerBuffer | 5 | Una textura de búfer |
Documentación de propiedades
[since 6.11] samplerHint : SamplerHint
Esta propiedad contiene una indicación sobre el tipo de textura que proporcionará la extensión. Esto es necesario porque los datos de la textura no se proporcionarán hasta que sea necesario, pero los materiales que utilizan el componente «Texture» necesitan saber qué tipo de muestreador deben proporcionar.
El valor por defecto es « QQuick3DTextureProviderExtension::Sampler2D ».
Nota: Esta propiedad solo se utiliza cuando se emplean CustomMaterials.
Esta enumeración se introdujo en Qt 6.11.
Funciones de acceso:
| QQuick3DTextureProviderExtension::SamplerHint | samplerHint() const |
| void | setSamplerHint(QQuick3DTextureProviderExtension::SamplerHint newSamplerHint) |
Señal de notificador:
| void | samplerHintChanged() |
Véase también SamplerHint.
Documentación de funciones miembro
[signal, since 6.12] void QQuick3DTextureProviderExtension::surfaceChanged()
Esta señal se emite cuando la superficie de renderizado subyacente ha cambiado y es necesario volver a generar las texturas.
Esta función se introdujo en Qt 6.12.
[override virtual protected] QSSGRenderGraphObject *QQuick3DTextureProviderExtension::updateSpatialNode(QSSGRenderGraphObject *node)
Reimplementa: QQuick3DRenderExtension::updateSpatialNode(QSSGRenderGraphObject *node).
Esta función se invoca durante la sincronización del grafo de escena de ` QtQuick3D ` cuando se crea un elemento o cuando se solicita una actualización, normalmente como resultado de un cambio en las propiedades del elemento. La función debe devolver una instancia de ` QSSGRenderTextureProviderExtension ` que contenga el código que debe ejecutarse durante la ejecución del proceso de renderizado de ` QtQuick3D`.
El parámetro ` node ` es la instancia anterior de ` QSSGRenderTextureProviderExtension ` que devolvió esta función, o `null` si es la primera vez que se llama a la función. La función puede devolver la misma instancia, una instancia diferente o `null`. Si la función devuelve `null`, la extensión se eliminará del proceso de renderizado.
Nota: La instancia ` QSSGRenderTextureProviderExtension ` es un objeto de recurso y será propiedad del grafo de escena de ` QtQuick3D `. Si se devuelve una instancia diferente, o `null`, el renderizador pondrá la instancia anterior en cola para su eliminación.
Véase también QSSGRenderTextureProviderExtension.
© 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.