Hallo Welt mit KallistiOS

Das folgende kleine Programm zeigt einen Hallo Welt-Schriftzug auf dem Bildschirm an.

#include <kos.h>

 extern uint8 romdisk[];

KOS_INIT_FLAGS(INIT_DEFAULT | INIT_MALLOCSTATS);

KOS_INIT_ROMDISK(romdisk);

/* Your program's main entry point */
int main(int argc, char **argv) {
	/* The requisite line */
	printf("\nHello world!\n\n");

	return 0;
}

Mit der kos.h, die in der ersten Zeile inkludiert wird, werden die wichtigsten Teile von KallistiOS eingebunden.

Mit extern uint8 romdisk[]; wird die romdisk definiert und mit KOS_INIT_ROMDISK(romdisk); initialisiert. Die romdisk ist ein virtuelles Dateisystem, in das während der Laufzeit eines Dreamcast-Programms Dateien, wie zum Beispiel Grafiken oder Musik, kopiert und ausgelesen werden können. Diese Dateien sollten sich im Ordner romdisk im Verzeichnis des Dreamcast-Programms befinden. Dabei sollte aber beachtet werden, dass der benötigte Speicherplatz dieser Dateien nicht den des Arbeitsspeichers nicht überschreitet, denn romdisk ist ja, wie schon gesagt, nur virtuell. Wenn die Romdisk initialisiert wurde, kann man in ihr Enthaltenes über /rd/Dateiname erreichen. Mehr Informationen zu romdisk entnehmt ihr den KallistiOS-Beispielen.

Mit KOS_INIT_FLAGS(INIT_DEFAULT | INIT_MALLOCSTATS); wird KallistiOS selbst schließlich intialisiert.

Die beiden Parameter INIT_DEFAULT und INIT_MALLOCSTATS sind Standardparamter.

Daneben gibt es noch folgende Parameter:

• INIT_NONE - Initialisiert sich gar nicht
• INIT_IRQ - Ermöglicht Programmunterbrechungen / Interupts
• INIT_THD_PREEMPT - Ermöglicht Threading
• INIT_NET - Initialisiert die Netwerkbibliothek,
• INIT_MALLOCSTATS -- Enable a call to malloc_stats() right before shutdown

  You can OR any or all of those together. If you want to start out with
  the current KOS defaults, use INIT_DEFAULT (or leave it out entirely). */