Windows용 Qt - 그래픽 가속화

의 경우 Qt Quick 가 작동하려면 Direct3D 11, Direct3D 12, Vulkan 1.0 또는 OpenGL 2.1 이상을 지원하는 그래픽 드라이버가 필요합니다. Qt 6부터 Windows에서 Qt Quick 의 기본값은 Direct3D 11입니다. 이는 기본값이 직접 또는 OpenGL에서 Direct3D로의 변환기인 ANGLE을 통해 OpenGL이었던 Qt 5와는 다릅니다. ANGLE은 더 이상 Qt 6에서 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의 기본값은 아니지만, 예를 들어 QOpenGLWindow 또는 QOpenGLWidget 에서 빌드하는 QWidget 기반 응용 프로그램에서 OpenGL은 여전히 많은 Qt 응용 프로그램에서 일반적으로 사용됩니다. 다음 섹션에서는 Qt 빌드의 일부 OpenGL 세부 사항을 다룹니다.

동적으로 OpenGL 로드하기

Qt는 런타임에 OpenGL 구현을 선택하고 로드하는 기능을 지원합니다. 이 모드는 기본값이며, 구성 스크립트에 -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를 추가하면 OpenGL 함수를 직접 호출할 수 있습니다: LIBS += opengl32.lib (Visual Studio) 또는 LIBS += -lopengl32 (Mingw-w64). 그 결과는 애플리케이션의 관점에서 볼 때 Qt XML의 -opengl desktop 빌드 구성과 동일합니다.

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

그래픽 카드 및 드라이버 버전에 따라 사용할 OpenGL 구현을 지정하는 JSON 형식의 구성 파일을 제공할 수 있습니다. 위치는 환경 변수 QT_OPENGL_BUGLIST 로 지정할 수 있습니다. 상대 경로는 QLibraryInfo::SettingsPath 또는 QStandardPaths::ConfigLocation 을 사용하여 확인합니다. 이 파일은 크롬 프로젝트에서 사용되는 드라이버 버그 목록의 형식을 사용합니다. 이 파일은 일련의 조건과 기능 키워드 목록을 지정하는 항목 목록으로 구성됩니다. 일반적으로 특정 그래픽 카드를 일치시키기 위해 장치 ID와 공급업체 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에 직접 종속하는 것입니다. 이 모드의 경우, 구성 스크립트에 -opengl desktop 명령줄 옵션을 전달합니다.

configure -opengl desktop

이러한 Qt 빌드에서는 많은 Qt 공유 라이브러리와 Qt 응용 프로그램도 opengl32.dll에 종속되므로 대체 라이브러리를 사용할 수 없습니다.