Create my first program - Revision history

Aoineko: /* Test template program */

2024-06-01T22:05:58Z

‎Test template program

2024-01-12T18:52:48Z

2023-11-04T23:20:20Z

‎Create your project directory

2023-11-04T23:13:18Z

2023-11-04T23:11:31Z

‎Create your project directory

2023-11-04T22:57:52Z

‎Setup Build Tool

2023-11-04T22:56:43Z

‎Create your project directory

2023-11-04T22:54:24Z

‎Create your project directory

2023-11-04T22:51:18Z

‎Create your project directory

2023-11-04T22:51:06Z

‎Create your project directory

@@ Line 4: / Line 4: @@
 To validate that your MSXgl [[install]]ation is correct and that you're ready to create your own project, first try to compile and run the <tt>template</tt> sample program:
-* Go to <tt>projects/template</tt> (or <tt>template_msx2</tt> if you target MSX 2 computer)
+* Go to <tt>projects/template</tt> (or <tt>template_msx2</tt> if you target MSX2 computer)
 * Execute <tt>build.bat</tt> (Windows) or <tt>./build.sh</tt> (Linux & macOS)
 * Go to <tt>projects/template/emul/rom</tt>, check if <tt>template.rom</tt> exists and try it on your MSX machine or emulator.

← Older revision		Revision as of 18:52, 12 January 2024
Line 57:		Line 57:
	The following example will show you all the steps required to create a program that moves a sprite over a background on an MSX1.		The following example will show you all the steps required to create a program that moves a sprite over a background on an MSX1.
	In the <tt>projects/samples</tt> directory you'll find numerous [[samples\|sample programs]] that will show you how to use MSXgl's various features for a variety of media.		In the <tt>projects/samples</tt> directory you'll find numerous [[samples\|sample programs]] that will show you how to use MSXgl's various features for a variety of media.
		+
		+	[[category:WIP]]

@@ Line 21: / Line 21: @@
   📁 MSXgl
   └─📁 projects
-    └─📁 mygame                │ Your project directory
+    └─📁 mygame                Your project directory
-      ├─🗎 build.bat            │ Launch Build tool (Windows)
+      ├─🗎 build.bat            Launch Build tool (Windows)
-      ├─🗎 build.sh             │ Launch Build tool (Linux)
+      ├─🗎 build.sh             Launch Build tool (Linux)
-      ├─🗎 msxgl_config.h       │ Library configuration
+      ├─🗎 msxgl_config.h       Library configuration
-      ├─🗎 '''mygame.c'''             │ Your program source code
+      ├─🗎 '''mygame.c'''             Your program source code
-      └─🗎 project_config.js    │ Build tool configuration
+      └─🗎 project_config.js    Build tool configuration
 ''<u>Note</u>: If you prefer, you can use an [[alternative file layout]] to have the MSXgl directory inside your own project directory.''

@@ Line 21: / Line 21: @@
   📁 MSXgl
   └─📁 projects
-    └─📁 mygame               Your project directory
+    └─📁 mygame                │ Your project directory
-      ├─📄 build.bat            Launch Build tool (Windows)
+      ├─🗎 build.bat            │ Launch Build tool (Windows)
-      ├─📄 build.sh             Launch Build tool (Linux)
+      ├─🗎 build.sh             │ Launch Build tool (Linux)
-      ├─📄 msxgl_config.h       Library configuration
+      ├─🗎 msxgl_config.h       │ Library configuration
-      ├─📄 '''mygame.c'''             Your program source code
+      ├─🗎 '''mygame.c'''             │ Your program source code
-      └─📄 project_config.js    Build tool configuration
+      └─🗎 project_config.js    │ Build tool configuration
 ''<u>Note</u>: If you prefer, you can use an [[alternative file layout]] to have the MSXgl directory inside your own project directory.''

@@ Line 22: / Line 22: @@
   └─📁 projects
     └─📁 mygame               Your project directory
-      ├─ build.bat            Launch Build tool (Windows)
+      ├─📄 build.bat            Launch Build tool (Windows)
-      ├─ build.sh             Launch Build tool (Linux)
+      ├─📄 build.sh             Launch Build tool (Linux)
-      ├─ msxgl_config.h       Library configuration
+      ├─📄 msxgl_config.h       Library configuration
-      ├─ '''mygame.c'''             Your program source code
+      ├─📄 '''mygame.c'''             Your program source code
-      └─ project_config.js    Build tool configuration
+      └─📄 project_config.js    Build tool configuration
 ''<u>Note</u>: If you prefer, you can use an [[alternative file layout]] to have the MSXgl directory inside your own project directory.''

@@ Line 35: / Line 35: @@
 * Change <tt>ProjName</tt> to <tt>"mygame"</tt>.
 * Set <tt>Machine</tt> to the minimal version of MSX hardware you want to support for your program. Let's say <tt>"1"</tt> for {{MSX1}}.
-* Set <tt>Target</tt> to your [[target|target format]]. Let's say <tt>ROM_32K</tt> (cartridge with a ROM visible by the CPU on page 1 and 2).
+* Set <tt>Target</tt> to your [[target|target format]]. Let's say <tt>ROM_32K</tt> (cartridge with a 32 KB ROM visible by the CPU on page 1 and 2).
 * If you have [[Install|configured an emulator path]] in <tt>projects/default_config.js</tt>, set <tt>DoRun</tt> to <tt>true</tt> to allow auto-launch (easier to test your program).