Mercurial > MadButterfly

annotate dox/event_dispatching.h @ 404:e774868fb7df

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
merge
author Thinker K.F. Li <thinker@branda.to>
date Tue, 16 Jun 2009 23:03:07 +0800
parents 18f8c3126cdb
children
rev   line source
191
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
1 /*! \page event_dispatching Event Dispatching Mechanism in MadButterfly
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
2 *
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
3 * by wycc
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
4 *
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
5 * \section evt_intro Introduction
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
6 *
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
7 * Event dispatching is an important job for the GUI system. Usually,
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
8 * we need to handle the following events in the GUI
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
9 *
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
10 * - Mouse/pointer events
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
11 * - Key event
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
12 * - timer event
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
13 * - IO event
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
14 * - Repaint event
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
15 *
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
16 * In the rest of this article, I will discuss the event mechanism of
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
17 * the MadButterfly and provide a design of event API.
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
18 *
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
19 * First thing go first. We will start from the most important event -
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
20 * mouse evnets.
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
21 *
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
22 * \section evt_mouse Mouse/point events
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
23 *
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
24 * MadButterfly use observer design pattern to implement the event
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
25 * dispatching. In this pattern, observer and subject are used to
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
26 * handle events. The subject is a specific type of events. For
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
27 * example, mouse events or keyboard events. Each subject can have zero
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
28 * or more observers. When the system send events related to the subject,
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
29 * it will call the subject_notify function of the subject, which will
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
30 * notify every registered observers.
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
31 *
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
32 * In this way, we can decouple the components which send the events and
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
33 * the components which need the events. For example, if we implement the
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
34 * X and GTK backend, both of them will call subject_notify when it
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
35 * receive the mouse events from the X or GTK. The observers don't
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
36 * care whether the notification coming from X or GTK. The X and GTK
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
37 * backend are responsible to translate the X or GTK mouse events into
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
38 * the mouse subject.
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
39 *
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
40 * Therefore, we can use the subject as the astraction layer between
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
41 * MadButterfly clients and the backend.
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
42 *
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
43 * To be more specific, in the current X backend. When it receive a
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
44 * MotionNotify mouse event from the X server, it will send an mouse
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
45 * event to the mouse event subject ob type OBJT_GEO.
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
46 * \code
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
47 * mouse_event.event.type = etype;
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
48 * mouse_event.x = x;
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
49 * mouse_event.y = y;
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
50 * mouse_event.but_state = state;
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
51 * mouse_event.button = button;
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
52 * subject = sh_get_mouse_event_subject(shape);
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
53 * factory = rdman_get_ob_factory(rdman);
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
54 * subject_notify(factory, subject, (event_t *)&mouse_event);
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
55 * \endcode
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
56 *
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
57 * The shape above is determined by the mouse position and the etype
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
58 * is determined the shape under the mouse and the last shape which
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
59 * receive mouse event.
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
60 *
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
61 * - If the mouse is on any shape,
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
62 * - If the new shape is the same as the last shape, we will send the
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
63 * EVT_MOUSE_MOVE events to it to notify it the mouse is moving inside it.
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
64 * - If the new shape is not the same as the last shape, we will send the
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
65 * EVT_MOUSE_OVER to notify it the mouse is just touch it.
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
66 * - If the current shape is not the same as the last shape, send the
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
67 * EVT_MOUSE_OUT to the last shape to tell it the mouse have left it.
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
68 * \code
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
69 * mevt = (XMotionEvent *)&evt;
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
70 * x = mevt->x;
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
71 * y = mevt->y;
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
72 * state = get_button_state(mevt->state);
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
73 *
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
74 * shape = find_shape_at_pos(rdman, x, y,
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
75 * &in_stroke);
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
76 * if(shape != NULL) {
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
77 * if(rt->last != shape) {
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
78 * if(rt->last)
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
79 * notify_shapes(rdman, rt->last, x, y,
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
80 * EVT_MOUSE_OUT, state, 0);
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
81 * notify_shapes(rdman, shape, x, y,
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
82 * EVT_MOUSE_OVER, state, 0);
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
83 * rt->last = shape;
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
84 * } else
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
85 * notify_shapes(rdman, shape, x, y,
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
86 * EVT_MOUSE_MOVE, state, 0);
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
87 * } else {
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
88 * if(rt->last) {
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
89 * notify_shapes(rdman, rt->last, x, y,
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
90 * EVT_MOUSE_OUT, state, 0);
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
91 * rt->last = NULL;
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
92 * }
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
93 * }
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
94 * \endcode
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
95 *
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
96 * Please remember that the subject will relay the the events to all of
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
97 * its parents.
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
98 *
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
99 * PS. Currently, the MadButterfly does not have mechanism to stop
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
100 * propogation based on the result of the observer.
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
101 *
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
102 * \section evt_key Key event
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
103 *
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
104 * The key events is send as subject type OBJT_KB. Each key object has
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
105 * the following fields code: The original raw keycode. sym: The symbol ID
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
106 * of the raw keycode. * event.type: EVT_KB_PRESS or EVT_KB_RELEASE
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
107 *
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
108 * \section evt_timer Timer event
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
109 *
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
110 * The timer use different mechanism. It does not use the observer pattern.
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
111 * Instead, it is registered as separate timer queue. Do we want to change
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
112 * the implementation?
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
113 *
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
114 * \section evt_io IO event
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
115 *
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
116 * Currently, no IO events is available in the MadButterfly yet. W should
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
117 * add the following IO subjects. OBJT_FD: We need to provide some function
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
118 * to generate subject for file description. It will send events when teh
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
119 * file descriptor become available for read/write or error. OBJT_XMLIO:
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
120 * Provides functions similiar to the XMLSocket in actionscript.
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
121 *
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
122 * \section evt_repaint Repaint
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
123 *
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
124 * The repaint event is not sent directly. Instead, the X backend call
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
125 * rdman_redraw_area directly to handle the repaint event. This function
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
126 * will send EVT_RDMAN_REDRAW out.
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
127 *
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
128 * \section evt_summary Summary
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
129 *
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
130 * The observer pattern can be used to be the abstraction layer of the
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
131 * MadButterfly. The current implementation has effectively seperate the
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
132 * backend and the core engine. There is no direct call to the engine
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
133 * from the backend. All messages are deliver to the MadButterfly through
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
134 * the observer.
18f8c3126cdb Refine installation instructions and document event dispatching by wycc.
Thinker K.F. Li <thinker@branda.to>
parents:
diff changeset
135 */