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.
| Constante | Valor | Descripción |
|---|---|---|
QSGImageNode::NoTransform | 0x00 | Las coordenadas de textura se orientan según las coordenadas de la ventana, es decir, con el origen en la esquina superior izquierda. |
QSGImageNode::MirrorHorizontally | 0x01 | Las coordenadas de textura se invierten en el eje horizontal con respecto a las coordenadas de la ventana |
QSGImageNode::MirrorVertically | 0x02 | Las 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.