I am pleased to announce the release of color-tools 1.3.0. This release
sees the unit testing of most of its methods, and a number of bug fixes
because of this. The plan for color-tools 2.0 has been laid, which will
coincide with the release of PDF::Writer 2.0 (this is planned around the
RubyConf 2005 timeframe), but the next version of PDF::Writer (1.2) will
require this version of color-tools for specific support.
= color-tools README
color-tools is a Ruby library to provide RGB, CMYK, and other colourspace
support to applications that require it. It also provides 152 named RGB
colours. It offers 152 named RGB colours (184 with spelling variations)
that are commonly supported and used in HTML, SVG, and X11 applications. A
technique for generating a monochromatic contrasting palette is also
Version 1.3 offers significant enhancements over color-tools 1.2, and a
plan for an incompatible change to the library.
* Colours that were defined in the Color namespace (e.g., Color::Red,
Color::AliceBlue) are now defined in Color::RGB (e.g., Color::RGB::Red,
Color::RGB::AliceBlue). They are added back to the Color namespace on
the first use of the old colours and a warning is printed. In version
1.4, this warning will be printed on every use of the old colours. In
version 1.5, the backwards compatible support for colours like
Color::Red will be removed completely.
* A CSS colour name module has been added. It is based on the Color::RGB
predefined colours. It is called with "Color::CSS[color]". The provided
colour name will be looked up ignoring case so that "DarkSalmon" and
"darksalmon" (and :darksalmon) are the same value. This makes it easier
on web or SVG developers who wish to be able to manipulate a colour
based on a CSS colour name.
* A new predefined colour namespace has been added for RGB metallic
colours (Color::Metallic, in color/rgb/metallic), suggested by Jim
Freeze <email@example.com> .
* A new colour space, Color::HSL (hue, saturation, and luminosity) has
been added with some helper methods to Color::RGB for colour
* Added unit tests and fixed various little bugs.
Copyright 2005 by Austin Ziegler
Color::Palette was developed based on techniques described by Andy
SlayerOffice and by Patrick Fitzgerald of BarelyFitz in PHP.
Permission is hereby granted, free of charge, to any person obtaining a
copy of this software and associated documentation files (the "Soft-
ware"), to deal in the Software without restriction, including without
limitation the rights to use, copy, modify, merge, publish, distribute,
sublicense, and/or sell copies of the Software, and to permit persons to
whom the Software is furnished to do so, subject to the following
* The names of its contributors may not be used to endorse or promote
products derived from this software without specific prior written
The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
DEALINGS IN THE SOFTWARE.