QSGImageNode Class
La clase QSGImageNode se proporciona por conveniencia para dibujar fácilmente contenido texturizado utilizando el gráfico de escena QML. Más...
| Cabecera: | #include <QSGImageNode> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Quick)target_link_libraries(mytarget PRIVATE Qt6::Quick) |
| qmake: | QT += quick |
| Hereda: | QSGGeometryNode |
Tipos Públicos
| enum | TextureCoordinatesTransformFlag { NoTransform, MirrorHorizontally, MirrorVertically } |
| flags | TextureCoordinatesTransformMode |
Funciones Públicas
| 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 nodo imagen debe tener una textura antes de ser añadida al gráfico de escena para ser renderizada.
Documentación de Tipos de Miembros
enum QSGImageNode::TextureCoordinatesTransformFlag
flags QSGImageNode::TextureCoordinatesTransformMode
El enum TextureCoordinatesTransformFlag se utiliza para especificar el modo utilizado para generar las coordenadas de textura de un quad texturizado.
| Constante | Valor | Descripción |
|---|---|---|
QSGImageNode::NoTransform | 0x00 | Las coordenadas de textura se orientan con las coordenadas de ventana, es decir, con el origen en la parte superior izquierda. |
QSGImageNode::MirrorHorizontally | 0x01 | Las coordenadas de la textura se invierten en el eje horizontal con respecto a las coordenadas de la ventana |
QSGImageNode::MirrorVertically | 0x02 | Las coordenadas de la textura se invierten en el eje vertical con respecto a las coordenadas de la ventana. |
El tipo TextureCoordinatesTransformMode es un typedef para QFlags<TextureCoordinatesTransformFlag>. Almacena una combinación OR de valores TextureCoordinatesTransformFlag.
Documentación de la Función Miembro
[pure virtual] QSGTexture::AnisotropyLevel QSGImageNode::anisotropyLevel() const
Devuelve el nivel de anistropía de este nodo de la imagen.
Véase también setAnisotropyLevel().
[pure virtual] QSGTexture::Filtering QSGImageNode::filtering() const
Devuelve el filtrado de este nodo de imagen.
Véase también setFiltering().
[pure virtual] QSGTexture::Filtering QSGImageNode::mipmapFiltering() const
Devuelve el filtrado mipmap para este nodo de imagen.
Véase también setMipmapFiltering().
[pure virtual] bool QSGImageNode::ownsTexture() const
Devuelve true si el nodo se apropia 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 las texture, las coordenadas en rect, y las coordenadas de textura de sourceRect.
g se supone que es una tira triangular de cuatro vértices de tipo QSGGeometry::TexturedPoint2D.
texCoordMode se utiliza para normalizar la 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 anistropía de este nodo de la imagen en level.
Véase también anisotropyLevel().
[pure virtual] void QSGImageNode::setFiltering(QSGTexture::Filtering filtering)
Establece el filtrado que se utilizará para este nodo de imagen en filtering.
Para un escalado suave, utilice QSGTexture::Linear. Para un escalado normal, utilice QSGTexture::Nearest.
Véase también filtering().
[pure virtual] void QSGImageNode::setMipmapFiltering(QSGTexture::Filtering filtering)
Establece el filtrado mipmap que se utilizará para este nodo de imagen en filtering.
Para un escalado suave entre mapas mip, utilice QSGTexture::Linear. Para escalado normal, utilice QSGTexture::Nearest.
Véase también mipmapFiltering().
[pure virtual] void QSGImageNode::setOwnsTexture(bool owns)
Establece si el nodo toma propiedad de la textura a owns.
Por defecto, el nodo no se apropia 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 el rectángulo de este nodo de imagen para que comience en (x, y) y tenga la anchura w y la altura 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 mostrar su textura desde (x, y) y tener anchura w y altura h relativamente a la QSGTexture::textureSize.
Esta es una función sobrecargada.
[pure virtual] void QSGImageNode::setTexture(QSGTexture *texture)
Establece la textura de este nodo de imagen a texture.
Utilice setOwnsTexture() para establecer si el nodo debe tomar posesión de la textura. Por defecto, el nodo no se apropia de la textura.
Advertencia: Un nodo imagen debe tener una textura antes de ser añadido al scenegraph para ser renderizado.
Véase también texture().
[pure virtual] void QSGImageNode::setTextureCoordinatesTransform(QSGImageNode::TextureCoordinatesTransformMode mode)
Establece el método utilizado para generar las coordenadas de la textura en mode. Esto se puede utilizar para obtener la orientación correcta de la textura. Esto es comúnmente necesario cuando se utiliza una librería OpenGL de terceros para renderizar la textura ya que OpenGL tiene un eje y invertido en relación 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 para 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.
