OSFatal

Syntax

#include <revolution/os.h>

void OSFatal ( GXColor fg, GXColor bg, const char* msg );

Arguments

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

Return Values

None.

Description

The OSFatal function immediately halts program execution and shows the specified text message on the TV screen. This function can even be called inside a callback function.

The following demo program illustrates how to hook the SDK assertion message to show the assertion failure message on the TV screen with the OSFatal function.

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

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

See Also

Error Functions, ASSERT, ASSERTMSG, OSReport

Revision History

2006/03/01 Initial version.

CONFIDENTIAL