Xlib

Xlib y otras bibliotecas que la utilizan.

Los tipos de datos principales en Xlib están en la estructura Display[2] y en los tipos de los identificadores.

Display, que viene del inglés y en español es pantalla, informalmente significa un dispositivo físico o virtual donde se realizan las operaciones gráficas. La estructura Display en la biblioteca Xlib contiene información acerca de la pantalla, aunque también contiene información acerca del canal entre el cliente y el servidor gráfico. Por ejemplo, en un sistema operativo unix-like, la estructura Display contiene un manipuladar de archivo del socket de ese canal (que se puede recuperar usando la macro ConnectionNumber.) La mayoría de las funciones de Xlib tienen una estructura Display como uno de los argumentos para permitirle operar en un canal en específico. En particular, todas las funciones de Xlib que interactúan con el servidor gráfico necesitan de esta estructura para acceder al canal. Algunas otras funciones necesitan de esta estructura, aunque operen localmente, porque operan sobre datos relativos a un canal en específico. Operaciones de esta clase incluyen por ejemplo operaciones sobre una cola de mensajes.

El servidor maneja las ventanas, los mapas de color, etc., lo cual significa que los datos acerca de su implementación se almacenan en el servidor. El cliente opera sobre esos objetos utilizando identificadores. El cliente no puede actuar directamente sobre un objeto, solo puede pedírselo únicamente al servidor para que éste realice la operación especificada por el identificador de un objeto.

Los tipos Windows, Pixmap, Font, Colormap, etc. son todos identificadores, los cuales son enteros de 32 bits (como los del mismo protocolo X11). Un cliente "crea" una ventana haciendo un pedido al servidor. Esto se realiza haciendo una llamada a una función de Xlib que devuelve un identificador para la ventana, que es, un número. El identificador puede ser usado por el cliente para poder realizar otras operaciones sobre la misma ventana en el servidor.

Los identificadores son únicos para el servidor. La mayoría pueden ser utilizados por diferentes aplicaciones para hacer referencia a los mismos objetos. Por ejemplo, dos aplicaciones se conectan al mismo servidor usando el mismo identificador para referirse a la misma ventana. Estas dos aplicaciones pueden utilizar dos canales diferentes, y tener dos diferentes estructuras Display; sin embargo, cuando hagan un pedido de operación con el mismo identificador, estas se harán sobre el mismo objeto.

Proporcionan a una aplicación la posibilidad de: abrir una presentación X, crear ventanas y escribir en ellas, recuperar eventos y cerrar la presentación. Casi todas las funciones se ejecutan de forma asíncrona y son peticiones enviadas a un buffer de salida. Para el trabajo en modo síncrono se requiere de Xsync tras la función de Xlib que se quiere ejecutar en modo síncrono.

Las funciones de la biblioteca Xlib pueden agruparse en:

1. operaciones de conexión (XOpenDisplay, XCloseDisplay,...);
2. requerimientos al servidor, incluyendo requerimientos para operaciones (XCreateWindow, XCreateGC,...) y requerimientos de información (XGetWindowProperty,...); y
3. operaciones del cliente: de eventos (XNextEvent, XPeekEvent,...) y otras operaciones de datos locales (XLookupKeysym, XParseGeometry, XSetRegion, XCreateImage, XSaveContext,...)

# include <X11/Xlib.h>
# include <X11/Xutil.h>
# include <X11/Xos.h>

El protocolo X tiene una arquitectura cliente/servidor. Se pueden transferir cuatro tipos de paquetes mediante este protocolo:

1. Peticiones: el cliente solicita algo al servidor.
2. Réplicas: las envía el servidor al cliente para responderle a determinadas peticiones.
3. Eventos: el servidor se los envía al cliente y el cliente indicará para cada ventana que eventos quieren recibir.
4. Errores: los envía el servidor

Casi todas las rutinas en Xlib son peticiones. Xlib encola dichas peticiones con lo que el cliente puede continuar ejecutándose. Esto se debe a que la gran parte de las llamadas a Xlib no requieren de una respuesta inmediata. Si hay algún problema: buffer lleno, petición de evento,… las peticiones que quedarán en el buffer y no se enviarán al servidor. Xlib envía el buffer al completo en las siguientes situaciones:

1. Cuando una aplicación llama a una rutina que espera un evento y la cola de eventos no contiene ninguno del tipo que se solicitó
2. En los caso de las rutinas Query, Fetch o Get. Pues se requiere la información del servidor inmediatamente.
3. Se envía manualmente el buffer con: Xflush (Display *d) (vacía el buffer de peticiones y las envía al servidor) o Xsync (Display *d Bool discardEvents) (vacía el buffer de salida y espera a que las peticiones sean atendidas por el servidor X)

Resultado del código de Ejemplo

El siguiente programa crea una ventana con un pequeño cuadrado negro dentro:

 /*
   Aplicación simple que usa Xlib, una ventana con un cuadrado negro en su interior
 */

 #include <X11/Xlib.h>
 #include <stdio.h>
 #include <stdlib.h>
 #include <string.h>

 int main(void) {
   Display *d;
   Window w;
   XEvent e;
   char *msg = "¡Hola, Mundo!";
   int s;

                        /* abrir la conexión con el servidor gráfico*/
   d = XOpenDisplay(NULL);
   if (d == NULL) {
     fprintf(stderr, "No se pudo conectar al servidor gráfico\n");
     exit(1);
   }

   s = DefaultScreen(d);

                        /* crea la ventana */
   w = XCreateSimpleWindow(d, RootWindow(d, s), 10, 10, 100, 100, 1,
                           BlackPixel(d, s), WhitePixel(d, s));

                        /* selecciona la clase de eventos que interesan */
   XSelectInput(d, w, ExposureMask | KeyPressMask);

                        /* muestra la ventana */
   XMapWindow(d, w);

                        /* lazo de eventos */
   while (1) {
     XNextEvent(d, &e);
                        /* dibujar o redibujar la ventana */
     if (e.type == Expose) {
       XFillRectangle(d, w, DefaultGC(d, s), 20, 20, 10, 10);
       XDrawString(d, w, DefaultGC(d, s), 50, 50, msg, strlen(msg));
     }
                        /* salir si se presionó una tecla */
     if (e.type == KeyPress)
       break;
   }

                        /* cerrar la conexión al servidor gráfico */
   XCloseDisplay(d);

   return 0;
 }

El cliente crea una conexión con el servidor llamando a la función XOpenDisplay(línea 18). Luego pide la creación de la ventana con XCreateSimpleWindow(línea 27). Una llamada más, a XMapWindow(línea 34), se necesita para mapear la ventana en la pantalla, es decir para que sea visible.

El cuadrado se dibuja llamando a XFillRectangle(línea 41). Esta operación solo puede realizarse cuando la ventana se crea. Sin embargo una vez realizado esto no es suficiente, de hecho, el contenido de la ventana no siempre está garantizado que se preserve. Por ejemplo, si la ventanta es cubierta o descubierta, se necesita que su contenido sea redibujado. El programa está informado de que la ventana o parte de ella debe dibujarse o redibujarse mediante la recepción de un evento Expose(línea 40).

El redibujado del contenido está dentro de un lazo para eventos. Antes que entre a este lazo, se establece la clase de eventos de la aplicación, en este caso se realiza con la llamada a XSelectInput(línea 31). El lazo de evento (entre líneas 37 y 47) espera por la llegada de un evento: si el evento es una tecla presionada, la aplicación termina; si el evento es Expose, se redibuja el contenido de la ventana. La función XNextEvent(línea 38) bloquea y vuelca el buffer requerido si no hay ningún evento en la cola.

Xlib provee lo fundamental para interactuar con el servidor X, pero utilizar sólo Xlib puede llegar a ser muy complicado. Por ello, se han ido construyendo interfaces de más alto nivel como: Xt (X Toolkit Intrinsics) y sus derivados (Motif y Xaw), Qt o GTK+.

La biblioteca de XCB está recomendada por X.Org como reemplazo de Xlib, ya que provee un acceso de bajo nivel más eficiente y simple, y no se recomienda el uso de Xlib para nuevos desarrollos.[3]

• X Window System
• Protocolo base de X Window System
• Protocolos y arquitectura de X Window System

• Xlib Programming Manual for Version 11. X Window System (en inglés)
• Artículo sobre xLib y XCB (en inglés)
• Programación en X Window System
• Low-level access to the X11 library Módulo en Perl para acceso a Xlib.
• Python X Library Biblioteca en python para X Window System, que no implementa una interfaz con xlib.