| 98 |
- |
1 |
<?xml version="1.0" encoding="ISO-8859-1" standalone="no"?>
|
|
|
2 |
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" /><title>3.5. Colors</title><link rel="stylesheet" type="text/css" href="phplotdoc.css" /><meta name="generator" content="DocBook XSL Stylesheets V1.78.1" /><link rel="home" href="index.html" title="PHPlot Reference Manual" /><link rel="up" href="concepts.html" title="Chapter 3. PHPlot Concepts" /><link rel="prev" href="conc-plottypes.html" title="3.4. PHPlot Plot Types" /><link rel="next" href="conc-labels.html" title="3.6. Labels" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">3.5. Colors</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="conc-plottypes.html">Prev</a> </td><th width="60%" align="center">Chapter 3. PHPlot Concepts</th><td width="20%" align="right"> <a accesskey="n" href="conc-labels.html">Next</a></td></tr></table><hr /></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="conc-colors"></a>3.5. Colors</h2></div></div></div><div class="abstract"><p class="title"><strong></strong></p><p>
|
|
|
3 |
This section contains information about using colors in PHPlot.
|
|
|
4 |
Functions described in <a class="xref" href="ref-colorstyle.html" title="6.3. Colors and Line Styles">Section 6.3, “Colors and Line Styles”</a> in the Reference
|
|
|
5 |
chapter control the use of colors in PHPlot.
|
|
|
6 |
</p><p>
|
|
|
7 |
This section describes <a class="link" href="concepts.html#def-palette">Palette images</a>.
|
|
|
8 |
Starting with PHPlot-5.1.1, a second color model is available in
|
|
|
9 |
PHPlot: <a class="link" href="concepts.html#def-truecolor">Truecolor images</a>.
|
|
|
10 |
Refer to <a class="xref" href="adv-truecolor.html" title="4.3. Truecolor Images">Section 4.3, “Truecolor Images”</a> for more information.
|
|
|
11 |
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="conc-colors-forms"></a>3.5.1. Color Parameter Forms</h3></div></div></div><p>
|
|
|
12 |
Individual colors as arguments to PHPlot functions can take one of the
|
|
|
13 |
following forms:
|
|
|
14 |
</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>
|
|
|
15 |
A color name, as defined by <a class="xref" href="SetRGBArray.html" title="SetRGBArray"><span class="refentrytitle">SetRGBArray</span></a> or from a built-in
|
|
|
16 |
color map if SetRGBArray was not called.
|
|
|
17 |
Note that color names are case sensitive.
|
|
|
18 |
</p></li><li class="listitem"><p>
|
|
|
19 |
Numeric color component values, in the form <code class="literal">#rrggbb</code>.
|
|
|
20 |
Here rr is red, gg is green, and bb is blue, and each component
|
|
|
21 |
value is represented as a 2-digit hexadecimal number between 00 and ff.
|
|
|
22 |
For example, <code class="literal">#0000ff</code> is full-saturation blue.
|
|
|
23 |
</p></li><li class="listitem"><p>
|
|
|
24 |
A PHP array of red, green, and blue color component values, each value
|
|
|
25 |
being in the range 0 to 255 inclusive, for example
|
|
|
26 |
<code class="literal">array(0,0,255)</code> for blue.
|
|
|
27 |
</p></li></ol></div><p>
|
|
|
28 |
Additional color forms can be found in <a class="xref" href="adv-truecolor.html#adv-truecolor-forms" title="4.3.4. Color Parameter Form Extensions">Section 4.3.4, “Color Parameter Form Extensions”</a>.
|
|
|
29 |
Those forms are more useful with truecolor images.
|
|
|
30 |
</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>
|
|
|
31 |
You cannot use the (red, green, blue) array form as a color value in those
|
|
|
32 |
functions (like <a class="xref" href="SetDataColors.html" title="SetDataColors"><span class="refentrytitle">SetDataColors</span></a>) which accept either a
|
|
|
33 |
single color or an array of colors. The functions are unable to distinguish
|
|
|
34 |
between an array of colors and a single color represented as an array.
|
|
|
35 |
However, you can work around this restriction by using an array containing
|
|
|
36 |
the array with the colors, for example:
|
|
|
37 |
<code class="literal">array(array(102, 0, 192))</code>.
|
|
|
38 |
</p></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="conc-colors-map"></a>3.5.2. Built-in Color Maps</h3></div></div></div><p>
|
|
|
39 |
There are 36 colors defined in the 'small' internal color map.
|
|
|
40 |
This is the set of color names which are available by default, unless
|
|
|
41 |
<a class="xref" href="SetRGBArray.html" title="SetRGBArray"><span class="refentrytitle">SetRGBArray</span></a> is used to load in a different color map.
|
|
|
42 |
The colors and their names are shown in the figure below.
|
|
|
43 |
</p><div class="informalfigure"><div class="mediaobject"><img src="images/colors.png" alt="The 36 color 'small' color map" /></div></div><p>
|
|
|
44 |
</p><p>
|
|
|
45 |
Here are the color names again.
|
|
|
46 |
|
|
|
47 |
</p><div class="informaltable"><table summary="Color names" border="0"><colgroup><col class="c1" /><col class="c2" /><col class="c3" /><col class="c4" /><col class="c5" /><col class="c6" /></colgroup><tbody><tr><td>DarkGreen</td><td>DimGrey</td><td>PeachPuff</td><td>SkyBlue</td><td>SlateBlue</td><td>YellowGreen</td></tr><tr><td>aquamarine1</td><td>azure1</td><td>beige</td><td>black</td><td>blue</td><td>brown</td></tr><tr><td>cyan</td><td>gold</td><td>gray</td><td>green</td><td>grey</td><td>ivory</td></tr><tr><td>lavender</td><td>magenta</td><td>maroon</td><td>navy</td><td>orange</td><td>orchid</td></tr><tr><td>peru</td><td>pink</td><td>plum</td><td>purple</td><td>red</td><td>salmon</td></tr><tr><td>snow</td><td>tan</td><td>violet</td><td>wheat</td><td>white</td><td>yellow</td></tr></tbody></table></div><p>
|
|
|
48 |
</p><p>
|
|
|
49 |
The color names and values in the 'small' internal color map are
|
|
|
50 |
selected from the X11 RGB Color Database.
|
|
|
51 |
If you use <a class="xref" href="SetRGBArray.html" title="SetRGBArray"><span class="refentrytitle">SetRGBArray</span></a> to pick the 'large' color map,
|
|
|
52 |
PHPlot loads a much larger list of colors equivalent to the entire
|
|
|
53 |
X11 RGB Color Database. Note that there are some duplicate colors in the
|
|
|
54 |
maps, as they include alternate spellings (like 'gray' and 'grey').
|
|
|
55 |
</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>
|
|
|
56 |
You are not limited to only using colors from the color map. The color map
|
|
|
57 |
contains a list of color names that PHPlot can translate into color values,
|
|
|
58 |
but you can use any color at all by specifying the color value using
|
|
|
59 |
one of the numeric representations described above.
|
|
|
60 |
</p></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="conc-colors-datacolors"></a>3.5.3. Plotting Colors</h3></div></div></div><p>
|
|
|
61 |
|
|
|
62 |
Each data set plotted on a graph uses the next color in the Data Colors list.
|
|
|
63 |
By default, the Data Colors list contains the following 16 colors in order.
|
|
|
64 |
</p><div class="informaltable"><table summary="Default PHPlot Data Colors List" border="1"><colgroup><col class="c1" /><col class="c2" /><col class="c3" /></colgroup><thead><tr><th>Data Set:</th><th>Color Name:</th><th>Color Sample:</th></tr></thead><tbody><tr bgcolor="white"><td>1</td><td>SkyBlue</td><td bgcolor="#87ceeb"> </td></tr><tr bgcolor="white"><td>2</td><td>green</td><td bgcolor="#00ff00"> </td></tr><tr bgcolor="white"><td>3</td><td>orange</td><td bgcolor="#ffa500"> </td></tr><tr bgcolor="white"><td>4</td><td>blue</td><td bgcolor="#0000ff"> </td></tr><tr bgcolor="white"><td>5</td><td>red</td><td bgcolor="#ff0000"> </td></tr><tr bgcolor="white"><td>6</td><td>DarkGreen</td><td bgcolor="#006400"> </td></tr><tr bgcolor="white"><td>7</td><td>purple</td><td bgcolor="#a020f0"> </td></tr><tr bgcolor="white"><td>8</td><td>peru</td><td bgcolor="#cd853f"> </td></tr><tr bgcolor="white"><td>9</td><td>cyan</td><td bgcolor="#00ffff"> </td></tr><tr bgcolor="white"><td>10</td><td>salmon</td><td bgcolor="#fa8072"> </td></tr><tr bgcolor="white"><td>11</td><td>SlateBlue</td><td bgcolor="#6a5acd"> </td></tr><tr bgcolor="white"><td>12</td><td>YellowGreen</td><td bgcolor="#9acd32"> </td></tr><tr bgcolor="white"><td>13</td><td>magenta</td><td bgcolor="#ff00ff"> </td></tr><tr bgcolor="white"><td>14</td><td>aquamarine1</td><td bgcolor="#7fffd4"> </td></tr><tr bgcolor="white"><td>15</td><td>gold</td><td bgcolor="#ffd700"> </td></tr><tr bgcolor="white"><td>16</td><td>violet</td><td bgcolor="#ee82ee"> </td></tr></tbody></table></div><p>
|
|
|
65 |
</p><p>
|
|
|
66 |
An additional color list is used with error plots. These have data type
|
|
|
67 |
<code class="literal">data-data-error</code> or <code class="literal">data-data-yx-error</code>
|
|
|
68 |
(see <a class="xref" href="conc-datatypes.html#conc-datatypes-types" title="3.3.1. Available Data Types">Section 3.3.1, “Available Data Types”</a>).
|
|
|
69 |
The positive and negative error bars use a color map that is set using
|
|
|
70 |
<a class="xref" href="SetErrorBarColors.html" title="SetErrorBarColors"><span class="refentrytitle">SetErrorBarColors</span></a>. By default, this color list contains
|
|
|
71 |
the same colors as the data color list, so each data set and its error bars
|
|
|
72 |
will be in the same color. If you change the data colors list with
|
|
|
73 |
<a class="xref" href="SetDataColors.html" title="SetDataColors"><span class="refentrytitle">SetDataColors</span></a>, you probably want to change the error bar
|
|
|
74 |
color list too, so you get the same colors for data sets and their error bars.
|
|
|
75 |
</p><p>
|
|
|
76 |
Some plot types support data borders, which are outlines around filled areas.
|
|
|
77 |
This includes the <code class="literal">bars</code> and <code class="literal">squaredarea</code>
|
|
|
78 |
plot types, for example.
|
|
|
79 |
Use <a class="xref" href="SetDrawDataBorders.html" title="SetDrawDataBorders"><span class="refentrytitle">SetDrawDataBorders</span></a> to enable or disable drawing of
|
|
|
80 |
data borders.
|
|
|
81 |
The colors used for data borders can be set with
|
|
|
82 |
<a class="xref" href="SetDataBorderColors.html" title="SetDataBorderColors"><span class="refentrytitle">SetDataBorderColors</span></a>.
|
|
|
83 |
By default, a black data border is used for all data sets, if borders are
|
|
|
84 |
enabled.
|
|
|
85 |
</p><p>
|
|
|
86 |
Note: PHPlot through version 5.0.7 used 8 colors in the default Data Colors
|
|
|
87 |
list: SkyBlue, green, orange, blue, orange, red, violet, and azure1.
|
|
|
88 |
If plotting more than four data sets with PHPlot-5.0.7 or earlier, you should
|
|
|
89 |
use <a class="xref" href="SetDataColors.html" title="SetDataColors"><span class="refentrytitle">SetDataColors</span></a> to define your own data colors list.
|
|
|
90 |
Otherwise you will get two data sets plotted in the same color, orange.
|
|
|
91 |
</p><p>
|
|
|
92 |
Instead of using sequential data colors for plotted data sets, you can
|
|
|
93 |
control exactly which data color is used for each data value using the
|
|
|
94 |
data color callback.
|
|
|
95 |
For more information, see <a class="xref" href="adv-datacolor-callback.html" title="4.5. Custom Data Color Selection">Section 4.5, “Custom Data Color Selection”</a>.
|
|
|
96 |
</p><p>
|
|
|
97 |
Some plot types which only support a single data set still use multiple
|
|
|
98 |
data colors, but in a way that is specific to that plot type. This is
|
|
|
99 |
described for each applicable plot type in <a class="xref" href="conc-plottypes.html" title="3.4. PHPlot Plot Types">Section 3.4, “PHPlot Plot Types”</a>.
|
|
|
100 |
For example, the 3 OHLC financial plot types use the first 4 data colors for
|
|
|
101 |
different parts of the marker at each data point, as well as to indicate
|
|
|
102 |
the overall direction (up or down). You can use the same methods -
|
|
|
103 |
<a class="xref" href="SetDataColors.html" title="SetDataColors"><span class="refentrytitle">SetDataColors</span></a> or a data color callback - to change colors
|
|
|
104 |
for these plot types.
|
|
|
105 |
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="conc-colors-transparent"></a>3.5.4. Transparency</h3></div></div></div><p>
|
|
|
106 |
You can designate one color in the color map to be transparent.
|
|
|
107 |
This is most often used to make a plot with a transparent background.
|
|
|
108 |
Use <a class="xref" href="SetTransparentColor.html" title="SetTransparentColor"><span class="refentrytitle">SetTransparentColor</span></a> to designate the color,
|
|
|
109 |
and <a class="xref" href="SetBackgroundColor.html" title="SetBackgroundColor"><span class="refentrytitle">SetBackgroundColor</span></a> to use that color for the background.
|
|
|
110 |
Use a color which is not otherwise used in the plot.
|
|
|
111 |
</p><p>
|
|
|
112 |
For transparency to work, the output format (see <a class="xref" href="SetFileFormat.html" title="SetFileFormat"><span class="refentrytitle">SetFileFormat</span></a>)
|
|
|
113 |
must support transparency, and the the user's viewer or browser also must
|
|
|
114 |
support transparency.
|
|
|
115 |
If transparency is not supported, the user will see the actual color
|
|
|
116 |
which was designated as transparent (so don't use red, for example).
|
|
|
117 |
Most viewers support transparency in GIF format, and newer viewers should
|
|
|
118 |
support transparency in PNG format. JPEG format does not support
|
|
|
119 |
transparency.
|
|
|
120 |
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="conc-colors-elements"></a>3.5.5. Plot Element Colors</h3></div></div></div><p>
|
|
|
121 |
The following table shows the function(s) used to set the color of each
|
|
|
122 |
element on a plot, and the default color if no functions are used to change it.
|
|
|
123 |
Where multiple function names are shown, they are listed from highest to
|
|
|
124 |
lowest priority. (That is, if the first function is not used, the color is set
|
|
|
125 |
with the second function, etc.)
|
|
|
126 |
</p><div class="informaltable"><table summary="Functions to set color of plot elements" border="1"><colgroup><col class="c1" /><col class="c2" /><col class="c3" /></colgroup><thead><tr><th>Plot element:</th><th>Function(s) used to set color:</th><th>Default color:</th></tr></thead><tbody><tr><td>Data borders</td><td><a class="xref" href="SetDataBorderColors.html" title="SetDataBorderColors"><span class="refentrytitle">SetDataBorderColors</span></a></td><td>black</td></tr><tr><td>Data elements (points, lines, area fill, etc.)</td><td><a class="xref" href="SetDataColors.html" title="SetDataColors"><span class="refentrytitle">SetDataColors</span></a></td><td>See <a class="xref" href="conc-colors.html#conc-colors-datacolors" title="3.5.3. Plotting Colors">Section 3.5.3, “Plotting Colors”</a></td></tr><tr><td>Data value labels</td><td><a class="xref" href="SetDataValueLabelColor.html" title="SetDataValueLabelColor"><span class="refentrytitle">SetDataValueLabelColor</span></a>,
|
|
|
127 |
<a class="xref" href="SetDataLabelColor.html" title="SetDataLabelColor"><span class="refentrytitle">SetDataLabelColor</span></a>,
|
|
|
128 |
<a class="xref" href="SetTextColor.html" title="SetTextColor"><span class="refentrytitle">SetTextColor</span></a></td><td>black</td></tr><tr><td>Error bars</td><td><a class="xref" href="SetErrorBarColors.html" title="SetErrorBarColors"><span class="refentrytitle">SetErrorBarColors</span></a></td><td>Same as data colors. See <a class="xref" href="conc-colors.html#conc-colors-datacolors" title="3.5.3. Plotting Colors">Section 3.5.3, “Plotting Colors”</a></td></tr><tr><td>Image background</td><td><a class="xref" href="SetBackgroundColor.html" title="SetBackgroundColor"><span class="refentrytitle">SetBackgroundColor</span></a></td><td>white</td></tr><tr><td>Image border</td><td><a class="xref" href="SetImageBorderColor.html" title="SetImageBorderColor"><span class="refentrytitle">SetImageBorderColor</span></a></td><td>#c2c2c2 gray</td></tr><tr><td>Legend background</td><td><a class="xref" href="SetLegendBgColor.html" title="SetLegendBgColor"><span class="refentrytitle">SetLegendBgColor</span></a>,
|
|
|
129 |
<a class="xref" href="SetBackgroundColor.html" title="SetBackgroundColor"><span class="refentrytitle">SetBackgroundColor</span></a></td><td>white</td></tr><tr><td>Legend color box fill or shape marker</td><td><a class="xref" href="SetDataColors.html" title="SetDataColors"><span class="refentrytitle">SetDataColors</span></a></td><td>N/A</td></tr><tr><td>Legend color box borders</td><td><a class="xref" href="SetTextColor.html" title="SetTextColor"><span class="refentrytitle">SetTextColor</span></a> or
|
|
|
130 |
<a class="xref" href="SetDataBorderColors.html" title="SetDataBorderColors"><span class="refentrytitle">SetDataBorderColors</span></a> (see notes)</td><td>black</td></tr><tr><td>Legend border</td><td><a class="xref" href="SetGridColor.html" title="SetGridColor"><span class="refentrytitle">SetGridColor</span></a></td><td>black</td></tr><tr><td>Legend text</td><td><a class="xref" href="SetLegendTextColor.html" title="SetLegendTextColor"><span class="refentrytitle">SetLegendTextColor</span></a>,
|
|
|
131 |
<a class="xref" href="SetTextColor.html" title="SetTextColor"><span class="refentrytitle">SetTextColor</span></a></td><td>black</td></tr><tr><td>Main title</td><td><a class="xref" href="SetTitleColor.html" title="SetTitleColor"><span class="refentrytitle">SetTitleColor</span></a></td><td>black</td></tr><tr><td>Pie chart data labels</td><td><a class="xref" href="SetPieLabelColor.html" title="SetPieLabelColor"><span class="refentrytitle">SetPieLabelColor</span></a>,
|
|
|
132 |
<a class="xref" href="SetGridColor.html" title="SetGridColor"><span class="refentrytitle">SetGridColor</span></a></td><td>black</td></tr><tr><td>Pie segment borders</td><td><a class="xref" href="SetPieBorderColor.html" title="SetPieBorderColor"><span class="refentrytitle">SetPieBorderColor</span></a>,
|
|
|
133 |
<a class="xref" href="SetGridColor.html" title="SetGridColor"><span class="refentrytitle">SetGridColor</span></a></td><td>black</td></tr><tr><td>Pie segment fill</td><td><a class="xref" href="SetDataColors.html" title="SetDataColors"><span class="refentrytitle">SetDataColors</span></a></td><td>N/A</td></tr><tr><td>Plot area background</td><td><a class="xref" href="SetPlotBgColor.html" title="SetPlotBgColor"><span class="refentrytitle">SetPlotBgColor</span></a></td><td>white, but disabled by default</td></tr><tr><td>Plot border</td><td><a class="xref" href="SetGridColor.html" title="SetGridColor"><span class="refentrytitle">SetGridColor</span></a></td><td>black</td></tr><tr><td>X axis line</td><td><a class="xref" href="SetGridColor.html" title="SetGridColor"><span class="refentrytitle">SetGridColor</span></a></td><td>black</td></tr><tr><td>X axis data labels</td><td><a class="xref" href="SetDataLabelColor.html" title="SetDataLabelColor"><span class="refentrytitle">SetDataLabelColor</span></a>,
|
|
|
134 |
<a class="xref" href="SetTextColor.html" title="SetTextColor"><span class="refentrytitle">SetTextColor</span></a></td><td>black</td></tr><tr><td>X data label lines</td><td><a class="xref" href="SetLightGridColor.html" title="SetLightGridColor"><span class="refentrytitle">SetLightGridColor</span></a></td><td>gray</td></tr><tr><td>X grid lines</td><td><a class="xref" href="SetLightGridColor.html" title="SetLightGridColor"><span class="refentrytitle">SetLightGridColor</span></a></td><td>gray</td></tr><tr><td>X tick labels</td><td><a class="xref" href="SetTickLabelColor.html" title="SetTickLabelColor"><span class="refentrytitle">SetTickLabelColor</span></a>,
|
|
|
135 |
<a class="xref" href="SetTextColor.html" title="SetTextColor"><span class="refentrytitle">SetTextColor</span></a></td><td>black</td></tr><tr><td>X tick marks</td><td><a class="xref" href="SetTickColor.html" title="SetTickColor"><span class="refentrytitle">SetTickColor</span></a></td><td>black</td></tr><tr><td>X title</td><td><a class="xref" href="SetXTitleColor.html" title="SetXTitleColor"><span class="refentrytitle">SetXTitleColor</span></a>,
|
|
|
136 |
<a class="xref" href="SetTitleColor.html" title="SetTitleColor"><span class="refentrytitle">SetTitleColor</span></a></td><td>black</td></tr><tr><td>Y axis lines</td><td><a class="xref" href="SetGridColor.html" title="SetGridColor"><span class="refentrytitle">SetGridColor</span></a></td><td>black</td></tr><tr><td>Y axis data labels</td><td><a class="xref" href="SetDataLabelColor.html" title="SetDataLabelColor"><span class="refentrytitle">SetDataLabelColor</span></a>,
|
|
|
137 |
<a class="xref" href="SetTextColor.html" title="SetTextColor"><span class="refentrytitle">SetTextColor</span></a></td><td>black</td></tr><tr><td>Y data label lines</td><td><a class="xref" href="SetLightGridColor.html" title="SetLightGridColor"><span class="refentrytitle">SetLightGridColor</span></a></td><td>gray</td></tr><tr><td>Y grid lines</td><td><a class="xref" href="SetLightGridColor.html" title="SetLightGridColor"><span class="refentrytitle">SetLightGridColor</span></a></td><td>gray</td></tr><tr><td>Y tick labels</td><td><a class="xref" href="SetTickLabelColor.html" title="SetTickLabelColor"><span class="refentrytitle">SetTickLabelColor</span></a>,
|
|
|
138 |
<a class="xref" href="SetTextColor.html" title="SetTextColor"><span class="refentrytitle">SetTextColor</span></a></td><td>black</td></tr><tr><td>Y tick marks</td><td><a class="xref" href="SetTickColor.html" title="SetTickColor"><span class="refentrytitle">SetTickColor</span></a></td><td>black</td></tr><tr><td>Y title</td><td><a class="xref" href="SetYTitleColor.html" title="SetYTitleColor"><span class="refentrytitle">SetYTitleColor</span></a>,
|
|
|
139 |
<a class="xref" href="SetTitleColor.html" title="SetTitleColor"><span class="refentrytitle">SetTitleColor</span></a></td><td>black</td></tr></tbody></table></div><p>
|
|
|
140 |
</p><p>
|
|
|
141 |
The following notes apply to the table of plot element colors above:
|
|
|
142 |
</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>
|
|
|
143 |
<span class="emphasis"><em>Data borders</em></span> refers to the borders, or outlines, around
|
|
|
144 |
bars in a <code class="literal">bars</code> or <code class="literal">stackedbars</code> plot.
|
|
|
145 |
Data borders are also available with the
|
|
|
146 |
<code class="literal">area</code>,
|
|
|
147 |
<code class="literal">squaredarea</code>,
|
|
|
148 |
<code class="literal">stackedarea</code>, and
|
|
|
149 |
<code class="literal">stackedsquaredarea</code> plot types.
|
|
|
150 |
</p></li><li class="listitem"><p>
|
|
|
151 |
<a class="xref" href="SetPieBorderColor.html" title="SetPieBorderColor"><span class="refentrytitle">SetPieBorderColor</span></a> was added in PHPlot-6.0.0. In prior
|
|
|
152 |
releases, pie segment borders (which were available only on unshaded pie
|
|
|
153 |
charts) used the color set with <a class="xref" href="SetGridColor.html" title="SetGridColor"><span class="refentrytitle">SetGridColor</span></a>.
|
|
|
154 |
The new function is backwards compatible, as the borders default to the grid
|
|
|
155 |
color if <code class="function">SetPieBorderColor</code> is not used.
|
|
|
156 |
</p></li><li class="listitem"><p>
|
|
|
157 |
<a class="xref" href="SetDataLabelColor.html" title="SetDataLabelColor"><span class="refentrytitle">SetDataLabelColor</span></a>,
|
|
|
158 |
<a class="xref" href="SetDataValueLabelColor.html" title="SetDataValueLabelColor"><span class="refentrytitle">SetDataValueLabelColor</span></a>,
|
|
|
159 |
<a class="xref" href="SetPieLabelColor.html" title="SetPieLabelColor"><span class="refentrytitle">SetPieLabelColor</span></a>, and
|
|
|
160 |
<a class="xref" href="SetTickLabelColor.html" title="SetTickLabelColor"><span class="refentrytitle">SetTickLabelColor</span></a> were added in PHPlot-5.7.0.
|
|
|
161 |
Through PHPlot-5.6.0:
|
|
|
162 |
</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: circle; "><li class="listitem"><p>
|
|
|
163 |
Tick labels and axis data labels all used the color set with
|
|
|
164 |
<a class="xref" href="SetTextColor.html" title="SetTextColor"><span class="refentrytitle">SetTextColor</span></a>.
|
|
|
165 |
</p></li><li class="listitem"><p>
|
|
|
166 |
Data value labels (incorrectly) used the title color set with
|
|
|
167 |
<a class="xref" href="SetTitleColor.html" title="SetTitleColor"><span class="refentrytitle">SetTitleColor</span></a>.
|
|
|
168 |
</p></li><li class="listitem"><p>
|
|
|
169 |
Pie chart labels used the grid color set with <a class="xref" href="SetGridColor.html" title="SetGridColor"><span class="refentrytitle">SetGridColor</span></a>.
|
|
|
170 |
</p></li></ul></div><p>
|
|
|
171 |
Except for data value labels, the defaults are backwards compatible. That
|
|
|
172 |
is, if you use <code class="function">SetGridColor()</code> and do not use the new
|
|
|
173 |
<code class="function">SetPieLabelColor()</code>, your pie chart labels will display
|
|
|
174 |
in the same color with all releases.
|
|
|
175 |
</p></li><li class="listitem"><p>
|
|
|
176 |
The legend background uses the overall image background color set with
|
|
|
177 |
<a class="xref" href="SetBackgroundColor.html" title="SetBackgroundColor"><span class="refentrytitle">SetBackgroundColor</span></a> by default.
|
|
|
178 |
Starting with PHPlot-6.0.0, you can set the legend background color
|
|
|
179 |
separately with <a class="xref" href="SetLegendBgColor.html" title="SetLegendBgColor"><span class="refentrytitle">SetLegendBgColor</span></a>.
|
|
|
180 |
</p></li><li class="listitem"><p>
|
|
|
181 |
The legend color box borders use the color set with
|
|
|
182 |
<a class="xref" href="SetTextColor.html" title="SetTextColor"><span class="refentrytitle">SetTextColor</span></a> by default. Starting with PHPlot-6.0.0,
|
|
|
183 |
you can use the colors set with <a class="xref" href="SetDataBorderColors.html" title="SetDataBorderColors"><span class="refentrytitle">SetDataBorderColors</span></a>
|
|
|
184 |
instead. See <a class="xref" href="SetLegendColorboxBorders.html" title="SetLegendColorboxBorders"><span class="refentrytitle">SetLegendColorboxBorders</span></a>.
|
|
|
185 |
</p></li><li class="listitem"><p>
|
|
|
186 |
Legend text uses the general text color set with <a class="xref" href="SetTextColor.html" title="SetTextColor"><span class="refentrytitle">SetTextColor</span></a>
|
|
|
187 |
by default. Starting with PHPlot-6.0.0, you can set the legend text color
|
|
|
188 |
separately with <a class="xref" href="SetLegendTextColor.html" title="SetLegendTextColor"><span class="refentrytitle">SetLegendTextColor</span></a>.
|
|
|
189 |
</p></li></ul></div><p>
|
|
|
190 |
</p></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="conc-plottypes.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="concepts.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="conc-labels.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">3.4. PHPlot Plot Types </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 3.6. Labels</td></tr></table></div></body></html>
|