En esta página

QSGSimpleTextureNode Class

La clase `QSGSimpleTextureNode` se ofrece para facilitar el dibujo de contenido con texturas mediante el grafo de escena de QML. Más información...

Encabezado: #include <QSGSimpleTextureNode>
CMake: find_package(Qt6 REQUIRED COMPONENTS Quick)
target_link_libraries(mytarget PRIVATE Qt6::Quick)
qmake: QT += quick
Heredan: QSGGeometryNode

Tipos públicos

enum TextureCoordinatesTransformFlag { NoTransform, MirrorHorizontally, MirrorVertically }
flags TextureCoordinatesTransformMode

Funciones públicas

QSGSimpleTextureNode()
virtual ~QSGSimpleTextureNode() override
QSGTexture::Filtering filtering() const
bool ownsTexture() const
QRectF rect() const
void setFiltering(QSGTexture::Filtering filtering)
void setOwnsTexture(bool owns)
void setRect(const QRectF &r)
void setRect(qreal x, qreal y, qreal w, qreal h)
void setSourceRect(const QRectF &r)
void setSourceRect(qreal x, qreal y, qreal w, qreal h)
void setTexture(QSGTexture *texture)
void setTextureCoordinatesTransform(QSGSimpleTextureNode::TextureCoordinatesTransformMode mode)
QRectF sourceRect() const
QSGTexture *texture() const
QSGSimpleTextureNode::TextureCoordinatesTransformMode textureCoordinatesTransform() const

Descripción detallada

Advertencia: La clase de nodo de textura simple debe tener una textura antes de añadirse al grafo de escena para que se pueda renderizar.

Advertencia: Esta clase de utilidad solo funciona cuando se ejecuta con los backends predeterminados o de software del grafo de escena de Qt Quick. Como alternativa, es preferible utilizar QSGImageNode a través de QQuickWindow::createImageNode(). Sin embargo, esta clase independiente sigue siendo útil cuando se utiliza mediante subclasificación y la aplicación sabe que no se utilizarán backends especiales del grafo de escena.

Documentación sobre los tipos de miembros

enum QSGSimpleTextureNode::TextureCoordinatesTransformFlag
flags QSGSimpleTextureNode::TextureCoordinatesTransformMode

La enumeración `TextureCoordinatesTransformFlag` se utiliza para especificar el modo que se emplea para generar coordenadas de textura para un cuadrilátero texturizado.

ConstanteValorDescripción
QSGSimpleTextureNode::NoTransform0x00Las coordenadas de textura se orientan según las coordenadas de la ventana, es decir, con el origen en la esquina superior izquierda.
QSGSimpleTextureNode::MirrorHorizontally0x01Las coordenadas de textura se invierten en el eje horizontal con respecto a las coordenadas de la ventana.
QSGSimpleTextureNode::MirrorVertically0x02Las coordenadas de textura se invierten en el eje vertical con respecto a las coordenadas de la ventana

El tipo `TextureCoordinatesTransformMode` es una definición de tipo (`typedef`) para ` QFlags<TextureCoordinatesTransformFlag>`. Almacena una combinación OR de valores de `TextureCoordinatesTransformFlag`.

Documentación de las funciones miembro

QSGSimpleTextureNode::QSGSimpleTextureNode()

Crea un nuevo nodo de textura simple

[override virtual noexcept] QSGSimpleTextureNode::~QSGSimpleTextureNode()

Elimina el nodo de textura

QSGTexture::Filtering QSGSimpleTextureNode::filtering() const

Devuelve el filtro aplicado actualmente a este nodo de textura

Véase también setFiltering().

bool QSGSimpleTextureNode::ownsTexture() const

Devuelve ` true ` si el nodo asume la propiedad de la textura; en caso contrario, devuelve ` false`.

Véase también setOwnsTexture().

QRectF QSGSimpleTextureNode::rect() const

Devuelve el rectángulo de destino de este nodo de textura.

Véase también ` setRect()`.

void QSGSimpleTextureNode::setFiltering(QSGTexture::Filtering filtering)

Establece el filtrado que se utilizará para este nodo de textura en « filtering ».

Para un escalado suave, utiliza QSGTexture::Linear; para un escalado normal, utiliza QSGTexture::Nearest.

Véase también ` filtering()`.

void QSGSimpleTextureNode::setOwnsTexture(bool owns)

Establece si el nodo asume la propiedad de la textura en owns.

Por defecto, el nodo no asume la propiedad de la textura.

Véase también ownsTexture() y setTexture().

void QSGSimpleTextureNode::setRect(const QRectF &r)

Establece el rectángulo de destino de este nodo de textura en r.

Véase también rect().

void QSGSimpleTextureNode::setRect(qreal x, qreal y, qreal w, qreal h)

Establece que el rectángulo de este nodo de textura comience en (x, y) y tenga un ancho de w y una altura de h.

Esta es una función sobrecargada.

void QSGSimpleTextureNode::setSourceRect(const QRectF &r)

Establece el rectángulo de origen de este nodo de textura en r.

Véase también sourceRect().

void QSGSimpleTextureNode::setSourceRect(qreal x, qreal y, qreal w, qreal h)

Establece el rectángulo de este nodo de textura para que muestre su textura desde (x, y) y tenga un ancho de w y una altura de h en relación con QSGTexture::textureSize.

Se trata de una función sobrecargada.

void QSGSimpleTextureNode::setTexture(QSGTexture *texture)

Establece la textura de este nodo de textura en texture.

Utiliza setOwnsTexture() para establecer si el nodo debe asumir la propiedad de la textura. Por defecto, el nodo no asume la propiedad.

Advertencia: Un nodo de textura debe tener una textura antes de añadirse al grafo de escena para que se pueda renderizar.

Véase también ` texture()`.

void QSGSimpleTextureNode::setTextureCoordinatesTransform(QSGSimpleTextureNode::TextureCoordinatesTransformMode mode)

Establece el método utilizado para generar las coordenadas de textura en « mode ». Esto puede utilizarse para obtener la orientación correcta de la textura. Suele ser necesario cuando se utiliza una biblioteca de OpenGL de terceros para renderizar en una textura, ya que OpenGL tiene el eje y invertido con respecto a Qt Quick.

Véase también textureCoordinatesTransform().

QRectF QSGSimpleTextureNode::sourceRect() const

Devuelve el rectángulo de origen de este nodo de textura.

Véase también ` setSourceRect()`.

QSGTexture *QSGSimpleTextureNode::texture() const

Devuelve la textura de este nodo de textura

Véase también setTexture().

QSGSimpleTextureNode::TextureCoordinatesTransformMode QSGSimpleTextureNode::textureCoordinatesTransform() const

Devuelve el modo utilizado para generar las coordenadas de textura de este nodo.

Véase también setTextureCoordinatesTransform().

© 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.