Difference between revisions of "Create my first program"

From MSX Game Library

Line 1: Line 1:
== Test ==
+
== Test template program ==
  
 
First try to compile and run the template program:
 
First try to compile and run the template program:
Line 8: Line 8:
 
''<u>Note</u>: If you have [[Install|configured an emulator path]] in <tt>MSXgl\projects\default_config.cmd</tt>, you can edit <tt>build.bat</tt> and change "<tt>set DoRun=0</tt>" to "<tt>set DoRun=1</tt>" to allow auto-launch of the built program.''
 
''<u>Note</u>: If you have [[Install|configured an emulator path]] in <tt>MSXgl\projects\default_config.cmd</tt>, you can edit <tt>build.bat</tt> and change "<tt>set DoRun=0</tt>" to "<tt>set DoRun=1</tt>" to allow auto-launch of the built program.''
  
== Create your program ==
+
== Create your project directory ==
  
 
Now that everything work well, let's create your own program.
 
Now that everything work well, let's create your own program.
 +
 
You can sure start a new project from scratch, but for this example lets duplicate <tt>template</tt> directory an rename it <tt>mygame</tt>.
 
You can sure start a new project from scratch, but for this example lets duplicate <tt>template</tt> directory an rename it <tt>mygame</tt>.
 +
 +
Rename <tt>template.c<tt> to <tt>mygame.c</tt>.
 +
 +
== Setup your project ==
 +
 +
Edit <tt>build.bat</tt>:
 +
* Change ProjName to mygame.
 +
* Set Machine to the version MSX hardware you want to support for your program.
 +
* Set Target to your target format. Let's say ROM_ASCII8 (default ROM size for mapper is 128 KB).

Revision as of 15:37, 16 January 2022

Test template program

First try to compile and run the template program:

  • Go to MSXgl\projects\template
  • Execute build.bat
  • Go to MSXgl\projects\template\emul\rom, check if template.rom exists and try it on your MSX machine or emulator.

Note: If you have configured an emulator path in MSXgl\projects\default_config.cmd, you can edit build.bat and change "set DoRun=0" to "set DoRun=1" to allow auto-launch of the built program.

Create your project directory

Now that everything work well, let's create your own program.

You can sure start a new project from scratch, but for this example lets duplicate template directory an rename it mygame.

Rename template.c<tt> to <tt>mygame.c.

Setup your project

Edit build.bat:

  • Change ProjName to mygame.
  • Set Machine to the version MSX hardware you want to support for your program.
  • Set Target to your target format. Let's say ROM_ASCII8 (default ROM size for mapper is 128 KB).