README.md

title	description	author	ms.author	ms.date	ms.topic
Azure Remote Rendering Toolkit	Azure Remote Rendering Toolkit welcome page	jakras	jakras	06/07/2022	article

Azure Remote Rendering Toolkit (ARRT)

Azure Remote Rendering Toolkit (ARRT) is a desktop application developed in C++/Qt that demonstrates how to use Azure Remote Rendering (ARR). It can be used to:

• Upload files to Azure Storage
• Convert models for Azure Remote Rendering
• Create remote rendering sessions
• Preview remotely rendered 3D models
• Modify its materials
• See basic performance statistics

ARRT is meant as a sample application for how to integrate Azure Remote Rendering into C++ applications. However, regardless of how you intend to use remote rendering, ARRT can always be used to get basic file upload, conversion and preview tasks done.

General prerequisites

To use ARRT, you need a working remote rendering account. Create an ARR account if you don't have one yet.

You should be familiar with the following ARR concepts:

• Sessions
• Models
• Model conversion

Prebuilt binaries

Prebuilt ARRT binaries can be found here.

Important:

If running ARRT fails due to a missing DLL (VCRUNTIME140_* dll), please install the latest Visual C++ redistributable from the Visual Studio download page or using this direct link

Building ARRT

Prerequisites

• Visual studio 2019 or 2022.
• Qt 6.2.0 or newer. Use the default installation options.
  • Set the Qt6_DIR environment variable (e.g. to C:\Qt6\6.2.2\msvc2019_64).
• CMake.
  • Make sure cmake.exe is in the PATH environment variable.
• Command-line NuGet.
  • Make sure nuget.exe is in the PATH environment variable.
• HEVC driver. See the ARR system requirements for details.

Building

1. Clone this repository
2. Open a command line terminal
3. From the repository's root directory, run the script GenerateSolution.bat
   • The script will run CMake and generate a Visual Studio solution in the Workspace sub-folder
   • To create the solution in a custom directory or with Visual Studio 2022, run: GenerateSolution.bat path/to/dir vs2022
4. Open and compile the generated solution

Documentation

• ARRT User Documentation

Contributing

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.

When you submit a pull request, a CLA bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.