QVulkanWindow Class

멤버 함수 문서

[explicit] QVulkanWindow::QVulkanWindow(QWindow *parent = nullptr)

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

표면 유형은 ` QSurface::VulkanSurface`로 설정됩니다.

[virtual noexcept] QVulkanWindow::~QVulkanWindow()

소멸자.

QList<VkPhysicalDeviceProperties> QVulkanWindow::availablePhysicalDevices()

시스템에서 지원되는 물리적 장치의 속성 목록을 반환합니다.

QMatrix4x4 QVulkanWindow::clipCorrectionMatrix()

OpenGL과 Vulkan 간의 좌표계 차이를 보정하는 데 사용할 수 있는 투영 매트릭스( QMatrix4x4 )를 반환합니다.

투영 행렬에 이 행렬을 미리 곱해 주면, 애플리케이션은 Y축이 위쪽을 가리킨다고 계속 가정할 수 있으며, 정점 Z 위치에 대한 추가 보정 없이도 뷰포트의 minDepth와 maxDepth를 각각 0과 1로 설정할 수 있습니다. 이렇게 하면 OpenGL 애플리케이션의 지오메트리를 OpenGL 컬링 및 전면면 설정과 일치하는 래스터화 상태를 가정하여 있는 그대로 사용할 수 있습니다.

VkFormat QVulkanWindow::colorFormat() const

스왑체인에서 사용하는 색상 버퍼 형식을 반환합니다.

setPreferredColorFormats()도 참조하십시오 .

int QVulkanWindow::concurrentFrameCount() const

동시에 활성 상태가 될 수 있는 프레임의 수를 반환합니다.

    class Renderer {
        void startNextFrame();
        // ...

        VkDescriptorBufferInfo m_uniformBufInfo[QVulkanWindow::MAX_CONCURRENT_FRAME_COUNT];
        QVulkanWindow *m_window = nullptr;
    };

    void Renderer::startNextFrame()
    {
        const int count = m_window->concurrentFrameCount();
        // for (int i = 0; i < count; ++i)
            // m_uniformBufInfo[i] = ...
        // ...
    }

참조: currentFrame()

[virtual] QVulkanWindowRenderer *QVulkanWindow::createRenderer()

QVulkanWindowRenderer 의 새로운 인스턴스를 반환합니다.

이 가상 함수는 창의 수명 주기 동안, 창이 처음 표시된 후 어느 시점에서 한 번 호출됩니다.

기본 구현은 null을 반환하므로, 버퍼를 지우는 것 외에는 렌더링이 수행되지 않습니다.

창은 반환된 렌더러 객체에 대한 소유권을 갖습니다.

VkCommandBuffer QVulkanWindow::currentCommandBuffer() const

현재 스왑 체인 프레임에 대한 활성 명령 버퍼를 반환합니다. ` QVulkanWindowRenderer::startNextFrame()`의 구현체는 이 명령 버퍼에 명령을 추가해야 합니다.

int QVulkanWindow::currentFrame() const

[0, concurrentFrameCount() - 1] 범위 내의 현재 프레임 인덱스를 반환합니다.

렌더러 구현체는 프레임 N이 여전히 활성 상태인 프레임 N - 1, N - 2, ... N - concurrentFrameCount() + 1에서 사용하는 데이터를 변경하지 못하도록, 유니폼 데이터 및 기타 동적 리소스가 여러 복사본으로 존재하도록 보장해야 합니다.

동적 배열 크기에 의존하지 않으려면, 애플리케이션은 배열을 선언할 때 ` MAX_CONCURRENT_FRAME_COUNT `를 사용할 수 있습니다. 이 값은 ` concurrentFrameCount()`에서 반환된 값과 항상 같거나 더 크다는 것이 보장됩니다. 그런 다음 이러한 배열은 이 함수에서 반환된 값을 사용하여 인덱싱할 수 있습니다.

    class Renderer {
        void startNextFrame();
        // ...

        VkDescriptorBufferInfo m_uniformBufInfo[QVulkanWindow::MAX_CONCURRENT_FRAME_COUNT];
        QVulkanWindow *m_window = nullptr;
    };

    void Renderer::startNextFrame()
    {
        VkDescriptorBufferInfo &uniformBufInfo(m_uniformBufInfo[m_window->currentFrame()]);
        // ...
    }

concurrentFrameCount()도 참조하십시오 .

VkFramebuffer QVulkanWindow::currentFramebuffer() const

기본 렌더 패스를 사용하여 현재 스왑체인 이미지에 대한 VkFramebuffer를 반환합니다.

멀티샘플링이 사용되지 않을 경우 이 프레임버퍼에는 두 개의 어태치먼트(색상, 깊이-스텐실)가 있으며, ` sampleCountFlagBits()`가 ` VK_SAMPLE_COUNT_1_BIT`보다 클 경우 세 개의 어태치먼트(색상 해상도, 깊이-스텐실, 멀티샘플 색상)가 있습니다. 렌더러는 예를 들어 클리어 값을 제공할 때 이를 고려해야 합니다.

defaultRenderPass()도 참조하십시오 .

int QVulkanWindow::currentSwapChainImageIndex() const

[0, swapChainImageCount() - 1] 범위 내의 현재 스왑 체인 이미지 인덱스를 반환합니다.

VkRenderPass QVulkanWindow::defaultRenderPass() const

하나의 서브 패스가 포함된 일반적인 렌더 패스를 반환합니다.

currentFramebuffer()도 참조하십시오 .

VkFormat QVulkanWindow::depthStencilFormat() const

깊이-스텐실 버퍼에서 사용하는 형식을 반환합니다.

VkImage QVulkanWindow::depthStencilImage() const

뎁스-스텐실 이미지를 반환합니다.

VkImageView QVulkanWindow::depthStencilImageView() const

깊이-스텐실 이미지 뷰를 반환합니다.

VkDevice QVulkanWindow::device() const

활성 논리 장치를 반환합니다.

uint32_t QVulkanWindow::deviceLocalMemoryIndex() const

일반적인 용도에 적합한 장치 로컬 메모리 유형 인덱스를 반환합니다.

QVulkanWindow::Flags QVulkanWindow::flags() const

요청된 플래그를 반환합니다.

setFlags()도 참조하십시오 .

[signal] void QVulkanWindow::frameGrabbed(const QImage &image)

image 가 준비 상태가 되면 이 신호가 전송됩니다.

void QVulkanWindow::frameReady()

이 함수는 QVulkanWindowRenderer::startNextFrame() 구현이 호출될 때마다 정확히 한 번씩 호출되어야 합니다. 이 호출 시점에는 currentCommandBuffer()을 통해 노출된 메인 명령 버퍼에 필요한 모든 렌더링 명령이 추가되어 있어야 합니다. 이 함수는 명령을 제출하고 현재 명령을 큐에 추가하는 작업을 트리거하기 때문입니다.

QVulkanWindowRenderer::startNextFrame()도 참조하십시오 .

QImage QVulkanWindow::grab()

다음 프레임을 생성하고 렌더링하되 화면에 표시하지 않은 다음, 이미지 콘텐츠에 대한 차단형 리드백을 수행합니다.

렌더러의 ` startNextFrame()` 구현이 ` frameReady()`를 직접 호출하는 경우 이미지를 반환합니다. 그렇지 않은 경우, 크기는 맞지만 아직 내용이 채워지지 않은 불완전한 이미지를 반환합니다. 후자의 경우, 내용은 ` frameGrabbed()` 신호를 통해 전달됩니다.

반환되는 ` QImage `는 항상 ` QImage::Format_RGBA8888` 형식을 갖습니다. ` colorFormat()`가 ` VK_FORMAT_B8G8R8A8_UNORM`인 경우, 이 형식은 스왑체인 색상 버퍼의 기본 선택으로 흔히 사용되므로 빨간색과 파란색 채널이 자동으로 바뀝니다. 다른 색상 버퍼 형식의 경우, 이 함수는 변환을 수행하지 않습니다.

VkCommandPool QVulkanWindow::graphicsCommandPool() const

활성 그래픽 명령 풀을 반환합니다.

VkQueue QVulkanWindow::graphicsQueue() const

활성 그래픽 큐를 반환합니다.

uint32_t QVulkanWindow::graphicsQueueFamilyIndex() const

활성 그래픽 큐의 패밀리 인덱스를 반환합니다.

uint32_t QVulkanWindow::hostVisibleMemoryIndex() const

일반적인 용도에 적합한 호스트 가시 메모리 유형 인덱스를 반환합니다.

반환되는 메모리 유형은 호스트 가시적이며 일관성을 갖습니다. 또한, 가능한 경우 캐시됩니다.

bool QVulkanWindow::isValid() const

이 창이 스왑체인(swapchain)을 포함한 모든 Vulkan 리소스를 성공적으로 초기화한 경우 true를 반환합니다.

VkImage QVulkanWindow::msaaColorImage(int idx) const

지정된 멀티샘플 컬러 이미지를 반환하며, 멀티샘플링이 사용되지 않는 경우에는 VK_NULL_HANDLE 를 반환합니다.

idx 값은 [0, swapChainImageCount() - 1] 범위 내에 있어야 합니다.

VkImageView QVulkanWindow::msaaColorImageView(int idx) const

지정된 멀티샘플 컬러 이미지 뷰를 반환하거나, 멀티샘플링이 사용되지 않는 경우 VK_NULL_HANDLE 를 반환합니다.

idx 값은 [0, swapChainImageCount() - 1] 범위 내에 있어야 합니다.

VkPhysicalDevice QVulkanWindow::physicalDevice() const

활성 상태인 물리적 장치를 반환합니다.

const VkPhysicalDeviceProperties *QVulkanWindow::physicalDeviceProperties() const

활성 물리적 장치의 속성에 대한 포인터를 반환합니다.

VkSampleCountFlagBits QVulkanWindow::sampleCountFlagBits() const

현재 샘플 수를 ‘ VkSampleCountFlagBits ’ 값으로 반환합니다.

기본 렌더 타겟을 대상으로 할 경우, ` VkPipelineMultisampleStateCreateInfo `의 ` rasterizationSamples ` 필드를 이 값으로 설정해야 합니다.

setSampleCount() 및 supportedSampleCounts()도 참조하십시오 .

void QVulkanWindow::setDeviceExtensions(const QByteArrayList &extensions)

활성화할 장치 extensions 목록을 설정합니다.

지원되지 않는 확장 기능은 무시됩니다.

스왑체인(swapchain) 확장 기능은 항상 자동으로 추가되므로 이 목록에 포함시킬 필요가 없습니다.

[since 6.7] void QVulkanWindow::setEnabledFeaturesModifier(const QVulkanWindow::EnabledFeaturesModifier &modifier)

활성화된 장치 기능 수정 함수 ` modifier`를 설정합니다.

이 함수는 Qt 6.7에서 도입되었습니다.

EnabledFeaturesModifier도 참조하십시오 .

[since 6.7] void QVulkanWindow::setEnabledFeaturesModifier(QVulkanWindow::EnabledFeatures2Modifier modifier)

활성화된 장치 기능 수정 함수 modifier 를 설정합니다.

이 함수는 Qt 6.7에서 도입되었습니다.

EnabledFeatures2Modifier도 참조하십시오 .

void QVulkanWindow::setFlags(QVulkanWindow::Flags flags)

지정된 ` flags`에 따라 동작을 설정합니다.

flags()도 참조하십시오 .

void QVulkanWindow::setPhysicalDeviceIndex(int idx)

인덱스가 idx 인 물리적 장치의 사용을 요청합니다. 이 인덱스는 availablePhysicalDevices()에서 반환된 목록에 해당합니다.

기본적으로 첫 번째 물리적 장치가 사용됩니다.

void QVulkanWindow::setPreferredColorFormats(const QList<VkFormat> &formats)

스왑 체인의 선호하는 formats 를 설정합니다.

기본적으로 애플리케이션이 선호하는 형식은 설정되어 있지 않습니다. 이 경우 서페이스의 선호 형식이 사용되며, 해당 형식이 없는 경우에는 ` VK_FORMAT_B8G8R8A8_UNORM`가 사용됩니다.

formats 내의 목록은 정렬되어 있습니다. 첫 번째 형식이 지원되지 않으면 두 번째 형식이 고려되며, 이 과정이 순차적으로 진행됩니다. 목록에 있는 형식 중 지원되는 것이 없을 경우, 동작은 기본 경우와 동일합니다.

초기화 후 실제 형식을 조회하려면 ` colorFormat()`를 호출하십시오.

colorFormat()도 참조하십시오 .

void QVulkanWindow::setQueueCreateInfoModifier(const QVulkanWindow::QueueCreateInfoModifier &modifier)

큐 생성 정보 수정 함수 modifier 를 설정합니다.

QueueCreateInfoModifier도 참조하십시오 .

void QVulkanWindow::setSampleCount(int sampleCount)

지정된 ` sampleCount` 값을 사용하여 멀티샘플 앤티앨리어싱을 요청합니다. 유효한 값은 1, 2, 4, 8, …이며, 물리적 장치가 지원하는 최대 값까지 가능합니다.

샘플 수가 1보다 클 경우, ` QVulkanWindow `는 단순히 스왑체인(swapchain)의 이미지를 대상으로 하는 대신 멀티샘플 컬러 버퍼를 생성합니다. 멀티샘플 버퍼에서의 렌더링 결과는 각 프레임이 끝날 때마다 비멀티샘플 버퍼로 변환됩니다.

지원되는 샘플 수 목록을 확인하려면 supportedSampleCounts()를 호출하십시오.

렌더링 파이프라인을 설정할 때, sampleCountFlagBits()를 호출하여 활성 샘플 수를 VkSampleCountFlagBits 값으로 조회하십시오.

supportedSampleCounts() 및 sampleCountFlagBits()도 참조하십시오 .

QVulkanInfoVector<QVulkanExtension> QVulkanWindow::supportedDeviceExtensions()

setPhysicalDeviceIndex() 함수로 선택한 물리적 장치에서 생성된 논리 장치가 지원하는 확장 기능 목록을 반환합니다.

QList<int> QVulkanWindow::supportedSampleCounts()

setPhysicalDeviceIndex() 함수로 선택된 물리적 장치를 사용할 때 지원되는 샘플 수 집합을 정렬된 목록 형태로 반환합니다.

기본적으로 ` QVulkanWindow ()`는 샘플 수 1을 사용합니다. 이 함수가 반환한 집합과 다른 값(2, 4, 8, ...)을 사용하여 ` setSampleCount()`를 호출하면, 다중 샘플 앤티앨리어싱을 요청할 수 있습니다.

참조: setSampleCount().

bool QVulkanWindow::supportsGrab() const

스왑체인(swapchain)이 전송 소스로서의 사용을 지원하는 경우, 즉 ` grab()`가 정상적으로 작동하는 경우 true를 반환합니다.

VkImage QVulkanWindow::swapChainImage(int idx) const

지정된 스왑 체인 이미지를 반환합니다.

idx 값은 [0, swapChainImageCount() - 1] 범위 내에 있어야 합니다.

int QVulkanWindow::swapChainImageCount() const

스왑 체인에 포함된 이미지 수를 반환합니다.

QSize QVulkanWindow::swapChainImageSize() const

스왑체인의 이미지 크기를 반환합니다.

이는 일반적으로 창의 크기와 일치하지만, vkGetPhysicalDeviceSurfaceCapabilitiesKHR 가 고정 크기를 보고하는 경우에는 다를 수도 있습니다.

또한 일부 플랫폼에서는 높은 DPI 스케일링이 활성화된 상태에서 Vulkan이 보고하는 표면 크기가 다른 것으로 관찰되었는데, 이는 QWindow 가 보고하는 size() 값에 devicePixelRatio() 값을 곱한 결과가 여기에서 반환된 값과 비교했을 때 1픽셀 정도 차이가 나는 것을 의미하며, 이는 아마도 반올림 차이로 인한 것으로 보입니다. 렌더링 코드는 이 점을 유의해야 하며, 관련 렌더링 로직은 반드시 여기서 반환된 값을 기반으로 해야 하며, 절대로 QWindow 에서 보고된 크기를 기준으로 해서는 안 됩니다. 이론적으로 어떤 픽셀 크기가 정확하든 상관없이, Vulkan 렌더링은 오직 Vulkan API에서 보고된 표면 크기만을 신뢰해야 합니다. 그렇지 않으면, 예를 들어 뷰포트를 설정할 때, 애플리케이션에서 제공한 값이 Vulkan의 관점에서 범위를 벗어날 수 있으므로 유효성 검사 오류가 발생할 수 있습니다.

VkImageView QVulkanWindow::swapChainImageView(int idx) const

지정된 스왑 체인 이미지 뷰를 반환합니다.

idx 값은 [0, swapChainImageCount() - 1] 범위 내에 있어야 합니다.