Difference between revisions of "Create my first program"
From MSX Game Library
(→Create your project directory) |
(→Setup Build Tool) |
||
| Line 20: | Line 20: | ||
Edit <tt>build.bat</tt>: | Edit <tt>build.bat</tt>: | ||
* Change <tt>ProjName</tt> to <tt>mygame</tt>. | * Change <tt>ProjName</tt> to <tt>mygame</tt>. | ||
| − | * Set <tt>Machine</tt> to the version MSX hardware you want to support for your program. Let's say <tt> | + | * Set <tt>Machine</tt> to the version MSX hardware you want to support for your program. Let's say <tt>1</tt> for {{MSX1}}. |
* 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). | * 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 23:14, 18 June 2022
Contents
Test template program
First try to compile and run the template program:
- Go to MSXgl\projects\template (or template_msx2 if you target MSX2 computer)
- 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 (or template_msx2) 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 1 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.
Many other build options can be defined in build.bat. See the options list.
Setup program
- msxgl_config.h...
Change program content
TBC...