RTsoft Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
=== Get Proton SDK ===
Use a [[http://tortoisesvn.net/downloads|svn client]] to checkout [[svn://rtsoft.com/rtsvn/proton|svn://rtsoft.com/rtsvn/proton]] to a directory.  (ie, "c:\proton" - the checkout path filename should have no spaces)

=== RTBareBones ===
The first example you should compile is RTBareBones.  It's the simplest one, it's the app I use when porting to new operating systems or testing engine features.

RTBarebones is still around 40 source files, it includes font loading, 2d blitting, and a super simple main game loop.

=== Configuration and compiling ===
Nagivate to  /RTBareBones/windows/RTBareBones.sln and double click to open the solution in MSVC++.

{{:proton:win_setup1.png?|}}

Choose Debug GL from the configuration drop down.

Here is an explanation of what each configuration is (they all make Windows exe's btw, but different configs can help you emulate platforms better):

  * Debug (or Debug Common) - Uses the PowerVR libgles library.  Useful for debugging GLES specific issues, or testing loading of the .pvr texture format.  (It's a compressed format specific to PowerVR, iOS can load them)  Much slower than Debug GL.  (Note: I don't think I can include .lib files from the PowerVR SDK, so this option probably won't work "out of the box")
  * Release (or Release Common) - Uses the PowerVR libgles library.  You'll probably never use this.
  * Debug GL - Most of your testing is going to be with this.  Standard GL.
  * Release GL - For a final Windows build this is what you should use.
  * Debug WebOS - This config links with the WebOS "SDL like" libraries, useful for debugging WebOS specific issues. I don't have a "release WebOS", not needed as the phone builds are done differently.  If you have a gamepad plugged in, you can use it to fake an accelerometer.

Before compiling you should do two things.  First, set the working directory.

{{:proton:win_setup2.png?|}}

Select the WinRTBareBones project, right click and choose properties.  Set working directory to "..\bin".  I think this is user specific so won't be setup correct by default.  Before setting this, you can select "All configurations" so it changes it across each one at the same time.

Next, open main.cpp and double check what the screensize/mode is going to be.  Main.cpp is actually shared between ALL the samples (and your own projects usually) so be careful with changes here.

Scroll down until you see something like this:

<code cpp>
	AddVideoMode("Windows", 768, 1024, PLATFORM_ID_WINDOWS); //used for Dink

	AddVideoMode("iPhone", 320, 480, PLATFORM_ID_IOS);
	AddVideoMode("iPad", 768, 1024, PLATFORM_ID_IOS);
	AddVideoMode("iPhone4", 640, 960, PLATFORM_ID_IOS);

	AddVideoMode("Palm Pre Plus", 320, 480, PLATFORM_ID_WEBOS);
	AddVideoMode("Pixi", 320, 400, PLATFORM_ID_WEBOS);
	
	AddVideoMode("G1", 320, 480, PLATFORM_ID_ANDROID);
	AddVideoMode("Nexus One", 480, 800, PLATFORM_ID_ANDROID);
	AddVideoMode("Droid", 480, 854, PLATFORM_ID_ANDROID);
	AddVideoMode("Nexus One Landscape", 800, 480, PLATFORM_ID_ANDROID); //g_landScapeNoNeckHurtMode should be false when testing

	string desiredVideoMode = "iPhone"; //name needs to match one of the ones defined below
        g_landScapeNoNeckHurtMode = false; //if true, will rotate the screen so we can play in landscape mode in windows without hurting ourselves
</code>

This is how you can test "virtually" test many devices with your Windows builds.  After things look good, then you can do tests on the device. Using this method saves a ton of time because MSVC debugging is fantastic, and the change/compile/test process happens in seconds rather than minutes.

Make sure you have desiredVideoMode set to "iPhone" and g_landScapeNoNeckHurtMode set to false.

Compile and run.  You should see the fps near the top, some rects, a rotating triangle and some colored text scaling up and down near the bottom:

{{:proton:win_setup3.png}}

Because we chose iPhone, the screensize is 320X480.  If you change to "iPad" and recompile, it will be 640X960.  You can add more resolution by adding another "AddVideoMode" call.

If you ran this app on a real iPhone, tilting the device would cause it to rotate to each orientation automatically. (You can disable that later or limit to only landscape modes)

For Windows there are some hotkey equivalents for rotation, try hitting these:

  * P - Portrait (same as how it starts up)
  * U - Upside down portrait 
  * R - Right landscape
  * L - Left landscape
  * Escape - Quit

RTBareBones is pretty simple, the app specific code is just two files, App.cpp and App.h.  (note, the physical source is located in /RTBareBones/source)

The two functions to look at are App::Update() and App::Draw().  Replacing the guts of those two areas is a good place to start experimenting.