Differences

This shows you the differences between two versions of the page.

--- proton:win_setup [2012/01/11 21:25] – seth
+++ proton:win_setup [2018/07/28 08:20] – seth
@@ Line 1: / Line 1: @@
 === 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)
+Clone the Proton github repository.  (Hope you have [[https://git-scm.com/download/win|git]] git or [[https://tortoisegit.org/download/|TortoiseGit]] installed)
+For git:
+<code>
+git clone https://github.com/SethRobinson/proton.git
+</code>
+For Tortoisegit you right click in file explorer, choose clone, and enter **https://github.com/SethRobinson/proton.git** as the repository.
+<html>
+<strong>Flash version:</strong>
+</html>
+<html>
+<div id="flashContent">
+			<object classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000" width="480" height="320" id="RTBareBones" align="middle">
+		  <param name="movie" value="/games/test/RTBareBones.swf" />
+              <!--[if !IE]>-->
+              <object type="application/x-shockwave-flash" data="/games/test/RTBareBones.swf" width="480" height="320">
+              <!--<![endif]-->
+                <param name="wmode" value="direct" />
+                <param name="allowScriptAccess" value="sameDomain" />
+                <param name="bgcolor" value="CCCCCC" />
+                <div>
+                  <h1>You need to update flash:</h1>
+                  <p><a href="http://www.adobe.com/go/getflashplayer"><img src="http://www.adobe.com/images/shared/download_buttons/get_flash_player.gif" alt="Get Adobe Flash player" /></a></p>
+                </div>
+              <!--[if !IE]>-->
+              </object>
+              <!--<![endif]-->
+            </object>
+		</div>
+</html>
 === Running RTBareBones on Windows===
-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.
+The first example you should compile is RTBareBones.  It's the simplest one that uses GL/GLES. (RTConsole is even simpler, it's command line only)
 RTBarebones is still around 40 "shared" framework source files, and one app level source file. (App.cpp/App.h)
@@ Line 10: / Line 42: @@
 === Configuration and compiling ===
-Nagivate to  /RTBareBones/windows/RTBareBones.sln and double click to open the solution in MSVC++.
+Navigate to /RTBareBones/windows_vc2017/RTBareBones.sln and double click to open the solution in Microsoft Visual Studio 2017 or newer. (Don't have Microsoft Visual Studio 2017? [[https://visualstudio.microsoft.com/vs/community|Grab it free]])
 {{:proton:win_setup1.png?|}}
-Choose Debug GL from the configuration drop down.
+Choose Debug GL from the configuration drop down. Nevermind that the screenshot is from VC 2015 and is outdated.
+Note that you can select platform Win32 or x64, Win32 is usually fine unless you are working on some 64 bit specific issue.  x64 might not be setup for every configuration, but it is for Debug GL and Release GL.
 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".. but here is [[:proton_gles_emu|how to set it up]])
+  * **Debug_GLES** (or Debug Common sometimes) - 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".. but here is [[:proton_gles_emu|how to set it up]])
-  * **Release** (or Release Common) - Uses the PowerVR libgles library.  You'll probably never use this.
+  * **Release_GLES** (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.
+  * **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.
+  * **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.
+  * **SDL_Debug_GL** - emulates using SDL2 as the backend. Linux builds use this so it can be useful to target it on Windows for testing.
-Before compiling you should do two things.  First, set the working directory.
+Note: Output directory should be .".\bin\"  This is important because that's where assets like pictures and sounds are also put.
-{{:proton:win_setup2.png?|}}
+=== shared vs source ===
-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.
+If you look at the solution explorer, you see two main folders - **shared** and **source**.
+  * **shared** is where files used across multiple projects are stored.  If you edit these, be aware that every project will be affected!
+  * **source** means files specific to your project.  The only exception is for some reason main.cpp/main.h are in there which are actually shared.  You will also see other folders off  **source** like **html5**, **linux**, **OSX** etc, these are not used in the compile but are there to make for easy search and replace and file editing.
 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.
@@ Line 35: / Line 71: @@
 <code cpp>
-	AddVideoMode("Windows", 768, 1024, PLATFORM_ID_WINDOWS); //used for Dink
+	AddVideoMode("Windows", 1024, 768, PLATFORM_ID_WINDOWS);
+	AddVideoMode("Windows Wide", 800, 1280, PLATFORM_ID_WINDOWS);
+        //OSX
+	AddVideoMode("OSX", 768, 1024, PLATFORM_ID_OSX);
+	AddVideoMode("OSX Wide", 800, 1280, PLATFORM_ID_OSX);
+	//iOS - for testing on Windows, you should probably use the "Landscape" versions unless you want to hurt your
+	//neck.
 	AddVideoMode("iPhone", 320, 480, PLATFORM_ID_IOS);
+	AddVideoMode("iPhone Landscape", 480, 320, PLATFORM_ID_IOS, ORIENTATION_PORTRAIT); //force orientation for emulation so it's not sideways
 	AddVideoMode("iPad", 768, 1024, PLATFORM_ID_IOS);
-	AddVideoMode("iPhone4", 640, 960, PLATFORM_ID_IOS);
+	AddVideoMode("iPad Landscape", 1024, 768, PLATFORM_ID_IOS, ORIENTATION_PORTRAIT); //force orientation for emulation so it's not sideways);
+	AddVideoMode("iPhone4", 640, 960, PLATFORM_ID_IOS, ORIENTATION_PORTRAIT); //force orientation for emulation so it's not sideways););
-	AddVideoMode("Palm Pre Plus", 320, 480, PLATFORM_ID_WEBOS);
+	AddVideoMode("iPhone4 Landscape", 960,640, PLATFORM_ID_IOS);
-	AddVideoMode("Pixi", 320, 400, PLATFORM_ID_WEBOS);
+	AddVideoMode("iPad HD", 768*2, 1024*2, PLATFORM_ID_IOS);
+	//Palm er, I mean HP. These should use the Debug WebOS build config in MSVC for the best results, it will
+	//use their funky SDL version
+	AddVideoMode("Pre", 320, 480, PLATFORM_ID_WEBOS);
+	AddVideoMode("Pre Landscape", 480, 320, PLATFORM_ID_WEBOS);
+	AddVideoMode("Pixi", 320, 400, PLATFORM_ID_WEBOS);
+	AddVideoMode("Pre 3", 480, 800, PLATFORM_ID_WEBOS);
+	AddVideoMode("Pre 3 Landscape", 800,480, PLATFORM_ID_WEBOS);
+	AddVideoMode("Touchpad", 768, 1024, PLATFORM_ID_WEBOS);
+	//Android
 	AddVideoMode("G1", 320, 480, PLATFORM_ID_ANDROID);
+	AddVideoMode("G1 Landscape", 480, 320, 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);
-	AddVideoMode("Nexus One Landscape", 800, 480, PLATFORM_ID_ANDROID); //g_landScapeNoNeckHurtMode should be false when testing
+	AddVideoMode("Droid Landscape", 854, 480, PLATFORM_ID_ANDROID);
+	AddVideoMode("Xoom Landscape", 1280,800, PLATFORM_ID_ANDROID);
+	AddVideoMode("Xoom", 800,1280, PLATFORM_ID_ANDROID);
+	AddVideoMode("Galaxy Tab 7.7 Landscape", 1024,600, PLATFORM_ID_ANDROID);
+	AddVideoMode("Galaxy Tab 10.1 Landscape", 1280,800, PLATFORM_ID_ANDROID);
+	//RIM Playbook OS/BBX/BB10/Whatever they name it to next week
+	AddVideoMode("Playbook", 600,1024, PLATFORM_ID_BBX);
+	AddVideoMode("Playbook Landscape", 1024,600, PLATFORM_ID_BBX);
-	string desiredVideoMode = "iPhone"; //name needs to match one of the ones defined below
+	string desiredVideoMode = "iPhone"; //name needs to match one of the ones defined above
-        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.
+Make sure you have desiredVideoMode set to "iPhone".
 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:
@@ Line 61: / Line 123: @@
 {{: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.
+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. <-- Wow, those screen sizes show how old this tutorial is.
 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)
@@ Line 67: / Line 129: @@
 For Windows there are some hotkey equivalents for rotation, try hitting these:
-  * P - Portrait (same as how it starts up)
+  * Ctrl-P - Portrait (same as how it starts up)
-  * U - Upside down portrait
+  * Ctrl-U - Upside down portrait
-  * R - Right landscape
+  * Ctrl-R - Right landscape
-  * L - Left landscape
+  * Ctrl-L - Left landscape
   * Escape - Quit
-NOTE: The "fake rotate the screen" testing keys above only work on Windows, and only if g_landScapeNoNeckHurtMode is set to false in main.cpp.
+NOTE: The "fake rotate the screen" testing keys above only work on Windows, and only on some setups, such as iPhone and iPad.
 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.
+It also has code to read some keys, the touchscreen, and detect shaking.  Check the debug log to see the messages.