$Id: README,v 1.5 2008/05/06 20:24:00 alex Exp $

Release notes for xoris 0.1d
============================

This is an uncomplicated util that helps (me) to easy insert (while
editing CSS-files) a rgb-color value of any part of the screen into
the editor.

xoris grabs the RGB color value of any pixel on the screen and dumps the
color's name to stdout. The output can be printed as:

   1. hex (#b0958e);
   2. triple of decimal RGB values (229 229 229);
   3. abstract name (gray90). 

To get such enumerated color specifications, click: Button1,
Ctrl+Button1, Shift+Button1 correspondingly.

Don't forget to type ``xoris -h'' for additional help.

Program has only been tested on displays with a bit depth of 24 bpp. 


INSTALL
-------

To compile, type:

    % xmkmf
    % make
    
To install, type (as root):

    # make install

For quick test how it works, type:

    % xoris | xmessage -file -

For a more convenience way try such script:

#!/bin/sh

while true
do
    xoris | xmessage -buttons 'Grab,Quit' -nearmouse \
        -xrm '*iconName:xoris output' \
        -title 'xoris output' \
        -geometry 180x65 \
        -file -
    [ $? -eq 102 ] && exit
done
