QQuickWidget - QQuickView 비교 예제

이 예제는 동일한 QWidget 기반 사용자 인터페이스 내에서 두 가지 다른 접근 방식을 사용하여 동일한 Qt Quick 장면을 표시하는 방법을 보여줍니다:

• QQuickView 를 사용하는 방법.

  이 객체는 자식 창으로 사용되며 QWidget::createWindowContainer() 메서드와 함께 사용됩니다.

• QQuickWidget 사용.

  진정한 QWidget 로 작동하며, 진정한 QWidget 에서 기대할 수 있듯이, 특히 더 나은 클리핑 및 스태킹 기능을 지원합니다.

Show widget overlay 확인란을 클릭하면 네이티브 창을 임베드할 때 예상대로 렌더링되지 않는 위젯 스태킹 사례가 표시되지만, QQuickWidget 를 사용하면 예상대로 렌더링됩니다.

예제 실행

다음 경로에서 예제를 실행할 수 있습니다.

• Qt Creator

  Welcome 모드를 열고 Examples 에서 예제를 선택하십시오. 자세한 내용은 Qt Creator 의 ‘튜토리얼: 빌드 및 실행’을 참조하십시오.

• Qt Extension for Visual Studio Code

  Command Palette 에서 Qt: Open Qt examples 명령을 실행하고, 목록에서 예제를 선택합니다. 자세한 내용은 Qt Extension for Visual Studio Code: 튜토리얼: 빌드 및 실행을 참조하십시오.

플랫폼 관련 참고 사항

Qt Quick 장면은 QQuickWidget 에 임베드된 경우에도 직접 OpenGL 렌더링을 사용합니다. 이는 렌더링이 계속해서 가속화된 3D API를 사용함을 확인시켜 줍니다.

따라서 이 예제는 OpenGL에 종속되어 있으며, Vulkan, Metal 또는 Direct3D와 같은 다른 그래픽 API에서는 작동하지 않습니다.

다중 샘플 앤티앨리어싱

해당 확인란을 선택하여 멀티샘플 앤티앨리어싱을 활성화할 수 있습니다. 이 기능이 활성화되면 QQuickWidget 는 콘텐츠를 멀티샘플 렌더 버퍼로 렌더링합니다. 각 렌더 패스가 끝난 후, 콘텐츠는 표준 2D 텍스처로 변환됩니다. 이를 통해 QWidget 기반 UI의 나머지 부분에는 영향을 주지 않으면서 Qt Quick 콘텐츠에 대한 앤티앨리어싱을 적용할 수 있습니다.

QQuickView 을 사용하는 경우, 네이티브 창은 해당 표면에 대해 멀티샘플링을 요청합니다. 이는 플랫폼 지원 여부에 따라 유사한 결과를 제공합니다.

키보드 입력

Qt Quick 장면은 사용되는 임베딩 기술에 관계없이 텍스트 입력을 포함한 사용자 상호작용을 지원합니다. QQuickWidget 를 사용할 경우, 입력 이벤트는 자동으로 Qt Quick 장면으로 전달됩니다.

예제 프로젝트 @ code.qt.io