132
<refsect1 role="desc">
128
<refsect1 id="libgimpcolor-GimpRGB.description" role="desc">
133
129
<title role="desc.title">Description</title>
135
131
Definitions and Functions relating to RGB colors.
139
<refsect1 role="details">
135
<refsect1 id="libgimpcolor-GimpRGB.details" role="details">
140
136
<title role="details.title">Details</title>
142
<title><anchor id="GimpRGB" role="struct"/>GimpRGB</title>
143
<indexterm><primary>GimpRGB</primary></indexterm><programlisting>typedef struct {
137
<refsect2 id="GimpRGB" role="struct">
138
<title>GimpRGB</title>
139
<indexterm zone="GimpRGB"><primary>GimpRGB</primary></indexterm><programlisting>typedef struct {
144
140
gdouble r, g, b, a;
146
142
</programlisting>
149
145
</para></refsect2>
151
<title><anchor id="GimpRGBCompositeMode" role="enum"/>enum GimpRGBCompositeMode</title>
152
<indexterm><primary>GimpRGBCompositeMode</primary></indexterm><programlisting>typedef enum
146
<refsect2 id="GimpRGBCompositeMode" role="enum">
147
<title>enum GimpRGBCompositeMode</title>
148
<indexterm zone="GimpRGBCompositeMode"><primary>GimpRGBCompositeMode</primary></indexterm><programlisting>typedef enum
154
150
GIMP_RGB_COMPOSITE_NONE = 0,
155
151
GIMP_RGB_COMPOSITE_NORMAL,
161
157
</para></refsect2>
163
<title><anchor id="gimp-rgb-set" role="function"/>gimp_rgb_set ()</title>
164
<indexterm><primary>gimp_rgb_set</primary></indexterm><programlisting><link linkend="void">void</link> gimp_rgb_set (<link linkend="GimpRGB">GimpRGB</link> *rgb,
158
<refsect2 id="gimp-rgb-set" role="function">
159
<title>gimp_rgb_set ()</title>
160
<indexterm zone="gimp-rgb-set"><primary>gimp_rgb_set</primary></indexterm><programlisting><link linkend="void">void</link> gimp_rgb_set (<link linkend="GimpRGB">GimpRGB</link> *rgb,
165
161
<link linkend="gdouble">gdouble</link> red,
166
162
<link linkend="gdouble">gdouble</link> green,
167
163
<link linkend="gdouble">gdouble</link> blue);</programlisting>
186
182
<listitem><simpara>
187
183
</simpara></listitem></varlistentry>
188
184
</variablelist></refsect2>
190
<title><anchor id="gimp-rgb-set-alpha" role="function"/>gimp_rgb_set_alpha ()</title>
191
<indexterm><primary>gimp_rgb_set_alpha</primary></indexterm><programlisting><link linkend="void">void</link> gimp_rgb_set_alpha (<link linkend="GimpRGB">GimpRGB</link> *rgb,
185
<refsect2 id="gimp-rgb-set-alpha" role="function">
186
<title>gimp_rgb_set_alpha ()</title>
187
<indexterm zone="gimp-rgb-set-alpha"><primary>gimp_rgb_set_alpha</primary></indexterm><programlisting><link linkend="void">void</link> gimp_rgb_set_alpha (<link linkend="GimpRGB">GimpRGB</link> *rgb,
192
188
<link linkend="gdouble">gdouble</link> alpha);</programlisting>
194
190
Sets the alpha component of <parameter>rgb</parameter> and leaves the RGB components unchanged.</para>
202
198
<listitem><simpara>
203
199
</simpara></listitem></varlistentry>
204
200
</variablelist></refsect2>
206
<title><anchor id="gimp-rgb-set-uchar" role="function"/>gimp_rgb_set_uchar ()</title>
207
<indexterm><primary>gimp_rgb_set_uchar</primary></indexterm><programlisting><link linkend="void">void</link> gimp_rgb_set_uchar (<link linkend="GimpRGB">GimpRGB</link> *rgb,
201
<refsect2 id="gimp-rgb-set-uchar" role="function">
202
<title>gimp_rgb_set_uchar ()</title>
203
<indexterm zone="gimp-rgb-set-uchar"><primary>gimp_rgb_set_uchar</primary></indexterm><programlisting><link linkend="void">void</link> gimp_rgb_set_uchar (<link linkend="GimpRGB">GimpRGB</link> *rgb,
208
204
<link linkend="guchar">guchar</link> red,
209
205
<link linkend="guchar">guchar</link> green,
210
206
<link linkend="guchar">guchar</link> blue);</programlisting>
227
223
<listitem><simpara>
228
224
</simpara></listitem></varlistentry>
229
225
</variablelist></refsect2>
231
<title><anchor id="gimp-rgb-get-uchar" role="function"/>gimp_rgb_get_uchar ()</title>
232
<indexterm><primary>gimp_rgb_get_uchar</primary></indexterm><programlisting><link linkend="void">void</link> gimp_rgb_get_uchar (const <link linkend="GimpRGB">GimpRGB</link> *rgb,
226
<refsect2 id="gimp-rgb-get-uchar" role="function">
227
<title>gimp_rgb_get_uchar ()</title>
228
<indexterm zone="gimp-rgb-get-uchar"><primary>gimp_rgb_get_uchar</primary></indexterm><programlisting><link linkend="void">void</link> gimp_rgb_get_uchar (const <link linkend="GimpRGB">GimpRGB</link> *rgb,
233
229
<link linkend="guchar">guchar</link> *red,
234
230
<link linkend="guchar">guchar</link> *green,
235
231
<link linkend="guchar">guchar</link> *blue);</programlisting>
252
248
</simpara></listitem></varlistentry>
253
249
</variablelist></refsect2>
255
<title><anchor id="gimp-rgb-parse-name" role="function" condition="since:GIMP 2.2"/>gimp_rgb_parse_name ()</title>
256
<indexterm role="GIMP 2.2"><primary>gimp_rgb_parse_name</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link> gimp_rgb_parse_name (<link linkend="GimpRGB">GimpRGB</link> *rgb,
250
<refsect2 id="gimp-rgb-parse-name" role="function" condition="since:GIMP 2.2">
251
<title>gimp_rgb_parse_name ()</title>
252
<indexterm zone="gimp-rgb-parse-name" role="GIMP 2.2"><primary>gimp_rgb_parse_name</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link> gimp_rgb_parse_name (<link linkend="GimpRGB">GimpRGB</link> *rgb,
257
253
const <link linkend="gchar">gchar</link> *name,
258
254
<link linkend="gint">gint</link> len);</programlisting>
280
276
</simpara></listitem></varlistentry>
281
277
</variablelist><para role="since">Since GIMP 2.2
282
278
</para></refsect2>
284
<title><anchor id="gimp-rgb-parse-hex" role="function" condition="since:GIMP 2.2"/>gimp_rgb_parse_hex ()</title>
285
<indexterm role="GIMP 2.2"><primary>gimp_rgb_parse_hex</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link> gimp_rgb_parse_hex (<link linkend="GimpRGB">GimpRGB</link> *rgb,
279
<refsect2 id="gimp-rgb-parse-hex" role="function" condition="since:GIMP 2.2">
280
<title>gimp_rgb_parse_hex ()</title>
281
<indexterm zone="gimp-rgb-parse-hex" role="GIMP 2.2"><primary>gimp_rgb_parse_hex</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link> gimp_rgb_parse_hex (<link linkend="GimpRGB">GimpRGB</link> *rgb,
286
282
const <link linkend="gchar">gchar</link> *hex,
287
283
<link linkend="gint">gint</link> len);</programlisting>
309
305
</simpara></listitem></varlistentry>
310
306
</variablelist><para role="since">Since GIMP 2.2
311
307
</para></refsect2>
313
<title><anchor id="gimp-rgb-parse-css" role="function" condition="since:GIMP 2.2"/>gimp_rgb_parse_css ()</title>
314
<indexterm role="GIMP 2.2"><primary>gimp_rgb_parse_css</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link> gimp_rgb_parse_css (<link linkend="GimpRGB">GimpRGB</link> *rgb,
308
<refsect2 id="gimp-rgb-parse-css" role="function" condition="since:GIMP 2.2">
309
<title>gimp_rgb_parse_css ()</title>
310
<indexterm zone="gimp-rgb-parse-css" role="GIMP 2.2"><primary>gimp_rgb_parse_css</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link> gimp_rgb_parse_css (<link linkend="GimpRGB">GimpRGB</link> *rgb,
315
311
const <link linkend="gchar">gchar</link> *css,
316
312
<link linkend="gint">gint</link> len);</programlisting>
342
338
</simpara></listitem></varlistentry>
343
339
</variablelist><para role="since">Since GIMP 2.2
344
340
</para></refsect2>
346
<title><anchor id="gimp-rgb-list-names" role="function" condition="since:GIMP 2.2"/>gimp_rgb_list_names ()</title>
347
<indexterm role="GIMP 2.2"><primary>gimp_rgb_list_names</primary></indexterm><programlisting><link linkend="gint">gint</link> gimp_rgb_list_names (const <link linkend="gchar">gchar</link> ***names,
341
<refsect2 id="gimp-rgb-list-names" role="function" condition="since:GIMP 2.2">
342
<title>gimp_rgb_list_names ()</title>
343
<indexterm zone="gimp-rgb-list-names" role="GIMP 2.2"><primary>gimp_rgb_list_names</primary></indexterm><programlisting><link linkend="gint">gint</link> gimp_rgb_list_names (const <link linkend="gchar">gchar</link> ***names,
348
344
<link linkend="GimpRGB">GimpRGB</link> **colors);</programlisting>
350
346
Allows to retrieve the list of <ulink
370
366
</simpara></listitem></varlistentry>
371
367
</variablelist><para role="since">Since GIMP 2.2
372
368
</para></refsect2>
374
<title><anchor id="gimp-rgb-add" role="function"/>gimp_rgb_add ()</title>
375
<indexterm><primary>gimp_rgb_add</primary></indexterm><programlisting><link linkend="void">void</link> gimp_rgb_add (<link linkend="GimpRGB">GimpRGB</link> *rgb1,
376
const <link linkend="GimpRGB">GimpRGB</link> *rgb2);</programlisting>
379
</para><variablelist role="params">
380
<varlistentry><term><parameter>rgb1</parameter> :</term>
382
</simpara></listitem></varlistentry>
383
<varlistentry><term><parameter>rgb2</parameter> :</term>
387
</simpara></listitem></varlistentry>
388
</variablelist></refsect2>
390
<title><anchor id="gimp-rgb-subtract" role="function"/>gimp_rgb_subtract ()</title>
391
<indexterm><primary>gimp_rgb_subtract</primary></indexterm><programlisting><link linkend="void">void</link> gimp_rgb_subtract (<link linkend="GimpRGB">GimpRGB</link> *rgb1,
392
const <link linkend="GimpRGB">GimpRGB</link> *rgb2);</programlisting>
395
</para><variablelist role="params">
396
<varlistentry><term><parameter>rgb1</parameter> :</term>
398
</simpara></listitem></varlistentry>
399
<varlistentry><term><parameter>rgb2</parameter> :</term>
403
</simpara></listitem></varlistentry>
404
</variablelist></refsect2>
406
<title><anchor id="gimp-rgb-multiply" role="function"/>gimp_rgb_multiply ()</title>
407
<indexterm><primary>gimp_rgb_multiply</primary></indexterm><programlisting><link linkend="void">void</link> gimp_rgb_multiply (<link linkend="GimpRGB">GimpRGB</link> *rgb1,
369
<refsect2 id="gimp-rgb-add" role="function">
370
<title>gimp_rgb_add ()</title>
371
<indexterm zone="gimp-rgb-add"><primary>gimp_rgb_add</primary></indexterm><programlisting><link linkend="void">void</link> gimp_rgb_add (<link linkend="GimpRGB">GimpRGB</link> *rgb1,
372
const <link linkend="GimpRGB">GimpRGB</link> *rgb2);</programlisting>
375
</para><variablelist role="params">
376
<varlistentry><term><parameter>rgb1</parameter> :</term>
378
</simpara></listitem></varlistentry>
379
<varlistentry><term><parameter>rgb2</parameter> :</term>
383
</simpara></listitem></varlistentry>
384
</variablelist></refsect2>
385
<refsect2 id="gimp-rgb-subtract" role="function">
386
<title>gimp_rgb_subtract ()</title>
387
<indexterm zone="gimp-rgb-subtract"><primary>gimp_rgb_subtract</primary></indexterm><programlisting><link linkend="void">void</link> gimp_rgb_subtract (<link linkend="GimpRGB">GimpRGB</link> *rgb1,
388
const <link linkend="GimpRGB">GimpRGB</link> *rgb2);</programlisting>
391
</para><variablelist role="params">
392
<varlistentry><term><parameter>rgb1</parameter> :</term>
394
</simpara></listitem></varlistentry>
395
<varlistentry><term><parameter>rgb2</parameter> :</term>
399
</simpara></listitem></varlistentry>
400
</variablelist></refsect2>
401
<refsect2 id="gimp-rgb-multiply" role="function">
402
<title>gimp_rgb_multiply ()</title>
403
<indexterm zone="gimp-rgb-multiply"><primary>gimp_rgb_multiply</primary></indexterm><programlisting><link linkend="void">void</link> gimp_rgb_multiply (<link linkend="GimpRGB">GimpRGB</link> *rgb1,
408
404
<link linkend="gdouble">gdouble</link> factor);</programlisting>
419
415
</simpara></listitem></varlistentry>
420
416
</variablelist></refsect2>
422
<title><anchor id="gimp-rgb-distance" role="function"/>gimp_rgb_distance ()</title>
423
<indexterm><primary>gimp_rgb_distance</primary></indexterm><programlisting><link linkend="gdouble">gdouble</link> gimp_rgb_distance (const <link linkend="GimpRGB">GimpRGB</link> *rgb1,
417
<refsect2 id="gimp-rgb-distance" role="function">
418
<title>gimp_rgb_distance ()</title>
419
<indexterm zone="gimp-rgb-distance"><primary>gimp_rgb_distance</primary></indexterm><programlisting><link linkend="gdouble">gdouble</link> gimp_rgb_distance (const <link linkend="GimpRGB">GimpRGB</link> *rgb1,
424
420
const <link linkend="GimpRGB">GimpRGB</link> *rgb2);</programlisting>
437
433
</simpara></listitem></varlistentry>
438
434
</variablelist></refsect2>
440
<title><anchor id="gimp-rgb-max" role="function"/>gimp_rgb_max ()</title>
441
<indexterm><primary>gimp_rgb_max</primary></indexterm><programlisting><link linkend="gdouble">gdouble</link> gimp_rgb_max (const <link linkend="GimpRGB">GimpRGB</link> *rgb);</programlisting>
444
</para><variablelist role="params">
445
<varlistentry><term><parameter>rgb</parameter> :</term>
447
</simpara></listitem></varlistentry>
448
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>
451
</simpara></listitem></varlistentry>
452
</variablelist></refsect2>
454
<title><anchor id="gimp-rgb-min" role="function"/>gimp_rgb_min ()</title>
455
<indexterm><primary>gimp_rgb_min</primary></indexterm><programlisting><link linkend="gdouble">gdouble</link> gimp_rgb_min (const <link linkend="GimpRGB">GimpRGB</link> *rgb);</programlisting>
458
</para><variablelist role="params">
459
<varlistentry><term><parameter>rgb</parameter> :</term>
461
</simpara></listitem></varlistentry>
462
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>
465
</simpara></listitem></varlistentry>
466
</variablelist></refsect2>
468
<title><anchor id="gimp-rgb-clamp" role="function"/>gimp_rgb_clamp ()</title>
469
<indexterm><primary>gimp_rgb_clamp</primary></indexterm><programlisting><link linkend="void">void</link> gimp_rgb_clamp (<link linkend="GimpRGB">GimpRGB</link> *rgb);</programlisting>
472
</para><variablelist role="params">
473
<varlistentry><term><parameter>rgb</parameter> :</term>
477
</simpara></listitem></varlistentry>
478
</variablelist></refsect2>
480
<title><anchor id="gimp-rgb-gamma" role="function"/>gimp_rgb_gamma ()</title>
481
<indexterm><primary>gimp_rgb_gamma</primary></indexterm><programlisting><link linkend="void">void</link> gimp_rgb_gamma (<link linkend="GimpRGB">GimpRGB</link> *rgb,
435
<refsect2 id="gimp-rgb-max" role="function">
436
<title>gimp_rgb_max ()</title>
437
<indexterm zone="gimp-rgb-max"><primary>gimp_rgb_max</primary></indexterm><programlisting><link linkend="gdouble">gdouble</link> gimp_rgb_max (const <link linkend="GimpRGB">GimpRGB</link> *rgb);</programlisting>
440
</para><variablelist role="params">
441
<varlistentry><term><parameter>rgb</parameter> :</term>
443
</simpara></listitem></varlistentry>
444
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>
447
</simpara></listitem></varlistentry>
448
</variablelist></refsect2>
449
<refsect2 id="gimp-rgb-min" role="function">
450
<title>gimp_rgb_min ()</title>
451
<indexterm zone="gimp-rgb-min"><primary>gimp_rgb_min</primary></indexterm><programlisting><link linkend="gdouble">gdouble</link> gimp_rgb_min (const <link linkend="GimpRGB">GimpRGB</link> *rgb);</programlisting>
454
</para><variablelist role="params">
455
<varlistentry><term><parameter>rgb</parameter> :</term>
457
</simpara></listitem></varlistentry>
458
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>
461
</simpara></listitem></varlistentry>
462
</variablelist></refsect2>
463
<refsect2 id="gimp-rgb-clamp" role="function">
464
<title>gimp_rgb_clamp ()</title>
465
<indexterm zone="gimp-rgb-clamp"><primary>gimp_rgb_clamp</primary></indexterm><programlisting><link linkend="void">void</link> gimp_rgb_clamp (<link linkend="GimpRGB">GimpRGB</link> *rgb);</programlisting>
468
</para><variablelist role="params">
469
<varlistentry><term><parameter>rgb</parameter> :</term>
473
</simpara></listitem></varlistentry>
474
</variablelist></refsect2>
475
<refsect2 id="gimp-rgb-gamma" role="function">
476
<title>gimp_rgb_gamma ()</title>
477
<indexterm zone="gimp-rgb-gamma"><primary>gimp_rgb_gamma</primary></indexterm><programlisting><link linkend="void">void</link> gimp_rgb_gamma (<link linkend="GimpRGB">GimpRGB</link> *rgb,
482
478
<link linkend="gdouble">gdouble</link> gamma);</programlisting>
508
504
</simpara></listitem></varlistentry>
509
505
</variablelist><para role="since">Since GIMP 2.4
510
506
</para></refsect2>
512
<title><anchor id="gimp-rgb-luminance-uchar" role="function" condition="since:GIMP 2.4"/>gimp_rgb_luminance_uchar ()</title>
513
<indexterm role="GIMP 2.4"><primary>gimp_rgb_luminance_uchar</primary></indexterm><programlisting><link linkend="guchar">guchar</link> gimp_rgb_luminance_uchar (const <link linkend="GimpRGB">GimpRGB</link> *rgb);</programlisting>
507
<refsect2 id="gimp-rgb-luminance-uchar" role="function" condition="since:GIMP 2.4">
508
<title>gimp_rgb_luminance_uchar ()</title>
509
<indexterm zone="gimp-rgb-luminance-uchar" role="GIMP 2.4"><primary>gimp_rgb_luminance_uchar</primary></indexterm><programlisting><link linkend="guchar">guchar</link> gimp_rgb_luminance_uchar (const <link linkend="GimpRGB">GimpRGB</link> *rgb);</programlisting>
524
520
</simpara></listitem></varlistentry>
525
521
</variablelist><para role="since">Since GIMP 2.4
526
522
</para></refsect2>
528
<title><anchor id="gimp-rgb-intensity" role="function" condition="deprecated:"/>gimp_rgb_intensity ()</title>
529
<indexterm role="deprecated"><primary>gimp_rgb_intensity</primary></indexterm><programlisting><link linkend="gdouble">gdouble</link> gimp_rgb_intensity (const <link linkend="GimpRGB">GimpRGB</link> *rgb);</programlisting>
523
<refsect2 id="gimp-rgb-intensity" role="function" condition="deprecated:">
524
<title>gimp_rgb_intensity ()</title>
525
<indexterm zone="gimp-rgb-intensity" role="deprecated"><primary>gimp_rgb_intensity</primary></indexterm><programlisting><link linkend="gdouble">gdouble</link> gimp_rgb_intensity (const <link linkend="GimpRGB">GimpRGB</link> *rgb);</programlisting>
530
526
<warning><para><literal>gimp_rgb_intensity</literal> is deprecated and should not be used in newly-written code.</para></warning>
532
528
This function is deprecated! Use <link linkend="gimp-rgb-luminance"><function>gimp_rgb_luminance()</function></link> instead.</para>
539
535
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the intensity in the range from 0.0 to 1.0.
540
536
</simpara></listitem></varlistentry>
541
537
</variablelist></refsect2>
543
<title><anchor id="gimp-rgb-intensity-uchar" role="function" condition="deprecated:"/>gimp_rgb_intensity_uchar ()</title>
544
<indexterm role="deprecated"><primary>gimp_rgb_intensity_uchar</primary></indexterm><programlisting><link linkend="guchar">guchar</link> gimp_rgb_intensity_uchar (const <link linkend="GimpRGB">GimpRGB</link> *rgb);</programlisting>
538
<refsect2 id="gimp-rgb-intensity-uchar" role="function" condition="deprecated:">
539
<title>gimp_rgb_intensity_uchar ()</title>
540
<indexterm zone="gimp-rgb-intensity-uchar" role="deprecated"><primary>gimp_rgb_intensity_uchar</primary></indexterm><programlisting><link linkend="guchar">guchar</link> gimp_rgb_intensity_uchar (const <link linkend="GimpRGB">GimpRGB</link> *rgb);</programlisting>
545
541
<warning><para><literal>gimp_rgb_intensity_uchar</literal> is deprecated and should not be used in newly-written code.</para></warning>
547
543
This function is deprecated! Use <link linkend="gimp-rgb-luminance-uchar"><function>gimp_rgb_luminance_uchar()</function></link> instead.</para>
554
550
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the intensity in the range from 0 to 255.
555
551
</simpara></listitem></varlistentry>
556
552
</variablelist></refsect2>
558
<title><anchor id="gimp-rgb-composite" role="function"/>gimp_rgb_composite ()</title>
559
<indexterm><primary>gimp_rgb_composite</primary></indexterm><programlisting><link linkend="void">void</link> gimp_rgb_composite (<link linkend="GimpRGB">GimpRGB</link> *color1,
553
<refsect2 id="gimp-rgb-composite" role="function">
554
<title>gimp_rgb_composite ()</title>
555
<indexterm zone="gimp-rgb-composite"><primary>gimp_rgb_composite</primary></indexterm><programlisting><link linkend="void">void</link> gimp_rgb_composite (<link linkend="GimpRGB">GimpRGB</link> *color1,
560
556
const <link linkend="GimpRGB">GimpRGB</link> *color2,
561
557
<link linkend="GimpRGBCompositeMode">GimpRGBCompositeMode</link> mode);</programlisting>
575
571
</simpara></listitem></varlistentry>
576
572
</variablelist></refsect2>
578
<title><anchor id="gimp-rgba-set" role="function"/>gimp_rgba_set ()</title>
579
<indexterm><primary>gimp_rgba_set</primary></indexterm><programlisting><link linkend="void">void</link> gimp_rgba_set (<link linkend="GimpRGB">GimpRGB</link> *rgba,
573
<refsect2 id="gimp-rgba-set" role="function">
574
<title>gimp_rgba_set ()</title>
575
<indexterm zone="gimp-rgba-set"><primary>gimp_rgba_set</primary></indexterm><programlisting><link linkend="void">void</link> gimp_rgba_set (<link linkend="GimpRGB">GimpRGB</link> *rgba,
580
576
<link linkend="gdouble">gdouble</link> red,
581
577
<link linkend="gdouble">gdouble</link> green,
582
578
<link linkend="gdouble">gdouble</link> blue,
604
600
<listitem><simpara>
605
601
</simpara></listitem></varlistentry>
606
602
</variablelist></refsect2>
608
<title><anchor id="gimp-rgba-set-uchar" role="function"/>gimp_rgba_set_uchar ()</title>
609
<indexterm><primary>gimp_rgba_set_uchar</primary></indexterm><programlisting><link linkend="void">void</link> gimp_rgba_set_uchar (<link linkend="GimpRGB">GimpRGB</link> *rgba,
603
<refsect2 id="gimp-rgba-set-uchar" role="function">
604
<title>gimp_rgba_set_uchar ()</title>
605
<indexterm zone="gimp-rgba-set-uchar"><primary>gimp_rgba_set_uchar</primary></indexterm><programlisting><link linkend="void">void</link> gimp_rgba_set_uchar (<link linkend="GimpRGB">GimpRGB</link> *rgba,
610
606
<link linkend="guchar">guchar</link> red,
611
607
<link linkend="guchar">guchar</link> green,
612
608
<link linkend="guchar">guchar</link> blue,
633
629
<listitem><simpara>
634
630
</simpara></listitem></varlistentry>
635
631
</variablelist></refsect2>
637
<title><anchor id="gimp-rgba-get-uchar" role="function"/>gimp_rgba_get_uchar ()</title>
638
<indexterm><primary>gimp_rgba_get_uchar</primary></indexterm><programlisting><link linkend="void">void</link> gimp_rgba_get_uchar (const <link linkend="GimpRGB">GimpRGB</link> *rgba,
632
<refsect2 id="gimp-rgba-get-uchar" role="function">
633
<title>gimp_rgba_get_uchar ()</title>
634
<indexterm zone="gimp-rgba-get-uchar"><primary>gimp_rgba_get_uchar</primary></indexterm><programlisting><link linkend="void">void</link> gimp_rgba_get_uchar (const <link linkend="GimpRGB">GimpRGB</link> *rgba,
639
635
<link linkend="guchar">guchar</link> *red,
640
636
<link linkend="guchar">guchar</link> *green,
641
637
<link linkend="guchar">guchar</link> *blue,
662
658
</simpara></listitem></varlistentry>
663
659
</variablelist></refsect2>
665
<title><anchor id="gimp-rgba-parse-css" role="function" condition="since:GIMP 2.2"/>gimp_rgba_parse_css ()</title>
666
<indexterm role="GIMP 2.2"><primary>gimp_rgba_parse_css</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link> gimp_rgba_parse_css (<link linkend="GimpRGB">GimpRGB</link> *rgba,
660
<refsect2 id="gimp-rgba-parse-css" role="function" condition="since:GIMP 2.2">
661
<title>gimp_rgba_parse_css ()</title>
662
<indexterm zone="gimp-rgba-parse-css" role="GIMP 2.2"><primary>gimp_rgba_parse_css</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link> gimp_rgba_parse_css (<link linkend="GimpRGB">GimpRGB</link> *rgba,
667
663
const <link linkend="gchar">gchar</link> *css,
668
664
<link linkend="gint">gint</link> len);</programlisting>
692
688
</simpara></listitem></varlistentry>
693
689
</variablelist><para role="since">Since GIMP 2.2
694
690
</para></refsect2>
696
<title><anchor id="gimp-rgba-add" role="function"/>gimp_rgba_add ()</title>
697
<indexterm><primary>gimp_rgba_add</primary></indexterm><programlisting><link linkend="void">void</link> gimp_rgba_add (<link linkend="GimpRGB">GimpRGB</link> *rgba1,
698
const <link linkend="GimpRGB">GimpRGB</link> *rgba2);</programlisting>
701
</para><variablelist role="params">
702
<varlistentry><term><parameter>rgba1</parameter> :</term>
704
</simpara></listitem></varlistentry>
705
<varlistentry><term><parameter>rgba2</parameter> :</term>
709
</simpara></listitem></varlistentry>
710
</variablelist></refsect2>
712
<title><anchor id="gimp-rgba-subtract" role="function"/>gimp_rgba_subtract ()</title>
713
<indexterm><primary>gimp_rgba_subtract</primary></indexterm><programlisting><link linkend="void">void</link> gimp_rgba_subtract (<link linkend="GimpRGB">GimpRGB</link> *rgba1,
714
const <link linkend="GimpRGB">GimpRGB</link> *rgba2);</programlisting>
717
</para><variablelist role="params">
718
<varlistentry><term><parameter>rgba1</parameter> :</term>
720
</simpara></listitem></varlistentry>
721
<varlistentry><term><parameter>rgba2</parameter> :</term>
725
</simpara></listitem></varlistentry>
726
</variablelist></refsect2>
728
<title><anchor id="gimp-rgba-multiply" role="function"/>gimp_rgba_multiply ()</title>
729
<indexterm><primary>gimp_rgba_multiply</primary></indexterm><programlisting><link linkend="void">void</link> gimp_rgba_multiply (<link linkend="GimpRGB">GimpRGB</link> *rgba,
691
<refsect2 id="gimp-rgba-add" role="function">
692
<title>gimp_rgba_add ()</title>
693
<indexterm zone="gimp-rgba-add"><primary>gimp_rgba_add</primary></indexterm><programlisting><link linkend="void">void</link> gimp_rgba_add (<link linkend="GimpRGB">GimpRGB</link> *rgba1,
694
const <link linkend="GimpRGB">GimpRGB</link> *rgba2);</programlisting>
697
</para><variablelist role="params">
698
<varlistentry><term><parameter>rgba1</parameter> :</term>
700
</simpara></listitem></varlistentry>
701
<varlistentry><term><parameter>rgba2</parameter> :</term>
705
</simpara></listitem></varlistentry>
706
</variablelist></refsect2>
707
<refsect2 id="gimp-rgba-subtract" role="function">
708
<title>gimp_rgba_subtract ()</title>
709
<indexterm zone="gimp-rgba-subtract"><primary>gimp_rgba_subtract</primary></indexterm><programlisting><link linkend="void">void</link> gimp_rgba_subtract (<link linkend="GimpRGB">GimpRGB</link> *rgba1,
710
const <link linkend="GimpRGB">GimpRGB</link> *rgba2);</programlisting>
713
</para><variablelist role="params">
714
<varlistentry><term><parameter>rgba1</parameter> :</term>
716
</simpara></listitem></varlistentry>
717
<varlistentry><term><parameter>rgba2</parameter> :</term>
721
</simpara></listitem></varlistentry>
722
</variablelist></refsect2>
723
<refsect2 id="gimp-rgba-multiply" role="function">
724
<title>gimp_rgba_multiply ()</title>
725
<indexterm zone="gimp-rgba-multiply"><primary>gimp_rgba_multiply</primary></indexterm><programlisting><link linkend="void">void</link> gimp_rgba_multiply (<link linkend="GimpRGB">GimpRGB</link> *rgba,
730
726
<link linkend="gdouble">gdouble</link> factor);</programlisting>
741
737
</simpara></listitem></varlistentry>
742
738
</variablelist></refsect2>
744
<title><anchor id="gimp-rgba-distance" role="function"/>gimp_rgba_distance ()</title>
745
<indexterm><primary>gimp_rgba_distance</primary></indexterm><programlisting><link linkend="gdouble">gdouble</link> gimp_rgba_distance (const <link linkend="GimpRGB">GimpRGB</link> *rgba1,
739
<refsect2 id="gimp-rgba-distance" role="function">
740
<title>gimp_rgba_distance ()</title>
741
<indexterm zone="gimp-rgba-distance"><primary>gimp_rgba_distance</primary></indexterm><programlisting><link linkend="gdouble">gdouble</link> gimp_rgba_distance (const <link linkend="GimpRGB">GimpRGB</link> *rgba1,
746
742
const <link linkend="GimpRGB">GimpRGB</link> *rgba2);</programlisting>
759
755
</simpara></listitem></varlistentry>
760
756
</variablelist></refsect2>
762
<title><anchor id="GIMP-RGB-LUMINANCE:CAPS" role="macro"/>GIMP_RGB_LUMINANCE()</title>
763
<indexterm><primary>GIMP_RGB_LUMINANCE</primary></indexterm><programlisting>#define GIMP_RGB_LUMINANCE(r,g,b)</programlisting>
757
<refsect2 id="GIMP-RGB-LUMINANCE:CAPS" role="macro">
758
<title>GIMP_RGB_LUMINANCE()</title>
759
<indexterm zone="GIMP-RGB-LUMINANCE:CAPS"><primary>GIMP_RGB_LUMINANCE</primary></indexterm><programlisting>#define GIMP_RGB_LUMINANCE(r,g,b)</programlisting>
766
762
</para><variablelist role="params">
777
773
</simpara></listitem></varlistentry>
778
774
</variablelist></refsect2>
780
<title><anchor id="GIMP-RGB-LUMINANCE-RED:CAPS" role="macro"/>GIMP_RGB_LUMINANCE_RED</title>
781
<indexterm><primary>GIMP_RGB_LUMINANCE_RED</primary></indexterm><programlisting>#define GIMP_RGB_LUMINANCE_RED (0.2126)
787
<title><anchor id="GIMP-RGB-LUMINANCE-GREEN:CAPS" role="macro"/>GIMP_RGB_LUMINANCE_GREEN</title>
788
<indexterm><primary>GIMP_RGB_LUMINANCE_GREEN</primary></indexterm><programlisting>#define GIMP_RGB_LUMINANCE_GREEN (0.7152)
794
<title><anchor id="GIMP-RGB-LUMINANCE-BLUE:CAPS" role="macro"/>GIMP_RGB_LUMINANCE_BLUE</title>
795
<indexterm><primary>GIMP_RGB_LUMINANCE_BLUE</primary></indexterm><programlisting>#define GIMP_RGB_LUMINANCE_BLUE (0.0722)
801
<title><anchor id="GIMP-RGB-INTENSITY:CAPS" role="macro" condition="deprecated:"/>GIMP_RGB_INTENSITY()</title>
802
<indexterm role="deprecated"><primary>GIMP_RGB_INTENSITY</primary></indexterm><programlisting>#define GIMP_RGB_INTENSITY(r,g,b)</programlisting>
775
<refsect2 id="GIMP-RGB-LUMINANCE-RED:CAPS" role="macro">
776
<title>GIMP_RGB_LUMINANCE_RED</title>
777
<indexterm zone="GIMP-RGB-LUMINANCE-RED:CAPS"><primary>GIMP_RGB_LUMINANCE_RED</primary></indexterm><programlisting>#define GIMP_RGB_LUMINANCE_RED (0.2126)
782
<refsect2 id="GIMP-RGB-LUMINANCE-GREEN:CAPS" role="macro">
783
<title>GIMP_RGB_LUMINANCE_GREEN</title>
784
<indexterm zone="GIMP-RGB-LUMINANCE-GREEN:CAPS"><primary>GIMP_RGB_LUMINANCE_GREEN</primary></indexterm><programlisting>#define GIMP_RGB_LUMINANCE_GREEN (0.7152)
789
<refsect2 id="GIMP-RGB-LUMINANCE-BLUE:CAPS" role="macro">
790
<title>GIMP_RGB_LUMINANCE_BLUE</title>
791
<indexterm zone="GIMP-RGB-LUMINANCE-BLUE:CAPS"><primary>GIMP_RGB_LUMINANCE_BLUE</primary></indexterm><programlisting>#define GIMP_RGB_LUMINANCE_BLUE (0.0722)
796
<refsect2 id="GIMP-RGB-INTENSITY:CAPS" role="macro" condition="deprecated:">
797
<title>GIMP_RGB_INTENSITY()</title>
798
<indexterm zone="GIMP-RGB-INTENSITY:CAPS" role="deprecated"><primary>GIMP_RGB_INTENSITY</primary></indexterm><programlisting>#define GIMP_RGB_INTENSITY(r,g,b)</programlisting>
803
799
<warning><para><literal>GIMP_RGB_INTENSITY</literal> is deprecated and should not be used in newly-written code.</para></warning>
805
801
This macro calculates the intensity of an RGB value based on
818
814
</simpara></listitem></varlistentry>
819
815
</variablelist></refsect2>
821
<title><anchor id="GIMP-RGB-INTENSITY-RED:CAPS" role="macro" condition="deprecated:"/>GIMP_RGB_INTENSITY_RED</title>
822
<indexterm role="deprecated"><primary>GIMP_RGB_INTENSITY_RED</primary></indexterm><programlisting>#define GIMP_RGB_INTENSITY_RED (0.30)
816
<refsect2 id="GIMP-RGB-INTENSITY-RED:CAPS" role="macro" condition="deprecated:">
817
<title>GIMP_RGB_INTENSITY_RED</title>
818
<indexterm zone="GIMP-RGB-INTENSITY-RED:CAPS" role="deprecated"><primary>GIMP_RGB_INTENSITY_RED</primary></indexterm><programlisting>#define GIMP_RGB_INTENSITY_RED (0.30)
823
819
</programlisting>
824
820
<warning><para><literal>GIMP_RGB_INTENSITY_RED</literal> is deprecated and should not be used in newly-written code.</para></warning>
827
823
</para></refsect2>
829
<title><anchor id="GIMP-RGB-INTENSITY-GREEN:CAPS" role="macro" condition="deprecated:"/>GIMP_RGB_INTENSITY_GREEN</title>
830
<indexterm role="deprecated"><primary>GIMP_RGB_INTENSITY_GREEN</primary></indexterm><programlisting>#define GIMP_RGB_INTENSITY_GREEN (0.59)
824
<refsect2 id="GIMP-RGB-INTENSITY-GREEN:CAPS" role="macro" condition="deprecated:">
825
<title>GIMP_RGB_INTENSITY_GREEN</title>
826
<indexterm zone="GIMP-RGB-INTENSITY-GREEN:CAPS" role="deprecated"><primary>GIMP_RGB_INTENSITY_GREEN</primary></indexterm><programlisting>#define GIMP_RGB_INTENSITY_GREEN (0.59)
831
827
</programlisting>
832
828
<warning><para><literal>GIMP_RGB_INTENSITY_GREEN</literal> is deprecated and should not be used in newly-written code.</para></warning>
835
831
</para></refsect2>
837
<title><anchor id="GIMP-RGB-INTENSITY-BLUE:CAPS" role="macro" condition="deprecated:"/>GIMP_RGB_INTENSITY_BLUE</title>
838
<indexterm role="deprecated"><primary>GIMP_RGB_INTENSITY_BLUE</primary></indexterm><programlisting>#define GIMP_RGB_INTENSITY_BLUE (0.11)
832
<refsect2 id="GIMP-RGB-INTENSITY-BLUE:CAPS" role="macro" condition="deprecated:">
833
<title>GIMP_RGB_INTENSITY_BLUE</title>
834
<indexterm zone="GIMP-RGB-INTENSITY-BLUE:CAPS" role="deprecated"><primary>GIMP_RGB_INTENSITY_BLUE</primary></indexterm><programlisting>#define GIMP_RGB_INTENSITY_BLUE (0.11)
839
835
</programlisting>
840
836
<warning><para><literal>GIMP_RGB_INTENSITY_BLUE</literal> is deprecated and should not be used in newly-written code.</para></warning>
843
839
</para></refsect2>
845
<title><anchor id="GIMP-TYPE-RGB:CAPS" role="macro"/>GIMP_TYPE_RGB</title>
846
<indexterm><primary>GIMP_TYPE_RGB</primary></indexterm><programlisting>#define GIMP_TYPE_RGB (gimp_rgb_get_type ())
840
<refsect2 id="GIMP-TYPE-RGB:CAPS" role="macro">
841
<title>GIMP_TYPE_RGB</title>
842
<indexterm zone="GIMP-TYPE-RGB:CAPS"><primary>GIMP_TYPE_RGB</primary></indexterm><programlisting>#define GIMP_TYPE_RGB (gimp_rgb_get_type ())
847
843
</programlisting>
849
845
<link linkend="GIMP-TYPE-RGB:CAPS"><type>GIMP_TYPE_RGB</type></link> is a <link linkend="GType"><type>GType</type></link> derived from <link linkend="G-TYPE-BOXED:CAPS"><type>G_TYPE_BOXED</type></link>.
850
846
</para></refsect2>
852
<title><anchor id="GIMP-TYPE-PARAM-RGB:CAPS" role="macro"/>GIMP_TYPE_PARAM_RGB</title>
853
<indexterm><primary>GIMP_TYPE_PARAM_RGB</primary></indexterm><programlisting>#define GIMP_TYPE_PARAM_RGB (gimp_param_rgb_get_type ())
847
<refsect2 id="GIMP-TYPE-PARAM-RGB:CAPS" role="macro">
848
<title>GIMP_TYPE_PARAM_RGB</title>
849
<indexterm zone="GIMP-TYPE-PARAM-RGB:CAPS"><primary>GIMP_TYPE_PARAM_RGB</primary></indexterm><programlisting>#define GIMP_TYPE_PARAM_RGB (gimp_param_rgb_get_type ())
854
850
</programlisting>
857
853
</para></refsect2>
859
<title><anchor id="gimp-param-spec-rgb" role="function" condition="since:GIMP 2.4"/>gimp_param_spec_rgb ()</title>
860
<indexterm role="GIMP 2.4"><primary>gimp_param_spec_rgb</primary></indexterm><programlisting><link linkend="GParamSpec">GParamSpec</link>* gimp_param_spec_rgb (const <link linkend="gchar">gchar</link> *name,
854
<refsect2 id="gimp-param-spec-rgb" role="function" condition="since:GIMP 2.4">
855
<title>gimp_param_spec_rgb ()</title>
856
<indexterm zone="gimp-param-spec-rgb" role="GIMP 2.4"><primary>gimp_param_spec_rgb</primary></indexterm><programlisting><link linkend="GParamSpec">GParamSpec</link>* gimp_param_spec_rgb (const <link linkend="gchar">gchar</link> *name,
861
857
const <link linkend="gchar">gchar</link> *nick,
862
858
const <link linkend="gchar">gchar</link> *blurb,
863
859
<link linkend="gboolean">gboolean</link> has_alpha,
892
888
</simpara></listitem></varlistentry>
893
889
</variablelist><para role="since">Since GIMP 2.4
894
890
</para></refsect2>
896
<title><anchor id="gimp-param-spec-rgb-has-alpha" role="function" condition="since:GIMP 2.4"/>gimp_param_spec_rgb_has_alpha ()</title>
897
<indexterm role="GIMP 2.4"><primary>gimp_param_spec_rgb_has_alpha</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link> gimp_param_spec_rgb_has_alpha (<link linkend="GParamSpec">GParamSpec</link> *pspec);</programlisting>
891
<refsect2 id="gimp-param-spec-rgb-has-alpha" role="function" condition="since:GIMP 2.4">
892
<title>gimp_param_spec_rgb_has_alpha ()</title>
893
<indexterm zone="gimp-param-spec-rgb-has-alpha" role="GIMP 2.4"><primary>gimp_param_spec_rgb_has_alpha</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link> gimp_param_spec_rgb_has_alpha (<link linkend="GParamSpec">GParamSpec</link> *pspec);</programlisting>
908
904
</simpara></listitem></varlistentry>
909
905
</variablelist><para role="since">Since GIMP 2.4
910
906
</para></refsect2>
912
<title><anchor id="GIMP-VALUE-HOLDS-RGB:CAPS" role="macro"/>GIMP_VALUE_HOLDS_RGB()</title>
913
<indexterm><primary>GIMP_VALUE_HOLDS_RGB</primary></indexterm><programlisting>#define GIMP_VALUE_HOLDS_RGB(value) (G_TYPE_CHECK_VALUE_TYPE ((value), GIMP_TYPE_RGB))
907
<refsect2 id="GIMP-VALUE-HOLDS-RGB:CAPS" role="macro">
908
<title>GIMP_VALUE_HOLDS_RGB()</title>
909
<indexterm zone="GIMP-VALUE-HOLDS-RGB:CAPS"><primary>GIMP_VALUE_HOLDS_RGB</primary></indexterm><programlisting>#define GIMP_VALUE_HOLDS_RGB(value) (G_TYPE_CHECK_VALUE_TYPE ((value), GIMP_TYPE_RGB))
914
910
</programlisting>
922
918
</simpara></listitem></varlistentry>
923
919
</variablelist></refsect2>
925
<title><anchor id="gimp-value-get-rgb" role="function"/>gimp_value_get_rgb ()</title>
926
<indexterm><primary>gimp_value_get_rgb</primary></indexterm><programlisting><link linkend="void">void</link> gimp_value_get_rgb (const <link linkend="GValue">GValue</link> *value,
920
<refsect2 id="gimp-value-get-rgb" role="function">
921
<title>gimp_value_get_rgb ()</title>
922
<indexterm zone="gimp-value-get-rgb"><primary>gimp_value_get_rgb</primary></indexterm><programlisting><link linkend="void">void</link> gimp_value_get_rgb (const <link linkend="GValue">GValue</link> *value,
927
923
<link linkend="GimpRGB">GimpRGB</link> *rgb);</programlisting>
938
934
</simpara></listitem></varlistentry>
939
935
</variablelist></refsect2>
941
<title><anchor id="gimp-value-set-rgb" role="function"/>gimp_value_set_rgb ()</title>
942
<indexterm><primary>gimp_value_set_rgb</primary></indexterm><programlisting><link linkend="void">void</link> gimp_value_set_rgb (<link linkend="GValue">GValue</link> *value,
936
<refsect2 id="gimp-value-set-rgb" role="function">
937
<title>gimp_value_set_rgb ()</title>
938
<indexterm zone="gimp-value-set-rgb"><primary>gimp_value_set_rgb</primary></indexterm><programlisting><link linkend="void">void</link> gimp_value_set_rgb (<link linkend="GValue">GValue</link> *value,
943
939
const <link linkend="GimpRGB">GimpRGB</link> *rgb);</programlisting>