May 8, 1991


*****************************************************************************

      Note:  This is IFFtoDCTV v1.0c, this version will now change
             the size of DCTV display files.  As with the old version all
             widths must be divisible by 16. As an example 736/16=46

                    Thank you for purchasing DCTV, 
               another fine Digital Creations product


*****************************************************************************

IFFtoDCTV
---------

This utility is used for situations where an IFF file (all Amiga modes and
24-bit IFF, Turbo Silver RGB8, and Sculpt4D 24-bit compressed) is to be
converted into a DCTV image or DCTV raw file.  It is provided so that
conversion can occur in bulk, using SPAT or a script or both.

Syntax:

IFFtoDCTV <input files...> <options>

<input files...> - Any number of file names to be converted.

Options:

-w<width>    -  Output image width, legal values are from 640 to 736
                If not specified the output width is 736

-h<height>   -  Output image height, legal values are from 200 to 241 and
                400 to 482.  If not specified the output height is 482.

-d<depth>    -  Output image depth, legal values are 3 or 4. If not
                specified the output depth is 4.

-r<n>        -  Output image as a DCTV raw file with n fields. If <n> is
                not specified it defaults to 2 fields.  Legal values are: 1
                or 1.  If -r isn't specified the output is DCTV image.

-b           -  Extract a base name from the input filename.  Scanning from
                the right until a period is encountered, a base name is
                constructed.  It is then used as the output filename along
                with the appropriate extension (.raw or .dctv).

-c           -  Align the picture into the output file at the top-left.  If
                an input file image is bigger than the output file image
                area it will align the image on the top-left corner.  If
                not specified the input file image will be centered on the
                output file image area.

-f           -  Turn on RGB filtering.  If specified, the input image will
                be filtered to remove chroma and luma artifacts.

-o<target>   -  Output directory.  If specified, the output file will be
                written to the given directory.  If not the output file
                will be written to the current directory.

-s           -  Use Sculpt 4D 24-bit image file ordering.  If the input
                file is from Sculpt 4D this option must be used for the
                file to be converted correctly.

Examples:

IFFtoDCTV pict.HAM -b -w640 -h400 -d3

The input file, "pict.HAM", is a ham file.  It will be converted into a
640 by 400 three bitplane deep DCTV file with the name: "pict.dctv".

IFFtoDCTV pict.HAM -w640 -h400 -d3

The same result as the example above except that the output filename will
be: "pict.HAM.dctv".

IFFtoDCTV pict.24 -w736 -h482 -d4 -oDCTVStuff -c -f -b

The 24 bit image file "pict.24" is converted into a 736 by 482 4 bitplane
DCTV image file.  It is saved into a directory called "DCTVStuff" with the
name "pict.dctv".  It is filtered and aligned to the top-left corner of the
736 by 482 image area.

SPAT IFFtoDCTV dr0:BIGFILES/pict.???.24 -w736 -h482 -d4 -oDCTVStuff -f -b

The files on the device "dr0:" in the directory "BIGFILES" with the form
"pict.<any three characters>.24" will be converted into 4 bitplane 736 by
482 size image files.  They are be stored into the directory "DCTVStuff"
off of the current directory with the output form "pict.<any three
characters> .24.dctv".

                         We hope you enjoy DCTV!

                    Digital Creations  January 15,1991

                   We can be reached monday thru friday
               from 9:00am to 5:00pm PST at (916) 344-4825