*******************************************************************************
    Niff.doc

    Mitchell/Ware Systems, Inc.         Version 2.01                8/26/90

    IFF Chunk Dump Utility

    Keep an eye out for our commercial products currently under development:

        3-Tuple --  A powerful Modeler/Ray Trace/Animation System. Details of
                    this system will not be revealed until release. (Sorry!)
                    4 man-years of effort has gone into the R&D of this product.

        ProReq  --  Professional Requester Interface Builder/Control Code
                    generator. Will be able to generate code for both 1.3
                    and 2.0 versions of the OS. Support planned for GadTools.

        Both of these products will run under AmigaDOS 2.0 and above. If
        you have any input regarding this or anything else that may come
        to mind, you may contact Fred at:

            BIX:    f.mitchell
            PHONE:  (215)344-7333
            EARTH:  Mitchell/Ware Systems, Inc.
                    1296 Airport Road
                    West Chester, PA 19380 USA
*******************************************************************************

    NAME
        Niff -- IFF Chunk dump utility

    SYNOPSIS
        NIFF ifffile1 ifffile2 ...

    FUNCTION
        Niff dumps the contents of IFF chunks from any IFF file. If Niff
        understands the chunk, then it will dump that chunk as named
        fields. Otherwise, it will perform a Hex dump.

        Chunks are indented according to the nesting within FORMs, CATs,
        PROPs, and LISTs. This makes it easy to follow the structure.

    INPUTS
        ifffilen    - name of the IFF file to be dumped

    RESULT
        The contents of the chunks will be displayed on screen. If
        Niff understands the information, will display it as named
        fields, else will do a HEX dump 80 columns wide.

    EXAMPLE
        Dumping a ILBM file 'cute.pic':

            Niff cute.pic

        Results in the following output:

            Dump of IFF file cute
            FORM.ILBM - 19886 (Group)
            	BMHD - 20
            		w=640, h=400, x=0, y=0
            		nPlanes = 2
            		masking = 0
            		compres = 1
            		transpC = 0
            		xAspect=20, yAspect=11
            		pageWidth=640, pageHeight=400
            	CMAP - 12
            		[0] red=00, green=00, blue=00
            		[1] red=e0, green=c0, blue=a0
            		[2] red=50, green=50, blue=f0
            		[3] red=f0, green=80, blue=00
            	CRNG - 8
            		rate   = 2730
            		active = 1
            		low=3, high=3
            	CRNG - 8
            		rate   = 2730
            		active = 1
            		low=3, high=3
            	CAMG - 4
            		Mode = 0000c004
            	BODY - 19600
            	0000 b1 00 b1 00 b1 00 b1 00-b1 00 b1 00 b1 00 b1 00 "................"
            	0010 b1 00 b1 00 b1 00 b1 00-b1 00 b1 00 b1 00 b1 00 "................"
            	0020 b1 00 b1 00 b1 00 b1 00-b1 00 b1 00 b1 00 b1 00 "................"
            	0030 b1 00 b1 00 b1 00 b1 00-b1 00 b1 00 b1 00 b1 00 "................"
            	0040 b1 00 b1 00 b1 00 b1 00-b1 00 b1 00 b1 00 b1 00 "................"
            	0050 b1 00 b1 00 b1 00 b1 00-b1 00 b1 00 b1 00 b1 00 "................"

                    ...

    NOTES
        The current version (2.01) only recognize ILBM chunks.

    BUGS
        On some lengthy chunks, the output can be voluminous. There
        needs to be a way to skip output of selected chunks.

    CREDITS/COPYRIGHT NOTICE
        Written by Fred Mitchell. Copyright © 1989 Mitchell/Ware Systems.
        This program may be freely redistributed, only in its unaltered,
        original and complete LHARCed or ZOOed format. Neither Fred Mitchell
        nor Mitchell/Ware Systems shall be held liable for any damages,
        direct or otherwise, resulting from the use or misuse of this program.
        Niff is only intended as a diagnostic tool for debugging IFF-formatted
        files. This program is provided for you as a courtesy of Mitchell/Ware
        Systems.