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.
| Constante | Valor | Descripción |
|---|---|---|
QSGSimpleTextureNode::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. |
QSGSimpleTextureNode::MirrorHorizontally | 0x01 | Las coordenadas de textura se invierten en el eje horizontal con respecto a las coordenadas de la ventana. |
QSGSimpleTextureNode::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
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.