3
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
4
<title>GimpController</title>
5
<meta name="generator" content="DocBook XSL Stylesheets V1.68.1">
6
<link rel="start" href="index.html" title="GIMP Widgets Library Reference Manual">
7
<link rel="up" href="libgimpwidgets-controller.html" title="Part IV. GIMP Controllers">
8
<link rel="prev" href="libgimpwidgets-controller.html" title="Part IV. GIMP Controllers">
9
<link rel="next" href="libgimpwidgets-utils.html" title="Part V. GIMP Widgets Utilities">
10
<meta name="generator" content="GTK-Doc V1.4 (XML mode)">
11
<link rel="stylesheet" href="style.css" type="text/css">
12
<link rel="part" href="libgimpwidgets-widgets.html" title="Part I. GIMP Widgets">
13
<link rel="chapter" href="libgimpwidgets-hierarchy.html" title="Object Hierarchy">
14
<link rel="chapter" href="libgimpwidgets-cell-renderers.html" title="Cell Renderers for GtkTreeView">
15
<link rel="part" href="libgimpwidgets-colordisplay.html" title="Part II. GIMP Display Filters">
16
<link rel="part" href="libgimpwidgets-colorselector.html" title="Part III. GIMP Color Selectors">
17
<link rel="part" href="libgimpwidgets-controller.html" title="Part IV. GIMP Controllers">
18
<link rel="part" href="libgimpwidgets-utils.html" title="Part V. GIMP Widgets Utilities">
19
<link rel="part" href="libgimpwidgets-deprecated.html" title="Part VI. Deprecated API">
21
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
22
<table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle">
23
<td><a accesskey="p" href="libgimpwidgets-controller.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
24
<td><a accesskey="u" href="libgimpwidgets-controller.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
25
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
26
<th width="100%" align="center">GIMP Widgets Library Reference Manual</th>
27
<td><a accesskey="n" href="libgimpwidgets-utils.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
29
<div class="refentry" lang="en">
30
<a name="GimpController"></a><div class="titlepage"></div>
31
<div class="refnamediv"><table width="100%"><tr>
33
<h2><span class="refentrytitle">GimpController</span></h2>
34
<p>GimpController — Pluggable GIMP input controller modules.</p>
36
<td valign="top" align="right"></td>
38
<div class="refsynopsisdiv">
40
<pre class="synopsis">
44
enum <a href="GimpController.html#GimpControllerEventType">GimpControllerEventType</a>;
45
<a href="GimpController.html#GimpControllerEventAny">GimpControllerEventAny</a>;
46
<a href="GimpController.html#GimpControllerEventTrigger">GimpControllerEventTrigger</a>;
47
<a href="GimpController.html#GimpControllerEventValue">GimpControllerEventValue</a>;
48
union <a href="GimpController.html#GimpControllerEvent">GimpControllerEvent</a>;
49
<a href="GimpController.html#GimpController-struct">GimpController</a>;
50
<a href="GimpController.html" title="GimpController">GimpController</a>* <a href="GimpController.html#gimp-controller-new">gimp_controller_new</a> (GType controller_type);
51
gint <a href="GimpController.html#gimp-controller-get-n-events">gimp_controller_get_n_events</a> (<a href="GimpController.html" title="GimpController">GimpController</a> *controller);
52
const gchar* <a href="GimpController.html#gimp-controller-get-event-name">gimp_controller_get_event_name</a> (<a href="GimpController.html" title="GimpController">GimpController</a> *controller,
54
const gchar* <a href="GimpController.html#gimp-controller-get-event-blurb">gimp_controller_get_event_blurb</a>
55
(<a href="GimpController.html" title="GimpController">GimpController</a> *controller,
57
gboolean <a href="GimpController.html#gimp-controller-event">gimp_controller_event</a> (<a href="GimpController.html" title="GimpController">GimpController</a> *controller,
58
const <a href="GimpController.html#GimpControllerEvent">GimpControllerEvent</a> *event);
62
<div class="refsect1" lang="en">
63
<a name="id2581701"></a><h2>Object Hierarchy</h2>
64
<pre class="synopsis">
70
<div class="refsect1" lang="en">
71
<a name="id2581720"></a><h2>Properties</h2>
72
<pre class="synopsis">
74
"<a href="GimpController.html#GimpController--name">name</a>" gchararray : Read / Write / Construct
75
"<a href="GimpController.html#GimpController--state">state</a>" gchararray : Read / Write / Construct
78
<div class="refsect1" lang="en">
79
<a name="id2579879"></a><h2>Signal Prototypes</h2>
80
<pre class="synopsis">
82
"<a href="GimpController.html#GimpController-event">event</a>" gboolean user_function (<a href="GimpController.html" title="GimpController">GimpController</a> *gimpcontroller,
87
<div class="refsect1" lang="en">
88
<a name="id2579924"></a><h2>Description</h2>
90
An abstract interface for implementing arbitrary input controllers.
93
<div class="refsect1" lang="en">
94
<a name="id2579937"></a><h2>Details</h2>
95
<div class="refsect2" lang="en">
96
<a name="id2579943"></a><h3>
97
<a name="GimpControllerEventType"></a>enum GimpControllerEventType</h3>
98
<a class="indexterm" name="id2579952"></a><pre class="programlisting">typedef enum
100
GIMP_CONTROLLER_EVENT_TRIGGER,
101
GIMP_CONTROLLER_EVENT_VALUE
102
} GimpControllerEventType;
109
<div class="refsect2" lang="en">
110
<a name="id2579969"></a><h3>
111
<a name="GimpControllerEventAny"></a>GimpControllerEventAny</h3>
112
<a class="indexterm" name="id2579978"></a><pre class="programlisting">typedef struct {
113
GimpControllerEventType type;
114
GimpController *source;
116
} GimpControllerEventAny;
123
<div class="refsect2" lang="en">
124
<a name="id2579995"></a><h3>
125
<a name="GimpControllerEventTrigger"></a>GimpControllerEventTrigger</h3>
126
<a class="indexterm" name="id2580004"></a><pre class="programlisting">typedef struct {
127
GimpControllerEventType type;
128
GimpController *source;
130
} GimpControllerEventTrigger;
137
<div class="refsect2" lang="en">
138
<a name="id2581080"></a><h3>
139
<a name="GimpControllerEventValue"></a>GimpControllerEventValue</h3>
140
<a class="indexterm" name="id2581089"></a><pre class="programlisting">typedef struct {
141
GimpControllerEventType type;
142
GimpController *source;
145
} GimpControllerEventValue;
152
<div class="refsect2" lang="en">
153
<a name="id2581108"></a><h3>
154
<a name="GimpControllerEvent"></a>union GimpControllerEvent</h3>
155
<a class="indexterm" name="id2581118"></a><pre class="programlisting">union GimpControllerEvent
157
GimpControllerEventType type;
158
GimpControllerEventAny any;
159
GimpControllerEventTrigger trigger;
160
GimpControllerEventValue value;
168
<div class="refsect2" lang="en">
169
<a name="id2581136"></a><h3>
170
<a name="GimpController-struct"></a>GimpController</h3>
171
<a class="indexterm" name="id2581145"></a><pre class="programlisting">typedef struct _GimpController GimpController;</pre>
177
<div class="refsect2" lang="en">
178
<a name="id2581162"></a><h3>
179
<a name="gimp-controller-new"></a>gimp_controller_new ()</h3>
180
<a class="indexterm" name="id2581172"></a><pre class="programlisting"><a href="GimpController.html" title="GimpController">GimpController</a>* gimp_controller_new (GType controller_type);</pre>
184
<div class="variablelist"><table border="0">
185
<col align="left" valign="top">
189
<span class="term"><em class="parameter"><code>controller_type</code></em> :</span></td>
195
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
205
<div class="refsect2" lang="en">
206
<a name="id2581228"></a><h3>
207
<a name="gimp-controller-get-n-events"></a>gimp_controller_get_n_events ()</h3>
208
<a class="indexterm" name="id2581236"></a><pre class="programlisting">gint gimp_controller_get_n_events (<a href="GimpController.html" title="GimpController">GimpController</a> *controller);</pre>
212
<div class="variablelist"><table border="0">
213
<col align="left" valign="top">
217
<span class="term"><em class="parameter"><code>controller</code></em> :</span></td>
223
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
233
<div class="refsect2" lang="en">
234
<a name="id2581292"></a><h3>
235
<a name="gimp-controller-get-event-name"></a>gimp_controller_get_event_name ()</h3>
236
<a class="indexterm" name="id2581301"></a><pre class="programlisting">const gchar* gimp_controller_get_event_name (<a href="GimpController.html" title="GimpController">GimpController</a> *controller,
237
gint event_id);</pre>
241
<div class="variablelist"><table border="0">
242
<col align="left" valign="top">
246
<span class="term"><em class="parameter"><code>controller</code></em> :</span></td>
252
<span class="term"><em class="parameter"><code>event_id</code></em> :</span></td>
258
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
268
<div class="refsect2" lang="en">
269
<a name="id2582660"></a><h3>
270
<a name="gimp-controller-get-event-blurb"></a>gimp_controller_get_event_blurb ()</h3>
271
<a class="indexterm" name="id2582671"></a><pre class="programlisting">const gchar* gimp_controller_get_event_blurb
272
(<a href="GimpController.html" title="GimpController">GimpController</a> *controller,
273
gint event_id);</pre>
277
<div class="variablelist"><table border="0">
278
<col align="left" valign="top">
282
<span class="term"><em class="parameter"><code>controller</code></em> :</span></td>
288
<span class="term"><em class="parameter"><code>event_id</code></em> :</span></td>
294
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
304
<div class="refsect2" lang="en">
305
<a name="id2582751"></a><h3>
306
<a name="gimp-controller-event"></a>gimp_controller_event ()</h3>
307
<a class="indexterm" name="id2582760"></a><pre class="programlisting">gboolean gimp_controller_event (<a href="GimpController.html" title="GimpController">GimpController</a> *controller,
308
const <a href="GimpController.html#GimpControllerEvent">GimpControllerEvent</a> *event);</pre>
312
<div class="variablelist"><table border="0">
313
<col align="left" valign="top">
317
<span class="term"><em class="parameter"><code>controller</code></em> :</span></td>
323
<span class="term"><em class="parameter"><code>event</code></em> :</span></td>
329
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
339
<div class="refsect1" lang="en">
340
<a name="id2582838"></a><h2>Properties</h2>
341
<div class="refsect2" lang="en">
342
<a name="id2582845"></a><h3>
343
<a name="GimpController--name"></a>The "<code class="literal">name</code>" property</h3>
344
<pre class="programlisting"> "name" gchararray : Read / Write / Construct</pre>
346
<p>Default value: "Unnamed Controller"</p>
349
<div class="refsect2" lang="en">
350
<a name="id2582877"></a><h3>
351
<a name="GimpController--state"></a>The "<code class="literal">state</code>" property</h3>
352
<pre class="programlisting"> "state" gchararray : Read / Write / Construct</pre>
354
<p>Default value: "Unknown"</p>
357
<div class="refsect1" lang="en">
358
<a name="id2582910"></a><h2>Signals</h2>
359
<div class="refsect2" lang="en">
360
<a name="id2582916"></a><h3>
361
<a name="GimpController-event"></a>The "event" signal</h3>
362
<pre class="programlisting">gboolean user_function (<a href="GimpController.html" title="GimpController">GimpController</a> *gimpcontroller,
364
gpointer user_data);</pre>
368
<div class="variablelist"><table border="0">
369
<col align="left" valign="top">
373
<span class="term"><em class="parameter"><code>gimpcontroller</code></em> :</span></td>
374
<td>the object which received the signal.
379
<span class="term"><em class="parameter"><code>arg1</code></em> :</span></td>
385
<span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
386
<td>user data set when the signal handler was connected.</td>
390
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
400
<table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle">
401
<td align="left"><a accesskey="p" href="libgimpwidgets-controller.html"><b><< Part IV. GIMP Controllers</b></a></td>
402
<td align="right"><a accesskey="n" href="libgimpwidgets-utils.html"><b>Part V. GIMP Widgets Utilities >></b></a></td>