.ig >>
<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>
.>>

.TH colors PL "11-MAR-2009   PL ploticus.sourceforge.net"

.LP
\fBcolor\fR specifications control the color of lines, filled areas, and text.

.sp 2
.ig >>
<a href="../gallery/colors.htm">colors<br><img src="../gallery/colors.gif"></a>
.>>
.sp 2

.ig >>
<br><br><br>
.>>

.SH How to specify a color
Colors may be specified by \fBpre-defined name\fR, by \fBRGB\fR specification, 
\fBhexadecimal\fR specification (like HTML),
or by \fBgray level\fR specification.
\fBHatch patterns\fR may also be used as colors, for rectangular areas such as bars.
With PostScript/EPS, you can also use \fBCMYK\fR and \fBHSB\fR specifications.
With PNG, GIF, or EPS, the special color 
\fCtransparent\fR may be used as a background color.
.LP
The total length of a color specification string cannot be longer than 38 characters.

.ig >>
<br><br><br>
.>>

.SH Predefined color names
See the illustration above.

.ig >>
<br><br><br>
.>>

.SH Custom RGB specifications
If none of the pre-named colors suit, 
a custom RGB specification in the form of
\fCrgb(\fIR\fR,\fIG\fR,\fIB\fR)\fR may be used.
\fIR\fR, \fIG\fR, \fIB\fR are values from 0.0 to 1.0 (1.0 is brightest)
specify the red, green and blue components.
No embedded spaces are allowed.
The values may be separated by a comma (as above), or by colon (:), dash (-), or
pipe (|).
.LP
Example: \fCrgb(0.4,0.84,0.37)\fR

.ig >>
<br><br><br>
.>>
.SH Hexadecimal RGB specifications
Similarly to HTML, you can use 6 or 12 digit hexadecimal RGB color values.
.LP
Example: \fCxA0FFA0\fR,
.LP
Example: \fCxAA00FFFFAA00\fR.  
.LP
The older notation eg. \fCxrgb(A0FFA0)\fR can also be used.

.ig >>
<br><br><br>
.>>

.SH Gray-level specifications
A gray-level specification in the form of
\fCgray(\fIG\fC)\fR or just \fIG\fR,
where \fIG\fR is 0.0-1.0 grey level (1.0 is white).
No embeddded spaces are allowed.
.LP
PostScript printers can vary considerably 
as to the relative darkness of a rendered grey area.
.LP
Example: \fCgray(0.8)\fR

.ig >>
<br><br><br>
.>>

.SH Custom HSB specifications
HSB color specifications are valid only with PostScript / EPS.
An HSB (hue saturation and brightness) specification in the form of
\fChsb(\fIH\fR,\fIS\fR,\fIB\fR)\fR,
where \fIR\fR, \fIG\fR, \fIB\fR are values from 0.0 to 1.0.
No embedded spaces are allowed.
The values may be separated by a comma (as above), or by colon (:), dash (-), or
pipe (|).

.ig >>
<br><br><br>
.>>

.SH Custom CMYK specifications
CMYK color specifications are valid only with PostScript / EPS.
A CMYK  (cyan, magenta, yellow, black) specification in the form of
\fCcmyk(\fIC\fC,\fIM\fC,\fIY\fC,\fIK\fC)\fR
where \fIC\fC, \fIM\fC, \fIY\fC, and \fIK\fR are values from 0.0 through 1.0.
No embedded spaces are allowed.
The values may be separated by a comma (as above), or by colon (:), dash (-), or
pipe (|).

.ig >>
<br><br><br>
.>>

.SH Hatch patterns
\fBHatch patterns\fR 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.
Hatch patterns are specified in the form of \fChatch\fR\fIn\fR
where \fIn\fR is 1 - 9.  \fChatch1\fR is the lightest and
\fChatch9\fR is the darkest.  The hatch line color is always black.
Hatch patterns may only be used to fill rectangular areas such as bars;
they won't work for pie graphs or rangesweeps.
.ig >>
<br>
<img src="../gallery/hatch.gif">
.>>

.ig >>
<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 &nbsp; <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> &nbsp; </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>
.>>
