frederik
/
libxcb
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

add the complete cursor example. Make the html code valid

This commit is contained in:
TORRI Vincent 2007-02-06 09:31:54 +01:00
parent ab22a4d616
commit 6cedaece0e
2 changed files with 411 additions and 30 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

431
doc/tutorial/index.html
View File

@ -587,8 +587,8 @@ gcc -Wall prog.c -o prog `pkg-config --cflags --libs xcb`
will be the one in the environment variable DISPLAY. will be the one in the environment variable DISPLAY.
</p> </p>
<pre class="code"> <pre class="code">
<type>xcb_connection_t</type> *xcb_connect (<keyword>const</keyword> <type>char</type> *displayname, <span class="type">xcb_connection_t</span> *xcb_connect (<span class="keyword">const</span> <span class="type">char</span> *displayname,
<type>int</type> *screenp); <span class="type">int</span> *screenp);
</pre> </pre>
<p> <p>
The second parameter returns the screen number used for the The second parameter returns the screen number used for the
@ -596,24 +596,24 @@ gcc -Wall prog.c -o prog `pkg-config --cflags --libs xcb`
and is opaque. Here is how the connection can be opened: and is opaque. Here is how the connection can be opened:
</p> </p>
<pre class="code"> <pre class="code">
#<include>include</include> <string>&lt;xcb/xcb.h&gt;</string> #<span class="include">include</span> <span class="string">&lt;xcb/xcb.h&gt;</span>
<type>int</type> <span class="type">int</span>
<function>main</function> () <span class="function">main</span> ()
{ {
<type>xcb_connection_t</type> *c; <span class="type">xcb_connection_t</span> *c;
/* Open the connection to the X server. Use the DISPLAY environment variable as the default display name */ /* Open the connection to the X server. Use the DISPLAY environment variable as the default display name */
c = xcb_connect (NULL, NULL); c = xcb_connect (NULL, NULL);
<keyword>return</keyword> 0; <span class="keyword">return</span> 0;
} }
</pre> </pre>
<p> <p>
To close a connection, it suffices to use: To close a connection, it suffices to use:
</p> </p>
<pre class="code"> <pre class="code">
<type>void</type> xcb_disconnect (<type>xcb_connection_t</type> *c); <span class="type">void</span> xcb_disconnect (<span class="type">xcb_connection_t</span> *c);
</pre> </pre>
<div class="comp"> <div class="comp">
<div class="title"> <div class="title">
@ -640,8 +640,7 @@ gcc -Wall prog.c -o prog `pkg-config --cflags --libs xcb`
</ul> </ul>
</div> </div>
</div> </div>
<p> <br>
</p>
<li class="title"><a name="screen">Checking basic information about a connection</a> <li class="title"><a name="screen">Checking basic information about a connection</a>
<p> <p>
Once we have opened a connection to an X server, we should check some Once we have opened a connection to an X server, we should check some
@ -3039,18 +3038,18 @@ xcb_void_cookie_t xcb_free_pixmap (xcb_connection_t *c, /* Pointer to the
the function <span class="code">xcb_create_glyph_cursor</span>: the function <span class="code">xcb_create_glyph_cursor</span>:
</p> </p>
<pre class="code"> <pre class="code">
xcb_void_cookie_t xcb_create_glyph_cursor_checked (xcb_connection_t *c, xcb_void_cookie_t xcb_create_glyph_cursor (xcb_connection_t *c,
xcb_cursor_t cid, xcb_cursor_t cid,
xcb_font_t source_font, /* font for the source glyph */ xcb_font_t source_font, /* font for the source glyph */
xcb_font_t mask_font, /* font for the mask glyph or XCB_NONE */ xcb_font_t mask_font, /* font for the mask glyph or XCB_NONE */
uint16_t source_char, /* character glyph for the source */ uint16_t source_char, /* character glyph for the source */
uint16_t mask_char, /* character glyph for the mask */ uint16_t mask_char, /* character glyph for the mask */
uint16_t fore_red, /* red value for the foreground of the source */ uint16_t fore_red, /* red value for the foreground of the source */
uint16_t fore_green, /* green value for the foreground of the source */ uint16_t fore_green, /* green value for the foreground of the source */
uint16_t fore_blue, /* blue value for the foreground of the source */ uint16_t fore_blue, /* blue value for the foreground of the source */
uint16_t back_red, /* red value for the background of the source */ uint16_t back_red, /* red value for the background of the source */
uint16_t back_green, /* green value for the background of the source */ uint16_t back_green, /* green value for the background of the source */
uint16_t back_blue) /* blue value for the background of the source */ uint16_t back_blue) /* blue value for the background of the source */
</pre> </pre>
<p> <p>
<b>TODO</b>: Describe <span class="code">source_char</span> <b>TODO</b>: Describe <span class="code">source_char</span>
@ -3124,8 +3123,391 @@ xcb_change_window_attributes (conn, window, mask, &amp;value_list);
</p> </p>
<li class="subtitle"><a name="mousecursorexample">Complete example</a> <li class="subtitle"><a name="mousecursorexample">Complete example</a>
<p> <p>
<b>TODO</b>: to do... The following example displays a window with a
button. When entering the window, the window cursor is changed
to an arrow. When clicking once on the button, the cursor is
changed to a hand. When clicking again on the button, the
cursor window gets back to the arrow. The Esc key exits the
application.
</p> </p>
<pre class="code">
#include &lt;stdlib.h&gt;
#include &lt;stdio.h&gt;
#include &lt;string.h&gt;
#include &lt;xcb/xcb.h&gt;
#define WIDTH 300
#define HEIGHT 150
static xcb_gc_t gc_font_get (xcb_connection_t *c,
xcb_screen_t *screen,
xcb_window_t window,
const char *font_name);
static void button_draw (xcb_connection_t *c,
xcb_screen_t *screen,
xcb_window_t window,
int16_t x1,
int16_t y1,
const char *label);
static void text_draw (xcb_connection_t *c,
xcb_screen_t *screen,
xcb_window_t window,
int16_t x1,
int16_t y1,
const char *label);
static void cursor_set (xcb_connection_t *c,
xcb_screen_t *screen,
xcb_window_t window,
int cursor_id);
static void
button_draw (xcb_connection_t *c,
xcb_screen_t *screen,
xcb_window_t window,
int16_t x1,
int16_t y1,
const char *label)
{
xcb_point_t points[5];
xcb_void_cookie_t cookie_gc;
xcb_void_cookie_t cookie_line;
xcb_void_cookie_t cookie_text;
xcb_generic_error_t *error;
xcb_gcontext_t gc;
int16_t width;
int16_t height;
uint8_t length;
int16_t inset;
length = strlen (label);
inset = 2;
gc = gc_font_get(c, screen, window, "7x13");
width = 7 * length + 2 * (inset + 1);
height = 13 + 2 * (inset + 1);
points[0].x = x1;
points[0].y = y1;
points[1].x = x1 + width;
points[1].y = y1;
points[2].x = x1 + width;
points[2].y = y1 - height;
points[3].x = x1;
points[3].y = y1 - height;
points[4].x = x1;
points[4].y = y1;
cookie_line = xcb_poly_line_checked (c, XCB_COORD_MODE_ORIGIN,
window, gc, 5, points);
error = xcb_request_check (c, cookie_line);
if (error) {
fprintf (stderr, "ERROR: can't draw lines : %d\n", error->error_code);
xcb_disconnect (c);
exit (-1);
}
cookie_text = xcb_image_text_8_checked (c, length, window, gc,
x1 + inset + 1,
y1 - inset - 1, label);
error = xcb_request_check (c, cookie_text);
if (error) {
fprintf (stderr, "ERROR: can't paste text : %d\n", error->error_code);
xcb_disconnect (c);
exit (-1);
}
cookie_gc = xcb_free_gc (c, gc);
error = xcb_request_check (c, cookie_gc);
if (error) {
fprintf (stderr, "ERROR: can't free gc : %d\n", error->error_code);
xcb_disconnect (c);
exit (-1);
}
}
static void
text_draw (xcb_connection_t *c,
xcb_screen_t *screen,
xcb_window_t window,
int16_t x1,
int16_t y1,
const char *label)
{
xcb_void_cookie_t cookie_gc;
xcb_void_cookie_t cookie_text;
xcb_generic_error_t *error;
xcb_gcontext_t gc;
uint8_t length;
length = strlen (label);
gc = gc_font_get(c, screen, window, "7x13");
cookie_text = xcb_image_text_8_checked (c, length, window, gc,
x1,
y1, label);
error = xcb_request_check (c, cookie_text);
if (error) {
fprintf (stderr, "ERROR: can't paste text : %d\n", error->error_code);
xcb_disconnect (c);
exit (-1);
}
cookie_gc = xcb_free_gc (c, gc);
error = xcb_request_check (c, cookie_gc);
if (error) {
fprintf (stderr, "ERROR: can't free gc : %d\n", error->error_code);
xcb_disconnect (c);
exit (-1);
}
}
static xcb_gc_t
gc_font_get (xcb_connection_t *c,
xcb_screen_t *screen,
xcb_window_t window,
const char *font_name)
{
uint32_t value_list[3];
xcb_void_cookie_t cookie_font;
xcb_void_cookie_t cookie_gc;
xcb_generic_error_t *error;
xcb_font_t font;
xcb_gcontext_t gc;
uint32_t mask;
font = xcb_generate_id (c);
cookie_font = xcb_open_font_checked (c, font,
strlen (font_name),
font_name);
error = xcb_request_check (c, cookie_font);
if (error) {
fprintf (stderr, "ERROR: can't open font : %d\n", error->error_code);
xcb_disconnect (c);
return -1;
}
gc = xcb_generate_id (c);
mask = XCB_GC_FOREGROUND | XCB_GC_BACKGROUND | XCB_GC_FONT;
value_list[0] = screen->black_pixel;
value_list[1] = screen->white_pixel;
value_list[2] = font;
cookie_gc = xcb_create_gc_checked (c, gc, window, mask, value_list);
error = xcb_request_check (c, cookie_gc);
if (error) {
fprintf (stderr, "ERROR: can't create gc : %d\n", error->error_code);
xcb_disconnect (c);
exit (-1);
}
cookie_font = xcb_close_font_checked (c, font);
error = xcb_request_check (c, cookie_font);
if (error) {
fprintf (stderr, "ERROR: can't close font : %d\n", error->error_code);
xcb_disconnect (c);
exit (-1);
}
return gc;
}
static void
cursor_set (xcb_connection_t *c,
xcb_screen_t *screen,
xcb_window_t window,
int cursor_id)
{
uint32_t values_list[3];
xcb_void_cookie_t cookie_font;
xcb_void_cookie_t cookie_gc;
xcb_generic_error_t *error;
xcb_font_t font;
xcb_cursor_t cursor;
xcb_gcontext_t gc;
uint32_t mask;
uint32_t value_list;
font = xcb_generate_id (c);
cookie_font = xcb_open_font_checked (c, font,
strlen ("cursor"),
"cursor");
error = xcb_request_check (c, cookie_font);
if (error) {
fprintf (stderr, "ERROR: can't open font : %d\n", error->error_code);
xcb_disconnect (c);
exit (-1);
}
cursor = xcb_generate_id (c);
xcb_create_glyph_cursor (c, cursor, font, font,
cursor_id, cursor_id + 1,
0, 0, 0,
0, 0, 0);
gc = xcb_generate_id (c);
mask = XCB_GC_FOREGROUND | XCB_GC_BACKGROUND | XCB_GC_FONT;
values_list[0] = screen->black_pixel;
values_list[1] = screen->white_pixel;
values_list[2] = font;
cookie_gc = xcb_create_gc_checked (c, gc, window, mask, values_list);
error = xcb_request_check (c, cookie_gc);
if (error) {
fprintf (stderr, "ERROR: can't create gc : %d\n", error->error_code);
xcb_disconnect (c);
exit (-1);
}
mask = XCB_CW_CURSOR;
value_list = cursor;
xcb_change_window_attributes (c, window, mask, &amp;value_list);
xcb_free_cursor (c, cursor);
cookie_font = xcb_close_font_checked (c, font);
error = xcb_request_check (c, cookie_font);
if (error) {
fprintf (stderr, "ERROR: can't close font : %d\n", error->error_code);
xcb_disconnect (c);
exit (-1);
}
}
int main ()
{
xcb_screen_iterator_t screen_iter;
xcb_connection_t *c;
const xcb_setup_t *setup;
xcb_screen_t *screen;
xcb_generic_event_t *e;
xcb_generic_error_t *error;
xcb_void_cookie_t cookie_window;
xcb_void_cookie_t cookie_map;
xcb_window_t window;
uint32_t mask;
uint32_t values[2];
int screen_number;
uint8_t is_hand = 0;
/* getting the connection */
c = xcb_connect (NULL, &amp;screen_number);
if (!c) {
fprintf (stderr, "ERROR: can't connect to an X server\n");
return -1;
}
/* getting the current screen */
setup = xcb_get_setup (c);
screen = NULL;
screen_iter = xcb_setup_roots_iterator (setup);
for (; screen_iter.rem != 0; --screen_number, xcb_screen_next (&amp;screen_iter))
if (screen_number == 0)
{
screen = screen_iter.data;
break;
}
if (!screen) {
fprintf (stderr, "ERROR: can't get the current screen\n");
xcb_disconnect (c);
return -1;
}
/* creating the window */
window = xcb_generate_id (c);
mask = XCB_CW_BACK_PIXEL | XCB_CW_EVENT_MASK;
values[0] = screen->white_pixel;
values[1] =
XCB_EVENT_MASK_KEY_RELEASE |
XCB_EVENT_MASK_BUTTON_PRESS |
XCB_EVENT_MASK_EXPOSURE |
XCB_EVENT_MASK_POINTER_MOTION;
cookie_window = xcb_create_window_checked (c,
screen->root_depth,
window, screen->root,
20, 200, WIDTH, HEIGHT,
0, XCB_WINDOW_CLASS_INPUT_OUTPUT,
screen->root_visual,
mask, values);
cookie_map = xcb_map_window_checked (c, window);
/* error managing */
error = xcb_request_check (c, cookie_window);
if (error) {
fprintf (stderr, "ERROR: can't create window : %d\n", error->error_code);
xcb_disconnect (c);
return -1;
}
error = xcb_request_check (c, cookie_map);
if (error) {
fprintf (stderr, "ERROR: can't map window : %d\n", error->error_code);
xcb_disconnect (c);
return -1;
}
cursor_set (c, screen, window, 68);
xcb_flush(c);
while (1) {
e = xcb_poll_for_event(c);
if (e) {
switch (e->response_type) {
case XCB_EXPOSE: {
char *text;
text = "click here to change cursor";
button_draw (c, screen, window,
(WIDTH - 7 * strlen(text)) / 2,
(HEIGHT - 16) / 2, text);
text = "Press ESC key to exit...";
text_draw (c, screen, window, 10, HEIGHT - 10, text);
break;
}
case XCB_BUTTON_PRESS: {
xcb_button_press_event_t *ev;
int length;
ev = (xcb_button_press_event_t *)e;
length = strlen ("click here to change cursor");
if ((ev->event_x &gt;= (WIDTH - 7 * length) / 2) &amp;&amp;
(ev->event_x &lt;= ((WIDTH - 7 * length) / 2 + 7 * length + 6)) &amp;&amp;
(ev->event_y &gt;= (HEIGHT - 16) / 2 - 19) &amp;&amp;
(ev->event_y &lt;= ((HEIGHT - 16) / 2)))
is_hand = 1 - is_hand;
is_hand ? cursor_set (c, screen, window, 58) : cursor_set (c, screen, window, 68);
}
case XCB_KEY_RELEASE: {
xcb_key_release_event_t *ev;
ev = (xcb_key_release_event_t *)e;
switch (ev->detail) {
/* ESC */
case 9:
free (e);
xcb_disconnect (c);
return 0;
}
}
}
free (e);
}
}
return 0;
}
</pre>
</ol> </ol>
<li class="title"><a name="translation">Translation of basic Xlib functions and macros</a> <li class="title"><a name="translation">Translation of basic Xlib functions and macros</a>
<p> <p>
@ -3438,8 +3820,7 @@ default_screen = screen_of_display (c, screen_default_nbr);
/* default_screen contains now the default root window, or a NULL window if no screen is found */ /* default_screen contains now the default root window, or a NULL window if no screen is found */
</pre> </pre>
<li class="subtitle"><a name="RootWindow">RootWindow / RootWindowOfScreen</a> <li class="subtitle"><a name="RootWindow">RootWindow / RootWindowOfScreen</a>
<p> <br>
</p>
<pre class="code"> <pre class="code">
xcb_connection_t *c; xcb_connection_t *c;
xcb_screen_t *screen; xcb_screen_t *screen;

10
doc/tutorial/xcb.css
View File

@ -101,23 +101,23 @@ span.code
font-family: monospace; font-family: monospace;
font-size: 12px; font-size: 12px;
} }
pre.code type pre.code .type
{ {
color: #44bb44; color: #44bb44;
} }
pre.code function pre.code .function
{ {
color: #449fb7; color: #449fb7;
} }
pre.code include pre.code .include
{ {
color: #7d93ae; color: #7d93ae;
} }
pre.code string pre.code .string
{ {
color: #ef6e4b; color: #ef6e4b;
} }
pre.code keyword pre.code .keyword
{ {
color: #00bbbb; color: #00bbbb;
} }