<!-- This file copyright Persistence of Vision Raytracer Pty. Ltd. 2003-2004 -->
<html>
<head>
<!-- NOTE: In order to users to help find information about POV-Ray using -->
<!-- web search engines, we ask you to *not* let them index documentation -->
<!-- mirrors because effectively, when searching, users will get hundreds -->
<!-- of results containing the same information! For this reason, the two -->
<!-- meta tags below disable archiving and indexing of this page by all -->
<!-- search engines that support these meta tags. -->
<meta content="noarchive" name="robots">
<meta content="noindex" name="robots">
<meta content="no-cache" http-equiv="Pragma">
<meta content="0" http-equiv="expires">
<title>3.7.3 colors.inc</title>
<link href="povray35.css" rel="stylesheet" type="text/css">
</head>
<body>
<table class="NavBar" width="100%">
<tr>
<td align="left" nowrap="" valign="middle" width="32">
<a href="s_133.html"><img alt="previous" border="0" src="prev.png"></a>
</td>
<td align="left" valign="middle" width="30%">
<a href="s_133.html">3.7.2 chars.inc</a>
</td>
<td align="center" valign="middle">
<strong class="NavBar">POV-Ray 3.6 for UNIX documentation</strong><br> <strong>3.7.3
colors.inc</strong>
</td>
<td align="right" valign="middle" width="30%">
<a href="s_135.html">3.7.4 consts.inc</a>
</td>
<td align="right" nowrap="" valign="middle" width="32">
<a href="s_135.html"><img alt="next" border="0" src="next.png"></a>
</td>
</tr>
</table>
<h3><a name="s03_07_03">3.7.3 </a>colors.inc</h3>
<p>
This file is mainly a list of predefined colors, but also has a few color manipulation macros.
</p>
<h4><a name="s03_07_03_01">3.7.3.1 </a>Predefined colors</h4>
<table border="0" cellpadding="0" cellspacing="2" summary="Primary colors">
<tr>
<td align="center" width="33%">
<br><center><img alt="Color Red" src="images/reference/colors/red.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color Green" src="images/reference/colors/green.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color Blue" src="images/reference/colors/blue.jpg"></center>
</td>
</tr>
<tr>
<td align="center" width="33%">
<br><center><img alt="Color Yellow" src="images/reference/colors/yellow.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color Cyan" src="images/reference/colors/cyan.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color Magenta" src="images/reference/colors/magenta.jpg"></center>
</td>
</tr>
<tr>
<td align="center" width="33%">
<br><center><img alt="Color Clear" src="images/reference/colors/clear.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color White" src="images/reference/colors/white.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color Black" src="images/reference/colors/black.jpg"></center>
</td>
</tr>
</table>
<table border="0" cellpadding="0" cellspacing="2" summary="Shades of gray...from 5% to 95%, in 5% increments">
<tr>
<td align="center" width="33%">
<br><center><img alt="Color Gray05" src="images/reference/colors/gray05.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color Gray10" src="images/reference/colors/gray10.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color Gray15" src="images/reference/colors/gray15.jpg"></center>
</td>
</tr>
<tr>
<td align="center" width="33%">
<br><center><img alt="Color Gray20" src="images/reference/colors/gray20.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color Gray25" src="images/reference/colors/gray25.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color Gray30" src="images/reference/colors/gray30.jpg"></center>
</td>
</tr>
<tr>
<td align="center" width="33%">
<br><center><img alt="Color Gray35" src="images/reference/colors/gray35.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color Gray40" src="images/reference/colors/gray40.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color Gray45" src="images/reference/colors/gray45.jpg"></center>
</td>
</tr>
<tr>
<td align="center" width="33%">
<br><center><img alt="Color Gray50" src="images/reference/colors/gray50.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color Gray55" src="images/reference/colors/gray55.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color Gray60" src="images/reference/colors/gray60.jpg"></center>
</td>
</tr>
<tr>
<td align="center" width="33%">
<br><center><img alt="Color Gray65" src="images/reference/colors/gray65.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color Gray70" src="images/reference/colors/gray70.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color Gray75" src="images/reference/colors/gray75.jpg"></center>
</td>
</tr>
<tr>
<td align="center" width="33%">
<br><center><img alt="Color Gray80" src="images/reference/colors/gray80.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color Gray85" src="images/reference/colors/gray85.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color Gray90" src="images/reference/colors/gray90.jpg"></center>
</td>
</tr>
<tr>
<td align="center" width="33%">
<br><center><img alt="Color Gray95" src="images/reference/colors/gray95.jpg"></center>
</td>
<td align="center" width="33%">
</td>
<td align="center" width="33%">
</td>
</tr>
</table>
<table border="0" cellpadding="0" cellspacing="2" summary="Misc. colors - plate 1">
<tr>
<td align="center" width="33%">
<br><center><img alt="Color DimGray" src="images/reference/colors/dimgray.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color Gray" src="images/reference/colors/gray.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color LightGray" src="images/reference/colors/lightgray.jpg"></center>
</td>
</tr>
<tr>
<td align="center" width="33%">
<br><center><img alt="Color VLightGray" src="images/reference/colors/vlightgray.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color Aquamarine" src="images/reference/colors/aquamarine.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color BlueViolet" src="images/reference/colors/blueviolet.jpg"></center>
</td>
</tr>
<tr>
<td align="center" width="33%">
<br><center><img alt="Color Brown" src="images/reference/colors/brown.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color CadetBlue" src="images/reference/colors/cadetblue.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color Coral" src="images/reference/colors/coral.jpg"></center>
</td>
</tr>
<tr>
<td align="center" width="33%">
<br><center><img alt="Color CornflowerBlue" src="images/reference/colors/cornflowerblue.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color DarkGreen" src="images/reference/colors/darkgreen.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color DarkOliveGreen" src="images/reference/colors/darkolivegreen.jpg"></center>
</td>
</tr>
<tr>
<td align="center" width="33%">
<br><center><img alt="Color DarkOrchid" src="images/reference/colors/darkorchid.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color DarkSlateBlue" src="images/reference/colors/darkslateblue.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color DarkSlateGray" src="images/reference/colors/darkslategray.jpg"></center>
</td>
</tr>
<tr>
<td align="center" width="33%">
<br><center><img alt="Color DarkTurquoise" src="images/reference/colors/darkturquoise.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color Firebrick" src="images/reference/colors/firebrick.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color ForestGreen" src="images/reference/colors/forestgreen.jpg"></center>
</td>
</tr>
<tr>
<td align="center" width="33%">
<br><center><img alt="Color Gold" src="images/reference/colors/gold.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color Goldenrod" src="images/reference/colors/goldenrod.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color GreenYellow" src="images/reference/colors/greenyellow.jpg"></center>
</td>
</tr>
<tr>
<td align="center" width="33%">
<br><center><img alt="Color IndianRed" src="images/reference/colors/indianred.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color Khaki" src="images/reference/colors/khaki.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color LightBlue" src="images/reference/colors/lightblue.jpg"></center>
</td>
</tr>
<tr>
<td align="center" width="33%">
<br><center><img alt="Color LightSteelBlue" src="images/reference/colors/lightsteelblue.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color LimeGreen" src="images/reference/colors/limegreen.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color Maroon" src="images/reference/colors/maroon.jpg"></center>
</td>
</tr>
<tr>
<td align="center" width="33%">
<br><center><img alt="Color MediumAquamarine" src="images/reference/colors/mediumaquamarine.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color MediumBlue" src="images/reference/colors/mediumblue.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color MediumForestGreen" src="images/reference/colors/mediumforestgreen.jpg"></center>
</td>
</tr>
<tr>
<td align="center" width="33%">
<br><center><img alt="Color MediumGoldenrod" src="images/reference/colors/mediumgoldenrod.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color MediumOrchid" src="images/reference/colors/mediumorchid.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color MediumSeaGreen" src="images/reference/colors/mediumseagreen.jpg"></center>
</td>
</tr>
</table>
<table border="0" cellpadding="0" cellspacing="2" summary="Misc. colors - plate 2">
<tr>
<td align="center" width="33%">
<br><center><img alt="Color MediumSlateBlue" src="images/reference/colors/mediumslateblue.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color MediumSpringGreen" src="images/reference/colors/mediumspringgreen.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color MediumTurquoise" src="images/reference/colors/mediumturquoise.jpg"></center>
</td>
</tr>
<tr>
<td align="center" width="33%">
<br><center><img alt="Color MediumVioletRed" src="images/reference/colors/mediumvioletred.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color MidnightBlue" src="images/reference/colors/midnightblue.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color Navy" src="images/reference/colors/navy.jpg"></center>
</td>
</tr>
<tr>
<td align="center" width="33%">
<br><center><img alt="Color NavyBlue" src="images/reference/colors/navyblue.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color Orange" src="images/reference/colors/orange.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color OrangeRed" src="images/reference/colors/orangered.jpg"></center>
</td>
</tr>
<tr>
<td align="center" width="33%">
<br><center><img alt="Color Orchid" src="images/reference/colors/orchid.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color PaleGreen" src="images/reference/colors/palegreen.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color Pink" src="images/reference/colors/pink.jpg"></center>
</td>
</tr>
<tr>
<td align="center" width="33%">
<br><center><img alt="Color Plum" src="images/reference/colors/plum.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color Salmon" src="images/reference/colors/salmon.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color SeaGreen" src="images/reference/colors/seagreen.jpg"></center>
</td>
</tr>
<tr>
<td align="center" width="33%">
<br><center><img alt="Color Sienna" src="images/reference/colors/sienna.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color SkyBlue" src="images/reference/colors/skyblue.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color SlateBlue" src="images/reference/colors/slateblue.jpg"></center>
</td>
</tr>
<tr>
<td align="center" width="33%">
<br><center><img alt="Color SpringGreen" src="images/reference/colors/springgreen.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color SteelBlue" src="images/reference/colors/steelblue.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color Tan" src="images/reference/colors/tan.jpg"></center>
</td>
</tr>
<tr>
<td align="center" width="33%">
<br><center><img alt="Color Thistle" src="images/reference/colors/thistle.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color Turquoise" src="images/reference/colors/turquoise.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color Violet" src="images/reference/colors/violet.jpg"></center>
</td>
</tr>
<tr>
<td align="center" width="33%">
<br><center><img alt="Color VioletRed" src="images/reference/colors/violetred.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color Wheat" src="images/reference/colors/wheat.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color YellowGreen" src="images/reference/colors/yellowgreen.jpg"></center>
</td>
</tr>
<tr>
<td align="center" width="33%">
<br><center><img alt="Color SummerSky" src="images/reference/colors/summersky.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color RichBlue" src="images/reference/colors/richblue.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color Brass" src="images/reference/colors/brass.jpg"></center>
</td>
</tr>
<tr>
<td align="center" width="33%">
<br><center><img alt="Color Copper" src="images/reference/colors/copper.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color Bronze" src="images/reference/colors/bronze.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color Bronze2" src="images/reference/colors/bronze2.jpg"></center>
</td>
</tr>
</table>
<table border="0" cellpadding="0" cellspacing="2" summary="Misc. colors - plate 3">
<tr>
<td align="center" width="33%">
<br><center><img alt="Color Silver" src="images/reference/colors/silver.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color BrightGold" src="images/reference/colors/brightgold.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color OldGold" src="images/reference/colors/oldgold.jpg"></center>
</td>
</tr>
<tr>
<td align="center" width="33%">
<br><center><img alt="Color Feldspar" src="images/reference/colors/feldspar.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color Quartz" src="images/reference/colors/quartz.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color Mica" src="images/reference/colors/mica.jpg"></center>
</td>
</tr>
<tr>
<td align="center" width="33%">
<br><center><img alt="Color NeonPink" src="images/reference/colors/neonpink.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color DarkPurple" src="images/reference/colors/darkpurple.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color NeonBlue" src="images/reference/colors/neonblue.jpg"></center>
</td>
</tr>
<tr>
<td align="center" width="33%">
<br><center><img alt="Color CoolCopper" src="images/reference/colors/coolcopper.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color MandarinOrange" src="images/reference/colors/mandarinorange.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color LightWood" src="images/reference/colors/lightwood.jpg"></center>
</td>
</tr>
<tr>
<td align="center" width="33%">
<br><center><img alt="Color MediumWood" src="images/reference/colors/mediumwood.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color DarkWood" src="images/reference/colors/darkwood.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color SpicyPink" src="images/reference/colors/spicypink.jpg"></center>
</td>
</tr>
<tr>
<td align="center" width="33%">
<br><center><img alt="Color SemiSweetChoc" src="images/reference/colors/semisweetchoc.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color BakersChoc" src="images/reference/colors/bakerschoc.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color Flesh" src="images/reference/colors/flesh.jpg"></center>
</td>
</tr>
<tr>
<td align="center" width="33%">
<br><center><img alt="Color NewTan" src="images/reference/colors/newtan.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color NewMidnightBlue" src="images/reference/colors/newmidnightblue.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color VeryDarkBrown" src="images/reference/colors/verydarkbrown.jpg"></center>
</td>
</tr>
<tr>
<td align="center" width="33%">
<br><center><img alt="Color DarkBrown" src="images/reference/colors/darkbrown.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color DarkTan" src="images/reference/colors/darktan.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color GreenCopper" src="images/reference/colors/greencopper.jpg"></center>
</td>
</tr>
<tr>
<td align="center" width="33%">
<br><center><img alt="Color DkGreenCopper" src="images/reference/colors/dkgreencopper.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color DustyRose" src="images/reference/colors/dustyrose.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color HuntersGreen" src="images/reference/colors/huntersgreen.jpg"></center>
</td>
</tr>
<tr>
<td align="center" width="33%">
<br><center><img alt="Color Scarlet" src="images/reference/colors/scarlet.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color Med_Purple" src="images/reference/colors/med_purple.jpg"></center>
</td>
<td align="center" width="33%">
<br><center><img alt="Color Light_Purple" src="images/reference/colors/light_purple.jpg"></center>
</td>
</tr>
<tr>
<td align="center" width="33%">
<br><center><img alt="Color Very_Light_Purple" src="images/reference/colors/very_light_purple.jpg"></center>
</td>
<td align="center" width="33%">
</td>
<td align="center" width="33%">
</td>
</tr>
</table>
<h4><a name="s03_07_03_02">3.7.3.2 </a>Color macros</h4>
<p>
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.<br> The three supported color
spaces:
</p>
<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>
<a name="s03_07_03_02_i1"><a name="CHSL2RGB"></a>
<p>
<code>CHSL2RGB(Color)</code>. Converts a color given in <code>HSL</code> space to one in <code>RGB</code> space.<br>
Parameters:
</p>
<ul>
<li>
<code>Color</code> = <code>HSL</code> color to be converted.
</li>
</ul>
<a name="s03_07_03_02_i2"><a name="CRGB2HSL"></a>
<p>
<code>CRGB2HSL(Color)</code>. Converts a color given in <code>RGB</code> space to one in <code>HSL</code> space.<br>
Parameters:
</p>
<ul>
<li>
<code>Color</code> = <code>RGB</code> color to be converted.
</li>
</ul>
<a name="s03_07_03_02_i3"><a name="CHSV2RGB"></a>
<p>
<code>CHSV2RGB(Color)</code>. Converts a color given in <code>HSV</code> space to one in <code>RGB</code> space.<br>
Parameters:
</p>
<ul>
<li>
<code>Color</code> = <code>HSV</code> color to be converted.
</li>
</ul>
<a name="s03_07_03_02_i4"><a name="CRGB2HSV"></a>
<p>
<code>CRGB2HSV(Color)</code>. Converts a color given in <code>RGB</code> space to one in <code>HSV</code> space.<br>
Parameters:
</p>
<ul>
<li>
<code>Color</code> = <code>RGB</code> color to be converted.
</li>
</ul>
<a name="s03_07_03_02_i5"><a name="Convert_Color"></a>
<p>
<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>.<br> Parameters:
</p>
<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>
<br>
<table class="NavBar" width="100%">
<tr>
<td align="left" nowrap="" valign="middle" width="32">
<a href="s_133.html"><img alt="previous" border="0" src="prev.png"></a>
</td>
<td align="left" valign="middle" width="30%">
<a href="s_133.html">3.7.2 chars.inc</a>
</td>
<td align="center" valign="middle">
<strong>3.7.3 colors.inc</strong>
</td>
<td align="right" valign="middle" width="30%">
<a href="s_135.html">3.7.4 consts.inc</a>
</td>
<td align="right" nowrap="" valign="middle" width="32">
<a href="s_135.html"><img alt="next" border="0" src="next.png"></a>
</td>
</tr>
</table>
</body> </html>
