<html> <head> <!-- This file has been generated by unroff 1.0, 03/11/09 12:56:13. --> <!-- Do not edit! --> <STYLE TYPE="text/css"> <!-- A:link{text-decoration:none} A:visited{text-decoration:none} A:active{text-decoration:none} OL,UL,P,BODY,TD,TR,TH,FORM { font-family: arial,helvetica,sans-serif;; font-size:small; color: #333333; } H1 { font-size: x-large; font-family: arial,helvetica,sans-serif; } H2 { font-size: large; font-family: arial,helvetica,sans-serif; } H3 { font-size: medium; font-family: arial,helvetica,sans-serif; } H4 { font-size: small; font-family: arial,helvetica,sans-serif; } --> </STYLE> <title>ploticus: colors</title> <body bgcolor=D0D0EE vlink=0000FF> <br> <br> <center> <table cellpadding=2 bgcolor=FFFFFF width=550><tr> <td> <table cellpadding=2 width=550><tr> <td><br><h2>colors</h2></td> <td align=right> <small> <a href="../doc/welcome.html"><img src="../doc/ploticus.gif" border=0></a><br> Version 2.41 Mar2009 <td></tr></table> </td></tr> <td> <br> <br> <title>Manual page for colors(PL)</title> </head> <body> <p> <b>color</b> specifications control the color of lines, filled areas, and text.<tt> </tt> <p> <p> <a href="../gallery/colors.htm">colors<br><img src="../gallery/colors.gif"></a> <p> <p> <br><br><br> <h2>How to specify a color</h2> Colors may be specified by <b>pre-defined name</b>, by <b>RGB</b> specification, <b>hexadecimal</b> specification (like HTML), or by <b>gray level</b> specification.<tt> </tt> <b>Hatch patterns</b> may also be used as colors, for rectangular areas such as bars.<tt> </tt> With PostScript/EPS, you can also use <b>CMYK</b> and <b>HSB</b> specifications.<tt> </tt> With PNG, GIF, or EPS, the special color <tt>transparent</tt> may be used as a background color.<tt> </tt> <p> The total length of a color specification string cannot be longer than 38 characters.<tt> </tt> <br><br><br> <h2>Predefined color names</h2> See the illustration above.<tt> </tt> <br><br><br> <h2>Custom RGB specifications</h2> If none of the pre-named colors suit, a custom RGB specification in the form of <tt>rgb(</tt><i>R</i>,<i>G</i>,<i>B</i>) may be used.<tt> </tt> <i>R</i>, <i>G</i>, <i>B</i> are values from 0.0 to 1.0 (1.0 is brightest) specify the red, green and blue components.<tt> </tt> No embedded spaces are allowed.<tt> </tt> The values may be separated by a comma (as above), or by colon (:), dash (-), or pipe (|).<tt> </tt> <p> Example: <tt>rgb(0.4,0.84,0.37)</tt> <br><br><br> <h2>Hexadecimal RGB specifications</h2> Similarly to HTML, you can use 6 or 12 digit hexadecimal RGB color values.<tt> </tt> <p> Example: <tt>xA0FFA0</tt>, <p> Example: <tt>xAA00FFFFAA00</tt>. <p> The older notation eg. <tt>xrgb(A0FFA0)</tt> can also be used.<tt> </tt> <br><br><br> <h2>Gray-level specifications</h2> A gray-level specification in the form of <tt>gray(</tt><i>G</i><tt>)</tt> or just <i>G</i>, where <i>G</i> is 0.0-1.0 grey level (1.0 is white).<tt> </tt> No embeddded spaces are allowed.<tt> </tt> <p> PostScript printers can vary considerably as to the relative darkness of a rendered grey area.<tt> </tt> <p> Example: <tt>gray(0.8)</tt> <br><br><br> <h2>Custom HSB specifications</h2> HSB color specifications are valid only with PostScript / EPS.<tt> </tt> An HSB (hue saturation and brightness) specification in the form of <tt>hsb(</tt><i>H</i>,<i>S</i>,<i>B</i>), where <i>R</i>, <i>G</i>, <i>B</i> are values from 0.0 to 1.0.<tt> </tt> No embedded spaces are allowed.<tt> </tt> The values may be separated by a comma (as above), or by colon (:), dash (-), or pipe (|).<tt> </tt> <br><br><br> <h2>Custom CMYK specifications</h2> CMYK color specifications are valid only with PostScript / EPS.<tt> </tt> A CMYK (cyan, magenta, yellow, black) specification in the form of <tt>cmyk(</tt><i>C</i><tt>,</tt><i>M</i><tt>,</tt><i>Y</i><tt>,</tt><i>K</i><tt>)</tt> where <i>C</i><tt>, </tt><i>M</i><tt>, </tt><i>Y</i><tt>, and </tt><i>K</i> are values from 0.0 through 1.0.<tt> </tt> No embedded spaces are allowed.<tt> </tt> The values may be separated by a comma (as above), or by colon (:), dash (-), or pipe (|).<tt> </tt> <br><br><br> <h2>Hatch patterns</h2> <b>Hatch patterns</b> may be used as colors to fill rectangular areas such as bars. These are most useful when rendering in PostScript for monochrome hard copy, for situations where the available gray-level gradations do not provide enough distinct variations.<tt> </tt> Hatch patterns are specified in the form of <tt>hatch</tt><i>n</i> where <i>n</i> is 1 - 9. <tt>hatch1</tt> is the lightest and <tt>hatch9</tt> is the darkest. The hatch line color is always black.<tt> </tt> Hatch patterns may only be used to fill rectangular areas such as bars; they won't work for pie graphs or rangesweeps.<tt> </tt> <br> <img src="../gallery/hatch.gif"> <br> <br> </td></tr> <td align=right> <a href="../doc/welcome.html"> <img src="../doc/ploticus.gif" border=0></a><br><small>data display engine <br> <a href="../doc/Copyright.html">Copyright Steve Grubb</a> <br> <br> <center> <img src="../gallery/all.gif"> </center> </td></tr> </table> <br> <center> <table><tr><td> Ploticus is hosted at http://ploticus.sourceforge.net</td><td> </td><td> <a href="http://sourceforge.net/projects/ploticus"><img src="http://sflogo.sourceforge.net/sflogo.php?group_id=38453&type=12" width="120" height="30" border="0" alt="Get ploticus data display engine at SourceForge.net. Fast, secure and Free Open Source software downloads" /></a> </td></tr></table> </center> <p><hr> Markup created by <em>unroff</em> 1.0, <tt> </tt> <tt> </tt>March 11, 2009. </body> </html>