Differences

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

--- en:tutorials:community:grey:tutorial1 [2018/02/13 20:46 (7 years ago)] – ↷ Links adapted because of a move operation iarwain
+++ en:tutorials:community:grey:tutorial1 [2020/08/31 06:16 (5 years ago)] (current) – Outdated content. Covered elsewhere sausage
@@ Line 1: / Line 1: @@
-====== Setting up Visual Studio (win) or Codelite (linux) ======
-**//Setting up your Development Environment//**\\
-[//This is ripped from the README and edited slightly for (hopefully) clarity//]
-<WRAP center round tip 60%>
-Please note this document needs to be reviewed.
-</WRAP>
-Orx's core is basically platform-independent. All the platform/OS-dependent features are implemented via plugins. These plugins can be loaded at runtime (hotplug) or they can be embedded at link-time.
-If you use the non-embedded versions, you'll have to specify which plugins to use. This is more flexible but also requires additional files (the plugins themselves). The embedded version will store everything in Orx's library, meaning you won't be able to choose which plugin to use at runtime, but in exchange, Orx will be more compact and will also run considerably faster.
-From the [[https://github.com/orx/orx/releases|download]] page you'll find pre-compiled dynamic embedded binaries for Windows (32bit), Linux (x86) and MacOS X (ppc/x86). If you want to use the non-embedded versions (to use your own plugins) or the static ones, you will need to compile Orx yourself from the source.
-Everything compiles out-of-the-box for the hardware platforms cited above.
-The embedded versions currently use:
-  * GLFW-based plugins for display, joystick, keyboard and mouse.
-  * OpenAL-based plugin for sound.\\
-  * Box2D-based plugin for physics.\\
-  * homemade plugin for 2D rendering.\\
-====== Requirements ======
- You will require one of the orx-dev-* files, depending on your IDE/OS from the [[https://github.com/orx/orx/releases|download]] page. This will give you a copy of the pre-compiled Orx binary, as a dynamic library, with everything you need to get started, compiled in.
-Extract the compress file.
-//**Quick and Dirty SVN + VS2010 Users Start Here!**//
-You will be presented with a number of folders: //bin//, //include// and //lib//.
- For now I'm going to create the project in a specific location, feel free to substitute your own in as you see fit.
-My project on Windows will be in "C:\MyProject\" and "~/MyProject/" or "/home/grey/MyProject/" on Linux. Move the three folders previously mentioned, into this directory.
-**Attention Linux Users!** Please be aware the files inside the archive are built with an older version of gcc and g++, so they will be incompatible with current releases. (And you are certain to get an error when attempting to link against them in this case.) I am not sure if Iarwain was planning on updating the 1.2 release, if not, you may be required to build all the required files from the svn yourself. I plan to write up a tutorial for this later.
-====== Making our IDE Project ======
- __Just 'click' these blue things for the IDE you're using!__ ^_^
-<hidden Visual Studio 2005, 2008 and 2010. (Windows)>
-{{http://grey.orx-project.org/tutorial_data/tutorial_1/1_NewProject.png}}
-Note, whatever you call your project, will have a folder created by that name (yes, even with the tick turned off!) So in my case, I now have "C:\MyProject\project\project.sln".
-</hidden>
- \\
-<hidden CodeLite. (Linux)>
-{{http://grey.orx-project.org/tutorial_data/tutorial_1/codelite/1.png}}
-{{http://grey.orx-project.org/tutorial_data/tutorial_1/codelite/2.png}}\\
-Apparently this pop-up will not allow us to use the tilde (~) symbol to represent our home address, so "~/MyProject/" in my case becomes "/home/grey/MyProject/"\\
-{{http://grey.orx-project.org/tutorial_data/tutorial_1/codelite/3.png}}
-{{http://grey.orx-project.org/tutorial_data/tutorial_1/codelite/4.png}}\\
-Again, we can't use the tilde symbol... guessing that's a feature which won't be changing.
-</hidden>
- \\
-From this point on, all of our directory structures will use these places as the "base" level. ( "C:\MyProject\" and "~/MyProject/" )
-====== Adding New Files ======
-Next, add a new file to the project:
-<hidden Visual Studio 2005, 2008 and 2010. (Windows)>
-{{http://grey.orx-project.org/tutorial_data/tutorial_1/2_NewFile.png}}
-{{http://grey.orx-project.org/tutorial_data/tutorial_1/3_NewFile.png}}
-</hidden>
- \\
-<hidden CodeLite. (Linux)>
-**Attention:** Codelite automatically adds a main.cpp file to it's project, so you CAN skip this step if you want!\\
-Those who have not skipped, we're going to -delete- the default main.cpp file and create our own, in the correct place (~/MyProject/Source/)
-{{http://grey.orx-project.org/tutorial_data/tutorial_1/codelite/codelite_newfile_1.png}}
-{{http://grey.orx-project.org/tutorial_data/tutorial_1/codelite/codelite_newfile_2.png}}\\
-{{http://grey.orx-project.org/tutorial_data/tutorial_1/codelite/codelite_newfile_3.png}}
-{{http://grey.orx-project.org/tutorial_data/tutorial_1/codelite/codelite_newfile_4.png}}\\
-{{http://grey.orx-project.org/tutorial_data/tutorial_1/codelite/codelite_newfile_5.png}}
-{{http://grey.orx-project.org/tutorial_data/tutorial_1/codelite/codelite_newfile_6.png}}
-</hidden>
-====== Setting Project Properties ======
-Then, it's time to change the project properties:
-<hidden Visual Studio 2005, 2008 and 2010. (Windows)>
-{{http://grey.orx-project.org/tutorial_data/tutorial_1/4_Properties.png}}
-</hidden>
- \\
-<hidden CodeLite (Linux)>
- -- fixme moment!
-</hidden>
-====== General Options ======
-We set up the general options:
-<hidden Visual Studio 2005, 2008. (Windows)>
-{{http://grey.orx-project.org/tutorial_data/tutorial_1/5_Properties.png}}\\
-Remember, our 'base' level is here: "C:\MyProject\project\project.sln", so this will point to "C:\MyProject\bin\"
-</hidden>
- \\
-<hidden Visual Studio 2010. (Windows)>
-{{http://grey.orx-project.org/tutorial_data/tutorial_1/vs2010_5a_Properties.png}}\\
-{{http://grey.orx-project.org/tutorial_data/tutorial_1/vs2010_5b_Properties.png}}\\
-{{http://grey.orx-project.org/tutorial_data/tutorial_1/vs2010_5_Properties.png}}\\
-Remember, our 'base' level is here: "C:\MyProject\project\project.sln", so this will point to "C:\MyProject\bin\"
-</hidden>
- \\
-<hidden CodeLite (Linux)>
-{{http://grey.orx-project.org/tutorial_data/tutorial_1/codelite/5.png}}\\
-Our project file is stored at "~/MyProject/project/" so in order to put things in the right place, we want "../bin/" which becomes "~/MyProject/bin/"\\
-{{http://grey.orx-project.org/tutorial_data/tutorial_1/codelite/6.png}}\\
-Same goes for release versions...
-</hidden>
-====== Compiler Options ======
-Next compiler options:
-<hidden Visual Studio 2008 and 2010. (Windows)>
-{{http://grey.orx-project.org/tutorial_data/tutorial_1/6_Properties.png}}
-{{http://grey.orx-project.org/tutorial_data/tutorial_1/7_Preprocessor.png}}
-The preprocessor only needs this addition for debug builds, no release. :) (That's 2 underscores on the start and end by the way.)
-</hidden>
- \\
-<hidden Visual Studio 2005 extra steps. (Windows)>
-Next activate debugging on the debug build:\\
-{{http://grey.orx-project.org/tutorial_data/tutorial_1/vs2005-debug-activate-debugging.png}}\\
-And deactivate debugging on the release build:\\
-{{http://grey.orx-project.org/tutorial_data/tutorial_1/vs2005-release-no-debugging.png}}\\
-Deactivate optimization on the debug build:\\
-{{http://grey.orx-project.org/tutorial_data/tutorial_1/vs2005-debug-no-optimisation.png}}
-</hidden>
- \\
-<hidden CodeLite (Linux)>
-{{http://grey.orx-project.org/tutorial_data/tutorial_1/codelite/7.png}}\\
-The default project will place a 'main.cpp' file inside the ~/MyProject/project/ folder. We can move this, but to keep things straight forward, we do not remove the current directory include (".;") and instead simply add another for our include folder ("../include;")\\
-{{http://grey.orx-project.org/tutorial_data/tutorial_1/codelite/8.png}}\\
-Release doesn't require the %%__orxDEBUG__%% preprocessor directive. (That's 2 underscores on the start and end by the way.)
-</hidden>
-====== Linker Options ======
-The linker needs to be configured too:
-<hidden Visual Studio 2005, 2008 and 2010. (Windows)>
-{{http://grey.orx-project.org/tutorial_data/tutorial_1/8_Linker.png}}
-{{http://grey.orx-project.org/tutorial_data/tutorial_1/9_Linker.png}}\\
-{{http://grey.orx-project.org/tutorial_data/tutorial_1/11_Linker_Input.png}}
-{{http://grey.orx-project.org/tutorial_data/tutorial_1/10_Linker_Input.png}}
-</hidden>
- \\
-<hidden CodeLite (Linux)>
-{{http://grey.orx-project.org/tutorial_data/tutorial_1/codelite/9.png}}
-{{http://grey.orx-project.org/tutorial_data/tutorial_1/codelite/10.png}}\\
-Please be careful to ensure the release version is liborx, not liborxd like the debugging version.
-</hidden>
-====== See Also ======
-This article is part of a series!\\
-Series: [[en:tutorials:community:grey|Grey's tutorials]]\\
-Prev: [[en:tutorials:community:grey:tutorial0|"Tutorial 0: Build Orx From Source!"]]\\
-Next: [[en:tutorials:community:grey:tutorial2|"Tutorial 2: Stand Alone Application."]]\\

Orx Learning

User Tools

Site Tools

Differences

Page Tools