En esta página

Qt3DRender::QBlitFramebuffer Class

class Qt3DRender::QBlitFramebuffer

Nodo de FrameGraph para transferir un rectángulo de valores de píxeles de una región de un objetivo de renderizado a otra. Más...

Cabecera: #include <QBlitFramebuffer>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3drender)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake: QT += 3drender
En QML: BlitFramebuffer
Hereda: Qt3DRender::QFrameGraphNode
Status: Obsoleto

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 un equivalente en el flujo de comandos. Esto proporciona un método más eficiente para copiar rectángulos entre texturas o backbuffers de superficie envueltos por QRenderTarget que dibujar quads de texturas. También admite el escalado con el método de interpolación especificado.

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

Documentación de los tipos de miembros

enum QBlitFramebuffer::InterpolationMethod

Especifica la interpolación aplicada si se estira la imagen.

ConstanteValorDescripción
Qt3DRender::QBlitFramebuffer::Nearest0Interpolación del vecino más próximo.
Qt3DRender::QBlitFramebuffer::Linear1Interpolación lineal.

Documentación de propiedades

destination : Qt3DRender::QRenderTarget*

Especifica el destino del renderizado. Si no se define, se asume 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 referirse al mismo objetivo de renderizado.

Funciones de acceso:

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

Señal notificadora:

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 del notificador:

void destinationAttachmentPointChanged()

destinationRect : QRectF

Especifica el rectángulo de destino. Se supone que las coordenadas siguen el sistema de coordenadas normal de Qt, lo que significa que Y va de arriba a abajo.

Funciones de acceso:

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

Señal notificadora:

void destinationRectChanged()

interpolationMethod : InterpolationMethod

Esta propiedad contiene el método de interpolación aplicado si la imagen se estira.

Especifica la interpolación aplicada si la imagen se estira. Por defecto es Lineal.

Funciones de acceso:

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

Señal notificadora:

void interpolationMethodChanged()

source : Qt3DRender::QRenderTarget*

Especifica el objetivo de renderizado de origen. Si no se define, se asume que el origen es el framebuffer por defecto (es decir, el backbuffer de la superficie actual), si existe.

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

Funciones de acceso:

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

Señal notificadora:

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 del notificador:

void sourceAttachmentPointChanged()

sourceRect : QRectF

Especifica el rectángulo de origen. Se supone que las coordenadas siguen el sistema de coordenadas normal de Qt, lo que significa que Y va de arriba a abajo.

Funciones de acceso:

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

Señal notificadora:

void sourceRectChanged()

Documentación de funciones miembro

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

Construye un nuevo QBlitFramebuffer con la dirección parent.

[virtual noexcept] QBlitFramebuffer::~QBlitFramebuffer()

Destructor.

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

Devuelve el destino del renderizado.

Nota: Función Getter para la propiedad destino.

Véase también setDestination().

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

Devuelve el punto de anclaje de destino.

Nota: Función Getter para la propiedad destinationAttachmentPoint.

Véase también setDestinationAttachmentPoint().

QRectF QBlitFramebuffer::destinationRect() const

Devuelve el rectángulo de destino.

Nota: Función Getter para la propiedad destinationRect.

Véase también setDestinationRect().

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

Devuelve el método de interpolación.

Nota: Función Getter para la propiedad interpolationMethod.

Véase también setInterpolationMethod().

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

Establece el destino del renderizado. El valor por defecto es nullptr, en cuyo caso se asume 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 referirse al mismo objetivo de renderizado.

Nota: Al igual que con otros nodos, destination se emparenta automáticamente con la instancia QBlitFramebuffer cuando no se ha establecido ningún padre. El tiempo de vida también es rastreado, lo que significa que el destino vuelve a nullptr en caso de que el destination actual sea destruido.

Nota: Función Setter para la propiedad destination.

Véase también destination().

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

Establece la propiedad destinationAttachmentPoint. Por defecto es Qt3DRender::QRenderTargetOutput::AttachmentPoint::Color0.

Nota: Función Setter para la propiedad destinationAttachmentPoint.

Véase también destinationAttachmentPoint().

void QBlitFramebuffer::setDestinationRect(const QRectF &outputRect)

Establece el rectángulo de destino en outputRect. Se supone que las coordenadas siguen el sistema de coordenadas normal de Qt, es decir, Y va de arriba a abajo.

Nota: Función Setter para la propiedad destinationRect.

Véase también destinationRect().

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

Establece el interpolationMethod que se aplica si la imagen se estira. Por defecto es Lineal.

Nota: Función Setter para la propiedad interpolationMethod.

Véase también interpolationMethod().

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

Establece el objetivo de renderizado fuente. El valor por defecto es nullptr, en cuyo caso se asume que la fuente es el framebuffer por defecto (es decir, el backbuffer de la superficie actual), si existe.

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

Nota: Al igual que con otros nodos, source se emparenta automáticamente con la instancia QBlitFramebuffer cuando no se ha establecido ningún padre. El tiempo de vida también es rastreado, lo que significa que la fuente se revierte a nullptr en caso de que el source actual sea destruido.

Nota: Función Setter para la propiedad source.

Véase también source().

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

Establece la propiedad sourceAttachmentPoint. Por defecto es Qt3DRender::QRenderTargetOutput::AttachmentPoint::Color0.

Nota: Función Setter para la propiedad sourceAttachmentPoint.

Véase también sourceAttachmentPoint().

void QBlitFramebuffer::setSourceRect(const QRectF &inputRect)

Establece el rectángulo de origen en inputRect. Se supone que las coordenadas siguen el sistema de coordenadas normal de Qt, es decir, Y va de arriba a abajo.

Nota: Función Setter para la propiedad sourceRect.

Véase también sourceRect().

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

Devuelve el destino de renderizado fuente.

Nota: Función Getter para la propiedad source.

Véase también setSource().

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

Devuelve el punto de anclaje de origen.

Nota: Función Getter para la propiedad sourceAttachmentPoint.

Véase también setSourceAttachmentPoint().

QRectF QBlitFramebuffer::sourceRect() const

Devuelve el rectángulo de origen.

Nota: Función Getter 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.