Merge pull request #596 from Esri/james/AR_Updates

James/ar updates

Author: JamesMBallard

augmentedreality/Examples/CppArExample/main.cpp

@@ -27,6 +27,7 @@
 #include <QQmlApplicationEngine>
 #include <QSettings>
 #include <QSurfaceFormat>
+#include <QQuickWindow>
 
 #include <ArcGISRuntimeEnvironment.h>
 #include <SceneQuickView.h>
@@ -49,13 +50,13 @@ using namespace Esri::ArcGISRuntime;
 
 int main(int argc, char *argv[])
 {
-  // Enforce OpenGL
-  qputenv("QSG_RHI_BACKEND", "opengl");
+  // At this time AR with the ArcGIS Maps SDK for Qt only supports OpenGL
+  QQuickWindow::setGraphicsApi(QSGRendererInterface::GraphicsApi::OpenGL);
 
   // There are some conflicts between the AR frameworks and the Qt's rendering thread.
   // This code enables the non-threaded render loop mode in Qt.
   // See SceneView::renderFrame documentation and Qt's documentation
-  // https://doc.qt.io/qt-5/qtquick-visualcanvas-scenegraph.html#non-threaded-render-loops-basic-and-windows
+  // https://doc.qt.io/qt-6/qtquick-visualcanvas-scenegraph.html#non-threaded-render-loops-basic-and-windows
   // for more information.
 #if defined(Q_OS_IOS) || defined(Q_OS_ANDROID)
   qputenv("QSG_RENDER_LOOP", "basic");

augmentedreality/Examples/QmlArExample/main.cpp

@@ -22,6 +22,7 @@
 #include <QCommandLineParser>
 #include <QDir>
 #include <QSurfaceFormat>
+#include <QQuickWindow>
 
 #ifdef Q_OS_WIN
 #include <Windows.h>
@@ -54,13 +55,13 @@
 
 int main(int argc, char *argv[])
 {
-  // Enforce OpenGL
-  qputenv("QSG_RHI_BACKEND", "opengl");
+  // At this time AR with the ArcGIS Maps SDK for Qt only supports OpenGL
+  QQuickWindow::setGraphicsApi(QSGRendererInterface::GraphicsApi::OpenGL);
 
   // There are some conflicts between the AR frameworks and the Qt's rendering thread.
   // This code enables the non-threaded render loop mode in Qt.
   // See SceneView::renderFrame documentation and Qt's documentation
-  // https://doc.qt.io/qt-5/qtquick-visualcanvas-scenegraph.html#non-threaded-render-loops-basic-and-windows
+  // https://doc.qt.io/qt-6/qtquick-visualcanvas-scenegraph.html#non-threaded-render-loops-basic-and-windows
   // for more information.
 #if defined(Q_OS_IOS) || defined(Q_OS_ANDROID)
   qputenv("QSG_RENDER_LOOP", "basic");

augmentedreality/README.md

@@ -62,6 +62,10 @@ Android 7.0 64-bit (armv8) is the minimum requirement. 32-bit (armv7) is not sup
 
 The latest ArcGIS Maps SDK for Qt is required to use this toolkit component.
 
+The system requirements for the ArcGIS Maps SDK for Qt take precedence over the minimum versions mentioned here.
+
+OpenGL graphics API is required. Metal is not supported. See the [limitations](#Limitations) section below for more details.
+
 ## Creating a new AR app using ArcGIS Maps AR toolkit
 
 ### Creating a new C++ app
@@ -411,3 +415,12 @@ The following lines of code enable the non-threaded render loop mode in Qt:
   qputenv("QSG_RENDER_LOOP", "basic");
 #endif
 ```
+
+## Limitations 
+
+AR currently only supports OpenGL. On iOS devices, you must enforce this because the default graphics API on 
+iOS devices is Metal. Add the following code to your apps:
+
+```cpp
+QQuickWindow::setGraphicsApi(QSGRendererInterface::GraphicsApi::OpenGL);
+```

uitools/examples/cpp_quick/src/main.cpp

@@ -35,8 +35,6 @@
 //------------------------------------------------------------------------------
 int main(int argc, char* argv[])
 {
-  // Enforce OpenGL
-  qputenv("QSG_RHI_BACKEND", "opengl");
 
   QtWebView::initialize();
   QGuiApplication app(argc, argv);

uitools/examples/qml_quick/src/main.cpp

@@ -27,8 +27,6 @@
 
 int main(int argc, char* argv[])
 {
-    // Enforce OpenGL
-    qputenv("QSG_RHI_BACKEND", "opengl");
 
     QtWebView::initialize();
     QGuiApplication app(argc, argv);