Back to Qt.io
Contact Us Blog Download Qt
이 페이지에서

Qt3DRender::QBlitFramebuffer Class

class Qt3DRender::QBlitFramebuffer

렌더 타깃의 한 영역에서 다른 영역으로 픽셀 값으로 구성된 사각형을 전송하는 FrameGraph 노드입니다. 더 보기...

헤더: #include <qblitframebuffer.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3drender)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake: QT += 3drender
QML에서: BlitFramebuffer
상속: Qt3DRender::QFrameGraphNode
상태: 사용 중단됨

이 클래스는 더 이상 사용되지 않습니다. 새로운 코드에서는 이 클래스를 사용하지 않는 것을 강력히 권장합니다.

공개 유형

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

신호

void destinationAttachmentPointChanged()
void destinationChanged()
void destinationRectChanged()
void interpolationMethodChanged()
void sourceAttachmentPointChanged()
void sourceChanged()
void sourceRectChanged()

상세 설명

이 노드는 명령 스트림에 glBlitFrameBuffer 또는 이에 상응하는 명령을 삽입합니다. 이는 텍스처가 적용된 사각형을 그리는 것보다, 텍스처 간 또는 QRenderTarget 로 래핑된 표면 백버퍼 간에 직사각형을 복사하는 데 더 효율적인 방법을 제공합니다. 또한 지정된 보간 방법을 사용한 크기 조정도 지원합니다.

참고: 실제로는 블릿(blit) 과정에서 어떤 엔티티에 대한 드로우 호출도 발생해서는 안 되므로, QBlitFramebuffer 노드는 종종 QNoDraw 와 함께 사용됩니다.

멤버 유형 설명서

enum QBlitFramebuffer::InterpolationMethod

이미지가 확대될 때 적용될 보간 방식을 지정합니다.

상수값설명
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)

Notifier 신호:

void destinationRectChanged()

interpolationMethod : InterpolationMethod

이 속성은 이미지가 늘어나는 경우 적용되는 보간 방법을 지정합니다.

이미지가 확대/축소될 때 적용될 보간 방식을 지정합니다. 기본값은 '선형'입니다.

액세스 함수:

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

알림 신호:

void interpolationMethodChanged()

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)

Notifier 시그널:

void sourceRectChanged()

멤버 함수 문서

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

지정된 ` parent`을 사용하여 새로운 `QBlitFramebuffer`를 생성합니다.

[virtual noexcept] QBlitFramebuffer::~QBlitFramebuffer()

소멸자.

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

대상 렌더 타깃을 반환합니다.

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

setDestination()도 참조하십시오 .

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

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

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

참조: ` setDestinationAttachmentPoint()` 함수.

QRectF QBlitFramebuffer::destinationRect() const

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

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

setDestinationRect()도 참조하십시오 .

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

보간 방법을 반환합니다.

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

setInterpolationMethod()도 참조하십시오 .

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

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

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

참고: 다른 노드와마찬가지로 , 부모가 설정되지 않은 경우 ` destination `는 ` QBlitFramebuffer ` 인스턴스에 자동으로 부모-자식 관계가 설정됩니다. 또한 수명 주기가 추적되므로, 현재 설정된 ` 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 )을 설정합니다. 기본값은 Linear입니다.

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

interpolationMethod()도 참조하십시오 .

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

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

참고: 소스와 대상은 동일한 렌더 타깃을 가리키면 안 됩니다.

참고: 다른 노드와마찬가지로 , 부모가 설정되지 않은 경우 ` source `는 ` QBlitFramebuffer ` 인스턴스에 자동으로 부모-자식 관계가 설정됩니다. 또한 수명 주기가 추적되므로, 현재 설정된 ` 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

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

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

setSource()도 참조하십시오 .

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

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

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

setSourceAttachmentPoint()도 참조하십시오 .

QRectF QBlitFramebuffer::sourceRect() const

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

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

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.