427 lines
15 KiB
HTML
427 lines
15 KiB
HTML
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<html>
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
|
|
<title>GimpController</title>
|
|
<meta name="generator" content="DocBook XSL Stylesheets V1.68.1">
|
|
<link rel="start" href="index.html" title="GIMP Widgets Library Reference Manual">
|
|
<link rel="up" href="libgimpwidgets-controller.html" title="Part IV. GIMP Controllers">
|
|
<link rel="prev" href="libgimpwidgets-controller.html" title="Part IV. GIMP Controllers">
|
|
<link rel="next" href="libgimpwidgets-utils.html" title="Part V. GIMP Widgets Utilities">
|
|
<meta name="generator" content="GTK-Doc V1.6 (XML mode)">
|
|
<link rel="stylesheet" href="style.css" type="text/css">
|
|
<link rel="part" href="libgimpwidgets-widgets.html" title="Part I. GIMP Widgets">
|
|
<link rel="chapter" href="libgimpwidgets-hierarchy.html" title="Object Hierarchy">
|
|
<link rel="chapter" href="libgimpwidgets-gallery.html" title="Widget Gallery">
|
|
<link rel="chapter" href="libgimpwidgets-cell-renderers.html" title="Cell Renderers for GtkTreeView">
|
|
<link rel="part" href="libgimpwidgets-colordisplay.html" title="Part II. GIMP Display Filters">
|
|
<link rel="part" href="libgimpwidgets-colorselector.html" title="Part III. GIMP Color Selectors">
|
|
<link rel="part" href="libgimpwidgets-controller.html" title="Part IV. GIMP Controllers">
|
|
<link rel="part" href="libgimpwidgets-utils.html" title="Part V. GIMP Widgets Utilities">
|
|
<link rel="part" href="libgimpwidgets-deprecated.html" title="Part VI. Deprecated API">
|
|
<link rel="index" href="ix01.html" title="Index">
|
|
<link rel="index" href="ix02.html" title="Index of new symbols in GIMP 2.2">
|
|
<link rel="index" href="ix03.html" title="Index of new symbols in GIMP 2.4">
|
|
<link rel="index" href="ix04.html" title="Index of deprecated symbols">
|
|
</head>
|
|
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
|
|
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
|
|
<tr valign="middle">
|
|
<td><a accesskey="p" href="libgimpwidgets-controller.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
|
|
<td><a accesskey="u" href="libgimpwidgets-controller.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
|
|
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
|
|
<th width="100%" align="center">GIMP Widgets Library Reference Manual</th>
|
|
<td><a accesskey="n" href="libgimpwidgets-utils.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
|
|
</tr>
|
|
<tr><td colspan="5" class="shortcuts"><nobr><a href="#top_of_page" class="shortcut">Top</a>
|
|
 | 
|
|
<a href="#desc" class="shortcut">Description</a>
|
|
 | 
|
|
<a href="#object_hierarchy" class="shortcut">Object Hierarchy</a>
|
|
 | 
|
|
<a href="#properties" class="shortcut">Properties</a>
|
|
 | 
|
|
<a href="#signal_proto" class="shortcut">Signals</a></nobr></td></tr>
|
|
</table>
|
|
<div class="refentry" lang="en">
|
|
<a name="GimpController"></a><div class="titlepage"></div>
|
|
<div class="refnamediv"><table width="100%"><tr>
|
|
<td valign="top">
|
|
<h2><span class="refentrytitle"><a name="top_of_page"></a>GimpController</span></h2>
|
|
<p>GimpController — Pluggable GIMP input controller modules.</p>
|
|
</td>
|
|
<td valign="top" align="right"></td>
|
|
</tr></table></div>
|
|
<div class="refsynopsisdiv">
|
|
<a name="synopsis"></a><h2>Synopsis</h2>
|
|
<pre class="synopsis">
|
|
|
|
|
|
|
|
enum <a href="GimpController.html#GimpControllerEventType">GimpControllerEventType</a>;
|
|
<a href="GimpController.html#GimpControllerEventAny">GimpControllerEventAny</a>;
|
|
<a href="GimpController.html#GimpControllerEventTrigger">GimpControllerEventTrigger</a>;
|
|
<a href="GimpController.html#GimpControllerEventValue">GimpControllerEventValue</a>;
|
|
union <a href="GimpController.html#GimpControllerEvent">GimpControllerEvent</a>;
|
|
<a href="GimpController.html#GimpController-struct">GimpController</a>;
|
|
<a href="GimpController.html" title="GimpController">GimpController</a>* <a href="GimpController.html#gimp-controller-new">gimp_controller_new</a> (GType controller_type);
|
|
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);
|
|
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,
|
|
gint event_id);
|
|
const gchar* <a href="GimpController.html#gimp-controller-get-event-blurb">gimp_controller_get_event_blurb</a>
|
|
(<a href="GimpController.html" title="GimpController">GimpController</a> *controller,
|
|
gint event_id);
|
|
gboolean <a href="GimpController.html#gimp-controller-event">gimp_controller_event</a> (<a href="GimpController.html" title="GimpController">GimpController</a> *controller,
|
|
const <a href="GimpController.html#GimpControllerEvent">GimpControllerEvent</a> *event);
|
|
|
|
</pre>
|
|
</div>
|
|
<div class="refsect1" lang="en">
|
|
<a name="object_hierarchy"></a><h2>Object Hierarchy</h2>
|
|
<pre class="synopsis">
|
|
|
|
GObject
|
|
+----GimpController
|
|
</pre>
|
|
</div>
|
|
<div class="refsect1" lang="en">
|
|
<a name="impl_interfaces"></a><h2>Implemented Interfaces</h2>
|
|
<p>
|
|
GimpController implements
|
|
<a
|
|
href="../libgimpconfig/libgimpconfig-GimpConfig.html#GimpConfigInterface"
|
|
>GimpConfigInterface</a>.</p>
|
|
</div>
|
|
<div class="refsect1" lang="en">
|
|
<a name="properties"></a><h2>Properties</h2>
|
|
<pre class="synopsis">
|
|
|
|
"<a href="GimpController.html#GimpController--name">name</a>" gchararray : Read / Write / Construct
|
|
"<a href="GimpController.html#GimpController--state">state</a>" gchararray : Read / Write / Construct
|
|
</pre>
|
|
</div>
|
|
<div class="refsect1" lang="en">
|
|
<a name="signal_proto"></a><h2>Signals</h2>
|
|
<pre class="synopsis">
|
|
|
|
"<a href="GimpController.html#GimpController-event">event</a>" gboolean user_function (<a href="GimpController.html" title="GimpController">GimpController</a> *gimpcontroller,
|
|
gpointer arg1,
|
|
gpointer user_data) : Run last
|
|
</pre>
|
|
</div>
|
|
<div class="refsect1" lang="en">
|
|
<a name="desc"></a><h2>Description</h2>
|
|
<p>
|
|
An abstract interface for implementing arbitrary input controllers.
|
|
</p>
|
|
</div>
|
|
<div class="refsect1" lang="en">
|
|
<a name="details"></a><h2>Details</h2>
|
|
<div class="refsect2" lang="en">
|
|
<a name="id2605158"></a><h3>
|
|
<a name="GimpControllerEventType"></a>enum GimpControllerEventType</h3>
|
|
<a class="indexterm" name="id2605170"></a><pre class="programlisting">typedef enum
|
|
{
|
|
GIMP_CONTROLLER_EVENT_TRIGGER,
|
|
GIMP_CONTROLLER_EVENT_VALUE
|
|
} GimpControllerEventType;
|
|
</pre>
|
|
<p>
|
|
|
|
</p>
|
|
</div>
|
|
<hr>
|
|
<div class="refsect2" lang="en">
|
|
<a name="id2604253"></a><h3>
|
|
<a name="GimpControllerEventAny"></a>GimpControllerEventAny</h3>
|
|
<a class="indexterm" name="id2604264"></a><pre class="programlisting">typedef struct {
|
|
GimpControllerEventType type;
|
|
GimpController *source;
|
|
gint event_id;
|
|
} GimpControllerEventAny;
|
|
</pre>
|
|
<p>
|
|
|
|
</p>
|
|
</div>
|
|
<hr>
|
|
<div class="refsect2" lang="en">
|
|
<a name="id2604281"></a><h3>
|
|
<a name="GimpControllerEventTrigger"></a>GimpControllerEventTrigger</h3>
|
|
<a class="indexterm" name="id2604292"></a><pre class="programlisting">typedef struct {
|
|
GimpControllerEventType type;
|
|
GimpController *source;
|
|
gint event_id;
|
|
} GimpControllerEventTrigger;
|
|
</pre>
|
|
<p>
|
|
|
|
</p>
|
|
</div>
|
|
<hr>
|
|
<div class="refsect2" lang="en">
|
|
<a name="id2604310"></a><h3>
|
|
<a name="GimpControllerEventValue"></a>GimpControllerEventValue</h3>
|
|
<a class="indexterm" name="id2604321"></a><pre class="programlisting">typedef struct {
|
|
GimpControllerEventType type;
|
|
GimpController *source;
|
|
gint event_id;
|
|
GValue value;
|
|
} GimpControllerEventValue;
|
|
</pre>
|
|
<p>
|
|
|
|
</p>
|
|
</div>
|
|
<hr>
|
|
<div class="refsect2" lang="en">
|
|
<a name="id2604339"></a><h3>
|
|
<a name="GimpControllerEvent"></a>union GimpControllerEvent</h3>
|
|
<a class="indexterm" name="id2604352"></a><pre class="programlisting">union GimpControllerEvent
|
|
{
|
|
GimpControllerEventType type;
|
|
GimpControllerEventAny any;
|
|
GimpControllerEventTrigger trigger;
|
|
GimpControllerEventValue value;
|
|
};
|
|
</pre>
|
|
<p>
|
|
|
|
</p>
|
|
</div>
|
|
<hr>
|
|
<div class="refsect2" lang="en">
|
|
<a name="id2604370"></a><h3>
|
|
<a name="GimpController-struct"></a>GimpController</h3>
|
|
<a class="indexterm" name="id2604381"></a><pre class="programlisting">typedef struct _GimpController GimpController;</pre>
|
|
<p>
|
|
|
|
</p>
|
|
</div>
|
|
<hr>
|
|
<div class="refsect2" lang="en">
|
|
<a name="id2604398"></a><h3>
|
|
<a name="gimp-controller-new"></a>gimp_controller_new ()</h3>
|
|
<a class="indexterm" name="id2604410"></a><pre class="programlisting"><a href="GimpController.html" title="GimpController">GimpController</a>* gimp_controller_new (GType controller_type);</pre>
|
|
<p>
|
|
|
|
</p>
|
|
<div class="variablelist"><table border="0">
|
|
<col align="left" valign="top">
|
|
<tbody>
|
|
<tr>
|
|
<td>
|
|
<span class="term"><em class="parameter"><code>controller_type</code></em> :</span></td>
|
|
<td>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td>
|
|
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
|
|
<td>
|
|
|
|
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table></div>
|
|
</div>
|
|
<hr>
|
|
<div class="refsect2" lang="en">
|
|
<a name="id2604466"></a><h3>
|
|
<a name="gimp-controller-get-n-events"></a>gimp_controller_get_n_events ()</h3>
|
|
<a class="indexterm" name="id2604477"></a><pre class="programlisting">gint gimp_controller_get_n_events (<a href="GimpController.html" title="GimpController">GimpController</a> *controller);</pre>
|
|
<p>
|
|
|
|
</p>
|
|
<div class="variablelist"><table border="0">
|
|
<col align="left" valign="top">
|
|
<tbody>
|
|
<tr>
|
|
<td>
|
|
<span class="term"><em class="parameter"><code>controller</code></em> :</span></td>
|
|
<td>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td>
|
|
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
|
|
<td>
|
|
|
|
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table></div>
|
|
</div>
|
|
<hr>
|
|
<div class="refsect2" lang="en">
|
|
<a name="id2607130"></a><h3>
|
|
<a name="gimp-controller-get-event-name"></a>gimp_controller_get_event_name ()</h3>
|
|
<a class="indexterm" name="id2607141"></a><pre class="programlisting">const gchar* gimp_controller_get_event_name (<a href="GimpController.html" title="GimpController">GimpController</a> *controller,
|
|
gint event_id);</pre>
|
|
<p>
|
|
|
|
</p>
|
|
<div class="variablelist"><table border="0">
|
|
<col align="left" valign="top">
|
|
<tbody>
|
|
<tr>
|
|
<td>
|
|
<span class="term"><em class="parameter"><code>controller</code></em> :</span></td>
|
|
<td>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td>
|
|
<span class="term"><em class="parameter"><code>event_id</code></em> :</span></td>
|
|
<td>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td>
|
|
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
|
|
<td>
|
|
|
|
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table></div>
|
|
</div>
|
|
<hr>
|
|
<div class="refsect2" lang="en">
|
|
<a name="id2607219"></a><h3>
|
|
<a name="gimp-controller-get-event-blurb"></a>gimp_controller_get_event_blurb ()</h3>
|
|
<a class="indexterm" name="id2607231"></a><pre class="programlisting">const gchar* gimp_controller_get_event_blurb
|
|
(<a href="GimpController.html" title="GimpController">GimpController</a> *controller,
|
|
gint event_id);</pre>
|
|
<p>
|
|
|
|
</p>
|
|
<div class="variablelist"><table border="0">
|
|
<col align="left" valign="top">
|
|
<tbody>
|
|
<tr>
|
|
<td>
|
|
<span class="term"><em class="parameter"><code>controller</code></em> :</span></td>
|
|
<td>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td>
|
|
<span class="term"><em class="parameter"><code>event_id</code></em> :</span></td>
|
|
<td>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td>
|
|
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
|
|
<td>
|
|
|
|
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table></div>
|
|
</div>
|
|
<hr>
|
|
<div class="refsect2" lang="en">
|
|
<a name="id2607311"></a><h3>
|
|
<a name="gimp-controller-event"></a>gimp_controller_event ()</h3>
|
|
<a class="indexterm" name="id2607322"></a><pre class="programlisting">gboolean gimp_controller_event (<a href="GimpController.html" title="GimpController">GimpController</a> *controller,
|
|
const <a href="GimpController.html#GimpControllerEvent">GimpControllerEvent</a> *event);</pre>
|
|
<p>
|
|
|
|
</p>
|
|
<div class="variablelist"><table border="0">
|
|
<col align="left" valign="top">
|
|
<tbody>
|
|
<tr>
|
|
<td>
|
|
<span class="term"><em class="parameter"><code>controller</code></em> :</span></td>
|
|
<td>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td>
|
|
<span class="term"><em class="parameter"><code>event</code></em> :</span></td>
|
|
<td>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td>
|
|
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
|
|
<td>
|
|
|
|
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table></div>
|
|
</div>
|
|
</div>
|
|
<div class="refsect1" lang="en">
|
|
<a name="property_details"></a><h2>Property Details</h2>
|
|
<div class="refsect2" lang="en">
|
|
<a name="id2607413"></a><h3>
|
|
<a name="GimpController--name"></a>The "<code class="literal">name</code>" property</h3>
|
|
<a class="indexterm" name="id2607427"></a><pre class="programlisting"> "name" gchararray : Read / Write / Construct</pre>
|
|
<p></p>
|
|
<p>Default value: "Unnamed Controller"</p>
|
|
</div>
|
|
<hr>
|
|
<div class="refsect2" lang="en">
|
|
<a name="id2607451"></a><h3>
|
|
<a name="GimpController--state"></a>The "<code class="literal">state</code>" property</h3>
|
|
<a class="indexterm" name="id2607465"></a><pre class="programlisting"> "state" gchararray : Read / Write / Construct</pre>
|
|
<p></p>
|
|
<p>Default value: "Unknown"</p>
|
|
</div>
|
|
</div>
|
|
<div class="refsect1" lang="en">
|
|
<a name="signals"></a><h2>Signal Details</h2>
|
|
<div class="refsect2" lang="en">
|
|
<a name="id2607501"></a><h3>
|
|
<a name="GimpController-event"></a>The "event" signal</h3>
|
|
<a class="indexterm" name="id2607509"></a><pre class="programlisting">gboolean user_function (<a href="GimpController.html" title="GimpController">GimpController</a> *gimpcontroller,
|
|
gpointer arg1,
|
|
gpointer user_data) : Run last</pre>
|
|
<p>
|
|
|
|
</p>
|
|
<div class="variablelist"><table border="0">
|
|
<col align="left" valign="top">
|
|
<tbody>
|
|
<tr>
|
|
<td>
|
|
<span class="term"><em class="parameter"><code>gimpcontroller</code></em> :</span></td>
|
|
<td>the object which received the signal.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td>
|
|
<span class="term"><em class="parameter"><code>arg1</code></em> :</span></td>
|
|
<td>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td>
|
|
<span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
|
|
<td>user data set when the signal handler was connected.</td>
|
|
</tr>
|
|
<tr>
|
|
<td>
|
|
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
|
|
<td>
|
|
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table></div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html>
|