GDSetOverflowCallback

C Specification

#include <revolution/gd.h>
typedef void (*GDOverflowCallback)(void);
void GDSetOverflowCallback( GDOverflowCallback cb );

Arguments

cb Pointer to an overflow callback function.

Return Values

None.

Description

This function allows you to declare a callback that is invoked when a graphics display list overflows. Overflow is detected only when you attempt to write to a GDLObj structure and the upper limit for the memory buffer associated with the current location pointer is exceeded (or when the limit may be exceeded as a result of writing).

If an overflow callback is not declared, the default overflow process will force an assertion failure. (Debug build only.)

See Also

GDGetOverflowCallback

Revision History

03/01/2006 Initial version.