Revision control

Copy as Markdown

// Copyright (C) 2014 Klaralvdalens Datakonsult AB (KDAB).
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only
/*!
\module Qt3DRender
\title Qt 3D Render C++ Classes
\brief The Qt 3D Render module contains functionality to support 2D and 3D
rendering using Qt 3D.
\since 5.7
\modulestate Deprecated
\deprecated [6.8]
\ingroup modules
\ingroup qt3d-modules
\qtcmakepackage 3drender
\qtvariable 3drender
The Qt 3D Render module provides an aspect, components, and other supporting types necessary
to implement 2D and 3D rendering as part of the Qt 3D framework.
To use classes from this module, add this directive into the C++ files:
\code
#include <Qt3DRender>
\endcode
To link against the corresponding C++ library, add the following to your qmake project file:
\badcode
QT += 3drender
\endcode
Classes, types, and functions are declared under the \l [Qt3DRender]{Qt3DRender} namespace.
\section1 Overview
The Qt 3D Render aspect offers support for data-driven configuration as described
in \l {Qt 3D Render Framegraph}.
\section1 Selecting a Rendering Backend
The Render aspect comes with two rendering backends.
\list
\li OpenGL backend (ES 2, ES 3.2, GL 2, GL 3, GL 3.2, GL 4.3)
\li RHI backend (ES 2, GL, DirectX, Vulkan, Metal)
\endlist
If you are targeting OpenGL exclusively and are using specific OpenGL
features, you might be better off using the OpenGL backend. This is the
OpenGL backend that Qt 3D exclusively used in the Qt 5 series.
For cases where you are not using specific OpenGL features and want to
target different platforms that might have deprecated OpenGL, using the RHI
backend is a better alternative.
To select your rendering backend, the environment variable QT3D_RENDERER is
to be set to either "opengl" or "rhi". Defaults to the OpenGL backend.
When using the RHI backend, you can further force the internal RHI backend
by setting the QSG_RHI_BACKEND to one of the following values:
\list
\li opengl -> RHI OpenGL backend
\li gl -> RHI OpenGL backend
\li gles2 -> RHI OpenGL backend
\li metal -> RHI Metal backend
\li vulkan -> RHI Vulkan backend
\li d3d11 -> RHI DirectX 11 backend
\endlist
If not specified, RHI will default to what it deduces to be the best backend
for the platform.
\section1 Reference
\list
\li \l {Qt 3D Render C++ Classes}
\li \l {Qt 3D Examples}
\endlist
*/
/*!
\namespace Qt3DRender
\inmodule Qt3DRender
\ingroup qt3d-namespaces
\brief Contains classes that enable 2D and 3D rendering.
*/
/*!
\qmlmodule Qt3D.Render 2.\QtMinorVersion
\title Qt 3D Render QML Types
\since 5.7
\modulestate Deprecated
\deprecated [6.8]
\ingroup qmlmodules
\ingroup qt3d-qmlmodules
\brief Provides Qt 3D QML types for rendering.
To import and use the module's QML types, use the following statement:
\qml \QtMinorVersion
import Qt3D.Render 2.\1
\endqml
\section1 Selecting a Rendering Backend
The Render aspect comes with two rendering backends.
\list
\li OpenGL backend (ES 2, ES 3.2, GL 2, GL 3, GL 3.2, GL 4.3)
\li RHI backend (ES 2, GL, DirectX, Vulkan, Metal)
\endlist
If you are targeting OpenGL exclusively and are using specific OpenGL
features, you might be better off using the OpenGL backend. This is the
OpenGL backend that Qt 3D exclusively used in the Qt 5 series.
For cases where you are not using specific OpenGL features and want to
target different platforms that might have deprecated OpenGL, using the RHI
backend is a better alternative.
To select your rendering backend, the environment variable QT3D_RENDERER is
to be set to either "opengl" or "rhi". Defaults to the OpenGL backend.
When using the RHI backend, you can further force the internal RHI backend
by setting the QSG_RHI_BACKEND to one of the following values:
\list
\li opengl -> RHI OpenGL backend
\li gl -> RHI OpenGL backend
\li gles2 -> RHI OpenGL backend
\li metal -> RHI Metal backend
\li vulkan -> RHI Vulkan backend
\li d3d11 -> RHI DirectX 11 backend
\endlist
If not specified, RHI will default to what it deduces to be the best backend
for the platform.
Alternatively, if using a QQuickWindow, QQuickWindow::setGraphicsApi()
can be used to specify the RHI internal rendering backend.
*/