
/*******************************************************************************************************
 README FILE ColorSafe 1.0 Beta - http://www.woven-media.com/
********************************************************************************************************
________________________________________________________________________________________________________
    / ___|___ | | ___  _ __/ ___|  __ _ / _| ___  / | / _ \  | __ )  ___| |_ __ _ 
    | |   / _ \| |/ _ \| '__\___ \ / _` | |_ / _ \ | || | | | |  _ \ / _ \ __/ _` |
    | |__| (_) | | (_) | |   ___) | (_| |  _|  __/ | || |_| | | |_) |  __/ || (_| |
     \____\___/|_|\___/|_|  |____/ \__,_|_|  \___| |_(_)___/  |____/ \___|\__\__,_|
________________________________________________________________________________________________________ 

A Java 6 Swing application for color testing and conversions from RGB to
hexadecimal data formats and vice versa.

Copyright (C) 2008-2009, Brent Allen Parrish <info@woven-media.com>

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.
*******************************************************************************************************/
                                                     
OVERVIEW

  ColorSafe 1.0 Beta is an open-source stand-alone Java(TM) 6 SE program 
released under GPL which converts color values from hexadecimal to RGB 
triplets, and vice versa. ColorSafe 1.0 will display the nearest web safe 
color based on values entered by the user as well. RGB triplets can be entered as 
floating point or integer values, which provides support for the Arithmetic 
and Decimal RGB Color Models. ColorSafe 1.0 makes selecting colors easy by 
providing RGB, hexadecimal, HSB and CMYK percentage information for all colors 
within the standard RGB Color Space. The Palettes accessed from the View menu 
allow the user to quickly choose from X11, grayscale, windows system, named 
and web safe colors. ColorSafe runs as a standard exe on windows systems thanks 
to Launch4j (see Resources) technology!

OPEN-SOURCE DEVELOPMENT

  Developers and students can customize ColorSafe to suit their own needs. The entire 
codebase has been released with this distribution under GPL. Source code can be found in the 
/com/woven_media/colorsafe/src directory. Also included with this distribution are the 
complete ColorSafe 1.0 Beta API Specifications located in the /API directory.

  Below are the three available distribution files and their descriptions.

colorsafe_1_0b.zip     -- windows distribution
colorsafe_1_0b.rar     -- windows distribution
colorsafe_1_0b.tar.gz  -- unix/linux distribution

--------------------------------------------------------------------------------------------------------
CONTENTS OF DISTRIBUTION FILES
--------------------------------------------------------------------------------------------------------

Directory         Description

/API
  -default        contains the public/protected member API specifications
  -private        contains all member API specifications
                 
/com              com.woven_media.colorsafe package
  -woven_media
    -colorsafe    ColorSafe class files 
      -src        contains the ColorSafe Java(TM) source code files
      -resources  properties files
        -default  images
          -flags  flag images

/dist             distribution files
  -colorsafe.exe  standard windows exe
  -colorsafe.jar  executable jar file

BUILD             example build commands text
GNU_LICENSE       GPL license text
INSTALL           install notes text
README            Overview, features and resources text
woven-media.ico   icon image

==========================================================================================================
                                     COLORSAFE 1.0 BETA FEATURES
==========================================================================================================

* ColorSafe can convert floating point values when Arithmetic color mode is selected.

* Web-safe, Grayscale, x11 Colors, Named and Windows System palettes can be accessed 
  from the View menu. Select any color within the palette window and the selected color
  information will be displayed in the main window.

* Cut/Copy/Paste support for all text fields makes transferring data between applications
  easy.
  
* Background color can be changed via the Edit menu.

* A safe color can be selected by accessing the Edit menu and selecting Nearest Safe Color.
  Click OK in the JColorChooser dialog. The safe color information will then be shown in 
  the main window.

* ColorSafe supports four different LookAndFeels which can changed at runtime via the View
  menu.
  
* ColorSafe features several keyboard shortcuts and are labeled when available in the top
  level menus.

* ColorSafe uses launch4j technology allowing it to run as a standard EXE on windows 
  machines.

* ColorSafe can dynamically change languages at runtime via the File menu. ColorSafe 
  currently supports the English and German languages.
  
==========================================================================================================
                                          RESOURCES
==========================================================================================================

ColorSafe 1.0 Beta Support             -- http://woven-media.com/
Cross-platform Java executable wrapper -- http://launch4j.sourceforge.net/                      
Lode's Computer Graphics Tutorial      -- http://www.student.kuleuven.be/~m0216922/CG/color.html
Color Topics in Computer Graphics      -- http://escience.anu.edu.au/lecture/cg/Color/printNotes.en.html
RGB color model                        -- http://en.wikipedia.org/wiki/RGB_color_model
