User Tools

Site Tools


en:tutorials:creating_your_own_project

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
en:tutorials:creating_your_own_project [2019/01/02 10:26 (17 months ago)]
sausage Added Interactive mode
en:tutorials:creating_your_own_project [2020/03/28 18:36 (2 months ago)] (current)
sausage Links
Line 3: Line 3:
 Orx supports the creation of your own game projects by providing a very useful script called: Orx supports the creation of your own game projects by providing a very useful script called:
 ''​init''​ ''​init''​
 +
 +Depending on your operating system, ''​init''​ will create a project for Visual Studio, Codelite, Code::​Blocks,​ XCode, and gmake.
  
 This is available in the root of your Orx folder. ((This is only available with the git version of Orx. See: [[en:​tutorials:​cloning_orx_from_github|Cloning Orx from Github]])) This is available in the root of your Orx folder. ((This is only available with the git version of Orx. See: [[en:​tutorials:​cloning_orx_from_github|Cloning Orx from Github]]))
Line 12: Line 14:
  
  
 +===== Interactive Mode =====
  
-===== Commandline Mode ===== +cd your way into the orx folder ​and type the ''​init''​ command ​without any parameters or double click the file from your desktop. You will enter interactive mode:
- +
-cd your way into the orx folder ​to try out the command. +
- +
-When typing ​the ''​init''​ command ​above, depending on what operating system you are on, you will receive the following output:+
  
 <​code>​ <​code>​
 c:​\Work\orx>​init c:​\Work\orx>​init
  
-== Not enough arguments: []+== No argument, switching to interactive mode 
 + * Project name (relative or full path)? 
 +</​code>​
  
-== Usagec:​\Work\orx\init.bat name+You only need to specify a full path or relative path in order to create and name a project. For example, you could enter a direct path like:
  
-  ​= name: Project namerelative or full path, required+''​C:​\Work\MyGame''​ 
 + 
 +Then the folder above will be created, and ''​MyGame''​ will be name of the Solution / Workspace / or Project. 
 + 
 +In the same way you could enter a relative path. For example on Linux or Mac: 
 + 
 +''​~/​Documents/​MyGame''​ 
 + 
 +After pressing Enter, choose one or more extensions (more on this in the next section). 
 + 
 + 
 +===== Getting Help ===== 
 + 
 +To see all commandline options: 
 + 
 +<​code>​ 
 +$ ./init 
 +== Usage: C:​\Work\Dev\orx\init.bat name [+/-scroll] [+/​-imgui] 
 + 
 +  - name: Project name (relative or full path), required 
 +  - scroll: C++ convenience layer with config-object binding=[no],​ optional 
 +  - imgui: Dear ImGui support (https://​github.com/​ocornut/​imgui)=[no],​ optional
 </​code>​ </​code>​
  
-You only need to specify a path in order to create ​and name a project. ​For example:+There are additional options ​to create a [[en:​tutorials:​creating_your_own_scroll_project_using_init|Scroll-based]] or [[en:​tutorials:​imgui|ImGui-based ​project]] (or both). 
 + 
 + 
 +===== Screen Output ===== 
 + 
 +You will see the following as the various projects and solutions are created for many IDEs:
  
 <​code>​ <​code>​
Line 89: Line 116:
 </​code>​ </​code>​
  
- 
- 
-===== Interactive mode =====  
- 
-For those who prefer not to use the commandline,​ init can be clicked directly from the Windows Explorer (for windows), Finder on Mac, or for Linux... could be anything really. 
- 
-When you click on ''​init.bat''​ or ''​init.sh'',​ you will be asked for a path. If you enter something like: 
- 
-''​c:​\work\MyGame''​ 
- 
-Then the folder above will be created, and ''​MyGame''​ will be name of the Solution / Workspace / or Project. 
- 
-In the same way for Linux or Mac if you could enter something like: 
- 
-''​~/​Documents/​MyGame''​ 
  
  
Line 126: Line 138:
  
 That's about it. A lot of work has gone into making this as bullet proof as possible, so you should have no trouble spinning up new projects whenever you need one. That's about it. A lot of work has gone into making this as bullet proof as possible, so you should have no trouble spinning up new projects whenever you need one.
 +
 +
 +===== Extensions =====
 +
 +You can also create [[en:​tutorials:​creating_your_own_scroll_project_using_init|orx/​Scroll-based projects]] for an object oriented way of using Orx with c++.
 +
 +For making Orx applications with a UI, like applications and editors, you can create [[en:​tutorials:​imgui|Dear ImGui-based projects]].
 +
 +Or a combination of both. More extensions are planned.
 +
  
 ====== Troubleshooting ====== ====== Troubleshooting ======
en/tutorials/creating_your_own_project.1546424780.txt.gz · Last modified: 2019/01/02 14:26 (17 months ago) (external edit)