~ubuntu-branches/ubuntu/trusty/gimp/trusty

« back to all changes in this revision

Viewing changes to devel-docs/libgimpcolor/html/libgimpcolor-GimpColorSpace.html

  • Committer: Bazaar Package Importer
  • Author(s): Ari Pollak
  • Date: 2009-08-14 09:57:17 UTC
  • mto: (1.1.21 upstream) (0.1.5 squeeze)
  • mto: This revision was merged to the branch mainline in revision 48.
  • Revision ID: james.westby@ubuntu.com-20090814095717-37dh2xqy5t0rurpk
ImportĀ upstreamĀ versionĀ 2.6.7

Show diffs side-by-side

added added

removed removed

Lines of Context:
3
3
<head>
4
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
<title>GimpColorSpace</title>
6
 
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
7
 
<link rel="start" href="index.html" title="GIMP Color Library Reference Manual">
 
6
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
 
7
<link rel="home" href="index.html" title="GIMP Color Library Reference Manual">
8
8
<link rel="up" href="libgimpcolor.html" title="PartĀ I.Ā GIMP Color Library">
9
9
<link rel="prev" href="libgimpcolor-GimpCMYK.html" title="GimpCMYK">
10
10
<link rel="next" href="libgimpcolor-GimpColorManaged.html" title="GimpColorManaged">
11
 
<meta name="generator" content="GTK-Doc V1.10 (XML mode)">
 
11
<meta name="generator" content="GTK-Doc V1.11 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
13
<link rel="part" href="libgimpcolor.html" title="PartĀ I.Ā GIMP Color Library">
14
14
<link rel="index" href="libgimpcolor-index.html" title="Index">
26
26
<th width="100%" align="center">GIMP Color Library Reference Manual</th>
27
27
<td><a accesskey="n" href="libgimpcolor-GimpColorManaged.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
28
28
</tr>
29
 
<tr><td colspan="5" class="shortcuts"><nobr><a href="#libgimpcolor-GimpColorSpace.synopsis" class="shortcut">Top</a>
30
 
                  Ā |Ā 
31
 
                  <a href="#libgimpcolor-GimpColorSpace.description" class="shortcut">Description</a></nobr></td></tr>
 
29
<tr><td colspan="5" class="shortcuts">
 
30
<a href="#libgimpcolor-GimpColorSpace.synopsis" class="shortcut">Top</a>
 
31
                Ā |Ā 
 
32
                <a href="#libgimpcolor-GimpColorSpace.description" class="shortcut">Description</a>
 
33
</td></tr>
32
34
</table>
33
 
<div class="refentry" lang="en">
 
35
<div class="refentry" title="GimpColorSpace">
34
36
<a name="libgimpcolor-GimpColorSpace"></a><div class="titlepage"></div>
35
37
<div class="refnamediv"><table width="100%"><tr>
36
38
<td valign="top">
39
41
</td>
40
42
<td valign="top" align="right"></td>
41
43
</tr></table></div>
42
 
<div class="refsynopsisdiv">
 
44
<div class="refsynopsisdiv" title="Synopsis">
43
45
<a name="libgimpcolor-GimpColorSpace.synopsis"></a><h2>Synopsis</h2>
44
46
<pre class="synopsis">
45
47
void                <a class="link" href="libgimpcolor-GimpColorSpace.html#gimp-rgb-to-hsv" title="gimp_rgb_to_hsv ()">gimp_rgb_to_hsv</a>                     (const <a class="link" href="libgimpcolor-GimpRGB.html#GimpRGB" title="GimpRGB">GimpRGB</a> *rgb,
174
176
>gdouble</a> value);
175
177
</pre>
176
178
</div>
177
 
<div class="refsect1" lang="en">
 
179
<div class="refsect1" title="Description">
178
180
<a name="libgimpcolor-GimpColorSpace.description"></a><h2>Description</h2>
179
181
<p>
180
182
When programming pixel data manipulation functions you will often use
183
185
different color spaces.
184
186
</p>
185
187
</div>
186
 
<div class="refsect1" lang="en">
 
188
<div class="refsect1" title="Details">
187
189
<a name="libgimpcolor-GimpColorSpace.details"></a><h2>Details</h2>
188
 
<div class="refsect2" lang="en">
 
190
<div class="refsect2" title="gimp_rgb_to_hsv ()">
189
191
<a name="gimp-rgb-to-hsv"></a><h3>gimp_rgb_to_hsv ()</h3>
190
192
<pre class="programlisting">void                gimp_rgb_to_hsv                     (const <a class="link" href="libgimpcolor-GimpRGB.html#GimpRGB" title="GimpRGB">GimpRGB</a> *rgb,
191
193
                                                         <a class="link" href="libgimpcolor-GimpHSV.html#GimpHSV" title="GimpHSV">GimpHSV</a> *hsv);</pre>
193
195
Does a conversion from RGB to HSV (Hue, Saturation,
194
196
Value) colorspace.</p>
195
197
<p>
196
 
 
197
198
</p>
198
199
<div class="variablelist"><table border="0">
199
200
<col align="left" valign="top">
212
213
</table></div>
213
214
</div>
214
215
<hr>
215
 
<div class="refsect2" lang="en">
 
216
<div class="refsect2" title="gimp_rgb_to_hsl ()">
216
217
<a name="gimp-rgb-to-hsl"></a><h3>gimp_rgb_to_hsl ()</h3>
217
218
<pre class="programlisting">void                gimp_rgb_to_hsl                     (const <a class="link" href="libgimpcolor-GimpRGB.html#GimpRGB" title="GimpRGB">GimpRGB</a> *rgb,
218
219
                                                         <a class="link" href="libgimpcolor-GimpHSV.html#GimpHSL" title="GimpHSL">GimpHSL</a> *hsl);</pre>
220
221
Convert an RGB color value to a HSL (Hue, Saturation, Lightness)
221
222
color value.</p>
222
223
<p>
223
 
 
224
224
</p>
225
225
<div class="variablelist"><table border="0">
226
226
<col align="left" valign="top">
239
239
</table></div>
240
240
</div>
241
241
<hr>
242
 
<div class="refsect2" lang="en">
 
242
<div class="refsect2" title="gimp_rgb_to_cmyk ()">
243
243
<a name="gimp-rgb-to-cmyk"></a><h3>gimp_rgb_to_cmyk ()</h3>
244
244
<pre class="programlisting">void                gimp_rgb_to_cmyk                    (const <a class="link" href="libgimpcolor-GimpRGB.html#GimpRGB" title="GimpRGB">GimpRGB</a> *rgb,
245
245
                                                         <a
253
253
parameter. A <em class="parameter"><code>pullout</code></em> value of 0 makes this a conversion to CMY.
254
254
A value of 1 causes the maximum amount of black to be pulled out.</p>
255
255
<p>
256
 
 
257
256
</p>
258
257
<div class="variablelist"><table border="0">
259
258
<col align="left" valign="top">
278
277
</table></div>
279
278
</div>
280
279
<hr>
281
 
<div class="refsect2" lang="en">
 
280
<div class="refsect2" title="gimp_hsv_to_rgb ()">
282
281
<a name="gimp-hsv-to-rgb"></a><h3>gimp_hsv_to_rgb ()</h3>
283
282
<pre class="programlisting">void                gimp_hsv_to_rgb                     (const <a class="link" href="libgimpcolor-GimpHSV.html#GimpHSV" title="GimpHSV">GimpHSV</a> *hsv,
284
283
                                                         <a class="link" href="libgimpcolor-GimpRGB.html#GimpRGB" title="GimpRGB">GimpRGB</a> *rgb);</pre>
285
284
<p>
286
285
Converts a color value from HSV to RGB colorspace</p>
287
286
<p>
288
 
 
289
287
</p>
290
288
<div class="variablelist"><table border="0">
291
289
<col align="left" valign="top">
304
302
</table></div>
305
303
</div>
306
304
<hr>
307
 
<div class="refsect2" lang="en">
 
305
<div class="refsect2" title="gimp_hsl_to_rgb ()">
308
306
<a name="gimp-hsl-to-rgb"></a><h3>gimp_hsl_to_rgb ()</h3>
309
307
<pre class="programlisting">void                gimp_hsl_to_rgb                     (const <a class="link" href="libgimpcolor-GimpHSV.html#GimpHSL" title="GimpHSL">GimpHSL</a> *hsl,
310
308
                                                         <a class="link" href="libgimpcolor-GimpRGB.html#GimpRGB" title="GimpRGB">GimpRGB</a> *rgb);</pre>
311
309
<p>
312
310
Convert a HSL color value to an RGB color value.</p>
313
311
<p>
314
 
 
315
312
</p>
316
313
<div class="variablelist"><table border="0">
317
314
<col align="left" valign="top">
330
327
</table></div>
331
328
</div>
332
329
<hr>
333
 
<div class="refsect2" lang="en">
 
330
<div class="refsect2" title="gimp_cmyk_to_rgb ()">
334
331
<a name="gimp-cmyk-to-rgb"></a><h3>gimp_cmyk_to_rgb ()</h3>
335
332
<pre class="programlisting">void                gimp_cmyk_to_rgb                    (const <a class="link" href="libgimpcolor-GimpCMYK.html#GimpCMYK" title="GimpCMYK">GimpCMYK</a> *cmyk,
336
333
                                                         <a class="link" href="libgimpcolor-GimpRGB.html#GimpRGB" title="GimpRGB">GimpRGB</a> *rgb);</pre>
338
335
Does a simple transformation from the CMYK colorspace to the RGB
339
336
colorspace, without taking color profiles into account.</p>
340
337
<p>
341
 
 
342
338
</p>
343
339
<div class="variablelist"><table border="0">
344
340
<col align="left" valign="top">
357
353
</table></div>
358
354
</div>
359
355
<hr>
360
 
<div class="refsect2" lang="en">
 
356
<div class="refsect2" title="gimp_rgb_to_hwb ()">
361
357
<a name="gimp-rgb-to-hwb"></a><h3>gimp_rgb_to_hwb ()</h3>
362
358
<pre class="programlisting">void                gimp_rgb_to_hwb                     (const <a class="link" href="libgimpcolor-GimpRGB.html#GimpRGB" title="GimpRGB">GimpRGB</a> *rgb,
363
359
                                                         <a
379
375
range [0, 1] and H is returned in the range [0, 6]. If W == 1 - B, H is
380
376
undefined.</p>
381
377
<p>
382
 
 
383
378
</p>
384
379
<div class="variablelist"><table border="0">
385
380
<col align="left" valign="top">
408
403
</table></div>
409
404
</div>
410
405
<hr>
411
 
<div class="refsect2" lang="en">
 
406
<div class="refsect2" title="gimp_hwb_to_rgb ()">
412
407
<a name="gimp-hwb-to-rgb"></a><h3>gimp_hwb_to_rgb ()</h3>
413
408
<pre class="programlisting">void                gimp_hwb_to_rgb                     (<a
414
409
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"
424
419
H is defined in the range [0, 6] or UNDEFINED, B and W are both in the
425
420
range [0, 1]. The returned RGB values are all in the range [0, 1].</p>
426
421
<p>
427
 
 
428
422
</p>
429
423
<div class="variablelist"><table border="0">
430
424
<col align="left" valign="top">
453
447
</table></div>
454
448
</div>
455
449
<hr>
456
 
<div class="refsect2" lang="en">
 
450
<div class="refsect2" title="gimp_rgb_to_hsv_int ()">
457
451
<a name="gimp-rgb-to-hsv-int"></a><h3>gimp_rgb_to_hsv_int ()</h3>
458
452
<pre class="programlisting">void                gimp_rgb_to_hsv_int                 (<a
459
453
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
474
468
corresponding, with the returned values in the following
475
469
ranges: H [0, 359], S [0, 255], V [0, 255].</p>
476
470
<p>
477
 
 
478
471
</p>
479
472
<div class="variablelist"><table border="0">
480
473
<col align="left" valign="top">
498
491
</table></div>
499
492
</div>
500
493
<hr>
501
 
<div class="refsect2" lang="en">
 
494
<div class="refsect2" title="gimp_hsv_to_rgb_int ()">
502
495
<a name="gimp-hsv-to-rgb-int"></a><h3>gimp_hsv_to_rgb_int ()</h3>
503
496
<pre class="programlisting">void                gimp_hsv_to_rgb_int                 (<a
504
497
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
517
510
The function changes the arguments to point to the RGB value
518
511
corresponding, with the returned values all in the range [0, 255].</p>
519
512
<p>
520
 
 
521
513
</p>
522
514
<div class="variablelist"><table border="0">
523
515
<col align="left" valign="top">
541
533
</table></div>
542
534
</div>
543
535
<hr>
544
 
<div class="refsect2" lang="en">
 
536
<div class="refsect2" title="gimp_rgb_to_hsl_int ()">
545
537
<a name="gimp-rgb-to-hsl-int"></a><h3>gimp_rgb_to_hsl_int ()</h3>
546
538
<pre class="programlisting">void                gimp_rgb_to_hsl_int                 (<a
547
539
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
561
553
value with the values pointed to in the following ranges:  H [0, 360],
562
554
L [0, 255], S [0, 255].</p>
563
555
<p>
564
 
 
565
556
</p>
566
557
<div class="variablelist"><table border="0">
567
558
<col align="left" valign="top">
585
576
</table></div>
586
577
</div>
587
578
<hr>
588
 
<div class="refsect2" lang="en">
 
579
<div class="refsect2" title="gimp_rgb_to_cmyk_int ()">
589
580
<a name="gimp-rgb-to-cmyk-int"></a><h3>gimp_rgb_to_cmyk_int ()</h3>
590
581
<pre class="programlisting">void                gimp_rgb_to_cmyk_int                (<a
591
582
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
606
597
parameter. A <em class="parameter"><code>pullout</code></em> value of 0 makes this a conversion to CMY.
607
598
A value of 100 causes the maximum amount of black to be pulled out.</p>
608
599
<p>
609
 
 
610
600
</p>
611
601
<div class="variablelist"><table border="0">
612
602
<col align="left" valign="top">
636
626
</table></div>
637
627
</div>
638
628
<hr>
639
 
<div class="refsect2" lang="en">
 
629
<div class="refsect2" title="gimp_cmyk_to_rgb_int ()">
640
630
<a name="gimp-cmyk-to-rgb-int"></a><h3>gimp_cmyk_to_rgb_int ()</h3>
641
631
<pre class="programlisting">void                gimp_cmyk_to_rgb_int                (<a
642
632
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
654
644
Does a naive conversion from CMYK to RGB colorspace. A simple
655
645
formula that doesn't take any color-profiles into account is used.</p>
656
646
<p>
657
 
 
658
647
</p>
659
648
<div class="variablelist"><table border="0">
660
649
<col align="left" valign="top">
683
672
</table></div>
684
673
</div>
685
674
<hr>
686
 
<div class="refsect2" lang="en">
 
675
<div class="refsect2" title="gimp_rgb_to_l_int ()">
687
676
<a name="gimp-rgb-to-l-int"></a><h3>gimp_rgb_to_l_int ()</h3>
688
677
<pre class="programlisting"><a
689
678
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
700
689
Calculates the lightness value of an RGB triplet with the formula
701
690
L = (max(R, G, B) + min (R, G, B)) / 2</p>
702
691
<p>
703
 
 
704
692
</p>
705
693
<div class="variablelist"><table border="0">
706
694
<col align="left" valign="top">
729
717
</table></div>
730
718
</div>
731
719
<hr>
732
 
<div class="refsect2" lang="en">
 
720
<div class="refsect2" title="gimp_hsl_to_rgb_int ()">
733
721
<a name="gimp-hsl-to-rgb-int"></a><h3>gimp_hsl_to_rgb_int ()</h3>
734
722
<pre class="programlisting">void                gimp_hsl_to_rgb_int                 (<a
735
723
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
748
736
The function changes the arguments to point to the RGB value
749
737
corresponding, with the returned values all in the range [0, 255].</p>
750
738
<p>
751
 
 
752
739
</p>
753
740
<div class="variablelist"><table border="0">
754
741
<col align="left" valign="top">
772
759
</table></div>
773
760
</div>
774
761
<hr>
775
 
<div class="refsect2" lang="en">
 
762
<div class="refsect2" title="gimp_rgb_to_hsv4 ()">
776
763
<a name="gimp-rgb-to-hsv4"></a><h3>gimp_rgb_to_hsv4 ()</h3>
777
764
<pre class="programlisting">void                gimp_rgb_to_hsv4                    (const <a
778
765
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"
789
776
<p>
790
777
</p>
791
778
<p>
792
 
 
793
779
</p>
794
780
<div class="variablelist"><table border="0">
795
781
<col align="left" valign="top">
819
805
</table></div>
820
806
</div>
821
807
<hr>
822
 
<div class="refsect2" lang="en">
 
808
<div class="refsect2" title="gimp_hsv_to_rgb4 ()">
823
809
<a name="gimp-hsv-to-rgb4"></a><h3>gimp_hsv_to_rgb4 ()</h3>
824
810
<pre class="programlisting">void                gimp_hsv_to_rgb4                    (<a
825
811
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"
836
822
<p>
837
823
</p>
838
824
<p>
839
 
 
840
825
</p>
841
826
<div class="variablelist"><table border="0">
842
827
<col align="left" valign="top">
869
854
</div>
870
855
<div class="footer">
871
856
<hr>
872
 
          Generated by GTK-Doc V1.10</div>
 
857
          Generated by GTK-Doc V1.11</div>
873
858
</body>
874
859
</html>