En esta página

QSGImageNode Class

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

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

Tipos públicos

enum TextureCoordinatesTransformFlag { NoTransform, MirrorHorizontally, MirrorVertically }
flags TextureCoordinatesTransformMode

Funciones públicas

virtual ~QSGImageNode() override
virtual QSGTexture::AnisotropyLevel anisotropyLevel() const = 0
virtual QSGTexture::Filtering filtering() const = 0
virtual QSGTexture::Filtering mipmapFiltering() const = 0
virtual bool ownsTexture() const = 0
virtual QRectF rect() const = 0
virtual void setAnisotropyLevel(QSGTexture::AnisotropyLevel level) = 0
virtual void setFiltering(QSGTexture::Filtering filtering) = 0
virtual void setMipmapFiltering(QSGTexture::Filtering filtering) = 0
virtual void setOwnsTexture(bool owns) = 0
virtual void setRect(const QRectF &rect) = 0
void setRect(qreal x, qreal y, qreal w, qreal h)
virtual void setSourceRect(const QRectF &rect) = 0
void setSourceRect(qreal x, qreal y, qreal w, qreal h)
virtual void setTexture(QSGTexture *texture) = 0
virtual void setTextureCoordinatesTransform(QSGImageNode::TextureCoordinatesTransformMode mode) = 0
virtual QRectF sourceRect() const = 0
virtual QSGTexture *texture() const = 0
virtual QSGImageNode::TextureCoordinatesTransformMode textureCoordinatesTransform() const = 0

Miembros públicos estáticos

void rebuildGeometry(QSGGeometry *g, QSGTexture *texture, const QRectF &rect, QRectF sourceRect, QSGImageNode::TextureCoordinatesTransformMode texCoordMode)

Descripción detallada

Advertencia: La clase de nodo de imagen debe tener una textura antes de añadirse al grafo de escena para poder renderizarse.

Documentación sobre los tipos de miembros

enum QSGImageNode::TextureCoordinatesTransformFlag
flags QSGImageNode::TextureCoordinatesTransformMode

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

ConstanteValorDescripción
QSGImageNode::NoTransform0x00Las coordenadas de textura se orientan según las coordenadas de la ventana, es decir, con el origen en la esquina superior izquierda.
QSGImageNode::MirrorHorizontally0x01Las coordenadas de textura se invierten en el eje horizontal con respecto a las coordenadas de la ventana
QSGImageNode::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

[override virtual noexcept default] QSGImageNode::~QSGImageNode()

Destruye la instancia de ` QSGImageNode`. Este destructor es virtual.

[pure virtual] QSGTexture::AnisotropyLevel QSGImageNode::anisotropyLevel() const

Devuelve el nivel de anisotropía de este nodo de imagen.

Véase también setAnisotropyLevel().

[pure virtual] QSGTexture::Filtering QSGImageNode::filtering() const

Devuelve el filtro de este nodo de imagen.

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

[pure virtual] QSGTexture::Filtering QSGImageNode::mipmapFiltering() const

Devuelve el filtrado de mipmaps para este nodo de imagen.

Véase también setMipmapFiltering().

[pure virtual] bool QSGImageNode::ownsTexture() const

Devuelve « true » si el nodo adquiere la propiedad de la textura; en caso contrario, « false ».

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

[static] void QSGImageNode::rebuildGeometry(QSGGeometry *g, QSGTexture *texture, const QRectF &rect, QRectF sourceRect, QSGImageNode::TextureCoordinatesTransformMode texCoordMode)

Actualiza la geometría g con el texture, las coordenadas de rect y las coordenadas de textura de sourceRect.

g Se supone que es una tira de triángulos de cuatro vértices de tipo QSGGeometry::TexturedPoint2D.

texCoordMode Se utiliza para normalizar el sourceRect.

[pure virtual] QRectF QSGImageNode::rect() const

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

Véase también setRect().

[pure virtual] void QSGImageNode::setAnisotropyLevel(QSGTexture::AnisotropyLevel level)

Establece el nivel de anisotropía de este nodo de imagen en level.

Véase también anisotropyLevel().

[pure virtual] void QSGImageNode::setFiltering(QSGTexture::Filtering filtering)

Establece el filtro que se utilizará para este nodo de imagen en « filtering ».

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

Véase también filtering().

[pure virtual] void QSGImageNode::setMipmapFiltering(QSGTexture::Filtering filtering)

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

Para un escalado suave entre los mipmaps, utiliza ` QSGTexture::Linear`. Para un escalado normal, utiliza ` QSGTexture::Nearest`.

Véase también mipmapFiltering().

[pure virtual] void QSGImageNode::setOwnsTexture(bool owns)

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

Por defecto, el nodo no se hace cargo de la textura.

Véase también ownsTexture().

[pure virtual] void QSGImageNode::setRect(const QRectF &rect)

Establece el rectángulo de destino de este nodo de imagen en rect.

Véase también rect().

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

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

Esta es una función sobrecargada.

[pure virtual] void QSGImageNode::setSourceRect(const QRectF &rect)

Establece el rectángulo de origen de este nodo de imagen en rect.

Véase también sourceRect().

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

Establece el rectángulo de este nodo de imagen 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.

[pure virtual] void QSGImageNode::setTexture(QSGTexture *texture)

Establece la textura de este nodo de imagen en texture.

Utiliza setOwnsTexture() para establecer si el nodo debe hacerse cargo de la textura. Por defecto, el nodo no se hace cargo de ella.

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

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

[pure virtual] void QSGImageNode::setTextureCoordinatesTransform(QSGImageNode::TextureCoordinatesTransformMode mode)

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

Véase también textureCoordinatesTransform().

[pure virtual] QRectF QSGImageNode::sourceRect() const

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

Véase también setSourceRect().

[pure virtual] QSGTexture *QSGImageNode::texture() const

Devuelve la textura de este nodo de imagen.

Véase también setTexture().

[pure virtual] QSGImageNode::TextureCoordinatesTransformMode QSGImageNode::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.