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