QCanvasRhiPaintDriver Class

멤버 함수 문서

void QCanvasRhiPaintDriver::beginPaint(QCanvasOffscreenCanvas &canvas, QRhiCommandBuffer *cb, QCanvasRhiPaintDriver::BeginPaintFlags flags = {})

지정된 오프스크린 canvas 에 페인팅을 시작하며, 렌더링 명령을 명령 버퍼 cb 에 기록합니다.

QCanvasOffscreenCanvas::Flag::PreserveContents 플래그가 설정된 경우를 제외하고는 fill color set on the canvas 를 통해 지워집니다. 플래그가 설정된 경우 지워지지 않고 캔버스 내용이 보존됩니다(기본 GPU 아키텍처에 따라 성능에 영향을 미칠 수 있음).

flags 렌더링을 제어하는 선택적 플래그를 지정합니다.

void QCanvasRhiPaintDriver::beginPaint(QRhiCommandBuffer *cb, QRhiRenderTarget *rt, const QMatrix4x4 &matrix, QCanvasRhiPaintDriver::BeginPaintFlags flags = {})

렌더 타겟 rt 에 페인팅을 시작하고, 렌더링 명령을 명령 버퍼 cb 에 기록합니다.

이 오버로드는 정점 변환에 사용되는 사용자 정의 matrix 를 인수로 받습니다. 이 행렬은 좌표가 픽셀 단위로 지정된 정점을 처리할 수 있어야 합니다. 일반적인 사용 사례로는 QSGRenderNode 의 하위 클래스 내에서 QCanvasPainter 기반 렌더링을 구현할 때 Qt Quick 의 모델-뷰-투영 행렬을 전달하는 것입니다.

뷰포트 크기와 장치 픽셀 비율은 렌더 타깃에서 가져옵니다.

이 오버로드는 채우기 색상을 받지 않습니다. 실제로는 EndPaintFlag::DoNotRecordRenderPass 플래그가 설정된 endPaint() 호출이 뒤따를 것으로 예상되기 때문입니다.

flags 렌더링을 제어하는 선택적 플래그를 지정합니다.

void QCanvasRhiPaintDriver::beginPaint(QRhiCommandBuffer *cb, QRhiRenderTarget *rt, QColor fillColor = Qt::black, QSize logicalSize = QSize(), qreal dpr = 1.0, QCanvasRhiPaintDriver::BeginPaintFlags flags = {})

렌더 타겟 rt 에 그리기를 시작하며, 렌더링 명령을 명령 버퍼 cb 에 기록합니다.

fillColor 컬러 버퍼를 지우는 데 사용되는 색상을 지정합니다. endPaint()의 플래그에 EndPaintFlag::DoNotRecordRenderPass 가 포함되어 있는 경우 이 값은 무시됩니다.

logicalSize 는 선택 사항입니다. 비어 있지 않을 경우, 논리 단위로 뷰포트 크기를 지정합니다. 이 경우 dpr 는 logicalSize 가 내부적으로 픽셀로 변환될 수 있도록 스케일 계수(디바이스 픽셀 비율)를 지정해야 합니다. 실제로는 렌더 타겟의 크기가 기본적으로 자동으로 사용되므로 이 옵션이 필요한 경우는 거의 없습니다.

flags 렌더링을 제어하는 선택적 플래그를 지정합니다.

void QCanvasRhiPaintDriver::endPaint(QCanvasRhiPaintDriver::EndPaintFlags flags = {})

QCanvasPainter 렌더링 명령어로 생성된 모든 QRhi 렌더링을 플러시하고 기록합니다.

기본적으로 이 함수는 전체 렌더링 패스를 기록하며, 이는 내부적으로 ` QRhiCommandBuffer::beginPass()` 및 ` QRhiCommandBuffer::endPass()`를 호출함을 의미합니다. 클리어 색상은 ` beginPaint()`의 `fillColor` 인자 또는 오프스크린 캔버스의 채우기 색상으로 지정됩니다.

flags endPaint()가 beginPass() - endPass() 시퀀스 전체를 실행하도록 하는 것이 바람직하지 않은 경우가 있으므로, 이 함수를 사용하여 렌더 패스 기록을 제어할 수 있습니다.

다음 두 코드 조각은 결과 면에서는 동일하지만, 애플리케이션이 동일한 렌더 패스 내에서 더 많은 작업을 수행하고자 하는 경우 두 번째 코드가 더 큰 유연성을 제공합니다:

pd->beginPaint(cb, rt, Qt::black);
// painter->...
pd->endPaint();

pd->beginPaint(cb, rt);
// painter->...
pd->endPaint(QCanvasRhiPaintDriver::EndPaintFlag::DoNotRecordRenderPass);

cb->beginPass(rt, Qt::black, { 1.0f, 0 });
pd->renderPaint();
cb->endPass();

beginPaint() 및 renderPaint()도 참조하십시오 .

template <typename Functor> void QCanvasRhiPaintDriver::grabCanvas(const QCanvasOffscreenCanvas &canvas, const QObject *context, Functor &&callback)

canvas 에 대한 텍스처 리드백 요청을 발행하며, 이를 context 와 연결합니다.

callback 이 함수는 기본이 되는 ` QRhi ` 및 3D API 구현에 따라, 함수가 반환되기 전이나 그 이후에 호출됩니다. 텍스처 내용을 다시 읽는 과정에는 GPU 아키텍처에 따라 GPU→CPU 복사가 포함될 수 있습니다. 이 함수는 단일 ` const QImage & ` 인자를 받으며, 이동 전용(move-only) 함수를 포함하여 어떤 펑터(functor)라도 사용할 수 있습니다.

읽기 작업이 완료되기 전에 context 가 소멸되면, 그랩이 취소되고 callback 는 호출되지 않습니다. 따라서 콜백 함수에서 진행 중인 읽기 작업이 완료되기 전에 소멸될 수 있는 객체를 참조해도 안전합니다.

이 함수는 ` beginPaint()` - ` endPaint()` 블록 내부와 외부 모두에서 호출될 수 있습니다. 외부에서 호출될 경우, 내부적으로 ` QRhi::beginOffscreenFrame()` 등을 호출하여 언제든지 그랩을 수행할 수 있게 합니다.

예를 들어, 다음 코드는 화면 밖 캔버스의 내용을 PNG 파일로 저장합니다:

grabCanvas(offscreenCanvas, qGuiApp, [](const QImage &image) {
    image.save("result.png");
});

void QCanvasRhiPaintDriver::renderPaint()

QCanvasPainter 드로잉 명령어로 생성된 모든 QRhi 렌더링을 기록합니다. 이 함수는 endPaint()이 DoNotRecordRenderPass 로 호출된 경우에만 호출해야 합니다. 그 외의 경우에는 절대로 호출해서는 안 됩니다.

이 함수가 호출될 때, 관련 QRhi 는 렌더링 패스를 기록 중이어야 합니다.

endPaint()도 참조하십시오 .

void QCanvasRhiPaintDriver::resetForNewFrame()

페인터 엔진 상태를 초기화합니다. 이 함수는 완전히 새로운 프레임을 시작할 때, 일반적으로 ` QRhi::beginFrame()` 또는 ` QRhi::beginOffscreenFrame()` 호출 후에 한 번 호출되어야 합니다.