Reference:Colors.inc - Revision history

Clipka: canonicalize some version numbers

2021-06-09T15:07:36Z

canonicalize some version numbers

Jholsenback: version changes

2017-06-26T10:22:49Z

version changes

Clipka: /* Predefined colors */

2016-12-24T07:36:44Z

Predefined colors

Clipka: /* Color macros */ CIELAB and CIEXYZ conversion macros

2016-12-22T00:39:52Z

Color macros: CIELAB and CIEXYZ conversion macros

Jholsenback: removed obsolete passage

2014-02-25T22:16:26Z

removed obsolete passage

Jholsenback: 1 revision: Reference Migration Initial Load

2012-03-15T19:05:17Z

1 revision: Reference Migration Initial Load

Jholsenback: 1 revision: Initial Load (TF)

2012-03-11T22:31:17Z

1 revision: Initial Load (TF)

New page

[[Category:Include Files]]
This file is mainly a list of predefined colors, but also has a few color
manipulation macros.

==Predefined colors==
This file contains 127 predefined colors that you can use in your scenes. Simply <code>#include</code> them in your scene file to use them:
<pre>
#include "colors.inc"
</pre>
These basic colors:
<ul>
<li>Red</li>
<li>Green</li>
<li>Blue</li>
<li>Yellow</li>
<li>Cyan</li>
<li>Magenta</li>
<li>Clear</li>
<li>White</li>
<li>Black</li>
</ul>
A series of percentage grays that are useful for fine-tuning lighting color values and for other areas where subtle variations of grays are needed, and a palette 99 additional color definitions are available. See the distribution file <code>~include/colors.inc</code> for more details.

==Color macros==
In POV-Ray all colors are handled in RGB color space with a component for
the amount of red, green and blue light. However, not everybody thinks this
is the most intuitive way to specify colors. For your convenience there are
macros included in colors.inc that converts between a few different types of
color spaces.
The three supported color spaces:
<ul>
<li><code>RGB</code> = < Red, Green, Blue, Filter, Transmit ></li>
<li><code>HSL</code> = < Hue, Saturation, Lightness, Filter, Transmit ></li>
<li><code>HSV</code> = < Hue, Saturation, Value, Filter, Transmit ></li>
</ul>
Note: The Hue parameter is given in degrees.

{{#indexentry:include files, CHSL2RGB}}
<code>CHSL2RGB(Color)</code>: Converts a color given in <code>HSL</code> space to one in <code>RGB</code> space.
Parameters:
<ul>
<li><code>Color</code> = <code>HSL</code> color to be converted.</li>
</ul>

{{#indexentry:include files, CRGB2HSL}}
<code>CRGB2HSL(Color)</code>: Converts a color given in <code>RGB</code> space to one in <code>HSL</code> space.
Parameters:
<ul>
<li><code>Color</code> = <code>RGB</code> color to be converted.</li>
</ul>

{{#indexentry:include files, CHSV2RGB}}
<code>CHSV2RGB(Color)</code>: Converts a color given in <code>HSV</code> space to one in <code>RGB</code> space.
Parameters:
<ul>
<li><code>Color</code> = <code>HSV</code> color to be converted.</li>
</ul>

{{#indexentry:include files, CRGB2HSV}}
<code>CRGB2HSV(Color)</code>: Converts a color given in <code>RGB</code> space to one in <code>HSV</code> space.
Parameters:
<ul>
<li><code>Color</code> = <code>RGB</code> color to be converted.</li>
</ul>

{{#indexentry:include files, Convert_Color}}
<code>Convert_Color(SourceType, DestType, Color)</code>: Converts a color from one color space to another. Color spaces available are: <code>RGB</code>, <code>HSL</code>, and <code>HSV</code>:
Parameters:
<ul>
<li><code>SourceType</code> = Color space of input color.</li>
<li><code>DestType</code> = Desired output color space.</li>
<li><code>Color</code> = Color to be converted, in SourceType color space.</li>
</ul>

@@ Line 2: / Line 2: @@
 <p>This file is mainly a list of predefined colors, but also has a few color
 manipulation macros.</p>
+.
 ==Predefined colors==
 <p>This file contains 125 predefined colors that you can use in your scenes. Simply <code>#include</code> them in your scene file to use them:</p>
@@ Line 33: / Line 33: @@
 <li><code>HSL</code> = &lt; Hue, Saturation, Lightness, Filter, Transmit &gt;</li>
 <li><code>HSV</code> = &lt; Hue, Saturation, Value, Filter, Transmit &gt;</li>
-<li><code>XYZ</code> = &lt; X, Y, Z, Filter, Transmit &gt; (CIEXYZ; {{New}} in 3.8)</li>
+<li><code>XYZ</code> = &lt; X, Y, Z, Filter, Transmit &gt; (CIEXYZ; {{New}} in v3.8)</li>
-<li><code>Lab</code> = &lt; Lightness L*, Chroma a*, Chroma b* &gt; (more accurately L*a*b*, CIELAB; {{New}} in 3.8)</li>
+<li><code>Lab</code> = &lt; Lightness L*, Chroma a*, Chroma b* &gt; (more accurately L*a*b*, CIELAB; {{New}} in v3.8)</li>
 </ul>
 <p class="Note"><strong>Note:</strong> The Hue parameter is given in degrees.</p>

@@ Line 33: / Line 33: @@
 <li><code>HSL</code> = &lt; Hue, Saturation, Lightness, Filter, Transmit &gt;</li>
 <li><code>HSV</code> = &lt; Hue, Saturation, Value, Filter, Transmit &gt;</li>
-<li><code>XYZ</code> = &lt; X, Y, Z, Filter, Transmit &gt; (CIEXYZ; {{New}} in 3.7.1)</li>
+<li><code>XYZ</code> = &lt; X, Y, Z, Filter, Transmit &gt; (CIEXYZ; {{New}} in 3.8)</li>
-<li><code>Lab</code> = &lt; Lightness L*, Chroma a*, Chroma b* &gt; (more accurately L*a*b*, CIELAB; {{New}} in 3.7.1)</li>
+<li><code>Lab</code> = &lt; Lightness L*, Chroma a*, Chroma b* &gt; (more accurately L*a*b*, CIELAB; {{New}} in 3.8)</li>
 </ul>
 <p class="Note"><strong>Note:</strong> The Hue parameter is given in degrees.</p>

@@ Line 28: / Line 28: @@
 macros included in colors.inc that converts between a few different types of
 color spaces.</p>
-<p>The three supported color spaces:</p>
+<p>The supported color spaces:</p>
 <ul>
 <li><code>RGB</code> = &lt; Red, Green, Blue, Filter, Transmit &gt;</li>
 <li><code>HSL</code> = &lt; Hue, Saturation, Lightness, Filter, Transmit &gt;</li>
 <li><code>HSV</code> = &lt; Hue, Saturation, Value, Filter, Transmit &gt;</li>
 </ul>
 <p class="Note"><strong>Note:</strong> The Hue parameter is given in degrees.</p>
@@ Line 59: / Line 61: @@
 {{#indexentry:include files, CRGB2HSV}}
 <p><code>CRGB2HSV(Color)</code>: Converts a color given in <code>RGB</code> space to one in <code>HSV</code> space.</p>
 <p>Parameters:</p>
 <ul>
 <li><code>Color</code> = <code>RGB</code> color to be converted.</li>
 </ul>

@@ Line 4: / Line 4: @@
 ==Predefined colors==
-<p>This file contains 127 predefined colors that you can use in your scenes. Simply <code>#include</code> them in your scene file to use them:</p>
+<p>This file contains 125 predefined colors that you can use in your scenes. Simply <code>#include</code> them in your scene file to use them:</p>
 <pre>
    #include &quot;colors.inc&quot;
@@ Line 20: / Line 20: @@
    <li>Black</li>
 </ul>
-<p>A series of <em>percentage</em> grays that are useful for fine-tuning lighting color values and for other areas where subtle variations of grays are needed, and a palette 99 additional color definitions are available. See the distribution file <code>~include/colors.inc</code> for more details.</p>
+<p>A series of <em>percentage</em> grays that are useful for fine-tuning lighting color values and for other areas where subtle variations of grays are needed, and a palette of over 100 additional color definitions are available. See the distribution file <code>~include/colors.inc</code> for more details.</p>
 ==Color macros==

← Older revision	Revision as of 19:05, 15 March 2012
(No difference)