En esta página

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

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.

ConstanteValorDescripción
QQuick3DTextureProviderExtension::SamplerHint::Sampler2D0Una textura 2D
QQuick3DTextureProviderExtension::SamplerHint::Sampler2DArray1Una textura de matriz
QQuick3DTextureProviderExtension::SamplerHint::Sampler3D2Una textura 3D
QQuick3DTextureProviderExtension::SamplerHint::SamplerCube3Una textura de mapa cúbico
QQuick3DTextureProviderExtension::SamplerHint::SamplerCubeArray4Una matriz de texturas de mapa cúbico
QQuick3DTextureProviderExtension::SamplerHint::SamplerBuffer5Una 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.