Skip to content

Latest commit

 

History

History
108 lines (58 loc) · 4.67 KB

README.md

File metadata and controls

108 lines (58 loc) · 4.67 KB
Raw
# Adding Resources to the Game #
### Exercise 5: Adding Resources to the Game ###

In this exercise, you will learn how to add and modify game resources. A game may have hundreds of resource files organized into a specific directory structure. These files may include textures, shaders, text files, etc. In a cross platform game, these resource files will be located outside of your Visual Studio project directory.

It can be difficult to manually add all of these files to the Visual Studio project. A Windows 10 UWP app cannot simply have these resource files copied to the project's output directory. They need to be packaged as part of the Windows 10 UWP app and therefore they need to be handled by the build process.

Instead of manually adding potentially hundreds of files to our game's project file, we are going to use a property sheet to instruct the build process to correctly add the resources to the app package during the build.

In this exercise, you will complete the following tasks:

  1. Learn how the resource files are added to the game.
  2. Modify a game resource.

Task 1 - Adding Resources to the Game

  1. Open Breakout.sln in the CodeLabs/Workshops/Games/Module3-ANGLE/Source/Ex5/Begin folder.

  2. Select Debug x64 from the Project Configuration and Platform dropdowns.

    Configuring the build target

    Configuring the build target

  3. Press F5 to build and run the project. The app should look like the following.

    No Resources

    No resources

    The resource has been removed from the project and you should see a black window.

  4. We will now add all of the resource files to our game. The resource files are located in CodeLabs-GameDev-3-ANGLE\Source\Resources.

    Resources Folder

    Resources folder

  5. Instead of adding each resource file manually to our project, we are going to use a property sheet to tell the project where to find the resource files. To add a property sheet, select Property Manager from the View menu. Note: You may need to select the Property Manager from View -> Other Windows -> PropertyManger.. depending on how your copy of Visual Studio is configured.

    Property Manager

    Property Manager

  6. Right click the Breakout project and select Add Existing Property Sheet....

    Add Existing Property Sheet

    Add existing property sheet

  7. Then select the file resources.props file in the folder CodeLabs-GameDev-3-ANGLE\Source\Ex5\Begin\Breakout.

    Add resources.props

    resources.props

  8. Close the Property Manager window.

    Close Property Manager

    Close Property Manager

  9. Press F5 to build and run the project. The app should look like the following.

    Breakout App with Resources

    Breakout App with Resources

Task 2 - Modifying Resources###

  1. Now we are going to add a resource to our game. Copy the awesomeface.png file located at *CodeLabs-GameDev-3-ANGLE\Source\Ex5\Resources\textures* to the *CodeLabs-GameDev-3-ANGLE\Source\Resources\textures* folder.

  2. Open the file Source/Game.cpp and change line 53.

    from:

    ResourceManager::LoadTexture("textures/ball.png", GL_TRUE, "face");

    to:

    ResourceManager::LoadTexture("textures/awesomeface.png", GL_TRUE, "face");

  3. Save your work. Press F5 to build and run your app. Your app should now look like this:

    Exercise 5 Complete

    Exercise 5 Complete

Discussion

You have now learned how to add and modify the resources for your game. By placing the resources for your game outside of the Visual Studio project folder it will be easier to make your game cross platform. By using a property sheet to automatically add the game resources, you won't have to manually add potentially hundreds of resource files to your game project.

Next