glutMenuStatusFunc - sets the global menu status callback.

glutMenuStateFunc
	glutMenuStateFunc(func) -> None
glutMenuStatusFunc
	glutMenuStatusFunc(func) -> None

void glutMenuStatusFunc(void (*func)(int status, int x, int y));
void glutMenuStateFunc(void (*func)(int status));

func      The new menu status (or  state)  callback  func-
          tion.

glutMenuStatusFunc sets the global menu status callback so
a GLUT program can determine when a menu is in use or not.
When  a  menu  status  callback  is registered, it will be
called with  the  value  GLUT_MENU_IN_USE  for  its  value
parameter  when  pop-up  menus are in use by the user; and
the   callback   will   be   called   with    the    value
GLUT_MENU_NOT_IN_USE  for its status parameter when pop-up
menus are no longer in use. The x and y  parameters  indi-
cate  the  location  in  window  coordinates of the button
press that caused the menu to go into use, or the location
where  the  menu was released (may be outside the window).
The func parameter  names  the  callback  function.  Other
callbacks  continue  to operate (except mouse motion call-
backs) when pop-up menus are in use  so  the  menu  status
callback  allows  a  program to suspend animation or other
tasks when menus are in use. The cascading  and  unmapping
of sub-menus from an initial pop-up menu does not generate
menu status callbacks. There is a single menu status call-
back for GLUT.

When  the menu status callback is called, the current menu
will be set  to  the  initial  pop-up  menu  in  both  the
GLUT_MENU_IN_USE  and GLUT_MENU_NOT_IN_USE cases. The cur-
rent window will be set to the window from which the  ini-
tial menu was popped up from, also in both cases.

Passing NULL to glutMenuStatusFunc disables the generation
of the menu status callback.

glutMenuStateFunc is a deprecated  version  of  the  glut-
MenuStatusFunc  routine. The only difference is glutMenuS-
tateFunc callback prototype does not deliver the two addi-
tional x and y coordinates.

glutCreateMenu, glutCreateWindow

Mark J. Kilgard (mjk@nvidia.com)