gp_x11.h File Reference

A X11 backend. More...

#include <backends/gp_backend.h>

Go to the source code of this file.

Enumerations
enum	gp_x11_flags { GP_X11_USE_ROOT_WIN = 0x01 , GP_X11_CREATE_ROOT_WIN = 0x02 , GP_X11_FULLSCREEN = 0x04 , GP_X11_DISABLE_SHM = 0x08 }
	A X11 backend init flags. More...

Functions
gp_backend *	gp_x11_init (const char *display, int x, int y, unsigned int w, unsigned int h, const char *caption, enum gp_x11_flags flags)
	X11 backend initialization.

Detailed Description

A X11 backend.

X11 backend supports multiple windows, you can call the init function multiple times, each time you get a backend representing a new X11 window that will share the underlying X11 server connection.

// SPDX-License-Identifier: GPL-2.1-or-later
/*
 * Copyright (C) 2009-2013 Cyril Hrubis <metan@ucw.cz>
 */
 
 /* X11 example with two windows. */
 
#include <stdio.h>
#include <gfxprim.h>
 
static void redraw(struct gp_pixmap *pixmap)
{
        gp_pixel white_pixel, black_pixel;
 
        black_pixel = gp_rgb_to_pixmap_pixel(0x00, 0x00, 0x00, pixmap);
        white_pixel = gp_rgb_to_pixmap_pixel(0xff, 0xff, 0xff, pixmap);
 
        gp_fill(pixmap, black_pixel);
        gp_line(pixmap, 0, 0, pixmap->w - 1, pixmap->h - 1, white_pixel);
        gp_line(pixmap, 0, pixmap->h - 1, pixmap->w - 1, 0, white_pixel);
}
 
static int ev_loop(struct gp_backend *backend, const char *name)
{
        gp_event *ev;
 
        if (backend == NULL)
                return 0;
 
        while ((ev = gp_backend_get_event(backend))) {
 
                printf("-------------------------- %s\n", name);
 
                gp_ev_dump(ev);
 
                switch (ev->type) {
                case GP_EV_KEY:
                        switch (ev->val) {
                        case GP_KEY_ESC:
                        case GP_KEY_Q:
                                gp_backend_exit(backend);
                                return 1;
                        break;
                        }
                break;
                case GP_EV_SYS:
                        switch (ev->code) {
                        case GP_EV_SYS_RESIZE:
                                gp_backend_resize_ack(backend);
                                redraw(backend->pixmap);
                                gp_backend_flip(backend);
                        break;
                        case GP_EV_SYS_QUIT:
                                gp_backend_exit(backend);
                                return 1;
                        break;
                        }
                break;
                }
 
                printf("-----------------------------\n");
        }
 
        return 0;
}
 
int main(void)
{
        gp_backend *win_1, *win_2;
 
        win_1 = gp_x11_init(NULL, 0, 0, 300, 300, "win 1", 0);
        win_2 = gp_x11_init(NULL, 0, 0, 300, 300, "win 2", 0);
 
        if (win_1 == NULL || win_2 == NULL) {
                gp_backend_exit(win_1);
                gp_backend_exit(win_2);
                return 1;
        }
 
        /* Update the windows */
        redraw(win_1->pixmap);
        redraw(win_2->pixmap);
 
        gp_backend_flip(win_1);
        gp_backend_flip(win_2);
 
        for (;;) {
                /*
                 * Wait for backend event.
                 *
                 * Either window is fine as they share connection.
                 */
                gp_backend *b = win_1 ? win_1 : win_2;
 
                if (b == NULL)
                        return 0;
 
                gp_backend_wait(b);
 
                if (ev_loop(win_1, "win 1"))
                        win_1 = NULL;
 
                if (ev_loop(win_2, "win 2"))
                        win_2 = NULL;
        }
 
        gp_backend_exit(win_1);
        gp_backend_exit(win_2);
 
        return 0;
}

Definition in file gp_x11.h.

Enumeration Type Documentation

gp_x11_flags

enum gp_x11_flags

A X11 backend init flags.

Enumerator
GP_X11_USE_ROOT_WIN	When set, w and h is ignored and root window is used.
GP_X11_CREATE_ROOT_WIN	Create new borderless window above the root window.
GP_X11_FULLSCREEN	Start fullscreen.
GP_X11_DISABLE_SHM	Do not use MIT SHM even if available.

Definition at line 22 of file gp_x11.h.

Function Documentation

gp_x11_init()

gp_backend * gp_x11_init	(	const char *	display,
		int	x,
		int	y,
		unsigned int	w,
		unsigned int	h,
		const char *	caption,
		enum gp_x11_flags	flags
	)

X11 backend initialization.

Parameters

display	A X11 display. If NULL default is used.
x	A window X offset.
y	A window Y offset.
w	A window width.
h	A window height.
caption	A window caption.
flags	A bitwise combination of enum gp_x11_flags.

Returns

A newly allocated backend, or NULL in a case of a failure, or if X11 support wasn't compiled in.