******************************************************************************
*                                                                            *
*                            Composition 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?
------------------------------------------------------------------------------
These scripts will handle some very dull and repetetive actions for you:
ADPro's composition mode. Not that I'm saying that all scripts are very
usefull, but I sure recon the power of AREXX when dealing with this
composition.


------------------------------------------------------------------------------
                                Emboss.rexx
------------------------------------------------------------------------------
The emboss technique is becoming more and more popular. Not for not. It
disturbs your images, just like it is engraved in thick paper, in a rock, if
you use a rather orange color. If you use a rather big offset, your paper will
appear thicker.

Useage:
    rx rexx:Emboss.rexx <filename> <Gray?> <OffX> <OffY>

Where:
    <Gray?>: Use GRAY if you want the image to be turned gray before emboss.
             Use COLOR if you don't want the image to be turned gray before
                    emboss.
    <OffX>:  Width offset, default=1.
                Use this to define your paper-thickness.
    <OffY>:  Height offset, default=1.

Example:
    rx rexx:Emboss.rexx ram:image GRAY 1 1
        This will create a simple emboss.

    rx rexx:Emboss.rexx ram:image COLOR 2 2
        This will create a colored emboss, with a thicker paper-effect.

I always use COLOR myself, because I can get the nicest results that way.

It was very easy to imply a GRAY-feature, so you can benefit from that too.


------------------------------------------------------------------------------
                               Foreground.rexx
------------------------------------------------------------------------------
Yes, this one will apply a foreground onto the original image. If you use
DOpus, you could do like me, and make sure that when I need this script there
always is an image ready and called 'Foreground'.

Useage:
    rx rexx:Foreground.rexx <filename> <foreground> <OffX> <OffY> <Mix%>
            <RLookThrough> <GLookThrough> <BLookThrough>

Where:
    <foreground>: Off course, the name of the foreground.
        You could choose to type the path along with it, but that isn't
        necassery, if you place the foreground-image in the same directory as
        the <filename>. Like:

            rx rexx:Foreground.rexx ram:image foreground 0 0 100 0 0 0

        Is much shorter than:

            rx rexx:Foreground.rexx ram:image ram:foreground 0 0 100 0 0 0

        And would work just as well. (DOpus feature)

    <OffX>/<OffY>: Pixel width/height offset.
    <Mix%>: percentage for mixing: from 0% to 100%
                But 0% wouldn't make very much sense.
    <RLookThrough>: Red color-value ranging fom 0 to 255.
            If ADPro encounters that value, along with the next 2, ADPro will
            'cut holes' at that value.
    <GLookThrough>: Green.
    <BLookThrough>: Blue.

Like:
    rx rexx:Foreground.rexx ram:image foreground 160 128 100 0 0 0

    Suppose ram:image is a hires 640x512 picture.
    Suppose ram:foreground is a lores 320x256 picture.
    Then foreground will appear in the front in the centre of ram:image, and
    all parts where the foreground is totally black will stay the way they
    were in the original image.

Maybe you should try it out, first with SHELL, I mean.


------------------------------------------------------------------------------
                                 Morph.rexx
------------------------------------------------------------------------------
No, it is not a new version of MorphPlus.

In fact, this one isn't very usefull. I only use this one when I have to fade
from an image to black, or in reverse.

Useage:
    rx rexx:Morph.rexx <filename> <morphTO> <frames>

Where:
    <morphTO>: Same features as 'Foreground' (above), but this file is needed
               to morph FROM <filename> TO <MorphTO>.
    <frames>: number of in-between-frames. This means you should not count the
              original images, meaning <filename> and <morphTO>, with them.

Like:
    rx rexx:Morph.rexx ram:image End 10

    Will create 10 new images, each representing less then 10% mixtures.

DOpus:

    DOS:  rx rexx:Morph.rexx {f} END {aEnter number of in-between-frames:1}

    Make sure that there is an image named END in your source.


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




Jan Van Overbeke.