Difference between revisions of "Create my first program"

From MSX Game Library

Line 16: Line 16:
 
Rename <tt>template.c</tt> to <tt>mygame.c</tt>.
 
Rename <tt>template.c</tt> to <tt>mygame.c</tt>.
  
== Setup your project ==
+
== Setup Build Tool ==
  
 
Edit <tt>build.bat</tt>:
 
Edit <tt>build.bat</tt>:
Line 26: Line 26:
 
* Execute <tt>build.bat</tt>, check the <tt>emul\rom</tt> directory for <tt>mygame.rom</tt> and test it.
 
* Execute <tt>build.bat</tt>, check the <tt>emul\rom</tt> directory for <tt>mygame.rom</tt> and test it.
  
== Change program ==
+
== Setup program ==
 +
 
 +
* <tt>msxgl_config.h</tt>...
 +
 
 +
== Change program content ==
  
 
TBC...
 
TBC...

Revision as of 15:23, 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 to mygame.c.

Setup Build Tool

Edit build.bat:

  • Change ProjName to mygame.
  • Set Machine to the version MSX hardware you want to support for your program. Let's say 2 for .
  • Set Target to your target format. Let's say ROM_48K (ROM on page 0, 1 and 2 with page 1 & 2 selected at startup).
  • If you have configured an emulator path in MSXgl\projects\default_config.cmd, set DoRun to 1 to allow auto-launch (easier to test your program).
  • Execute build.bat, check the emul\rom directory for mygame.rom and test it.

Setup program

  • msxgl_config.h...

Change program content

TBC...