Qt3DRender::QBlitFramebuffer Class
class Qt3DRender::QBlitFramebufferNodo 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
| void | destinationAttachmentPointChanged() |
| void | destinationChanged() |
| void | destinationRectChanged() |
| void | interpolationMethodChanged() |
| void | sourceAttachmentPointChanged() |
| void | sourceChanged() |
| void | sourceRectChanged() |
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.
| Constante | Valor | Descripción |
|---|---|---|
Qt3DRender::QBlitFramebuffer::Nearest | 0 | Interpolación del vecino más próximo. |
Qt3DRender::QBlitFramebuffer::Linear | 1 | Interpolació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:
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.