QBlitFramebuffer Class

class Qt3DRender::QBlitFramebuffer

프레임 그래프 노드를 사용하여 렌더링 대상의 한 영역에서 다른 영역으로 픽셀 값의 직사각형을 전송할 수 있습니다. 더 보기...

Header: #include <QBlitFramebuffer>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3drender)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake: QT += 3drender
QML에서: BlitFramebuffer
상속합니다: Qt3DRender::QFrameGraphNode
상태: Deprecated

공용 유형

enum InterpolationMethod { Nearest, Linear }

속성

공공 기능

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

신호

상세 설명

이 노드는 glBlitFrameBuffer 또는 이와 동등한 것을 명령 스트림에 삽입합니다. 이는 텍스처 쿼드를 그리는 것보다 QRenderTarget 로 래핑된 텍스처 또는 표면 백버퍼 사이에 직사각형을 복사하는 데 더 효율적인 방법을 제공합니다. 또한 지정된 보간 방법을 사용한 스케일링도 지원합니다.

참고: 실제로는 블릿에 엔티티에 대한 드로 콜을 발행하지 않아야 하므로 QBlitFramebuffer 노드는 종종 QNoDraw 와 함께 사용됩니다.

멤버 유형 문서

enum QBlitFramebuffer::InterpolationMethod

이미지가 늘어날 때 적용되는 보간을 지정합니다.

Constant설명
Qt3DRender::QBlitFramebuffer::Nearest0최근접 보간.
Qt3DRender::QBlitFramebuffer::Linear1선형 보간입니다.

프로퍼티 문서

destination : Qt3DRender::QRenderTarget*

대상 렌더링 대상을 지정합니다. 설정하지 않으면 대상은 기본 프레임버퍼(즉, 현재 서페이스의 백버퍼)가 있는 경우 기본 프레임버퍼로 간주됩니다.

참고: 소스와 대상은 동일한 렌더링 대상을 참조하지 않아야 합니다.

함수 액세스:

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

알림 신호:

void destinationChanged()

destinationAttachmentPoint : Qt3DRender::QRenderTargetOutput::AttachmentPoint

대상 첨부 지점을 지정합니다.

기능에 액세스합니다:

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

알림 신호:

void destinationAttachmentPointChanged()

destinationRect : QRectF

대상 사각형을 지정합니다. 좌표는 일반 Qt 좌표계를 따르는 것으로 가정합니다. 즉, Y는 위에서 아래로 이어집니다.

함수에 액세스합니다:

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

알림 신호:

void destinationRectChanged()

source : Qt3DRender::QRenderTarget*

소스 렌더링 타깃을 지정합니다. 설정하지 않으면 소스는 기본 프레임버퍼(즉, 현재 서페이스의 백버퍼)가 있는 경우 기본 프레임버퍼로 간주됩니다.

참고: 소스와 대상은 동일한 렌더링 대상을 참조하지 않아야 합니다.

함수 액세스:

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

알림 신호:

void sourceChanged()

sourceAttachmentPoint : Qt3DRender::QRenderTargetOutput::AttachmentPoint

소스 첨부 지점을 지정합니다.

기능에 접근합니다:

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

알림 신호:

void sourceAttachmentPointChanged()

sourceRect : QRectF

소스 사각형을 지정합니다. 좌표는 일반 Qt 좌표계를 따르는 것으로 가정합니다. 즉, Y는 위에서 아래로 이어집니다.

함수에 액세스합니다:

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

알림 신호:

void sourceRectChanged()

멤버 함수 문서

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

주어진 parent 으로 새로운 QBlitFramebuffer를 생성합니다.

[virtual noexcept] QBlitFramebuffer::~QBlitFramebuffer()

파괴자.

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

대상 렌더링 대상을 반환합니다.

참고: 속성 대상에 대한 게터 함수입니다.

setDestination()도 참조하세요 .

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

대상 첨부 지점을 반환합니다.

참고: destinationAttachmentPoint 속성에 대한 게터 함수입니다.

setDestinationAttachmentPoint()도 참조하세요 .

QRectF QBlitFramebuffer::destinationRect() const

대상 사각형을 반환합니다.

참고: destinationRect 속성에 대한 게터 함수입니다.

setDestinationRect()도 참조하세요 .

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

보간 메서드를 반환합니다.

참고: 인터폴레이션 메서드 속성에 대한 게터 함수입니다.

setInterpolationMethod()도 참조하세요 .

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

대상 렌더링 대상을 설정합니다. 기본값은 nullptr이며, 이 경우 대상은 기본 프레임버퍼(즉, 현재 서페이스의 백버퍼)가 있는 경우 기본 프레임버퍼로 간주됩니다.

참고: 소스와 대상은 동일한 렌더링 대상을 참조해서는 안 됩니다.

참고: 다른 노드와 마찬가지로 부모가 설정되지 않은 경우 destinationQBlitFramebuffer 인스턴스에 자동으로 부모가 됩니다. 수명도 추적되므로 현재 설정된 destination 이 파괴될 경우 대상은 nullptr로 되돌아갑니다.

참고: destination 속성에 대한 설정자 함수.

destination()도 참조하세요 .

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

destinationAttachmentPoint. 기본값은 Qt3DRender::QRenderTargetOutput::AttachmentPoint::Color0 입니다.

참고: destinationAttachmentPoint 속성에 대한 세터 함수입니다.

destinationAttachmentPoint()도 참조하십시오 .

void QBlitFramebuffer::setDestinationRect(const QRectF &outputRect)

대상 사각형을 outputRect 로 설정합니다. 좌표는 일반 Qt 좌표계를 따르는 것으로 가정합니다. 즉, Y는 위에서 아래로 이어집니다.

참고: destinationRect 속성에 대한 설정자 함수.

destinationRect()도 참조하세요 .

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

이미지가 늘어날 때 적용되는 interpolationMethod 을 설정합니다. 기본값은 선형입니다.

참고: interpolationMethod 속성에 대한 설정자 함수입니다.

interpolationMethod()도 참조하세요 .

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

소스 렌더링 대상을 설정합니다. 기본값은 nullptr이며, 이 경우 소스는 기본 프레임버퍼(즉, 현재 서페이스의 백버퍼)가 있는 경우 기본 프레임버퍼로 간주됩니다.

참고: 소스와 대상은 동일한 렌더링 대상을 참조해서는 안 됩니다.

참고: 다른 노드와 마찬가지로 부모가 설정되지 않은 경우 sourceQBlitFramebuffer 인스턴스에 자동으로 부모가 됩니다. 수명도 추적되므로 현재 설정된 source 이 파괴될 경우 소스는 nullptr로 되돌아갑니다.

참고: source 속성에 대한 설정자 함수.

source()도 참조하세요 .

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

sourceAttachmentPoint. 기본값은 Qt3DRender::QRenderTargetOutput::AttachmentPoint::Color0 입니다.

참고: sourceAttachmentPoint 속성에 대한 세터 함수입니다.

sourceAttachmentPoint()도 참조하십시오 .

void QBlitFramebuffer::setSourceRect(const QRectF &inputRect)

소스 사각형을 inputRect 로 설정합니다. 좌표는 일반 Qt 좌표계를 따르는 것으로 가정하므로, Y 는 위에서 아래로 이어집니다.

참고: 속성 설정자 함수 sourceRect.

sourceRect()도 참조하세요 .

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

소스 렌더 타깃을 반환합니다.

참고: 프로퍼티 소스에 대한 게터 함수입니다.

setSource()도 참조하세요 .

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

소스 첨부 지점을 반환합니다.

참고: sourceAttachmentPoint 속성에 대한 게터 함수입니다.

setSourceAttachmentPoint()도 참조하세요 .

QRectF QBlitFramebuffer::sourceRect() const

소스 사각형을 반환합니다.

참고: sourceRect 속성에 대한 게터 함수입니다.

setSourceRect()도 참조하세요 .

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