이 페이지에서

Qt 3D Render QML Types

이 모듈은 Qt3D.Render 6.8부터 더 이상 사용되지 않습니다. 새로운 코드에서는 이 모듈을 사용하지 않는 것을 강력히 권장합니다.

이 모듈의 QML 타입을 가져와 사용하려면 다음 문장을 사용하십시오:

import Qt3D.Render 2.12

렌더링 백엔드 선택

Render 측면에는 두 가지 렌더링 백엔드가 제공됩니다.

  • OpenGL 백엔드 (ES 2, ES 3.2, GL 2, GL 3, GL 3.2, GL 4.3)
  • RHI 백엔드 (ES 2, GL, DirectX, Vulkan, Metal)

OpenGL만을 대상으로 하고 특정 OpenGL 기능을 사용하는 경우, OpenGL 백엔드를 사용하는 것이 더 나을 수 있습니다. 이는 Qt 5 시리즈에서 Qt 3D 가 독점적으로 사용했던 OpenGL 백엔드입니다.

특정 OpenGL 기능을 사용하지 않고, OpenGL이 더 이상 지원되지 않을 수 있는 다양한 플랫폼을 대상으로 하는 경우에는 RHI 백엔드를 사용하는 것이 더 나은 대안입니다.

렌더링 백엔드를 선택하려면 환경 변수 QT3D_RENDERER를 "opengl" 또는 "rhi"로 설정해야 합니다. 기본값은 OpenGL 백엔드입니다.

RHI 백엔드를 사용할 때, QSG_RHI_BACKEND를 다음 값 중 하나로 설정하여 내부 RHI 백엔드를 강제로 사용할 수 있습니다.

  • opengl -> RHI OpenGL 백엔드
  • gl -> RHI OpenGL 백엔드
  • gles2 -> RHI OpenGL 백엔드
  • metal -> RHI Metal 백엔드
  • vulkan -> RHI Vulkan 백엔드
  • d3d11 -> RHI DirectX 11 백엔드

명시되지 않은 경우, RHI는 해당 플랫폼에 가장 적합한 백엔드로 판단되는 것을 기본값으로 사용합니다.

또는 ` QQuickWindow`를 사용하는 경우, ` QQuickWindow::setGraphicsApi()`를 사용하여 RHI 내부 렌더링 백엔드를 지정할 수 있습니다.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.