OSFatal

C Specification

#include <revolution/os.h>
void OSFatal ( GXColor fg, GXColor bg, const char* msg );

Arguments

fg Foreground (text) color. The value of fg member a (the alpha value) is not used.
bg Background (text) color. The value of bg member a (the alpha value) is not used.
msg Pointer to the null-terminated string.

Return Values

None.

Description

The OSFatal function immediately stops the running program and displays the specified text message on the TV screen. This function can even be called inside a callback function.

The following example demo shows how to hook the SDK assertion message for displaying the assertion failure message on a TV screen using the OSFatal function.

       $REVOLUTION_SDK_ROOT/build/demos/osdemo/src/panic.c

Note: The OSFatal function uses the memory space above 18 MB for its work buffer.

See Also

Error Functions, ASSERT, ASSERTMSG,OSReport

Revision History

03/01/2006 Initial version.