En esta página

Qt3DRender::QBlitFramebuffer Class

class Qt3DRender::QBlitFramebuffer

Nodo de FrameGraph que permite transferir un rectángulo de valores de píxeles de una región de un destino de renderizado a otra. Más información...

Encabezado: #include <qblitframebuffer.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3drender)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake: QT += 3drender
En QML: BlitFramebuffer
Heredado de: Qt3DRender::QFrameGraphNode
Estado: Obsoleto

Esta clase está obsoleta. Se desaconseja encarecidamente su uso en código nuevo.

Tipos públicos

enum InterpolationMethod { Nearest, Linear }

Propiedades

Funciones públicas

QBlitFramebuffer(Qt3DCore::QNode *parent = nullptr)
virtual ~QBlitFramebuffer()
Qt3DRender::QRenderTarget *destination() const
Qt3DRender::QRenderTargetOutput::AttachmentPoint destinationAttachmentPoint() const
QRectF destinationRect() const
Qt3DRender::QBlitFramebuffer::InterpolationMethod interpolationMethod() const
void setDestination(Qt3DRender::QRenderTarget *destination)
void setDestinationAttachmentPoint(Qt3DRender::QRenderTargetOutput::AttachmentPoint destinationAttachmentPoint)
void setDestinationRect(const QRectF &outputRect)
void setInterpolationMethod(Qt3DRender::QBlitFramebuffer::InterpolationMethod interpolationMethod)
void setSource(Qt3DRender::QRenderTarget *source)
void setSourceAttachmentPoint(Qt3DRender::QRenderTargetOutput::AttachmentPoint sourceAttachmentPoint)
void setSourceRect(const QRectF &inputRect)
Qt3DRender::QRenderTarget *source() const
Qt3DRender::QRenderTargetOutput::AttachmentPoint sourceAttachmentPoint() const
QRectF sourceRect() const

Señales

Descripción detallada

Este nodo inserta un « glBlitFrameBuffer » o su equivalente en el flujo de comandos. Esto proporciona un método más eficiente para copiar rectángulos entre texturas o búferes de fondo de superficie envueltos por « QRenderTarget » que dibujar cuadriláteros texturizados. También admite el escalado con el método de interpolación especificado.

Nota: En la práctica, el nodo QBlitFramebuffer se suele utilizar en combinación con QNoDraw, ya que un blit no debería implicar la emisión de llamadas de dibujo para ninguna entidad.

Documentación sobre los tipos de miembros

enum QBlitFramebuffer::InterpolationMethod

Especifica la interpolación que se aplica si se amplía la imagen.

ConstanteValorDescripción
Qt3DRender::QBlitFramebuffer::Nearest0Interpolación por vecino más cercano.
Qt3DRender::QBlitFramebuffer::Linear1Interpolación lineal.

Documentación de la propiedad

destination : Qt3DRender::QRenderTarget*

Especifica el objetivo de renderizado de destino. Si no se establece, se supone que el destino es el framebuffer predeterminado (es decir, el backbuffer de la superficie actual), si existe.

Nota: el origen y el destino no deben hacer referencia al mismo objetivo de renderizado.

Funciones de acceso:

Qt3DRender::QRenderTarget *destination() const
void setDestination(Qt3DRender::QRenderTarget *destination)

Señal de notificación:

void destinationChanged()

destinationAttachmentPoint : Qt3DRender::QRenderTargetOutput::AttachmentPoint

Especifica el punto de fijación de destino.

Funciones de acceso:

Qt3DRender::QRenderTargetOutput::AttachmentPoint destinationAttachmentPoint() const
void setDestinationAttachmentPoint(Qt3DRender::QRenderTargetOutput::AttachmentPoint destinationAttachmentPoint)

Señal de notificación:

void destinationAttachmentPointChanged()

destinationRect : QRectF

Especifica el rectángulo de destino. Se da por hecho que las coordenadas siguen el sistema de coordenadas habitual de Qt, es decir, que el eje Y va de arriba abajo.

Funciones de acceso:

QRectF destinationRect() const
void setDestinationRect(const QRectF &outputRect)

Señal del notificador:

void destinationRectChanged()

interpolationMethod : InterpolationMethod

Esta propiedad especifica el método de interpolación que se aplica si se estira la imagen.

Especifica la interpolación que se aplica si se amplía la imagen. El valor predeterminado es «Lineal».

Funciones de acceso:

Qt3DRender::QBlitFramebuffer::InterpolationMethod interpolationMethod() const
void setInterpolationMethod(Qt3DRender::QBlitFramebuffer::InterpolationMethod interpolationMethod)

Señal de notificación:

void interpolationMethodChanged()

source : Qt3DRender::QRenderTarget*

Especifica el destino de renderizado de origen. Si no se establece, se supone que el origen es el framebuffer predeterminado (es decir, el backbuffer de la superficie actual), si existe.

Nota: la fuente y el destino no deben hacer referencia al mismo destino de renderizado.

Funciones de acceso:

Qt3DRender::QRenderTarget *source() const
void setSource(Qt3DRender::QRenderTarget *source)

Señal de notificador:

void sourceChanged()

sourceAttachmentPoint : Qt3DRender::QRenderTargetOutput::AttachmentPoint

Especifica el punto de fijación de origen.

Funciones de acceso:

Qt3DRender::QRenderTargetOutput::AttachmentPoint sourceAttachmentPoint() const
void setSourceAttachmentPoint(Qt3DRender::QRenderTargetOutput::AttachmentPoint sourceAttachmentPoint)

Señal de notificación:

void sourceAttachmentPointChanged()

sourceRect : QRectF

Especifica el rectángulo de origen. Se da por hecho que las coordenadas siguen el sistema de coordenadas habitual de Qt, lo que significa que el eje Y va de arriba abajo.

Funciones de acceso:

QRectF sourceRect() const
void setSourceRect(const QRectF &inputRect)

Señal del notificador:

void sourceRectChanged()

Documentación de las funciones miembro

[explicit] QBlitFramebuffer::QBlitFramebuffer(Qt3DCore::QNode *parent = nullptr)

Crea un nuevo `QBlitFramebuffer` con el ` parent` indicado.

[virtual noexcept] QBlitFramebuffer::~QBlitFramebuffer()

Destructor.

Qt3DRender::QRenderTarget *QBlitFramebuffer::destination() const

Devuelve el objetivo de renderizado de destino.

Nota: Funcióngetter para la propiedad «destination».

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

Qt3DRender::QRenderTargetOutput::AttachmentPoint QBlitFramebuffer::destinationAttachmentPoint() const

Devuelve el punto de fijación de destino.

Nota: Funcióngetter para la propiedad destinationAttachmentPoint.

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

QRectF QBlitFramebuffer::destinationRect() const

Devuelve el rectángulo de destino.

Nota: Funcióngetter para la propiedad destinationRect.

Véase también setDestinationRect().

Qt3DRender::QBlitFramebuffer::InterpolationMethod QBlitFramebuffer::interpolationMethod() const

Devuelve el método de interpolación.

Nota: Funcióngetter para la propiedad interpolationMethod.

Véase también setInterpolationMethod().

void QBlitFramebuffer::setDestination(Qt3DRender::QRenderTarget *destination)

Establece el objetivo de renderizado de destino. El valor por defecto es `nullptr`; en ese caso, se supone que el destino es el framebuffer por defecto (es decir, el backbuffer de la superficie actual), si existe.

Nota: el origen y el destino no deben hacer referencia al mismo objetivo de renderizado.

Nota: Al igual que con otros nodos, « destination » se vincula automáticamente a la instancia « QBlitFramebuffer » cuando no se ha establecido ningún padre. También se realiza un seguimiento de su ciclo de vida, lo que significa que el destino vuelve a «nullptr» en caso de que se destruya el « destination » establecido actualmente.

Nota: Funciónde asignación para la propiedad destination.

Véase también destination().

void QBlitFramebuffer::setDestinationAttachmentPoint(Qt3DRender::QRenderTargetOutput::AttachmentPoint destinationAttachmentPoint)

Establece la propiedad ` destinationAttachmentPoint`. El valor predeterminado es ` Qt3DRender::QRenderTargetOutput::AttachmentPoint::Color0`.

Nota: Funciónde asignación para la propiedad destinationAttachmentPoint.

Véase también destinationAttachmentPoint().

void QBlitFramebuffer::setDestinationRect(const QRectF &outputRect)

Establece el rectángulo de destino en outputRect. Se da por hecho que las coordenadas siguen el sistema de coordenadas habitual de Qt, lo que significa que el eje Y va de arriba abajo.

Nota: Funciónde asignación para la propiedad destinationRect.

Véase también destinationRect().

void QBlitFramebuffer::setInterpolationMethod(Qt3DRender::QBlitFramebuffer::InterpolationMethod interpolationMethod)

Establece la opción « interpolationMethod » que se aplica si se estira la imagen. El valor predeterminado es «Linear».

Nota: Funciónde asignación para la propiedad interpolationMethod.

Véase también interpolationMethod().

void QBlitFramebuffer::setSource(Qt3DRender::QRenderTarget *source)

Establece el destino de renderizado de origen. El valor por defecto es `nullptr`; en ese caso, se supone que el origen es el framebuffer por defecto (es decir, el backbuffer de la superficie actual), si existe.

Nota: la fuente y el destino no deben hacer referencia al mismo destino de renderizado.

Nota: Al igual que con otros nodos, « source » se vincula automáticamente a la instancia de « QBlitFramebuffer » cuando no se ha establecido ningún nodo padre. También se realiza un seguimiento de su ciclo de vida, lo que significa que la fuente vuelve a «nullptr» en caso de que se destruya el « source » establecido actualmente.

Nota: Funciónde asignación para la propiedad source.

Véase también source().

void QBlitFramebuffer::setSourceAttachmentPoint(Qt3DRender::QRenderTargetOutput::AttachmentPoint sourceAttachmentPoint)

Establece la propiedad sourceAttachmentPoint. El valor por defecto es Qt3DRender::QRenderTargetOutput::AttachmentPoint::Color0.

Nota: Funciónde asignación para la propiedad sourceAttachmentPoint.

Véase también sourceAttachmentPoint().

void QBlitFramebuffer::setSourceRect(const QRectF &inputRect)

Establece el rectángulo de origen en inputRect. Se da por hecho que las coordenadas siguen el sistema de coordenadas habitual de Qt, lo que significa que el eje Y va de arriba abajo.

Nota: Funciónde asignación para la propiedad sourceRect.

Véase también sourceRect().

Qt3DRender::QRenderTarget *QBlitFramebuffer::source() const

Devuelve el destino de renderizado de origen.

Nota: Funcióngetter para la propiedad «source».

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

Qt3DRender::QRenderTargetOutput::AttachmentPoint QBlitFramebuffer::sourceAttachmentPoint() const

Devuelve el punto de anclaje de origen.

Nota: Funcióngetter para la propiedad sourceAttachmentPoint.

Véase también setSourceAttachmentPoint().

QRectF QBlitFramebuffer::sourceRect() const

Devuelve el rectángulo de origen.

Nota: Funcióngetter para la propiedad sourceRect.

Véase también setSourceRect().

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