
******************************************************************************
*                                                                            *
*                          ColorCorrection Document                          *
*                                                                            *
*                     Belongs To The Scripti Collection                      *
*                                                                            *
*                         By Jan Van Overbeke, 3-DEE                         *
*                                                                            *
*      Read The Doc On The Scripti Collection For More Info About Rights     *
*                                                                            *
******************************************************************************

------------------------------------------------------------------------------
                                    WHAT?
------------------------------------------------------------------------------
Well, these scripts will change the colors of your images.



------------------------------------------------------------------------------
                               LockPalette.rexx
------------------------------------------------------------------------------
Locking a palette means that if you do operations on the next images, they
will get the palette from the locked one. Especially old ones, animations are
rarely made with locked-palettes. This can however disturb and blur some of
your images, so don't blaim me, it's IFF. But, I think, the speed will
increase. If you have a rather old animation-program, you could use this
script.

Useage:
    rx rexx:LockPalette.rexx <filename>

This scripts will end very FAST, because only the palette will be loaded.
And off course locked. (just in case you might think nothing happened.)

Now what? You can now use the next script:


------------------------------------------------------------------------------
                            UseLockedPalette.rexx
------------------------------------------------------------------------------
This script will load an IFF image, and render a new image, based on the
locked palette. You can choose to apply dither or not.

Useage:
    rx rexx:UseLockedPalette.rexx <filename> <dither>

Where:
    <dither>: code to apply dither type.
                    0: No dither
                    1: Floyd-Steinmann.
                    there are more.

It doesn't matter if your locked palette is bigger or smaller than the one you
need to call this script. However, I strongly advice that for example, that if
you locked a 32-color image, you should apply this script on a 32-color image.



------------------------------------------------------------------------------
                             UnLockPalette.rexx
------------------------------------------------------------------------------
To turn the palette back to normal, you should call this script. It is simple,
you don't need any arguments.

Useage:
    rx rexx:UnLockPalette.rexx



------------------------------------------------------------------------------
                              ColorToGray.rexx
------------------------------------------------------------------------------
This script will turn any color image to gray, using on of ADPro's operators.
Guess which one.

Useage:
    rx rexx:ColorToGray.rexx <filename>

Read the "FrequentRoutines"-doc if you want to learn about the result-palette.



------------------------------------------------------------------------------
                                Colors.rexx
------------------------------------------------------------------------------
This one will not only change your palette, but also your maximum colors in
IFF-mode. The script works with any image, but I would advice to only use
IFF-images, including 24Bit. If you convert from 24Bit, you could better use
the script "24Bit->IFF.rexx" (general).

Useage:
    rx rexx:Colors.rexx <filename> <colors>

Where:
    <colors>: 2 4 8 16 32 64 128 256 HAM8 HAM 24BIT

The palette will be adjusted accordingly.

It is best to move to higher colors, like from 2 to HAM8. If you want to go to
lower colors, use "24Bit->IFF.rexx". The latter will apply some dithering if
you want.



------------------------------------------------------------------------------
                                  THE END
------------------------------------------------------------------------------




Jan Van Overbeke.





