QQuick3DTextureProviderExtension Class
Clase abstracta para implementar extensiones del proveedor de texturas del lado del usuario. Más...
| Header: | #include <QQuick3DTextureProviderExtension> |
| Since: | Qt 6.11 |
| In QML: | TextureProviderExtension |
| Inherits: | QQuick3DRenderExtension |
Propiedades
(since 6.11)samplerHint : SamplerHint
Funciones públicas
| QQuick3DTextureProviderExtension::SamplerHint | samplerHint() const |
| void | setSamplerHint(QQuick3DTextureProviderExtension::SamplerHint newSamplerHint) |
Señales
| void | samplerHintChanged() |
Funciones protegidas reimplementadas
| virtual QSSGRenderGraphObject * | updateSpatialNode(QSSGRenderGraphObject *node) override |
Descripción detallada
Este es el front-end de una extensión del proveedor de texturas. El lado back-end está implementado en QSSGRenderExtension. El QQuick3DTextureProviderExtension es una especialización de la clase QQuick3DRenderExtension que se utiliza para crear una extensión de proveedor de textura personalizada que puede proporcionar metadatos adicionales sobre qué tipo de textura se proporcionará y también registrar automáticamente la extensión con el gráfico de escena QtQuick3D. Esto significa que no es necesario añadir manualmente la extensión a la lista de extensiones a utilizar con un View3D, y que basta con utilizar la propiedad textureProvider del componente Texture para que el código de la extensión se ejecute cuando sea necesario.
La clase QQuick3DTextureProviderExtension es una clase abstracta que debe ser subclasificada y expuesta a QML. La subclase debe implementar la función QQuick3DRenderExtension::updateSpatialNode() y devolver una instancia QSSGRenderExtension que contenga el código que debe ejecutarse.
Véase también QSSGRenderExtension.
Documentación de propiedades
[since 6.11] samplerHint : SamplerHint
Esta propiedad contiene una pista sobre el tipo de textura que proporcionará la extensión. Esto es necesario porque los datos de textura no se proporcionarán hasta que sean necesarios, pero los materiales que utilizan el componente Textura necesitan saber qué tipo de muestreador proporcionar.
El valor por defecto es QQuick3DTextureProviderExtension::Sampler2D.
Nota: Esta propiedad sólo se utiliza cuando se usan CustomMaterials.
Esta propiedad se introdujo en Qt 6.11.
Funciones de acceso:
| QQuick3DTextureProviderExtension::SamplerHint | samplerHint() const |
| void | setSamplerHint(QQuick3DTextureProviderExtension::SamplerHint newSamplerHint) |
Notifier signal:
| void | samplerHintChanged() |
Véase también SamplerHint.
Documentación de las funciones miembro
[override virtual protected] QSSGRenderGraphObject *QQuick3DTextureProviderExtension::updateSpatialNode(QSSGRenderGraphObject *node)
Reimplementa: QQuick3DRenderExtension::updateSpatialNode(QSSGRenderGraphObject *nodo).
Esta función se llama durante la sincronización del gráfico de escena 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 contiene el código que debe ejecutarse durante la ejecución del canal de renderizado de QtQuick3D.
El parámetro node es la instancia QSSGRenderTextureProviderExtension anterior que fue devuelta por 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 será eliminada del proceso de renderizado.
Nota: La instancia QSSGRenderTextureProviderExtension es un objeto recurso y será propiedad del gráfico de escena QtQuick3D. Si se devuelve una instancia diferente, o null, la instancia anterior se pondrá en cola para ser eliminada por el renderizador.
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.
