Está en la página 1de 15

API GLUT Completa

1. 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_RGBA
GLUT_RGB 
GLUT_INDEX
GLUT_SINGLE
GLUT_DOUBLE
GLUT_ACCUM
GLUT_ALPHA
GLUT_DEPTH
GLUT_STENCIL
GLUT_MULTISAMPLE
GLUT_STEREO
GLUT_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 ventana
10. glutSwapBuffers
void 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. glutPositionWindow
void 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. glutReshapeWindow
void 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. glutFullScreen
void 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 glutPushWindow
void 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 ventana


glutSetIconTitle pone la barra de título en la ventana minimizada

17. glutSetCursor

void glutSetCursor(int cursor);

cursor
Nombre de la imagen del cursor a cambiar.
GLUT_CURSOR_RIGHT_ARROW
Flecha que señala encima y a la derecha.
GLUT_CURSOR_LEFT_ARROW
Flecha que señala encima y a la izquierda.
GLUT_CURSOR_INFO
Señalador de mano.
GLUT_CURSOR_DESTROY
Cráneo y huesos encrusijados.
GLUT_CURSOR_HELP
Marca de pregunta.
GLUT_CURSOR_CYCLE
Flecha que está rotando en un círculo.
GLUT_CURSOR_SPRAY
Lata de aerosol.
GLUT_CURSOR_WAIT
Reloj.
GLUT_CURSOR_TEXT
Cursor para apuntar a la insercion de texto.
GLUT_CURSOR_CROSSHAIR
Cortador.
GLUT_CURSOR_UP_DOWN
Puntero bidireccional arriba y abajo.
GLUT_CURSOR_LEFT_RIGHT
Puntero bidireccional izquierda y derecha
GLUT_CURSOR_TOP_SIDE
Flecha que upunta a un lado superior.
GLUT_CURSOR_BOTTOM_SIDE
Flecha que apunta a un lado inferior.
GLUT_CURSOR_LEFT_SIDE
Flecha que apunta a un lado izquierdo.
GLUT_CURSOR_RIGHT_SIDE
Flecha que apunta a un lado derecho.
GLUT_CURSOR_TOP_LEFT_CORNER
Flecha que apunta a la esquina superior izquierda.
GLUT_CURSOR_TOP_RIGHT_CORNER
Flecha que apunta a la esquina superior derecha.
GLUT_CURSOR_BOTTOM_RIGHT_CORNER
Flecha que apunta a la esquina inferior izquierda.
GLUT_CURSOR_BOTTOM_LEFT_CORNER
Flecha que apunta a la esquina inferior derecha.
GLUT_CURSOR_FULL_CROSSHAIR
Cursor de pantalla completa del cortador.
GLUT_CURSOR_NONE
Cursor invisible.
GLUT_CURSOR_INHERIT
Uso 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);

layer
Cualquier 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));

func
La 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);

menu
El 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);

menu
El 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);

name
Cadena de caracteres ASCII a desplegar en la entrada del menu.
value
Valor 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);

name
Cadena de caracteres ASCII a desplegar en el objeto menu del cual se deriva el sub-menu.
menu
Identificador 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ú).
name
Cadena de caracteres ASCII a desplegar en la entrada del menú.
value
Valor 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ú).
name
Cadena de caracteres ASCII a desplegar en la entrada del menú.
value
Valor 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ón
El 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));

func
La 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 llamada
GLUT 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. glutOverlayDisplayFunc
void 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. glutReshapeFunc
void glutReshapeFunc(void (*func)(int largo, int alto));
func
La 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. glutKeyboardFunc
void 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. glutMouseFunc
void 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, glutPassiveMotionFunc
void glutMotionFunc(void (*func)(int x, int y));
void glutPassiveMotionFunc(void (*func)(int x, int y));

func
La nueva función de movimiento o movimiento pasivo
glutMotionFunc 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. glutVisibilityFunc
void glutVisibilityFunc(void (*func)(int estado));
func
La nueva función de visibilidad
glutVisibilityFunc 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));
func
La nueva función de entrada
glutEntryFunc 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. glutSpecialFunc
void glutSpecialFunc(void (*func)(int tecla, int x, int y));

func
La nueva función de entrada
glutSpecialFunc 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_F1
Tecla F1
GLUT_KEY_F2
Tecla F2 
GLUT_KEY_F3
Tecla F3 
GLUT_KEY_F4
Tecla F4 
GLUT_KEY_F5
Tecla F5 
GLUT_KEY_F6
Tecla F6 
GLUT_KEY_F7
Tecla F7
GLUT_KEY_F8
Tecla F8 
GLUT_KEY_F9
Tecla F9 
GLUT_KEY_F10
Tecla F10
GLUT_KEY_F11
Tecla F11
GLUT_KEY_F12
Tecla F12.
GLUT_KEY_LEFT
Tecla de dirección izquierda
GLUT_KEY_UP
Tecla de dirección arriba
GLUT_KEY_RIGHT
Tecla de dirección derecha
GLUT_KEY_DOWN
Tecla de dirección abajo
GLUT_KEY_PAGE_UP
Tacla de avance de página.
GLUT_KEY_PAGE_DOWN
Tacla de retroceso de página
GLUT_KEY_HOME
Tecla de inicio
GLUT_KEY_END
Tecla de fin
GLUT_KEY_INSERT
Tecla de imsertar
Note que las teclas de escape, suprimir y borrar generan un código ASCII , por lo tanto no son teclas especiales
41. glutSpaceballMotionFunc
void glutSpaceballMotionFunc(void (*func)(int x, int y, int z));
func
La nueva entrada para la función
glutSpaceballMotionFunc 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 libertad
42. glutSpaceballRotateFunc
void glutSpaceballRotateFunc(void (*func)(int x, int y, int z));

func
La nueva entrada para la función
glutSpaceballRotateFunc 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 libertad
43. glutSpaceballButtonFunc
void glutSpaceballButtonFunc(void (*func)(int botón, int estado));
func
La nueva entrada para la función
glutSpaceballButtonFunc 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 libertad
44. 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);

font
Tipo de Fuente para el caracter que se va a utilizar
character
Caracter 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-1
GLUT_BITMAP_9_BY_15
-misc-fixed-medium-r-normal--15-140-75-75-C-90-iso8859-1
GLUT_BITMAP_TIMES_ROMAN_10
-adobe-times-medium-r-normal--10-100-75-75-p-54-iso8859-1
GLUT_BITMAP_TIMES_ROMAN_24
-adobe-times-medium-r-normal--24-240-75-75-p-124-iso8859-1
GLUT_BITMAP_HELVETICA_10
-adobe-helvetica-medium-r-normal--10-100-75-75-p-56-iso8859-1
GLUT_BITMAP_HELVETICA_12
-adobe-helvetica-medium-r-normal--12-120-75-75-p-67-iso8859-1
GLUT_BITMAP_HELVETICA_18
-adobe-helvetica-medium-r-normal--18-180-75-75-p-98-iso8859-1
La 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)

font
Tipo de Fuente para el caracter que se va a utilizar
caracter
Caracter 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 utilizar
character
Caracter a renderizar.

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

GLUT_STROKE_ROMAN
Roman Simple Espaciada Proporcionadamente. El máximo alto de los caracteres en esta fuente es de 119.05
unidades.
GLUT_STROKE_MONO_ROMAN
Roman 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. glutStrokeWidth
Devuelve el valor de el ancho de un Stroke caracter en píxeles.

int glutStrokeWidth(GLUTstrokeFont font, int character)


font
Fuente a utilizar
character
Caracter 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);
radius
Radio de la esfera
slices
Numero de subdivisions alrededor del eje Z(similar a líneas de longitud)
stacks
Numero 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);

base
El radio de la base del cono
height
El alto del cono
slices
Número de subdivisiones alrededor del eje Z
stacks
Nú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);

innerRadius
Radio interno de la dona.
outerRadius
Radio Externo de la dona
insides
Numero de lados por cada sección radial
rings
Nú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, glutWireDodecahedron


Renderiza 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, glutWireOctahedron
Renderiza 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, glutWireTetrahedron
Renderiza 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, glutWireIcosahedron
Renderiza 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);

size
Tamaño relativo de la Tetera
Tanto las coordenadas de la superficie normal como la textura son generadas. La tetera se genera con los
evaluadores de OpenGL.

También podría gustarte