Windows용 Qt - 그래픽 가속

이 기능을 Qt Quick 이 기능이 작동하려면 Direct 3D 11, Direct3D 12, Vulkan 1.0 또는 OpenGL 2.1 이상을 지원하는 그래픽 드라이버가 필요합니다. Qt 6부터 Windows에서 Qt Quick 의 기본값은 Direct3D 11입니다. 이는 기본값이 Qt OpenGL이거나 Qt OpenGL을 Direct3D로 변환하는 ANGLE을 통해 Qt OpenGL을 사용했던 Qt 5와는 다릅니다. Qt 6에서는 더 이상 ANGLE이 Qt와 함께 제공되지 않습니다.

Direct3D의 소프트웨어 래스터라이저(WARP) 사용을 강제하려면 환경 변수 ` QSG_RHI_PREFER_SOFTWARE_RENDERER `를 ` 1`로 설정하십시오. 경우에 따라 ` Qt Quick `는 추가 구성 없이 Qt 애플리케이션을 실행할 수 있도록 이러한 대체 방식을 자동으로 수행합니다. 이는 드라이버가 충분한 수준의 D3D11 기능을 제공하지 않을 때 발생하며, 일반적으로 적절한 GPU 가속 및 패스스루가 구현되지 않은 가상 머신에서 나타납니다. 어떤 그래픽 장치가 사용되고 있는지 확실하지 않거나, 문제 해결을 하거나 Qt에 문제를 보고할 때는 QSG_INFO=1 환경 변수를 설정하고 애플리케이션을 실행한 후 디버그 출력을 확인하십시오. qtdiag 도구를 실행하면 사용 가능한 모든 3D API를 열거하므로 유용한 정보를 얻을 수 있습니다.

Vulkan, OpenGL 또는 Direct 3D 12 사용을 요청하려면 환경 변수 QSG_RHI_BACKEND 를 vulkan, opengl 또는 d3d12 로 설정하거나, main() 의 해당 C++ API 를 사용하십시오. 이러한 3D API 중 일부는 적절한 드라이버가 설치되어 있어야 할 수 있습니다.

비록 Qt Quick는 아니지만, OpenGL은 여전히 많은 Qt 애플리케이션에서 널리 사용되고 있습니다. 예를 들어, QOpenGLWindow 또는 QOpenGLWidget 를 기반으로 구축된 QWidget 기반 애플리케이션이 있습니다. 다음 섹션에서는 Qt 빌드와 관련된 OpenGL의 몇 가지 세부 사항을 다룹니다.

OpenGL의 동적 로딩

Qt는 런타임 시 OpenGL 구현체를 선택하고 로드하는 기능을 지원합니다. 이 모드는 기본 설정이며, configure 스크립트에 -opengl dynamic 를 전달하여 명시적으로 요청할 수 있습니다.

configure -opengl dynamic

이 구성은 빌드 시점에 OpenGL 구현체에 대한 의존성이나 가정이 하드코딩되지 않기 때문에 가장 유연합니다. 이를 통해 안정적인 애플리케이션 배포가 가능합니다. 특정 환경에서 적절한 OpenGL 2.0 구현체를 제공하지 못할 경우, 시스템은 자동으로 opengl32.dll 대신 대체 구현체를 로드하며, 이 대체 구현체의 기본 이름은 opengl32sw.dll 입니다. 사전 빌드된 Qt 패키지에는 OpenGL의 소프트웨어 래스터라이저 구현체인 Mesa llvmpipe가 해당 이름으로 포함되어 있습니다.

-opengl dynamic 로 구성될 경우, Qt나 qmake 또는 CMake 를 사용하여 빌드된 애플리케이션 모두 opengl32.lib에 링크되지 않습니다. 대신, 라이브러리는 런타임에 선택되어 로드됩니다. 기본적으로 Qt는 시스템의 opengl32.dll이 OpenGL 2 함수를 제공하는지 여부를 판단합니다. 해당 함수가 존재하면 opengl32.dll이 사용되며, 그렇지 않은 경우 opengl32sw.dll 을 로드하려고 시도합니다. 자세한 내용은 아래를 참조하십시오.

이 로딩 메커니즘은 QT_OPENGL 환경 변수와 다음 애플리케이션 속성을 통해 구성할 수 있습니다:

• Qt::AA_UseDesktopOpenGL QT_OPENGL 을 로 설정하는 것과 동일합니다. desktop
• Qt::AA_UseOpenGLES Qt 6에서는 효과가 없습니다.
• Qt::AA_UseSoftwareOpenGL QT_OPENGL 을 로 설정하는 것과 동일합니다. software

특정 구성이 명시적으로 요청된 경우, 애플리케이션 시작 시에는 검사가 수행되지 않습니다. 즉, 시스템에서 제공하는 opengl32.dll은 검사되지 않습니다.

동적 로딩은 네이티브 OpenGL 호출을 포함하는 애플리케이션에 상당한 영향을 미칩니다. opengl32.lib가 링커에 자동으로 지정되지 않기 때문에 링크에 실패할 수 있습니다. 대신, 애플리케이션은 QOpenGLFunctions 클래스를 통해 OpenGL 함수를 사용해야 합니다. 따라서 OpenGL 라이브러리에 대한 직접적인 종속성이 제거되고, 모든 호출은 런타임 중에 Qt가 선택한 구현으로 라우팅됩니다. 또는, .pro 프로젝트 파일에 opengl32.lib를 추가하는 경우( LIBS += opengl32.lib (Visual Studio) 또는 LIBS += -lopengl32 (Mingw-w64)), 애플리케이션에서 OpenGL 함수를 직접 호출할 수도 있습니다. 그 결과, 애플리케이션의 관점에서 볼 때 이는 Qt의 ` -opengl desktop ` 빌드 구성과 동등한 효과를 냅니다.

Qt::AA_UseSoftwareOpenGL 는 비표준 이름의 OpenGL 구현체를 로드하려고 시도한다는 점에서 특별합니다. 기본 이름은 opengl32sw.dll 입니다. 이를 통해 llvmpipe가 포함된 Mesa 빌드와 같은 순수 소프트웨어 기반 OpenGL 구현체를 이 이름으로 배포할 수 있습니다. 필요한 경우, QT_OPENGL_DLL 환경 변수를 설정하여 파일 이름을 재정의할 수 있습니다.

그래픽 카드 및 드라이버 버전에 따라 사용할 OpenGL 구현체를 지정하는 JSON 형식의 구성 파일을 제공할 수 있습니다. 파일 위치는 QT_OPENGL_BUGLIST 환경 변수로 지정됩니다. 상대 경로는 QLibraryInfo::SettingsPath 또는 QStandardPaths::ConfigLocation 를 사용하여 해결됩니다. 이 파일은 크롬 프로젝트(The Chromium Projects)에서 사용되는 드라이버 버그 목록의 형식을 따릅니다. 이 파일은 각 항목이 일련의 조건과 기능 키워드 목록을 지정하는 항목 목록으로 구성됩니다. 일반적으로 특정 그래픽 카드를 식별하기 위해 장치 ID(device id)와 공급업체 ID(vendor id)가 사용됩니다. 이러한 정보는 ` qtdiag6 ` 또는 ` dxdiag ` 도구의 출력에서 확인할 수 있습니다.

다음 기능 키워드는 OpenGL 구현을 선택하는 데 관련이 있습니다:

• disable_desktopgl - OpenGL을 비활성화합니다. 이를 통해 Qt가 일반 OpenGL(opengl32.dll)을 사용하려고 시도하지 않고, 바로 ANGLE로 시작하도록 보장합니다. 이는 불량한 OpenGL 드라이버로 인해 애플리케이션이 강제 종료되는 것을 방지하는 데 유용합니다.
• disable_rotation - 애플리케이션이 항상 가로 방향으로 실행되도록 강제합니다. 소프트웨어 OpenGL 구현체를 사용할 때는 효과가 없습니다. 이 옵션은 회전 기능에 문제가 있는 드라이버를 위해 마련되었습니다.
• disable_program_cache - 디스크에 셰이더 프로그램 바이너리를 저장하지 않도록 합니다.

샘플 파일은 다음과 같습니다:

{
"entries": [
{
  "id": 1,
  "description": "Disable D3D11 on older nVidia drivers",
  "os": {
    "type": "win"
  },
  "vendor_id": "0x10de",
  "device_id": ["0x0DE9"],
  "driver_version": {
    "op": "<=",
    "value": "8.17.12.6973"
  },
  "features": [
    "disable_d3d11"
  ]
},
...

QT_OPENGL_BUGLIST 가 지정되지 않은 경우, 내장된 목록이 사용됩니다. 이 목록에는 일반적으로 disable_desktopgl 가 설정된 구형이고 성능이 낮은 그래픽 카드가 포함되어 있습니다. 이는 Qt가 해당 카드의 불안정한 데스크톱 OpenGL 구현을 사용하는 것을 방지하고, 대신 즉시 소프트웨어 기반 대체 라이브러리를 로드하도록 전환하기 위함입니다.

실제로 가장 흔한 조합은 다음과 같을 것으로 예상됩니다:

• disable_desktopgl - 시스템이 OpenGL 2.0 이상을 제공하지만, 드라이버가 불안정하고 충돌이 자주 발생하는 것으로 알려진 경우.
• disable_desktopgl, disable_angle - 가속 경로를 원하지 않을 때 사용합니다. 이 옵션을 사용하면 Qt가 시도하는 유일한 옵션이 소프트웨어 래스터라이저(opengl32sw.dll)가 되도록 보장합니다. 가상 머신이나 다양한 구형 시스템에 배포된 애플리케이션에서 유용할 수 있습니다.

주어진 그래픽 카드나 드라이버와 일치하는 데 지원되는 키는 다음과 같습니다. 이들 중 일부는 Qt에 특화된 것임을 유의하십시오.

• os.type - 운영 체제: win, linux, macosx, android
• os.version - 커널 버전
• os.release - Windows에서 지원되는 운영 체제 릴리스 목록: xp, vista, 7, 8, 8.1, 10.
• vendor_id - 어댑터 식별자에서 추출한 공급업체
• device_id - PCI 장치 ID 목록.
• driver_version - 어댑터 식별자에서 추출한 드라이버 버전
• driver_description - 값이 어댑터 식별자에 포함된 드라이버 설명의 부분 문자열일 때 일치합니다.
• gl_vendor - 값이 ‘ GL_VENDOR ’ 문자열의 부분 문자열일 때 일치합니다

모든 블랙리스트 기능을 비활성화하려면 환경 변수 ` QT_NO_OPENGL_BUGLIST `를 임의의 값으로 설정하십시오. 이렇게 하면 구성 파일 읽기가 건너뛰어지며, 드라이버나 OS에 관계없이 아무것도 비활성화되지 않은 것으로 간주됩니다.

opengl32.dll에 대한 직접 의존성

기본 dynamic OpenGL 빌드 대신 opengl32.dll에 직접 의존하는 방법도 있습니다. 이 모드를 사용하려면 configure 스크립트에 -opengl desktop 명령줄 옵션을 전달하십시오.

configure -opengl desktop

이러한 Qt 빌드에서는 많은 Qt 공유 라이브러리와 Qt 애플리케이션이 opengl32.dll에 의존하게 되므로, 대체 라이브러리를 사용하는 것은 불가능합니다.