QVulkanWindow Class

멤버 함수 문서

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

주어진 parent 로 새 QVulkanWindow 를 생성합니다.

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

[virtual noexcept] QVulkanWindow::~QVulkanWindow()

파괴자.

QList<VkPhysicalDeviceProperties> QVulkanWindow::availablePhysicalDevices()

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

QMatrix4x4 QVulkanWindow::clipCorrectionMatrix()

OpenGL과 벌칸의 좌표계 차이를 보정하는 데 사용할 수 있는 QMatrix4x4 을 반환합니다.

투영 행렬에 이 행렬을 미리 곱하면 애플리케이션은 계속해서 Y가 위쪽을 가리키고 있다고 가정하고 뷰포트에서 최소 깊이와 최대 깊이를 각각 0과 1로 설정하여 버텍스 Z 위치를 추가로 수정할 필요 없이 사용할 수 있습니다. 그러면 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를 반환합니다.

프레임버퍼에는 멀티샘플링을 사용하지 않는 경우 2개의 첨부 파일(색상, 깊이 스텐실)이 있고 sampleCountFlagBits()이 VK_SAMPLE_COUNT_1_BIT 보다 큰 경우 3개의 첨부 파일(색상 해상도, 깊이 스텐실, 멀티샘플 색상)이 있습니다. 렌더러는 명확한 값을 제공할 때 등 이 점을 고려해야 합니다.

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

이 창이 스왑체인을 포함한 모든 벌칸 리소스를 성공적으로 초기화하면 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 목록을 설정합니다.

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

스왑체인 확장은 항상 자동으로 추가되므로 이 목록에 포함할 필요가 없습니다.

[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 은 단순히 스왑체인의 이미지를 대상으로 하는 대신 멀티샘플 컬러 버퍼를 생성합니다. 멀티샘플 버퍼의 렌더링은 각 프레임이 끝날 때마다 비멀티샘플 버퍼로 리졸브됩니다.

지원되는 샘플 수 목록을 확인하려면 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

스왑체인이 전송 소스로서 사용을 지원하는 경우, 즉 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] 범위여야 합니다.