Previo - Práctica 6

A continuación se presentan las explicaciones de los comandos de la librería Glut y, adicionalmente, los códigos referentes al despliegue de mi nombre utilizando glutBitMapCharacter, glutBitMapStroke, ambas con ampliación y disminución de tamaño por funciones del Mouse, así como un cronómetro que también funciona basándose en los botones del Mouse.

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.

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.

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

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

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.

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.

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.

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.

glutPostRedisplay

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

Mark the normal plane of current window as needing to be redisplayed. The next iteration through glutMainLoop, the window's display callback will be called to redisplay the window's normal plane. Multiple calls to glutPostRedisplay before the next display callback opportunity generates only a single redisplay callback. glutPostRedisplay may be called within a window's display or overlay display callback to re-mark that window for redisplay.

Logically, normal plane damage notification for a window is treated as a glutPostRedisplay on the damaged window. Unlike damage reported by the window system, glutPostRedisplay will not set to true the normal plane's damaged status (returned by glutLayerGet(GLUT_NORMAL_DAMAGED).

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.

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.

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.

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ó está definida sólo para ventanas de alto nivel. Al igual que las dos instrucciones anteriores, no se procesa inmediatamente.

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.

6.9 glutAttachMenu, glutDetachMenu

Uso

void glutAttachMenu(int botón);

void glutDetachMenu(int botón);

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

Descripción:

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.

7.1 glutDisplayFunc

Uso

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

func .- la nueva función de display

Descripción:

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.

7.2 glutOverlayDisplayFunc

Uso

void glutOverlayDisplayFunc(void (*func)(void));

func.- la nueva función overlay display callback.

Descripción:

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.

7.3 glutReshapeFunc

Uso

void glutReshapeFunc(void (*func)(int largo, int alto));

func.- la nueva función redimensionamiento

Descripción

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.

7.4 glutKeyboardFunc

Uso

void glutKeyboardFunc(void (*func)(unsigned char tecla,

                                   int x, int y));

func.- la nueva función de teclado

Descripción

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.

7.5 glutMouseFunc

Uso

void glutMouseFunc(void (*func)(int botón, int estado,

                                int x, int y));

func.- la nueva función del mouse

Description

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.

7.6 glutMotionFunc, glutPassiveMotionFunc

Uso

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

Descripción

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.

7.7 glutVisibilityFunc

Uso

void glutVisibilityFunc(void (*func)(int estado));

func.- la nueva función de visibilidad

Descripción

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.

7.8 glutEntryFunc

Uso

void glutEntryFunc(void (*func)(int estado));

func.- la nueva función de entrada

Description

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.

7.9 glutSpecialFunc

Uso

void glutSpecialFunc(void (*func)(int tecla, int x, int y));

func .- la nueva función de entrada

Description

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

7.10 glutSpaceballMotionFunc

Uso

void glutSpaceballMotionFunc(void (*func)(int x, int y, int z));

func .- la nueva entrada para la función

Description

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

7.11 glutSpaceballRotateFunc

Uso

void glutSpaceballRotateFunc(void (*func)(int x, int y, int z));

func.- la nueva entrada para la función

Description

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

7.12 glutSpaceballButtonFunc

Uso

void glutSpaceballButtonFunc(void (*func)(int botón, int estado));

func.- la nueva entrada para la función

Descripció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

7.13. glutButtonBoxFunc

Uso: 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.

7.14. glutDialsFunc

Uso: 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.

7.15. glutTabletMotionFunc

Uso: 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.

7.16. glutTabletButtonFunc

Uso: 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.

7.17. glutMenuStatusFunc

Uso: 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.

7.18. glutIdleFunc

Uso: 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.

7.19. glutTimerFunc

Uso: 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.

8.1. glutSetColor

Uso: 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.

8.2. glutGetColor

Uso: 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.

8.3. glutCopyColormap

Uso: 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.

9.1. glutGet

Uso: 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.

9.2. glutLayerGet

Uso: 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.

9.3. glutDeviceGet

Uso: 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.

9.4. glutGetModifiers

Uso: 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.

9.5. glutExtensionSupported

Uso: 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. 

10.1 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 caracter que no existe no tiene ningún efecto.

10.2 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.

10.3 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.

10.4 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.

11.1 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)

11.2 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.

11.3 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

11.4 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.

11.5 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 .

11.6 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.

11.7 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 .

11.8 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.

/*Programa que despliega el nombre de su servilleta en una ventana, el cual

puede ser cambiado de tamaño por medio de los botones izquierdo y derecho del

mouse. Debido a las limitaciones de glutBitMapCharacter, tan sólo existen

dos tamaños disponibles*/

#include

#include

/*Función que sirve para asignar un tipo de fuente a las cadenas de caracteres

a ser desplegadas.*/

void *font = GLUT_BITMAP_TIMES_ROMAN_24;

void *fonts[] =

{

GLUT_BITMAP_TIMES_ROMAN_10,

GLUT_BITMAP_TIMES_ROMAN_24

};

/*Función utilizada para desplegar el texto.*/

void output(int x, int y, char *string)

{

int len, i;

glRasterPos2f(x, y);

len = (int) strlen(string);

for (i = 0; i <>

glutBitmapCharacter(font, string[i]);

}

}

void

display(void)

{

glClear(GL_COLOR_BUFFER_BIT);

output(100, 100, "Rafael Mesa.");

glutSwapBuffers();

}

/*Función utilizada para los controles del mouse.*/

void processMouse(int button, int state, int x, int y) {

if (state == GLUT_DOWN) {

if (button == GLUT_LEFT_BUTTON) {

font = GLUT_BITMAP_TIMES_ROMAN_10;

glutPostRedisplay();

}

else if (button == GLUT_RIGHT_BUTTON){

font = GLUT_BITMAP_TIMES_ROMAN_24;

glutPostRedisplay();

}

}

}

void

reshape(int w, int h)

{

glViewport(0, 0, w, h);

glMatrixMode(GL_PROJECTION);

glLoadIdentity();

gluOrtho2D(0, w, h, 0);

glMatrixMode(GL_MODELVIEW);

}

int main(int argc, char **argv)

{

glutInitDisplayMode(GLUT_DOUBLE | GLUT_RGB);

glutInitWindowSize(500, 150);

glutCreateWindow(argv[0]);

glClearColor(0.0, 0.0, 0.0, 1.0);

glutDisplayFunc(display);

glutReshapeFunc(reshape);

glutMouseFunc(processMouse);

glutMainLoop();

return 0;

}

/*Programa que despliega el nombre de su servilleta en una ventana, el cual

puede ser cambiado de tamaño por medio de los botones izquierdo y derecho del

mouse.*/

#include

#include

#include

#include

/*Variable global que servirá para el escalamiento de los caracteres desplegados

con glutStrokeCharacter.*/

static float esca = 0.003;

/*Función que sirve para desplegar una cadena de caracteres utilizando el comando

glutStrokeCharacter.*/

void stroke_output(GLfloat x, GLfloat y, char *format,...)

{

va_list args;

char buffer[200], *p;

va_start(args, format);

vsprintf(buffer, format, args);

va_end(args);

glPushMatrix();

glTranslatef(x, y, 0);

glScalef((GLfloat)esca, (GLfloat)esca, (GLfloat)esca);

for (p = buffer; *p; p++)

glutStrokeCharacter(GLUT_STROKE_ROMAN, *p);

glPopMatrix();

}

void

display(void)

{

glClear(GL_COLOR_BUFFER_BIT);

glMatrixMode(GL_PROJECTION);

glPushMatrix();

glLoadIdentity();

gluPerspective(40.0, 1.0, 0.1, 20.0);

glMatrixMode(GL_MODELVIEW);

glPushMatrix();

gluLookAt(0.0, 0.0, 4.0, 0.0, 0.0, 0.0, 0.0, 1.0, 0.);

glPushMatrix();

glTranslatef(0, 0, -4);

stroke_output(-1.5, 0, "Rafael Mesa");

glPopMatrix();

glMatrixMode(GL_MODELVIEW);

glPopMatrix();

glMatrixMode(GL_PROJECTION);

glPopMatrix();

glMatrixMode(GL_MODELVIEW);

glFlush();

}

/*Función que permite hacer el texto más grande o más chico con los

botones del mouse.*/

void processMouse(int button, int state, int x, int y) {

if (state == GLUT_DOWN) {

if (button == GLUT_LEFT_BUTTON) {

esca = esca - 0.0002;

glutPostRedisplay();

}

else if (button == GLUT_RIGHT_BUTTON){

esca = esca + 0.0002;

glutPostRedisplay();

}

}

}

void

reshape(int w, int h)

{

glViewport(0, 0, w, h);

glMatrixMode(GL_PROJECTION);

glLoadIdentity();

gluOrtho2D(0, w, 0, h);

glScalef(1, -1, 1);

glTranslatef(0, -h, 0);

glMatrixMode(GL_MODELVIEW);

}

int

main(int argc, char **argv)

{

glutInit(&argc, argv);

glutInitDisplayMode(GLUT_SINGLE | GLUT_RGB);

glutInitWindowSize(600, 350);

glutCreateWindow(argv[0]);

glClearColor(1.0, 1.0, 1.0, 1.0);

glColor3f(0, 0, 0);

glLineWidth(1.0);

glutDisplayFunc(display);

glutMouseFunc(processMouse);

glutReshapeFunc(reshape);

glutMainLoop();

return 0;

}

/*Programa que despliega el nombre de su servilleta en una ventana, el cual

puede ser cambiado de tamaño por medio de los botones izquierdo y derecho del

mouse. Debido a las limitaciones de glutBitMapCharacter, tan sólo existen

dos tamaños disponibles*/

#include

#include

/*Variables globales que representan los segundos, minutos y horas, expresados

en int y char para ser desplegados con la función glutBitMapCharacter. El entero

bandera funciona como un interruptor para el comando glutTimerFunc.*/

static int seg = 0;

static int min = 0;

static int hor = 0;

static char segundo[5];

static char minuto[5];

static char hora[5];

static int bandera = 1;

/*Función que sirve para asignar un tipo de fuente a las cadenas de caracteres

a ser desplegadas.*/

void *font = GLUT_BITMAP_TIMES_ROMAN_24;

void *fonts[] =

{

GLUT_BITMAP_TIMES_ROMAN_10,

GLUT_BITMAP_TIMES_ROMAN_24

};

/*Función utilizada para desplegar el texto.*/

void output(int x, int y, char *string)

{

int len, i;

glRasterPos2f(x, y);

len = (int) strlen(string);

for (i = 0; i <>

glutBitmapCharacter(font, string[i]);

}

}

/*Función utilizada para modificar los valores de las variables

globales utilizadas para representar los minutos, segundos y horas

en el cronómetro.*/

void cronometro(){

if ((GLint)bandera == 1){

seg = seg + 1;

glutPostRedisplay();

if (seg == 60){

seg = 0;

min = min + 1;

glutPostRedisplay();

if (min == 60){

min = 0;

hor = hor + 1;

glutPostRedisplay();

if (hor == 24){

hor = 0;

glutPostRedisplay();

}

}

}

glutTimerFunc(1000, cronometro, (GLint)bandera);

}

else {

}

}

void display(void)

{

glClear(GL_COLOR_BUFFER_BIT);

itoa(seg, segundo, 10);

output(300, 100, segundo);

output(285, 100, ":");

itoa(min, minuto, 10);

output(255, 100, minuto);

output(240, 100, ":");

itoa(hor, hora, 10);

output(210, 100, hora);

glutSwapBuffers();

}

/*Función utilizada para los controles del mouse.*/

void processMouse(int button, int state, int x, int y) {

if (state == GLUT_DOWN) {

if (button == GLUT_LEFT_BUTTON) {

seg = 0;

min = 0;

hor = 0;

glutPostRedisplay();

}

else if (button == GLUT_RIGHT_BUTTON){

(GLint)bandera = 0;

glutPostRedisplay();

}

}

if (state == GLUT_UP) {

if (button == GLUT_RIGHT_BUTTON){

(GLint)bandera = 1;

glutPostRedisplay();

glutTimerFunc(1000, cronometro, (GLint)bandera);

}

}

}

void

reshape(int w, int h)

{

glViewport(0, 0, w, h);

glMatrixMode(GL_PROJECTION);

glLoadIdentity();

gluOrtho2D(0, w, h, 0);

glMatrixMode(GL_MODELVIEW);

}

int main(int argc, char **argv)

{

glutInitDisplayMode(GLUT_DOUBLE | GLUT_RGB);

glutInitWindowSize(500, 150);

glutCreateWindow(argv[0]);

glClearColor(0.0, 0.0, 0.0, 1.0);

glutDisplayFunc(display);

glutReshapeFunc(reshape);

glutMouseFunc(processMouse);

glutTimerFunc(1000, cronometro, (GLint)bandera); //Comando que utiliza la función cronómetro al inicio para comenzar la cuenta.

glutMainLoop();

return 0;

}