Played around with nitfol build process, adding rules to generate the
[rodin/chimara.git] / libchimara / abort.c
1 #include "event.h"
2 #include <glib.h>
3 #include <gtk/gtk.h>
4
5 #include "chimara-glk-private.h"
6
7 extern ChimaraGlkPrivate *glk_data;
8
9 /**
10  * glk_set_interrupt_handler:
11  * @func: A pointer to an interrupt handler function.
12  *
13  * Sets @func to be the interrupt handler. @func should be a pointer to a 
14  * function which takes no argument and returns no result. If Glk receives an
15  * interrupt, and you have set an interrupt handler, your handler will be 
16  * called, before the process is shut down.
17  * 
18  * Initially there is no interrupt handler. You can reset to not having any by
19  * calling <code>#glk_set_interrupt_handler(%NULL)</code>.
20  * 
21  * If you call glk_set_interrupt_handler() with a new handler function while an
22  * older one is set, the new one replaces the old one. Glk does not try to queue
23  * interrupt handlers.
24  *
25  * You should not try to interact with the player in your interrupt handler. Do
26  * not call glk_select() or glk_select_poll(). Anything you print to a window
27  * may not be visible to the player. 
28  */
29 void
30 glk_set_interrupt_handler(void (*func)(void))
31 {
32         glk_data->interrupt_handler = func;
33 }
34
35 /* Internal function: abort this Glk program, freeing resources and calling the
36 user's interrupt handler. */
37 static void
38 abort_glk()
39 {
40         if(glk_data->interrupt_handler)
41                 (*(glk_data->interrupt_handler))();
42         g_signal_emit_by_name(glk_data->self, "stopped");
43         g_thread_exit(NULL);
44 }
45
46 /* Internal function: Signal this Glk thread to abort. Does nothing if the abort
47 mutex has already been freed. (That means the thread already ended.) */
48 void
49 signal_abort()
50 {
51         if(glk_data && glk_data->abort_lock) {
52                 g_mutex_lock(glk_data->abort_lock);
53                 glk_data->abort_signalled = TRUE;
54                 g_mutex_unlock(glk_data->abort_lock);
55                 /* Stop blocking on the event queue condition */
56                 event_throw(evtype_Abort, NULL, 0, 0);
57         }
58 }
59
60 /* Internal function: check if the Glk program has been interrupted. */
61 void
62 check_for_abort()
63 {
64         g_mutex_lock(glk_data->abort_lock);
65         if(glk_data->abort_signalled) 
66         {
67                 g_mutex_unlock(glk_data->abort_lock);
68                 abort_glk();
69         }
70         g_mutex_unlock(glk_data->abort_lock);
71 }