32
31
<link linkend="void">void</link> <link linkend="gimp-zoom-model-get-fraction">gimp_zoom_model_get_fraction</link> (<link linkend="GimpZoomModel">GimpZoomModel</link> *model,
33
32
<link linkend="gint">gint</link> *numerator,
34
33
<link linkend="gint">gint</link> *denominator);
35
<link linkend="GtkWidget">GtkWidget</link>* <link linkend="gimp-zoom-button-new">gimp_zoom_button_new</link> (<link linkend="GimpZoomModel">GimpZoomModel</link> *model,
34
<link linkend="GtkWidget">GtkWidget</link> * <link linkend="gimp-zoom-button-new">gimp_zoom_button_new</link> (<link linkend="GimpZoomModel">GimpZoomModel</link> *model,
36
35
<link linkend="GimpZoomType">GimpZoomType</link> zoom_type,
37
36
<link linkend="GtkIconSize">GtkIconSize</link> icon_size);
38
37
<link linkend="gdouble">gdouble</link> <link linkend="gimp-zoom-model-zoom-step">gimp_zoom_model_zoom_step</link> (<link linkend="GimpZoomType">GimpZoomType</link> zoom_type,
83
80
<title role="details.title">Details</title>
84
81
<refsect2 id="GimpZoomModel-struct" role="struct">
85
82
<title>GimpZoomModel</title>
86
<indexterm zone="GimpZoomModel-struct"><primary>GimpZoomModel</primary></indexterm><programlisting>typedef struct _GimpZoomModel GimpZoomModel;</programlisting>
83
<indexterm zone="GimpZoomModel-struct"><primary sortas="GimpZoomModel">GimpZoomModel</primary></indexterm><programlisting>typedef struct _GimpZoomModel GimpZoomModel;</programlisting>
90
86
<refsect2 id="GimpZoomType" role="enum">
91
87
<title>enum GimpZoomType</title>
92
<indexterm zone="GimpZoomType"><primary>GimpZoomType</primary></indexterm><programlisting>typedef enum
88
<indexterm zone="GimpZoomType"><primary sortas="GimpZoomType">GimpZoomType</primary></indexterm><programlisting>typedef enum
94
90
GIMP_ZOOM_IN, /*< desc="Zoom in" >*/
95
91
GIMP_ZOOM_OUT, /*< desc="Zoom out" >*/
105
100
</para></refsect2>
106
101
<refsect2 id="gimp-zoom-model-new" role="function">
107
102
<title>gimp_zoom_model_new ()</title>
108
<indexterm zone="gimp-zoom-model-new"><primary>gimp_zoom_model_new</primary></indexterm><programlisting><link linkend="GimpZoomModel">GimpZoomModel</link>* gimp_zoom_model_new (void);</programlisting>
103
<indexterm zone="gimp-zoom-model-new"><primary sortas="gimp_zoom_model_new">gimp_zoom_model_new</primary></indexterm><programlisting><link linkend="GimpZoomModel">GimpZoomModel</link> * gimp_zoom_model_new (void);</programlisting>
110
105
Creates a new <link linkend="GimpZoomModel"><type>GimpZoomModel</type></link>.</para>
113
107
</para><variablelist role="params">
114
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> a new <link linkend="GimpZoomModel"><type>GimpZoomModel</type></link>.
108
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> a new <link linkend="GimpZoomModel"><type>GimpZoomModel</type></link>.
117
111
</simpara></listitem></varlistentry>
118
112
</variablelist></refsect2>
119
113
<refsect2 id="gimp-zoom-model-set-range" role="function">
120
114
<title>gimp_zoom_model_set_range ()</title>
121
<indexterm zone="gimp-zoom-model-set-range"><primary>gimp_zoom_model_set_range</primary></indexterm><programlisting><link linkend="void">void</link> gimp_zoom_model_set_range (<link linkend="GimpZoomModel">GimpZoomModel</link> *model,
115
<indexterm zone="gimp-zoom-model-set-range"><primary sortas="gimp_zoom_model_set_range">gimp_zoom_model_set_range</primary></indexterm><programlisting><link linkend="void">void</link> gimp_zoom_model_set_range (<link linkend="GimpZoomModel">GimpZoomModel</link> *model,
122
116
<link linkend="gdouble">gdouble</link> min,
123
117
<link linkend="gdouble">gdouble</link> max);</programlisting>
128
122
Since GIMP 2.4</para>
131
124
</para><variablelist role="params">
132
<varlistentry><term><parameter>model</parameter> :</term>
125
<varlistentry><term><parameter>model</parameter> :</term>
133
126
<listitem><simpara> a <link linkend="GimpZoomModel"><type>GimpZoomModel</type></link>
134
127
</simpara></listitem></varlistentry>
135
<varlistentry><term><parameter>min</parameter> :</term>
128
<varlistentry><term><parameter>min</parameter> :</term>
136
129
<listitem><simpara> new lower limit for zoom factor
137
130
</simpara></listitem></varlistentry>
138
<varlistentry><term><parameter>max</parameter> :</term>
131
<varlistentry><term><parameter>max</parameter> :</term>
139
132
<listitem><simpara> new upper limit for zoom factor
140
133
</simpara></listitem></varlistentry>
141
134
</variablelist></refsect2>
142
135
<refsect2 id="gimp-zoom-model-zoom" role="function">
143
136
<title>gimp_zoom_model_zoom ()</title>
144
<indexterm zone="gimp-zoom-model-zoom"><primary>gimp_zoom_model_zoom</primary></indexterm><programlisting><link linkend="void">void</link> gimp_zoom_model_zoom (<link linkend="GimpZoomModel">GimpZoomModel</link> *model,
137
<indexterm zone="gimp-zoom-model-zoom"><primary sortas="gimp_zoom_model_zoom">gimp_zoom_model_zoom</primary></indexterm><programlisting><link linkend="void">void</link> gimp_zoom_model_zoom (<link linkend="GimpZoomModel">GimpZoomModel</link> *model,
145
138
<link linkend="GimpZoomType">GimpZoomType</link> zoom_type,
146
139
<link linkend="gdouble">gdouble</link> scale);</programlisting>
148
141
Since GIMP 2.4</para>
151
143
</para><variablelist role="params">
152
<varlistentry><term><parameter>model</parameter> :</term>
144
<varlistentry><term><parameter>model</parameter> :</term>
153
145
<listitem><simpara> a <link linkend="GimpZoomModel"><type>GimpZoomModel</type></link>
154
146
</simpara></listitem></varlistentry>
155
<varlistentry><term><parameter>zoom_type</parameter> :</term>
147
<varlistentry><term><parameter>zoom_type</parameter> :</term>
156
148
<listitem><simpara> the <link linkend="GimpZoomType"><type>GimpZoomType</type></link>
157
149
</simpara></listitem></varlistentry>
158
<varlistentry><term><parameter>scale</parameter> :</term>
159
<listitem><simpara> ignored unless <parameter>zoom_type</parameter> == <link linkend="GIMP-ZOOM-TO:CAPS"><literal>GIMP_ZOOM_TO</literal></link>
150
<varlistentry><term><parameter>scale</parameter> :</term>
151
<listitem><simpara> ignored unless <parameter>zoom_type</parameter> == <link linkend="GIMP-ZOOM-TO--CAPS"><literal>GIMP_ZOOM_TO</literal></link>
160
152
</simpara></listitem></varlistentry>
161
153
</variablelist></refsect2>
162
154
<refsect2 id="gimp-zoom-model-get-factor" role="function">
163
155
<title>gimp_zoom_model_get_factor ()</title>
164
<indexterm zone="gimp-zoom-model-get-factor"><primary>gimp_zoom_model_get_factor</primary></indexterm><programlisting><link linkend="gdouble">gdouble</link> gimp_zoom_model_get_factor (<link linkend="GimpZoomModel">GimpZoomModel</link> *model);</programlisting>
156
<indexterm zone="gimp-zoom-model-get-factor"><primary sortas="gimp_zoom_model_get_factor">gimp_zoom_model_get_factor</primary></indexterm><programlisting><link linkend="gdouble">gdouble</link> gimp_zoom_model_get_factor (<link linkend="GimpZoomModel">GimpZoomModel</link> *model);</programlisting>
166
158
Retrieves the current zoom factor of <parameter>model</parameter>.</para>
169
160
</para><variablelist role="params">
170
<varlistentry><term><parameter>model</parameter> :</term>
161
<varlistentry><term><parameter>model</parameter> :</term>
171
162
<listitem><simpara> a <link linkend="GimpZoomModel"><type>GimpZoomModel</type></link>
172
163
</simpara></listitem></varlistentry>
173
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the current scale factor
164
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the current scale factor
176
167
</simpara></listitem></varlistentry>
177
168
</variablelist></refsect2>
178
169
<refsect2 id="gimp-zoom-model-get-fraction" role="function">
179
170
<title>gimp_zoom_model_get_fraction ()</title>
180
<indexterm zone="gimp-zoom-model-get-fraction"><primary>gimp_zoom_model_get_fraction</primary></indexterm><programlisting><link linkend="void">void</link> gimp_zoom_model_get_fraction (<link linkend="GimpZoomModel">GimpZoomModel</link> *model,
171
<indexterm zone="gimp-zoom-model-get-fraction"><primary sortas="gimp_zoom_model_get_fraction">gimp_zoom_model_get_fraction</primary></indexterm><programlisting><link linkend="void">void</link> gimp_zoom_model_get_fraction (<link linkend="GimpZoomModel">GimpZoomModel</link> *model,
181
172
<link linkend="gint">gint</link> *numerator,
182
173
<link linkend="gint">gint</link> *denominator);</programlisting>
187
178
Since GIMP 2.4</para>
190
180
</para><variablelist role="params">
191
<varlistentry><term><parameter>model</parameter> :</term>
181
<varlistentry><term><parameter>model</parameter> :</term>
192
182
<listitem><simpara> a <link linkend="GimpZoomModel"><type>GimpZoomModel</type></link>
193
183
</simpara></listitem></varlistentry>
194
<varlistentry><term><parameter>numerator</parameter> :</term>
184
<varlistentry><term><parameter>numerator</parameter> :</term>
195
185
<listitem><simpara> return location for numerator
196
186
</simpara></listitem></varlistentry>
197
<varlistentry><term><parameter>denominator</parameter> :</term>
187
<varlistentry><term><parameter>denominator</parameter> :</term>
198
188
<listitem><simpara> return location for denominator
199
189
</simpara></listitem></varlistentry>
200
190
</variablelist></refsect2>
201
191
<refsect2 id="gimp-zoom-button-new" role="function">
202
192
<title>gimp_zoom_button_new ()</title>
203
<indexterm zone="gimp-zoom-button-new"><primary>gimp_zoom_button_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>* gimp_zoom_button_new (<link linkend="GimpZoomModel">GimpZoomModel</link> *model,
193
<indexterm zone="gimp-zoom-button-new"><primary sortas="gimp_zoom_button_new">gimp_zoom_button_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link> * gimp_zoom_button_new (<link linkend="GimpZoomModel">GimpZoomModel</link> *model,
204
194
<link linkend="GimpZoomType">GimpZoomType</link> zoom_type,
205
195
<link linkend="GtkIconSize">GtkIconSize</link> icon_size);</programlisting>
210
199
</para><variablelist role="params">
211
<varlistentry><term><parameter>model</parameter> :</term>
200
<varlistentry><term><parameter>model</parameter> :</term>
212
201
<listitem><simpara> a <link linkend="GimpZoomModel"><type>GimpZoomModel</type></link>
213
202
</simpara></listitem></varlistentry>
214
<varlistentry><term><parameter>zoom_type</parameter> :</term>
203
<varlistentry><term><parameter>zoom_type</parameter> :</term>
215
204
<listitem><simpara>
216
205
</simpara></listitem></varlistentry>
217
<varlistentry><term><parameter>icon_size</parameter> :</term>
206
<varlistentry><term><parameter>icon_size</parameter> :</term>
218
207
<listitem><simpara> use 0 for a button with text labels
219
208
</simpara></listitem></varlistentry>
220
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> a newly created GtkButton
209
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> a newly created GtkButton
223
212
</simpara></listitem></varlistentry>
224
213
</variablelist></refsect2>
225
214
<refsect2 id="gimp-zoom-model-zoom-step" role="function">
226
215
<title>gimp_zoom_model_zoom_step ()</title>
227
<indexterm zone="gimp-zoom-model-zoom-step"><primary>gimp_zoom_model_zoom_step</primary></indexterm><programlisting><link linkend="gdouble">gdouble</link> gimp_zoom_model_zoom_step (<link linkend="GimpZoomType">GimpZoomType</link> zoom_type,
216
<indexterm zone="gimp-zoom-model-zoom-step"><primary sortas="gimp_zoom_model_zoom_step">gimp_zoom_model_zoom_step</primary></indexterm><programlisting><link linkend="gdouble">gdouble</link> gimp_zoom_model_zoom_step (<link linkend="GimpZoomType">GimpZoomType</link> zoom_type,
228
217
<link linkend="gdouble">gdouble</link> scale);</programlisting>
230
219
Utility function to calculate a new scale factor.</para>
233
221
</para><variablelist role="params">
234
<varlistentry><term><parameter>zoom_type</parameter> :</term>
222
<varlistentry><term><parameter>zoom_type</parameter> :</term>
235
223
<listitem><simpara>
236
224
</simpara></listitem></varlistentry>
237
<varlistentry><term><parameter>scale</parameter> :</term>
238
<listitem><simpara> ignored unless <parameter>zoom_type</parameter> == <link linkend="GIMP-ZOOM-TO:CAPS"><literal>GIMP_ZOOM_TO</literal></link>
225
<varlistentry><term><parameter>scale</parameter> :</term>
226
<listitem><simpara> ignored unless <parameter>zoom_type</parameter> == <link linkend="GIMP-ZOOM-TO--CAPS"><literal>GIMP_ZOOM_TO</literal></link>
239
227
</simpara></listitem></varlistentry>
240
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the new scale factor
228
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the new scale factor
243
231
</simpara></listitem></varlistentry>
247
235
<refsect1 id="GimpZoomModel.property-details" role="property_details">
248
236
<title role="property_details.title">Property Details</title>
249
<refsect2 id="GimpZoomModel--fraction"><title>The <literal>"fraction"</literal> property</title>
250
<indexterm zone="GimpZoomModel--fraction"><primary>GimpZoomModel:fraction</primary></indexterm><programlisting> "fraction" <link linkend="gchar">gchar</link>* : Read</programlisting>
237
<refsect2 id="GimpZoomModel--fraction" role="property"><title>The <literal>"fraction"</literal> property</title>
238
<indexterm zone="GimpZoomModel--fraction"><primary sortas="GimpZoomModel:fraction">GimpZoomModel:fraction</primary></indexterm><programlisting> "fraction" <link linkend="gchar">gchar</link>* : Read</programlisting>
251
239
<para></para><para>Default value: "1:1"</para>
253
<refsect2 id="GimpZoomModel--maximum"><title>The <literal>"maximum"</literal> property</title>
254
<indexterm zone="GimpZoomModel--maximum"><primary>GimpZoomModel:maximum</primary></indexterm><programlisting> "maximum" <link linkend="gdouble">gdouble</link> : Read / Write</programlisting>
241
<refsect2 id="GimpZoomModel--maximum" role="property"><title>The <literal>"maximum"</literal> property</title>
242
<indexterm zone="GimpZoomModel--maximum"><primary sortas="GimpZoomModel:maximum">GimpZoomModel:maximum</primary></indexterm><programlisting> "maximum" <link linkend="gdouble">gdouble</link> : Read / Write</programlisting>
255
243
<para></para><para>Allowed values: [0.00390625,256]</para>
256
244
<para>Default value: 256</para>
258
<refsect2 id="GimpZoomModel--minimum"><title>The <literal>"minimum"</literal> property</title>
259
<indexterm zone="GimpZoomModel--minimum"><primary>GimpZoomModel:minimum</primary></indexterm><programlisting> "minimum" <link linkend="gdouble">gdouble</link> : Read / Write</programlisting>
246
<refsect2 id="GimpZoomModel--minimum" role="property"><title>The <literal>"minimum"</literal> property</title>
247
<indexterm zone="GimpZoomModel--minimum"><primary sortas="GimpZoomModel:minimum">GimpZoomModel:minimum</primary></indexterm><programlisting> "minimum" <link linkend="gdouble">gdouble</link> : Read / Write</programlisting>
260
248
<para></para><para>Allowed values: [0.00390625,256]</para>
261
249
<para>Default value: 0.00390625</para>
263
<refsect2 id="GimpZoomModel--percentage"><title>The <literal>"percentage"</literal> property</title>
264
<indexterm zone="GimpZoomModel--percentage"><primary>GimpZoomModel:percentage</primary></indexterm><programlisting> "percentage" <link linkend="gchar">gchar</link>* : Read</programlisting>
251
<refsect2 id="GimpZoomModel--percentage" role="property"><title>The <literal>"percentage"</literal> property</title>
252
<indexterm zone="GimpZoomModel--percentage"><primary sortas="GimpZoomModel:percentage">GimpZoomModel:percentage</primary></indexterm><programlisting> "percentage" <link linkend="gchar">gchar</link>* : Read</programlisting>
265
253
<para></para><para>Default value: "100%"</para>
267
<refsect2 id="GimpZoomModel--value"><title>The <literal>"value"</literal> property</title>
268
<indexterm zone="GimpZoomModel--value"><primary>GimpZoomModel:value</primary></indexterm><programlisting> "value" <link linkend="gdouble">gdouble</link> : Read / Write</programlisting>
255
<refsect2 id="GimpZoomModel--value" role="property"><title>The <literal>"value"</literal> property</title>
256
<indexterm zone="GimpZoomModel--value"><primary sortas="GimpZoomModel:value">GimpZoomModel:value</primary></indexterm><programlisting> "value" <link linkend="gdouble">gdouble</link> : Read / Write</programlisting>
269
257
<para></para><para>Allowed values: [0.00390625,256]</para>
270
258
<para>Default value: 1</para>
275
262
<refsect1 id="GimpZoomModel.signal-details" role="signals">
276
263
<title role="signals.title">Signal Details</title>
277
<refsect2 id="GimpZoomModel-zoomed"><title>The <literal>"zoomed"</literal> signal</title>
278
<indexterm zone="GimpZoomModel-zoomed"><primary>GimpZoomModel::zoomed</primary></indexterm><programlisting><link linkend="void">void</link> user_function (<link linkend="GimpZoomModel">GimpZoomModel</link> *model,
264
<refsect2 id="GimpZoomModel-zoomed" role="signal"><title>The <literal>"zoomed"</literal> signal</title>
265
<indexterm zone="GimpZoomModel-zoomed"><primary sortas="GimpZoomModel::zoomed">GimpZoomModel::zoomed</primary></indexterm><programlisting><link linkend="void">void</link> user_function (<link linkend="GimpZoomModel">GimpZoomModel</link> *model,
279
266
<link linkend="gdouble">gdouble</link> old_factor,
280
267
<link linkend="gdouble">gdouble</link> new_factor,
281
268
<link linkend="gpointer">gpointer</link> user_data) : Run Last</programlisting>
283
270
Emitted when the zoom factor of the zoom model changes.</para>
286
272
</para><variablelist role="params">
287
<varlistentry><term><parameter>model</parameter> :</term>
273
<varlistentry><term><parameter>model</parameter> :</term>
288
274
<listitem><simpara> the object that received the signal
289
275
</simpara></listitem></varlistentry>
290
<varlistentry><term><parameter>old_factor</parameter> :</term>
276
<varlistentry><term><parameter>old_factor</parameter> :</term>
291
277
<listitem><simpara> the zoom factor before it changes
292
278
</simpara></listitem></varlistentry>
293
<varlistentry><term><parameter>new_factor</parameter> :</term>
279
<varlistentry><term><parameter>new_factor</parameter> :</term>
294
280
<listitem><simpara> the zoom factor after it has changed.
295
281
</simpara></listitem></varlistentry>
296
<varlistentry><term><parameter>user_data</parameter> :</term>
282
<varlistentry><term><parameter>user_data</parameter> :</term>
297
283
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
298
284
</variablelist></refsect2>