NAME

cgGetErrorCallBack, cgSetErrorCallBack - get and set the error callback

SYNOPSIS

  #include <Cg/cg.h>

  typedef void (*CGerrorCallBackFunc)(void);

  void cgSetErrorCallBack( CGerrorCallBackFunc func );
  CGerrorCallBackFunc cgGetErrorCallBack( void );

PARAMETERS

func

A function pointer to the callback function.

DESCRIPTION

cgSetErrorCallBack sets a callback function that will be called every time an error occurrs. The callback function is not passed any parameters. It is assumed that the callback function will call cgGetError to obtain the current error. To disable the callback function, cgSetErrorCallBack may be called with NULL.

cgGetErrorCallBack returns the currently set callback function. NULL will be returned if no callback function is set.

The following is an example of how to set and use an error callback :

  void MyErrorCallBack( void ) {
    int Error = cgGetError();
    fprintf(stderr, "ERROR : %s\n", cgGetErrorString(Error));
  }

  void main(int argc, char *argv[])
   {
    cgSetErrorCallBack(MyErrorCallBack);

    /* Do stuff */
   }

ERRORS

SEE ALSO

the "cgGetError" document, the "cgGetErrorString" document