API GLUT Completa1. glutInit

El comando glutInit inicializa la librería de GLUT y negocia una sesión con el sistema de ventana. También procesa opciones de la línea de comando. Se utiliza de la siguiente manera:

void glutInit(int *argcp, char **argv)

Donde argcp es un apuntador a la variable sin modificar argc. Como regreso de esta función el valor al que apunta argcp es actualizado.

El parámetro argv es para la variable sin modificar de main argv. Como el parámetro anterior, actualiza el valor de argv.

2. glutInitWindowPosition y glutInitWindowSize

Estas funciones fijan los parámetros para la posición inicial y el tamaño de la ventana que se crea. Se utilizan de la siguiente manera:

void glutInitWindowSize(int width, int height);void glutInitWindowPosition(int x, int y);

Donde width es el ancho de la ventana y height la altura en píxeles.X y Y responden a las coordenadas de la ventana cuando se crea.

3. glutInitDisplayMode

Esta función fija el modo despliegue inicial. Este modo es para la creación de ventanas de alto nivel, subventanas y capas para determinar el display de OpenGL para la ventana que se va a crear. Se utiliza de la siguiente manera:

void glutInitDisplayMode(unsigned int mode);

Donde mode es la opción de máscara de bit deseada (la descripción de éstas se pueden encontrar en la fuente de referencia)

Las máscaras son:GLUT_RGBAGLUT_RGB GLUT_INDEXGLUT_SINGLEGLUT_DOUBLEGLUT_ACCUMGLUT_ALPHAGLUT_DEPTHGLUT_STENCILGLUT_MULTISAMPLEGLUT_STEREOGLUT_LUMINANCE

4. glutMainLoop

Entra al loop de proceso de eventos. Esta rutina debe ser llamada al menos una vez en un programa de GLUT. Una vez llamada, esta rutina nunca va a retornar, sólo va a llamar todas las callbacks o llamadas de retorno que se hayan registrado. Se utiliza:

void glutMainLoop(void);

5. glutCreateWindow

Crea una ventana de alto nivel. Se utiliza de la siguiente manera:

int glutCreateWindow(char *name);

El nombre de la ventana es dado por la variable name. El estado de despliegue o display de una ventana es mostrada por la ventana inicialmente, pero el estado de despliegue no actúa hasta que se entra al ciclo generado por la función glutMainLoop. Esto quiere decir que no se puede renderizar efectivamente a esta ventana hasta que se haya entrado al ciclo.

6. glutCreateSubWindow

Crea una sub ventana a partir de los parámetros que obtiene. Se utiliza como:

int glutCreateSubWindow(int win, int x, int y, int width, int height);

Donde se tiene que especificar el nombre de la ventana a la cual se le quiera agregar la subventana (parámetro win). Los parámetros X y Y responden a la ubicación de la subventana dentro de la ventana original. Widht y Heigth especifican respectivamente el ancho y alto de esta subventana.

El estado de despliegue o display de la subventana es mostrada inicialmente, pero el estado de despliegue no actúa hasta que se entra al ciclo generado por la función glutMainLoop. Es similar a la utilización de la función glutCreateWindow.

7. glutSetWindow y glutGetWindow

glutSetWindow fija la ventana actual, glutGetWindow regresa el identificador de la ventana actual. Si no existen ventanas o la ventana actual fue destruida, glutGetWindow regresa el valor de 0. glutSetWindow no modifica la capa en uso para la ventana, esto se realiza mediane la función glutUseLayer. Se utilizan

void glutSetWindow(int win);int glutGetWindow(void);

Donde win es el identificador de la ventana.

8. glutDestroyWindow

void glutDestroyWindow(int win);

Destruye a la ventana determinada por el parámetro win. Destruye también el contexto asociado por OpenGL, el mapa de colores lógico y las capas y estados relacionados. Cualquier subventana de la ventana destruida son tambien destruidas. SI la ventana a destruir es la actual, glutGetWindow regresa el valor de 0.

9. glutPostRedisplay

void glutPostRedisplay(void);

Marca el plano normal de la ventana actual según se necesite ser re desplegado. En la próxima iteración a través de glutMainLoop se llamará la llamada de retorno o callback para re desplegar el plano normal de la ventana10. glutSwapBuffersvoid glutSwapBuffers(void);Realiza un intercambio de buffer en la capa en uso para la ventana actual. Específicamente, hace que el contenido del buffer trasero de la capa en uso se convierta en contenido del buffer frontal. En este paso el contenido del buffer trasero se considera cono undefined o indefinido. La actualización usualmente se realiza durante el re-trazado vertical del monitor, en vez de ser realizado inmediatamente después de llamar a la función glutSwapBuffers. Antes de retornar, esta función realiza un glFlush. Los comandos subsecuentes de OpenGL pueden ser ordenados inmediatamente después de llamar a la función, pero no son ejecutados hasta que el intercambio de buffers se complete.11. glutPositionWindowvoid glutPositionWindow(int x, int y);Solicita un cambio en la posición de la ventana actual. Para ventanas de alto nivel los parámetros de X y Y son offsets de píxeles del origen de la pantalla. Para subventanas, la X y la Y son offsets de píxel de la ventana padre. Las solicitudes hechas por glutPositionWindow no son procesadas inmediatamente, son ejecutadas después de regresar al loop de evento principal. Para el caso de ventanas de alto nivel, esta función es considerada sólo como una petición para posicionar la ventana. El sistema de ventanas es libre de aplicar sus propias políticas para la colocación de ventanas de alto nivel; la intención es que

estas ventanas puedan ser re-posicionadas de acuerdo a los parámetros de glutPositionWindow.12. glutReshapeWindowvoid glutReshapeWindow(int width, int height);Donde width es el ancho nuevo de la ventana y height la nueva altura. Realiza una petición de cambio de tamaño en la ventana actual. Los parámetros width y height son dados en píxeles y deben ser valores positivos.Al igual que la función anterior, las solicitudes no son procesadas inmediatamente y para ventanas de alto nivel se considera como una petición de modificar la ventana.13. glutFullScreenvoid glutFullScreen(void);Solicita que la ventana actual se haga de tamaño de la pantalla completa. El concepto de ventana completa varía de sistema dependiendo del sistema de ventana. La idea es hacer la ventana tan larga como sea posible y deshabilitar cualquier decoración o borde de ventana añadidos al sistema de ventanas. El largo y ancho de la ventana no se garantiza que sean los mismos que los de la pantalla, pero esa es la intención de hacer la ventana de tamaño completo.Esta función está definida sólo para ventanas de alto nivel. Al igual que las dos instrucciones anteriores, no se procesa inmediatamente.14. glutPopWindow y glutPushWindowvoid glutPopWindow(void);void glutPushWindow(void);Estos comandos funcionan para los dos niveles de ventanas, principales y subventanas. El efecto de hacer un push y pop en las ventanas no se realiza inmediatamente. En vez de eso, se salva la ejecución hasta regresar al ciclo de evento de GLUT. Subsecuentemente, estas instrucciones solicitan un reemplazo de la petición anteriormente guardada para esa ventana. El efecto de hacer pop y push en ventanas de alto nivel es a consideración de la política del sistema de ventanas para apilar las mismas.15. glutShowWindow, glutHideWindow, glutIconifyWindow

void glutShowWindow(void);void glutHideWindow(void);void glutIconifyWindow(void);

glutShowWindow muestra la ventana actual.glutHideWindow oculta la ventana actual.glutIconifyWindow minimiza la ventana actual.

16. glutSetWindowTitle, glutSetIconTitle

void glutSetWindowTitle(char *name);void glutSetIconTitle(char *name);

name: deberá conformarse por una cadena de caracteres ASCII.

glutSetWindowTitle pone la barra de título en la ventanaglutSetIconTitle pone la barra de título en la ventana minimizada

17. glutSetCursor

void glutSetCursor(int cursor);

cursorNombre de la imagen del cursor a cambiar.GLUT_CURSOR_RIGHT_ARROWFlecha que señala encima y a la derecha.GLUT_CURSOR_LEFT_ARROWFlecha que señala encima y a la izquierda.GLUT_CURSOR_INFOSeñalador de mano.GLUT_CURSOR_DESTROYCráneo y huesos encrusijados.GLUT_CURSOR_HELPMarca de pregunta.GLUT_CURSOR_CYCLEFlecha que está rotando en un círculo.GLUT_CURSOR_SPRAY

Lata de aerosol.GLUT_CURSOR_WAITReloj.GLUT_CURSOR_TEXTCursor para apuntar a la insercion de texto.GLUT_CURSOR_CROSSHAIRCortador.GLUT_CURSOR_UP_DOWNPuntero bidireccional arriba y abajo.GLUT_CURSOR_LEFT_RIGHTPuntero bidireccional izquierda y derechaGLUT_CURSOR_TOP_SIDEFlecha que upunta a un lado superior.GLUT_CURSOR_BOTTOM_SIDEFlecha que apunta a un lado inferior.GLUT_CURSOR_LEFT_SIDEFlecha que apunta a un lado izquierdo.GLUT_CURSOR_RIGHT_SIDEFlecha que apunta a un lado derecho.GLUT_CURSOR_TOP_LEFT_CORNERFlecha que apunta a la esquina superior izquierda.GLUT_CURSOR_TOP_RIGHT_CORNERFlecha que apunta a la esquina superior derecha.GLUT_CURSOR_BOTTOM_RIGHT_CORNERFlecha que apunta a la esquina inferior izquierda.GLUT_CURSOR_BOTTOM_LEFT_CORNERFlecha que apunta a la esquina inferior derecha.GLUT_CURSOR_FULL_CROSSHAIRCursor de pantalla completa del cortador.GLUT_CURSOR_NONECursor invisible.GLUT_CURSOR_INHERITUso del cursor padre.

glutSetCursor cambia la imagen del cursor de la ventana actual.

18. glutEstablishOverlay

Uso:

void glutEstablishOverlay(void);

Descripción:

glutEstablishOverlay: establece un recubrimiento (si es posible) para la ventana actual. El modo de despliegue solicitado para el recubrimiento es determinado por el modo inicial de despliegue.glutLayerGet(GLUT_OVERLAY_POSSIBLE): puede ser llamado para determinar si un recubrimiento es posible en la ventana actual con el modo inicial de despliegue actual. No intente establecer un recubrimiento cuando no es posible, ya que GLUT terminará el programa.

Si glutEstablishOverlay es llamado cuando un recubrimiento ya existe, el recubrimiento existente es removido primero, y entonces un nuevo recubrimiento es establecido.

19. glutUseLayer

void glutUseLayer(GLenum layer);

layerCualquier GLUT_NORMAL o GLUT_OVERLAY, selecciona el plano normal o el recubrimiento respectivamente.

glutUseLayer: cambia la capa en uso por ventana para la ventana actual, seleccionando cualquier plano normal o recubrimiento. El recubrimiento debe sólo ser especificado si es que existe, sin embargo una ventana sin recubrimiento puede todavía llamar a glutUseLayer(GLUT_NORMAL). Los comandos OpenGL

para ventanas están dirigidos a la actual capa en uso.

Para saber la capa en uso en un ventana puede llamar a glutLayerGet(GLUT_LAYER_IN_USE).

20. glutRemoveOverlay

void glutRemoveOverlay(void);

glutRemoveOverlay remueve el recubrimiento (si es que existe). Es seguro llamar a glutRemoveOverlay incluso si no hay un recubrimiento establecido actualmente, no hará nada en ese caso. Implícitamente, la capa en uso de la ventana cambia al plano norma inmediatamente un vez que haya sido eliminado el recubrimiento.

Si el programa intenta reestablecer el recubrimiento mas tarde, es típicamente mas rápido y hacienda uso de menos recursos utilizar glutHideOverlay and glutShowOverlay que simplemente cambia el estado de despliegue del recubrimiento.

21. glutPostOverlayRedisplay

void glutPostOverlayRedisplay(void);

Marca el recubrimiento de la ventana actual como necesitando ser re-desplegado. La siguiente iteración a través de glutMainLoop, el recubrimiento de la ventana desplegará el callback (o simplemente el despliegue del callback si no hay un recubrimiento registrado en el despliegue del callback) será llamad a re-desplegar el plano del recubrimiento de la ventana. Llamadas múltiples con glutPostOverlayRedisplay antes de dar oportunidad al siguiente despliegue del callback(o la oportunidad al despliegue del callback con el recubrimiento si es que se registra alguno) se genera olamente un único re-despliegue. glutPostOverlayRedisplay podrá ser llamado dentro despliegue del callback o recubrimiento de la ventana y así remarcar esa ventana para su re-despliegue.

Lógicamente, Una notificación de daños de un recubrimiento para una ventana se trabaja con glutPostOverlayRedisplay sobre la ventana dañada. Diferente al daño reportado por sistema de la ventana, glutPostOverlayRedisplay no fijará el verdadero estado de daño del recubrimiento (retornado por glutLayerGet(GLUT_OVERLAY_DAMAGED)).

22. glutShowOverlay, glutHideOverlay

void glutShowOverlay(void);void glutHideOverlay(void);

glutShowOverlay muestra el recubrimiento de la ventana actual; glutHideOverlay oculta el recubrimiento. El efecto de mostrar u ocultar un recubrimiento tiene lugar inmediatamente. Note que glutShowOverlay no mostrará realmente el recubrimiento a menos de que la ventana también sea mostrada (e incluso una ventana mostrada podrá ser ocultada por otras ventanas, a tal grado ocultando el recubrimiento). Es típico, más rápido y hacienda uso de menos recursos del sistema utilizar estas rutinas para controlar el estado despliegue de un recubrimiento a quitar y reestablecer el recubrimiento.

23. glutCreateMenu

int glutCreateMenu(void (*func)(int value));

funcLa función callback para el menú es llamada cuando una entrada del menú se selecciona. El valor pasado al callback es determinado por el valor de la selección de la entrada del menú.

glutCreateMenu crea un nuevo menú pop-up y retorna un único identificador entro pequeño. El rango asignación a los identificadores inicia en uno. El rango identificador de menú es independiente de el rango identificador de ventana. Implícitamente, el menú actual es fijado a es menú creado nuevamente. Este identificador de menú puede ser usado llamando a glutSetMenu.

Cuando el menú callback es llamado porque una entrada es seleccionada para el menú, el menú actual será implícitamente fijado a el menú con la entrada seleccionada antes el callback es hecho.

24. glutSetMenu, glutGetMenu

void glutSetMenu(int menu);int glutGetMenu(void);

menuEl identificador del menú para hacer el menú actual.

glutSetMenu fija el menú actual; glutGetMenu devuelve el identificador del menú actual. Si no existen menús o el menú anterior fue eliminado, glutGetMenu devuelva cero.

25. glutDestroyMenu

void glutDestroyMenu(int menu);

menuEl identificador del menú a destruir.

glutDestroyMenu destruye el menú especificado por el argumento menú. Si el argumento menú fuera el del menú actual, el menú actual se convierte en inválido y glutGetMenu devolverá cero.

26. glutAddMenuEntry

void glutAddMenuEntry(char *name, int value);

nameCadena de caracteres ASCII a desplegar en la entrada del menu.valueValor a devolver a la función callback del menú si la entrada del menú es seleccionada.

glutAddMenuEntry agrega una entrada de menú en la ultima parte del menú actual. La cadena name se desplegará para la entrada agregada nuevamente. Si la entrada de menú es seleccionada por el usuario, el callback del menú será llamado pasando value como parámetro de callback.

27. glutAddSubMenu

void glutAddSubMenu(char *name, int menu);

nameCadena de caracteres ASCII a desplegar en el objeto menu del cual se deriva el sub-menu.menuIdentificador de el menú del que se va a derivar este sub-menú.

glutAddSubMenu agrega un sub-menu activador en el fondo del menu actual. La cadena name sera desplegada para el sub-menu activador agregado nuevamente. Si el sub-menu activador es incorporado, el sub-menú será numerado por el argumento menu y será colocado en cascada, permitiendo así que los objetos del sub-menú sean seleccionados.

28. glutChangeToMenuEntry

void glutChangeToMenuEntry(int entry, char *name, int value);

entryÍndice de los artículos de menú en el menú actual (1 es el nivel más alto en un articulo de menú).nameCadena de caracteres ASCII a desplegar en la entrada del menú.valueValor a devolver a la función callback del menú si la entrada del menú es seleccionada.

glutChangeToMenuEntry cambia la entrada de menú especificada en el menú actual. El parámetro entry determina cual artículo del menú debe ser cambiado, con uno siendo el de más alto nivel. entry necesita estar entre 1 y glutGet(GLUT_MENU_NUM_ITEMS) inclusive. El elemento del menú a cambiar no tiene que ser ya una entrada del menú. La cadena name será desplegada para la entrada de menú cambiada nuevamente. El valor value será devuelto al callback del menú si esta entrada del menú es seleccionada.

29. glutChangeToSubMenu

void glutChangeToSubMenu(int entry, char *name, int menu);

entryÍndice de los artículos de menú en el menú actual (1 es el nivel más alto en un articulo de menú).nameCadena de caracteres ASCII a desplegar en la entrada del menú.valueValor a devolver a la función callback del menú si la entrada del menú es seleccionada.

glutChangeToSubMenu cambia el elemento del menú especificado en el menú actual dentro de un sub-menú activador. El parámetro entry determina cual elemento del menú debe ser cambiado, con un elemente estando en el nivel mas alto. entry necesita estar entre 1 y glutGet(GLUT_MENU_NUM_ITEMS) incluso. El elemento del menú a cambiar no tiene ya que ser un sub-menú activador. La cadena name será desplegada para el sub-menú activador cambiado nuevamente. El parámetro menú es el identificador por nombre del sub-menú colocado en cascada nuevamente.

30. glutRemoveMenuItem

void glutRemoveMenuItem(int entry);

entryÍndice de los artículos de menú en el menú actual (1 es el nivel más alto en un articulo de menú).

glutRemoveMenuItem elimina el elemento de la entrada del menú sin importar que sea una entrada de menu o un activador de sub-menú. entry necesita estar entre 1 y glutGet(GLUT_MENU_NUM_ITEMS) incluso. Los elementos del menú debajo del elemento del menú eliminado son renumerados.

31. glutAttachMenu, glutDetachMenu

void glutAttachMenu(int botón);void glutDetachMenu(int botón);

botónEl botón a adjuntar o quitar el menú.

glutAttachMenu adjunta un boton del mouse a la ventana actual, con el identificador del menú activo; glutDetachMenu quita el botón adjuntado del mouse a la ventana activa. Al adjuntar un menú identificador hacia un botón, el menú nombrado saldrá cuando el usuario presione el botón especificado. El valor botón debe ser uno de los siguientes: GLUT_LEFT_BUTTON, GLUT_MIDDLE_BUTTON, and GLUT_RIGHT_BUTTON. Note que el menú esta adjuntado al botón mediante un identificador y no mediante una referencia.

32. glutDisplayFunc

void glutDisplayFunc(void (*func)(void));

funcLa nueva función de display

glutDisplayFunc dispone la función de display para la ventana actual. Cuando GLUT determina que el plano normal para la ventana necesita ser refrescada, el display callback de la ventana será llamado. Antes de la llamada, la ventana actual será dispuesta a la ventana que necesita ser refrescada y (si ninguna función de overlay display callback es registrada) la capa en uso es colocada en el plano normal. La función display callback es llamada sin ningún parámetro. Toda la región del plano normal deberá ser refrescada en respuesta a la llamadaGLUT determina cuando la función display callback deberá ser activada, basándose en el estado de refresco de la ventana. El estado de refresco para la ventana puede ser o explicitito llamando la función glutPostRedisplay o implícito como resultado de un reporte de daños de ventana, llamado por el sistema de ventanas. 33. glutOverlayDisplayFuncvoid glutOverlayDisplayFunc(void (*func)(void));func

La nueva función overlay display callback.glutDisplayFunc dispone la función overlay display callback para la ventana actual. La función overlay display callback es funconalmente la misma que display callback excepto que la función overlay display callback es usada para refrescar el overlay de la ventana.GLUT determina cuando la función overlay display callback deberá ser activada, basándose en el estado de refresco de la ventana. El estado de refresco para la ventana puede ser o explicitito llamando la función glutPostOverlayRedisplay o implícito como resultado de un reporte de daños de ventana, llamado por el sistema de ventanas.34. glutReshapeFuncvoid glutReshapeFunc(void (*func)(int largo, int alto));

funcLa nueva función redimensionamiento glutReshapeFunc dispone la función de redimensionamiento para la ventana actual. La función de redimensionamiento es activada cuando una ventana es redimensionada. Esta también es llamada inmediatamente antes de la primera función display callback dela ventana, después de que la venta es creada o en cualquier momento que un overlay para la ventana es establecido. El largo y la altura son parámetros de la función y especifican el tamaño de la nueva ventana en píxeles.35. glutKeyboardFuncvoid glutKeyboardFunc(void (*func)(unsigned char tecla, int x, int y));fun.La nueva función de teclado glutKeyboardFunc dispone la función de telado para la ventan actual. Cuando el usuario teclea en la ventana, cada tecla presionada genera un carácter ASCII el cual generará un una función de teclado. El parámetro tecla es el carácter ASCII generado. El estado de teclas modificadoras como Shift no pueden ser determinadas directamente; su único efecto será al regresar un dato ASCII los parámetros x y y indican la posición de mouse en coordenadas relativas dentro de la ventana cuando la tecla fue presionada. Cuando una nueva ventana es creada, no hay ninguna función de teclado asignada, y todos los caracteres ASCII creados en la ventana serán ignorados.36. glutMouseFuncvoid glutMouseFunc(void (*func)(int botón, int estado, int x, int y));

func.La nueva función del mouse glutMouseFunc dispone la función del mouse para la ventana actual. Cuando un usuario presiona y suelta un botón del mouse dentro de la ventana, cada presionada y cada soltada generan una función del mouse. El parámetro botón es uno de los siguientes GLUT_LEFT_BUTTON, GLUT_MIDDLE_BUTTON, or GLUT_RIGHT_BUTTON. Para sistemas con mouse de solo 2 botones, no será posible generar el estado GLUT_MIDDLE_BUTTON. Y para los sistemas con un solo botón de mouse, solo podra utilizar el parámetro GLUT_LEFT_BUTTON. El parámetro estado es GLUT_UP o GLUT_DOWN indicando que fue generado debido al presionar o soltar el botón respectivamente, los parámetros x y y indican la posición de mouse en coordenadas relativas dentro de la ventana cuando el botón del mouse fue presionado.37. glutMotionFunc, glutPassiveMotionFuncvoid glutMotionFunc(void (*func)(int x, int y));void glutPassiveMotionFunc(void (*func)(int x, int y));

funcLa nueva función de movimiento o movimiento pasivoglutMotionFunc and glutPassiveMotionFunc dispone la función de movimiento o movimiento pasivo dentro de la ventana activa. La función de movimiento es accionada cuando mouse se mueve dentro de la ventana mientras uno o mas botones son presionados. La función de movimiento pasivo es llamada cuando el mouse se mueve dentro de la ventana mientras que no hay botones presionados. Los parámetros x y y indican la posición del mouse en la ventana en coordenadas relativas.38. glutVisibilityFuncvoid glutVisibilityFunc(void (*func)(int estado));funcLa nueva función de visibilidadglutVisibilityFunc dispone la función de visibilidad dentro de la ventana actual. Esta función es llamada cuando la visibilidad en una ventana ha cambiado. El parámetro estado puede ser GLUT_NOT_VISIBLE o GLUT_VISIBLE dependiendo en la la visibilidad actual de la ventana. GLUT_VISIBLE no distingue entre una ventana totalmente visible a una parcialmente visible. GLUT_NOT_VISIBLE significa que ninguna parte de la ventana es visible. GLUT considera a una ventana visible si cualquier píxel de la ventana es visible o cualquier píxel de cualquier ventada descendiente es visible en la pantalla.39. glutEntryFunc

void glutEntryFunc(void (*func)(int estado));funcLa nueva función de entradaglutEntryFunc dispone la función de entrada/salida del mouse para la ventana actual. El parámetro estado es uno de los siguientes: GLUT_LEFT o GLUT_ENTERED , dependiendo si el puntero del mouse se ha ido o a entrado a la ventana. Algunos sistemas no generaran correctas llamadas a funciones de entrada y salida del mouse.40. glutSpecialFuncvoid glutSpecialFunc(void (*func)(int tecla, int x, int y));

funcLa nueva función de entradaglutSpecialFunc dispone la función para teclas especiales dentro de la ventana actual. Esta función es activada cuando las teclas de funciones o teclas de dirección son presionadas en el teclado. El parámetro tecla es una constante GLUT_KEY_* para la tecla especial presionada. Los parámetros x y y indican la posición de mouse en coordenadas relativas dentro de la ventana cuando la tecla fue presionada. Las teclas especiales son:GLUT_KEY_F1Tecla F1GLUT_KEY_F2Tecla F2 GLUT_KEY_F3Tecla F3 GLUT_KEY_F4Tecla F4 GLUT_KEY_F5Tecla F5 GLUT_KEY_F6Tecla F6 GLUT_KEY_F7Tecla F7GLUT_KEY_F8Tecla F8 GLUT_KEY_F9Tecla F9 GLUT_KEY_F10Tecla F10GLUT_KEY_F11Tecla F11GLUT_KEY_F12Tecla F12.GLUT_KEY_LEFTTecla de dirección izquierdaGLUT_KEY_UPTecla de dirección arribaGLUT_KEY_RIGHTTecla de dirección derechaGLUT_KEY_DOWNTecla de dirección abajoGLUT_KEY_PAGE_UPTacla de avance de página.GLUT_KEY_PAGE_DOWNTacla de retroceso de páginaGLUT_KEY_HOMETecla de inicioGLUT_KEY_ENDTecla de finGLUT_KEY_INSERTTecla de imsertarNote que las teclas de escape, suprimir y borrar generan un código ASCII , por lo tanto no son teclas especiales41. glutSpaceballMotionFuncvoid glutSpaceballMotionFunc(void (*func)(int x, int y, int z));func

La nueva entrada para la funciónglutSpaceballMotionFunc dispone la función dentro de la ventana actual para el Spaceball. Esta función es activada cuando la ventana tiene un foco de entrada del Spaceball (normalmente cuando el mouse esta dentro de la ventana) y el usuario genera una traslación del Spaceball. Los parámetros x, y y z indican la traslación en los ejes X, Y y Z respectivamente. Los parámetros se normalizan para estar dentro del rango de -1000 a 1000. Nota: el Spaceball es un dispositivo de entrada con 6 grados de libertad42. glutSpaceballRotateFuncvoid glutSpaceballRotateFunc(void (*func)(int x, int y, int z));

funcLa nueva entrada para la funciónglutSpaceballRotateFunc dispone la función de rotación para el Spaceball dentro de la ventana actual. Esta Función es llamada cuando el foco de entrada del Spaceball (normalmente cuando el mouse esta dentro de la ventana) y el usuario genera una rotación en el spaceball. Los parámetros x, y y z indican la rotación dentro de los ejes X, Y y Z. los parámetros son normalizados para estar dentro del rango de –1800 a 1800.Nota: el Spaceball es un dispositivo de entrada con 6 grados de libertad43. glutSpaceballButtonFuncvoid glutSpaceballButtonFunc(void (*func)(int botón, int estado));funcLa nueva entrada para la funciónglutSpaceballButtonFunc dispone la función para los botones del Spaceball. Esta función es llamada cuando el foco de entrada del Spaceball (normalmente cuando el mouse esta dentro de la ventana) y el usuario presiona algún botón del Spaceball. El parámetro botón será el número del botón (empezando en uno). El número de botones disponibles puede ser determinado con glutDeviceGet(GLUT_NUM_SPACEBALL_BUTTO NS). El estado es GLUT_UP o GLUT_DOWN indicando si el botón esta siendo liberado o presionado respectivamente.Nota: el Spaceball es un dispositivo de entrada con 6 grados de libertad44. glutButtonBoxFunc

void glutButtonBoxFunc(void (*func)(int button, int state));

glutButtonBoxFunc coloca el callback de botón de caja de marcado y botón para la ventana actual. El callback de botón de caja de marcado y botón para una ventana es llamado cuando la ventana tiene una entrada de caja de marcado y botón (normalmente, cuando el Mouse se encuentra dentro de la ventana) y el usuario genera entradas de presión de botón de caja de marcado y botón. El parámetro de botón será el número de botón (comenzando con uno). El número de botón de marcado y botón puede ser dterminado con glutDeviceGet (GLUT_NUM_BUTTON_BOX_BUTTONS). El estado es GLUT_UP o GLUT_DOWN, lo cual indica si el callback se debió a una presión o a una falta de tal, respectivamente. Func se refiere a la función callback a ejecutarse.

45. glutDialsFunc

void glutDialsFunc(void (*func)(int dial, int value));

glutDialsFunc coloca el callback de la caja de marcado de botón y marcado para la ventana actual. El callback de la caja de marcado de botón y marcado para una ventana generalmente se efectúa cuando la ventana tiene una caja de marcado y botón con una entrada enfocada (normalmente, cuando el Mouse se encuentra dentro de la ventana) y el usuario genera cambios de caja de marcado de marcado y botón. El parámetro de marcado será el del número marcado (empezando por uno). El número de marcados de la caja de botón y marcado disponible puede ser determinado con glutDeviceGet (GLUT_NUM_DIALS). El valor mide la rotación absoluta en grados. Los valores de marcado no giran con cada rotación completa, mas continúan acumulando grados (hasta que haya un desbordamiento de int dial value). Func se refiere a la función callback a ejecutarse.

46. glutTabletMotionFunc

void glutTabletMotionFunc(void (*func)(int x, int y));

glutTabletMotionFunc coloca el callback de moción de tableta para la ventana actual. El callback para la moción de tableta para una ventana se ejecuta cuando la ventana tiene un enfoque de entrada por tableta (cuando el Mouse está dentro de la ventana) y el usuario genera la moción de tableta. Los parámetros callback de x y y indican la posición absoluta del “puck” de la tableta en la tableta. Los

parámetros de callback se normalizan en el rango de 0 a 2000 inclusivos. Func se refiere a la función callback a ejecutarse.

47. glutTabletButtonFunc

void glutTabletButtonFunc(void (*func)(int button, int state, int x, int y));

glutTabletButtonFunc coloca el callback de botón de tableta para la ventana actual. El callback de botón de tableta es llamado cuando la ventana tiene un enfoque de entrada de tableta y el usuario genera entradas por presión de botón de tableta. El parámetro de botón será el número de botón (comenzando con uno). El número disponible de botones de tabletas puede ser determinado con glutDeviceGet (GLUT_NUM_TABLET_BUTTONS). El estado será GLUT_UP o GLUT_DOWN, indicando si el callback ocurre debido a una liberación o a una presión, respectivamente. Los parámetros de callback x y y indican las coordenadas relativas de la ventana cuando el botón de tableta es cambiado. Func se refiere a la función callback a ejecutarse.

48. glutMenuStatusFunc

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

glutMenuStatusFunc coloca el callback del estado del menú global para que un programa GLUT pueda determinar cuando un menú está en uso o no. Cuando el callback del estado de un menú es registrado, será llamado con el valor de GLUT_MENU_IN_USE por su parámetro de valor cuando los menús pop-up estén siendo usados por el usuario; y el callback entonces será llamado con el valor GLUT_MENU_NOT_IN_USE por su parámetro de estado cuando los menús pop-up no estén siendo usados. Los parámetros x y y indican la localización en coordenadas de ventana de la presión de botón que causó que el menú estuviera en uso o la localización donde el menú fue liberado (puede ser fuera de la ventana). El parámetro fun. Nombra la función callback. Otros callbacks continúan operando (excepto por los callbacks de movimiento del Mouse) cuando los menús pop-up están en uso para que los callback de estado de menú permitan a un programa suspender su animación u otras tareas cuando los menús están en uso. Los menús de unmapping o de cascada de un menú pop-up inicial no generan llamadas al estado de menú. Hay un solo callback de estado de menú para GLUT.glutMenuStateFunc es una función simplificada de la anterior: esta no recibe parámetros de coordenadas x y y.

49. glutIdleFunc

void glutIdleFunc(void (*func)(void));

glutIdleFunc coloca el callback de inactividad global para ser func para que así un programa GLUT pueda realizar procesos continuos de animación cuando el los eventos de sistema de ventana no estén siendo recibidos. Si se habilita, el callback de inactividad se llama continuamente cuando no haya eventos recibidos. La rutina de callback no tiene parámetros. La ventana actual y el menú actual no serán cambiados antes del callback de inactividad. Los programas con ventanas o menús múltiples deben colocar explícitamente la ventana y/o el menú actual y no deberán confiar en su configuración actual.

50. glutTimerFunc

void glutTimerFunc(unsigned int msecs, void (*func)(int value), value)

glutTimerFunc registra la func de callback de tiempo para que sea ejecutada en al menos msecs milisegundos. El parámetro value para el callback de tiempo será el valor del parámetro value para glutTimerFunc. Callbacks múltiples de tiempo al mismo tiempo o en diferentes tiempos pueden ser registradas simultáneamente.

51. glutSetColor

void glutSetColor(int cell, GLfloat red, GLfloat green, GLfloat blue);

Coloca el mapa de colores del índice de color de cell para el mapa de color lógico para la ventana actual para la capa en uso con el color especificado por red, green y blue (rojo, verde y azul, cuyos rangos varían desde 0.0 hasta 1.0). La capa en uso para la ventana actual debe ser una ventana de índice de color. Cell debe ser cero o más grande y menos del número total de entradas de mapa de color para la

ventana. Si el mapa de color de la capa en uso fue copiado por una referencia, una llamada a glutSetColor forzará la duplicación del mapa de colores.

52. glutGetColor

GLfloat glutGetColor(int cell, int component);

glutGetColor obtiene los components rojo, verde o azul para una entrada de mapa de colores de índice de colores dada para el color de mapa lógico de la ventana. La ventana actual debe ser una ventana de índice de color. Cell debe ser cero o mayor y menor del número de total de entradas de mapa de color para la ventana. Para índices de color válidos, el valor regresado es un valor de punto flotante entre 0.0 y 1.0. glutGetColor devolverá .0 si el índice de color especificado es un índice transparente de overlay, menos de cero o mayor o igual al valor devuelto por glutGet (GLUT_WINDOW_COLORMAP_SIZE), esto es si el índice de color es transparente o está fuera del rango de los índices de color válidos.

53. glutCopyColormap

void glutCopyColormap(int win);

glutCopyColormap copia (lentamente de ser posible, para promover el compartir archivos) el mapa de color lógico de una ventana especificada a la capa en uso de la ventana. La copia será del plano normal al plano normal; o del overlay al overlay (nunca a través de capas distintas). Una vez que el mapa de color haya sido copiado, evite colocar cells en el mapa de color con glutSetColor, ya que eso forzará una copia actual del mapa de colores si fue copiada previamente por referencia. glutCopyColormap solamente debería ser empleada cuando ambas la ventana actual y la ventana win sean ventanas de índice de color.

54. glutGet

int glutGet(GLenum state);

glutGet obtiene un estado simple de GLUT representado por enteros. El parámetro state determina qué tipo de estado regresará. El estado de capacidad de la ventana se regresa para la capa en uso. Nombres de estado de GLUT comenzando por GLUT_WINDOW_ devuelven el estado para la ventana actual. Nombres de estado de GLUT comenzando por GLUT_MENU_ devuelven el estado para el menú actual. Otros nombres de estado de GLUT devuelven un estado global. El pedir un estado para un nombre de estado inválido de GLUT devuelve un uno negativo.

55. glutLayerGet

int glutLayerGet(GLenum info);

glutLayerGet obtiene la información de la capa GLUT para la ventana actual representada por enteros. El parámetro info determina qué tipo de información de capa hay que devolver.

56. glutDeviceGet

int glutDeviceGet(GLenum info);

glutDeviceGet obtiene información de dispositivos GLUT representados por enteros. El parámetro info determina qué tipo de información de dispositivo hay que devolver. El pedir la información de dispositivo para una información de dispositivo GLUT inválida devuelve un uno negativo.

57. glutGetModifiers

int glutGetModifiers(void);

glutGetModifiers devuelve el estado de las teclas modificadoras al momento en el cual un evento de entrada para el teclado, especial o Mouse se genera. Esta rutina sólo puede ser llamada mientras se maneja el teclado, especial o el Mouse. Al sistema de ventana le es permitido interceptar teclas modificadoras definidas para el sistema de ventana o botones de Mouse, en cuyo caso, no se generará ningún callback GLUT. Esta intercepción es independiente al uso de glutGetModifiers.

58. glutExtensionSupported

int glutExtensionSupported(char *extension);

glutExtensionSupported ayuda a determinar fácilmente si una extensión de OpenGL dada está soportada o no. El parámetro extensión da nombre al query de extensión. Las extensiones soportadas tambien pueden ser determinadas con glGetString (GL_EXTENSIONS), pero glutExtensionSupported reconoce el parking correcto de la cadena devuelta.

glutExtensionSupported devuelve un no-cero si la extensión es soportada y cero si no lo es.Debe haber una ventana actual válida para llamar a glutExtensionSupported.glutExtensionSupported sólo devuelve información de extensiones soportadas por OpenGLO. Esto significa que los sistemas de ventana dependientes de extensiones (por ejemplo, extensiones GLX) no se reportan en glutExtensionSupported.

59. glutBitmapCharacter

Renderiza un caracter usando OpenGL. Permite mostrar en la pantalla un caracter con algún tipo de fuente que se le asigne.

void glutBitmapCharacter(void *font, int character);

fontTipo de Fuente para el caracter que se va a utilizarcharacterCaracter a renderizar.

Las Fuentes disponibles para glutBitmapCharacter son:GLUT_BITMAP_8_BY_13-misc-fixed-medium-r-normal--13-120-75-75-C-80-iso8859-1GLUT_BITMAP_9_BY_15-misc-fixed-medium-r-normal--15-140-75-75-C-90-iso8859-1GLUT_BITMAP_TIMES_ROMAN_10-adobe-times-medium-r-normal--10-100-75-75-p-54-iso8859-1GLUT_BITMAP_TIMES_ROMAN_24-adobe-times-medium-r-normal--24-240-75-75-p-124-iso8859-1GLUT_BITMAP_HELVETICA_10-adobe-helvetica-medium-r-normal--10-100-75-75-p-56-iso8859-1GLUT_BITMAP_HELVETICA_12-adobe-helvetica-medium-r-normal--12-120-75-75-p-67-iso8859-1GLUT_BITMAP_HELVETICA_18-adobe-helvetica-medium-r-normal--18-180-75-75-p-98-iso8859-1La representación de un carácter que no existe no tiene ningún efecto.

60. glutBitmapWidth

Devuelve el valor del ancho de un caracter en píxeles.

int glutBitmapWidth(GLUTbitmapFont font, int character)

fontTipo de Fuente para el caracter que se va a utilizarcaracterCaracter a devolver el ancho.

Mientras que el ancho de los caracteres en una fuente puede variar, las características de la altura máxima de una fuente en particular son fijas.

61. glutStrokeCharacter

Renderiza un Stroke Caracter(Caracter de tipo a mano alzada)

void glutStrokeCharacter(void *font, int character);

font

Fuente a utilizarcharacterCaracter a renderizar.

Las Fuentes disponibles para esta función son las siguientes:

GLUT_STROKE_ROMANRoman Simple Espaciada Proporcionadamente. El máximo alto de los caracteres en esta fuente es de 119.05 unidades.GLUT_STROKE_MONO_ROMANRoman Simple monoespaciada. El máximo alto de los caracteres en esta fuente es de 119.05 unidades. Cada caracter es de 104.76 unidades de ancho.

62. glutStrokeWidthDevuelve el valor de el ancho de un Stroke caracter en píxeles.

int glutStrokeWidth(GLUTstrokeFont font, int character)fontFuente a utilizarcharacterCaracter a devolver el ancho.

Mientras que el ancho de los caracteres en una fuente puede variar, las características de la altura máxima de una fuente en particular son fijas.

63. glutSolidSphere, glutWireSphere

Renderiza una esfera sólida o de tipo de conexiones de líneas respectivamente.

void glutSolidSphere(GLdouble radius, GLint slices, GLint stacks);void glutWireSphere(GLdouble radius, GLint slices, GLint stacks);radiusRadio de la esferaslicesNumero de subdivisions alrededor del eje Z(similar a líneas de longitud)stacksNumero de subdivisions a lo largo del eje Z(similar a líneas de latitud)

64. glutSolidCube, glutWireCube

Renderiza un cubo sólido (glutSolidCube) o de tipo de conexiones de líneas (glutWireCube) respectivamente.

void glutSolidCube(GLdouble size);void glutWireCube(GLdouble size);

El cubo es centrado el origen de los coordenadas del modelado con los lados del tamaño de la longitud.

65. glutSolidCone, glutWireCone

Renderiza un cono sólido (glutSolidCone) o de tipo de conexiones de líneas(glutWireCone) respectivamente.

void glutSolidCone(GLdouble base, GLdouble height, GLint slices, GLint stacks);void glutWireCone(GLdouble base, GLdouble height, GLint slices, GLint stacks);

baseEl radio de la base del conoheightEl alto del conoslicesNúmero de subdivisiones alrededor del eje ZstacksNúmero de subdivisions a lo largo del eje Z

66. glutSolidTorus, glutWireTorus

Renderiza una dona sólida (glutSolidTorus) o de tipo de conexiones de líneas (glutWireTorus) respectivamente.

void glutSolidTorus(GLdouble innerRadius, GLdouble outerRadius, GLint nsides, GLint rings);void glutWireTorus(GLdouble innerRadius, GLdouble outerRadius, GLint nsides, GLint rings);

innerRadiusRadio interno de la dona.outerRadiusRadio Externo de la donainsidesNumero de lados por cada sección radialringsNúmero de divisiones radiales para la dona

La dona es centrada el origen de los coordenadas del modelado cuyos ejes son alineados con el eje Z.

67. glutSolidDodecahedron, glutWireDodecahedronRenderiza un dodecaedro(doce lados) sólido (glutSolidDodecahedron) o de tipo de conexiones de líneas (glutWireDodecahedron) respectivamente.void glutSolidDodecahedron(void);void glutWireDodecahedron(void);La imagen es centrada en el origen de las coordenadas del modelo con un radio de 3^1/3.68. glutSolidOctahedron, glutWireOctahedronRenderiza un octaedro(ocho lados) sólido ( glutSolidOctahedron) o de tipo de conexiones de líneas (glutWireDoOctahedron) respectivamente.void glutSolidOctahedron(void);void glutWireOctahedron(void);La imagen es centrada en el origen de las coordenadas del modelo con un radio de 1.69. glutSolidTetrahedron, glutWireTetrahedronRenderiza un tetraedro(cuatro lados) sólido ( glutSolidTetrahedron) o de tipo de conexiones de líneas (glutWireTetrahedron) respectivamente.void glutSolidTetrahedron(void);void glutWireTetrahedron(void);La imagen es centrada en el origen de las coordenadas del modelo con un radio de 3^1/3.70. glutSolidIcosahedron, glutWireIcosahedronRenderiza un icosaedro(veinte lados) sólido ( glutSolidIcosahedron) o de tipo de conexiones de líneas (glutWireDoIcosahedron) respectivamente.void glutSolidIcosahedron(void);void glutWireIcosahedron(void);La imagen es centrada en el origen de las coordenadas del modelo con un radio de 1.11.9 glutSolidTeapot, glutWireTeapot

Renderiza una figura en forma de tetera ya sea sólida (glutSolidTeapot) o de tipo de conexiones de líneas(glutWireTeapot).

void glutSolidTeapot(GLdouble size);void glutWireTeapot(GLdouble size);

sizeTamaño relativo de la TeteraTanto las coordenadas de la superficie normal como la textura son generadas. La tetera se genera con los evaluadores de OpenGL.