Difference between revisions of "Create my first program"

From MSX Game Library

Line 22: Line 22:
 
* Set <tt>Machine</tt> to the version MSX hardware you want to support for your program. Let's say <tt>2</tt> for {{MSX2}}.
 
* Set <tt>Machine</tt> to the version MSX hardware you want to support for your program. Let's say <tt>2</tt> for {{MSX2}}.
 
* Set <tt>Target</tt> to your target format. Let's say <tt>ROM_48K</tt> (ROM on page 0, 1 and 2 with page 1 & 2 selected at startup).
 
* Set <tt>Target</tt> to your target format. Let's say <tt>ROM_48K</tt> (ROM on page 0, 1 and 2 with page 1 & 2 selected at startup).
 +
* If you have [[Install|configured an emulator path]] in <tt>MSXgl\projects\default_config.cmd</tt>, set <tt>DoRun</tt>" to <tt>1</tt> to allow auto-launch (easier to test your program).

Revision as of 16:00, 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 your project

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).