Microsoft-Build-2016/CodeLabs-GameDev-3-ANGLE

Name: CodeLabs-GameDev-3-ANGLE

Owner: Microsoft-Build-2016

Description: Porting your OpenGL ES 2.0 Game to Windows 10 using ANGLE

Created: 2016-03-11 23:00:27.0

Updated: 2016-07-26 02:56:47.0

Pushed: 2016-03-31 11:50:25.0

Homepage: null

Size: 17540

Language: C++

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

?

Porting your OpenGL ES 2.0 Game to Windows 10 using ANGLE

---

Overview

With the introduction of the single, unified Windows 10 core and the Universal Windows Platform (UWP), one app can run across all Windows 10 devices. However, Windows 10 UWP does not support OpenGL or OpenGL ES. This module will show you how to port your existing OpenGL ES 2.0 game to Windows 10 UWP using ANGLE. ANGLE allows Windows developers to seamlessly port their OpenGL ES apps to Windows 10 UWP by efficiently translating the OpenGL ES API into DirectX 11 API calls. During this hands on lab, you will be guided step by step in porting a simple OpenGL ES 2.0 game to a Windows 10 UWP app using ANGLE.

Objectives

In this module, you will learn how to:

• Create a new ANGLE project using a Visual Studio Template
• Integrate your game code with ANGLE
• Handle window resizing
• Add touch and keyboard events to your app
• Add game resources to your app
• Run your game on Windows Phone
• Add ANGLE to your project using NuGet. Please note that this is the recommended method for adding ANGLE to a project.

Prerequisites

The following is required to complete this module:

• Visual Studio Community 2015 or greater.
• ANGLE built and installed on your computer.

Note: You can take advantage of the Visual Studio Dev Essentials subscription in order to get everything you need to build and deploy your app on any platform.

Setup

For the ANGLE Lab @ Build, Angle has all ready been setup for you. You may skip the Setup procedure.

In order to run the exercises in this module, you will need to set up your environment first.

1. ANGLE needs to be built and installed on your computer. For this lab, ANGLE has already been built and installed in c:\angle. If ANGLE is not installed on your computer, you will need to do the following:

   Compiling ANGLE from source

   1. Clone or download ANGLE from our GitHub repository.

   2. Install our easy-to-use Visual Studio templates by running install.bat in the /templates/ directory of your copy of ANGLE.

   3. Open the appropriate ANGLE Visual Studio solution for your project, and build all flavors of it. The Windows 10 Visual Studio solution for ANGLE is located in angle/winrt/10/src/angle.sln.

   4. For more information, see ANGLE.

Note: Make sure you have checked all the dependencies for this module before running the setup.

Note: Each exercise is accompanied by a starting solution located in the Begin folder of the exercise that allows you to follow each exercise independently of the others. Please be aware that the code snippets that are added during an exercise are missing from these starting solutions and may not work until you have completed the exercise. Inside the source code for an exercise, you will also find an End folder containing a Visual Studio solution with the code that results from completing the steps in the corresponding exercise. You can use these solutions as guidance if you need additional help as you work through this module.

---

Estimated time to complete this module: 60 minutes

Note: When you first start Visual Studio, you must select one of the predefined settings collections. Each predefined collection is designed to match a particular development style and determines window layouts, editor behavior, IntelliSense code snippets, and dialog box options. The procedures in this module describe the actions necessary to accomplish a given task in Visual Studio when using the General Development Settings collection. If you choose a different settings collection for your development environment, there may be differences in the steps that you should take into account.

Exercises

This module includes the following exercises:

1. Creating a new ANGLE project using a Visual Studio Template
2. Integrating your game code with ANGLE
3. Resizing the Window
4. Handling keyboard and pointer events
5. Adding Resources to the Game (optional)
6. Windows Phone (optional)
7. Adding ANGLE using NuGet (optional)

---

Summary

By completing this module you should have learned:

1. how to create a new ANGLE project using a Visual Studio template.
2. how to integrate your game code with an ANGLE app.
3. how to handle window resizing.
4. how to handle keyboard and pointer events.
5. how to add resources to your game.
6. how to run your game on Windows Phone.
7. how to add ANGLE to your project using NuGet. Please note that this is the recommended method for adding ANGLE to a project.

For more information on ANGLE, please refer to the ANGLE wiki and the ANGLE GitHub repo.

Note: You can take advantage of the Visual Studio Dev Essentials subscription in order to get everything you need to build and deploy your app on any platform.