Skip to content

Choosing a Visual Studio template

Shawn Hargreaves edited this page Jun 16, 2016 · 6 revisions

There are several Visual Studio templates available that use ANGLE:

  1. You can use Visual Studio's Cross Platform OpenGL ES template
  2. You can use one of the templates distributed with our ANGLE source code

Cross Platform Visual Studio 2015 Template

A project template for cross-platform graphics development that uses the ANGLE.WindowsStore NuGet package is available in Visual Studio 2015.

You can install the template from within Visual Studio using the online template gallery or download it from here.

Additional information about how to use the template can be found here.

Visual Studio 2015 Template

Note that the Cross Platform Visual Studio 2015 template only supports CoreWindow, and doesn't support integration with XAML without major modifications.

Additional Templates

Additional templates come with this repository and can be found here. Use these templates if you are compiling ANGLE yourself rather than using the ANGLE.WindowsStore NuGet package or require XAML in your application.

You can install these templates by running install.bat in the /templates/ directory of your copy of ANGLE, or follow these manual steps.

Once you’ve installed the templates, you’ll be able to go "File -> New -> Project" in Visual Studio and easily create apps for OpenGL ES!

The subsections below explain each template, and can help you decide which template is most suitable for your app.

Universal App for OpenGL ES (Windows 10)

After installation, this template can be found in Visual Studio 2015 in the "File -> New -> Project" menu, under:

Visual C++ -> Windows -> Windows Universal -> App for OpenGL ES (Windows Universal)

This template is for Windows apps on Windows 10. It removes the small overhead associated with XAML.

Universal XAML App for OpenGL ES (Windows 10)

After installation, this template can be found in Visual Studio 2015 in the "File -> New -> Project" menu, under:

Visual C++ -> Windows -> Windows Universal -> XAML App for OpenGL ES (Windows Universal)

This template is for Windows apps on Windows 10. It allows you to use other XAML content in your app (e.g. advertising)

Universal XAML App for OpenGL ES (Windows 8.1)

After installation, this template can be found in the new project menu under:

Store Apps -> Universal Apps -> XAML App for OpenGL ES (Universal Apps)

This template is for Windows Store applications on Windows 8.1 and Windows Phone 8.1. It:

  • Allows you to use other XAML content in your app (e.g. advertising)
  • Resizes and rotates the EGL window surface upon device rotation on all platforms

Universal App for OpenGL ES (Windows 8.1) (a.k.a. 'CoreWindow')

After installation, this template can be found in the new project menu under:

Store Apps -> Universal Apps -> App for OpenGL ES (Universal Apps)

This template is for Windows Store applications on Windows 8.1 and Windows Phone 8.1. It:

  • Removes the small overhead associated with XAML (e.g. memory usage)
  • Does not resize or rotate the EGL window surface upon device rotation on Windows Phone. You must rotate your app's content yourself.

Desktop Win32 Application for OpenGL ES

This template is for classic Windows desktop applications on Windows 10 or Windows 8.1 (and potentially below).