Color Space
Introduction
The <colorspace> option specifies whether the text for the Table of Contents is grayscale or RGB color:
- Grayscale is the gray level specified.
- RGB color is the Red, Green and Blue levels specified to create a color.
The table below describes the elements for the TOC <colorspace>.
Contents of the <colorspace> Element
Element | Level | Pro | Required | Content |
---|---|---|---|---|
<appendparam version=”1.0″> | Top | ✔ | Topmost element, contains entire parameter spec | |
⇔ <toc> | 2 | Pro | Table of contents information | |
⇔ <colorspace> | 3 | Pro | Specifies the color space for the TOC | |
<devicegray> | 4 | Pro | Sets to grayscale | |
<color> | 5 | Pro | ✔ | Grayscale level (0–100) |
– – – – – – OR – – – – – – | ||||
⇔ <colorspace> | 3 | Pro | Specifies the color space for the TOC | |
<devicergb> | 4 | Pro | Sets to RGB color | |
<red> | 5 | Pro | ✔ | Red level (0–255) |
<green> | 5 | Pro | ✔ | Green level (0–255) |
<blue> | 5 | Pro | ✔ | Blue level (0–255) |
XML Code Sample
The first example uses <devicegray>, setting <colorspace> to <devicegray> and <color> to 50, which will create medium gray text in the Table of Contents.
<appendparam version="1.0"> <!-- . Indicates skipped sections --> <!-- . --> <!-- . --> <TOC> <!-- . --> <!-- . --> <!-- . --> <colorspace> <devicegray> <color> 50 </color> </devicegray> </colorspace> <!-- . --> <!-- . --> <!-- . --> </TOC> <!-- . --> <!-- . --> <!-- . --> </appendparam>
The second example uses <devicergb>, setting <colorspace> to <devicergb> and using the values of <red> 51, <green> 153, and <blue> 51, which will create medium green text in the Table of Contents.
<appendparam version="1.0"> <!-- . Indicates skipped sections --> <!-- . --> <!-- . --> <TOC> <!-- . --> <!-- . --> <!-- . --> <colorspace> <devicergb> <red> 51 </red> <green> 153 </green> <blue> 51 </blue> </devicergb> </colorspace> <!-- . --> <!-- . --> <!-- . --> </TOC> <!-- . --> <!-- . --> <!-- . --> </appendparam>
Elements for <colorspace>
devicegray
Specifies the Table of Content entries to be grayscale.
color (required for <devicegray>)
Specifies the gray level of the TOC entries using values from 0 through 100. The <color> value is a percentage of white, such that:
• 0 is black
• 50 is medium gray
• 100 is white
devicergb
Specifies the Table of Content entries to be in RGB color.
red (required for <devicergb>)
Specifies the red level of the TOC entries using values from 0 through 255.
green (required for <devicergb>)
Specifies the green level of the TOC entries using values from 0 through 255.
blue (required for <devicergb>)
Specifies the blue level of the TOC entries using values from 0 through 255.
Usage notes for <red>, <green>, and <blue>
If the color space is <devicergb>, then <red>, <green>, and <blue> specify the levels of each color from 0–255, such that:
RED | GREEN | BLUE | RESULT |
---|---|---|---|
0 | 0 | 0 | Black |
255 | 0 | 0 | Red |
0 | 255 | 0 | Green |
0 | 0 | 255 | Blue |
255 | 255 | 255 | White |
128 | 128 | 128 | Gray |
16 million colors are possible with this system. You can get help choosing RGB values from graphic design software or several internet sites (for example, www.visibone.com/colorlab).
Note that red=128, green=128, and blue=128 makes gray. You can duplicate any gray color in RGB with an appropriate choice of equal red, green, and blue values.
Examples
To specify dark gray TOC entries:
<TOC> <!-- . --> <!-- . --> <!-- . --> <colorspace> <devicegray> <color> 25 </color> </devicegray> </colorspace> <!-- . --> <!-- . --> <!-- . --> </TOC>
The following, used in the sample parameter file, paramsletter.xml, results in dark green:
<TOC> <!-- . --> <!-- . --> <!-- . --> <colorspace> <devicergb> <red> 0 </red> <green> 87 </green> <blue> 44 </blue> </devicergb> </colorspace> <!-- . --> <!-- . --> <!-- . --> </TOC>