1
<?xml version="1.0" encoding="UTF-8" ?>
2
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
3
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
5
<refentry id="libgimp-gimppatternselect">
7
<refentrytitle role="top_of_page" id="libgimp-gimppatternselect.top_of_page">gimppatternselect</refentrytitle>
8
<manvolnum>3</manvolnum>
9
<refmiscinfo>LIBGIMP Library</refmiscinfo>
13
<refname>gimppatternselect</refname>
14
<refpurpose>Functions providing a pattern selection dialog.</refpurpose>
17
<refsynopsisdiv id="libgimp-gimppatternselect.synopsis" role="synopsis">
18
<title role="synopsis.title">Synopsis</title>
21
<link linkend="void">void</link> (<link linkend="GimpRunPatternCallback">*GimpRunPatternCallback</link>) (const <link linkend="gchar">gchar</link> *pattern_name,
22
<link linkend="gint">gint</link> width,
23
<link linkend="gint">gint</link> height,
24
<link linkend="gint">gint</link> bpp,
25
const <link linkend="guchar">guchar</link> *mask_data,
26
<link linkend="gboolean">gboolean</link> dialog_closing,
27
<link linkend="gpointer">gpointer</link> user_data);
28
const <link linkend="gchar">gchar</link> * <link linkend="gimp-pattern-select-new">gimp_pattern_select_new</link> (const <link linkend="gchar">gchar</link> *title,
29
const <link linkend="gchar">gchar</link> *pattern_name,
30
<link linkend="GimpRunPatternCallback">GimpRunPatternCallback</link> callback,
31
<link linkend="gpointer">gpointer</link> data);
32
<link linkend="void">void</link> <link linkend="gimp-pattern-select-destroy">gimp_pattern_select_destroy</link> (const <link linkend="gchar">gchar</link> *pattern_callback);
33
<link linkend="gboolean">gboolean</link> <link linkend="gimp-patterns-popup">gimp_patterns_popup</link> (const <link linkend="gchar">gchar</link> *pattern_callback,
34
const <link linkend="gchar">gchar</link> *popup_title,
35
const <link linkend="gchar">gchar</link> *initial_pattern);
36
<link linkend="gboolean">gboolean</link> <link linkend="gimp-patterns-close-popup">gimp_patterns_close_popup</link> (const <link linkend="gchar">gchar</link> *pattern_callback);
37
<link linkend="gboolean">gboolean</link> <link linkend="gimp-patterns-set-popup">gimp_patterns_set_popup</link> (const <link linkend="gchar">gchar</link> *pattern_callback,
38
const <link linkend="gchar">gchar</link> *pattern_name);
50
<refsect1 id="libgimp-gimppatternselect.description" role="desc">
51
<title role="desc.title">Description</title>
53
Functions providing a pattern selection dialog.
57
<refsect1 id="libgimp-gimppatternselect.details" role="details">
58
<title role="details.title">Details</title>
59
<refsect2 id="GimpRunPatternCallback" role="function">
60
<title>GimpRunPatternCallback ()</title>
61
<indexterm zone="GimpRunPatternCallback"><primary sortas="GimpRunPatternCallback">GimpRunPatternCallback</primary></indexterm><programlisting><link linkend="void">void</link> (*GimpRunPatternCallback) (const <link linkend="gchar">gchar</link> *pattern_name,
62
<link linkend="gint">gint</link> width,
63
<link linkend="gint">gint</link> height,
64
<link linkend="gint">gint</link> bpp,
65
const <link linkend="guchar">guchar</link> *mask_data,
66
<link linkend="gboolean">gboolean</link> dialog_closing,
67
<link linkend="gpointer">gpointer</link> user_data);</programlisting>
69
</para><variablelist role="params">
70
<varlistentry><term><parameter>pattern_name</parameter> :</term>
72
</simpara></listitem></varlistentry>
73
<varlistentry><term><parameter>width</parameter> :</term>
75
</simpara></listitem></varlistentry>
76
<varlistentry><term><parameter>height</parameter> :</term>
78
</simpara></listitem></varlistentry>
79
<varlistentry><term><parameter>bpp</parameter> :</term>
81
</simpara></listitem></varlistentry>
82
<varlistentry><term><parameter>mask_data</parameter> :</term>
84
</simpara></listitem></varlistentry>
85
<varlistentry><term><parameter>dialog_closing</parameter> :</term>
87
</simpara></listitem></varlistentry>
88
<varlistentry><term><parameter>user_data</parameter> :</term>
90
</simpara></listitem></varlistentry>
91
</variablelist></refsect2>
92
<refsect2 id="gimp-pattern-select-new" role="function">
93
<title>gimp_pattern_select_new ()</title>
94
<indexterm zone="gimp-pattern-select-new"><primary sortas="gimp_pattern_select_new">gimp_pattern_select_new</primary></indexterm><programlisting>const <link linkend="gchar">gchar</link> * gimp_pattern_select_new (const <link linkend="gchar">gchar</link> *title,
95
const <link linkend="gchar">gchar</link> *pattern_name,
96
<link linkend="GimpRunPatternCallback">GimpRunPatternCallback</link> callback,
97
<link linkend="gpointer">gpointer</link> data);</programlisting>
99
</para><variablelist role="params">
100
<varlistentry><term><parameter>title</parameter> :</term>
102
</simpara></listitem></varlistentry>
103
<varlistentry><term><parameter>pattern_name</parameter> :</term>
105
</simpara></listitem></varlistentry>
106
<varlistentry><term><parameter>callback</parameter> :</term>
108
</simpara></listitem></varlistentry>
109
<varlistentry><term><parameter>data</parameter> :</term>
111
</simpara></listitem></varlistentry>
112
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>
113
</simpara></listitem></varlistentry>
114
</variablelist></refsect2>
115
<refsect2 id="gimp-pattern-select-destroy" role="function">
116
<title>gimp_pattern_select_destroy ()</title>
117
<indexterm zone="gimp-pattern-select-destroy"><primary sortas="gimp_pattern_select_destroy">gimp_pattern_select_destroy</primary></indexterm><programlisting><link linkend="void">void</link> gimp_pattern_select_destroy (const <link linkend="gchar">gchar</link> *pattern_callback);</programlisting>
119
</para><variablelist role="params">
120
<varlistentry><term><parameter>pattern_callback</parameter> :</term>
122
</simpara></listitem></varlistentry>
123
</variablelist></refsect2>
124
<refsect2 id="gimp-patterns-popup" role="function">
125
<title>gimp_patterns_popup ()</title>
126
<indexterm zone="gimp-patterns-popup"><primary sortas="gimp_patterns_popup">gimp_patterns_popup</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link> gimp_patterns_popup (const <link linkend="gchar">gchar</link> *pattern_callback,
127
const <link linkend="gchar">gchar</link> *popup_title,
128
const <link linkend="gchar">gchar</link> *initial_pattern);</programlisting>
130
Invokes the Gimp pattern selection.
133
This procedure opens the pattern selection dialog.</para>
135
</para><variablelist role="params">
136
<varlistentry><term><parameter>pattern_callback</parameter> :</term>
137
<listitem><simpara> The callback PDB proc to call when pattern selection is made.
138
</simpara></listitem></varlistentry>
139
<varlistentry><term><parameter>popup_title</parameter> :</term>
140
<listitem><simpara> Title of the pattern selection dialog.
141
</simpara></listitem></varlistentry>
142
<varlistentry><term><parameter>initial_pattern</parameter> :</term>
143
<listitem><simpara> The name of the pattern to set as the first selected.
144
</simpara></listitem></varlistentry>
145
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> TRUE on success.
146
</simpara></listitem></varlistentry>
147
</variablelist></refsect2>
148
<refsect2 id="gimp-patterns-close-popup" role="function">
149
<title>gimp_patterns_close_popup ()</title>
150
<indexterm zone="gimp-patterns-close-popup"><primary sortas="gimp_patterns_close_popup">gimp_patterns_close_popup</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link> gimp_patterns_close_popup (const <link linkend="gchar">gchar</link> *pattern_callback);</programlisting>
152
Close the pattern selection dialog.
155
This procedure closes an opened pattern selection dialog.</para>
157
</para><variablelist role="params">
158
<varlistentry><term><parameter>pattern_callback</parameter> :</term>
159
<listitem><simpara> The name of the callback registered for this pop-up.
160
</simpara></listitem></varlistentry>
161
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> TRUE on success.
162
</simpara></listitem></varlistentry>
163
</variablelist></refsect2>
164
<refsect2 id="gimp-patterns-set-popup" role="function">
165
<title>gimp_patterns_set_popup ()</title>
166
<indexterm zone="gimp-patterns-set-popup"><primary sortas="gimp_patterns_set_popup">gimp_patterns_set_popup</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link> gimp_patterns_set_popup (const <link linkend="gchar">gchar</link> *pattern_callback,
167
const <link linkend="gchar">gchar</link> *pattern_name);</programlisting>
169
Sets the current pattern in a pattern selection dialog.
172
Sets the current pattern in a pattern selection dialog.</para>
174
</para><variablelist role="params">
175
<varlistentry><term><parameter>pattern_callback</parameter> :</term>
176
<listitem><simpara> The name of the callback registered for this pop-up.
177
</simpara></listitem></varlistentry>
178
<varlistentry><term><parameter>pattern_name</parameter> :</term>
179
<listitem><simpara> The name of the pattern to set as selected.
180
</simpara></listitem></varlistentry>
181
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> TRUE on success.
182
</simpara></listitem></varlistentry>
183
</variablelist></refsect2>