
ABOUT THIS RELEASE - IFF_Nov88 - CBM
====================================

"IFF" - Interchange File Format

The files contained on this disk are the source and sample code for producing
and using the Interface File Format developed jointly by Electronic Arts and
Commodore-Amiga, Inc.  

Due to space limitations, this disk no longer contains ASCII versions
of the IFF documents EAIFF85, ILBM, FTXT, SMUS, and 8SVX.  Current
versions of these documents may be found in:

 1. IFF Docs and Disk
   Available thru CATS (CBM USA) and several other national CBM
   support organizations.  Check with your local organization or
   order direct from CATS USA.  Note that the following prices
   are 1988 prices and should be good through 1989.

   Price: $20 US + shipping (Shipping: US $0, Canada $2.50, Other $5.00)
   Check made out to Commodore Business Machines
   Allow 6-8 weeks for delivery.
   Ask for "IFF Docs and Disk" and mail to:

    CATS - Orders
    Brenda Billings
    CBM
    1200 Wilson Drive
    West Chester, PA.  19380   U.S.A.

  2. Addison-Wesley new 1.3 "Rom Kernel Manual - Includes and Autodocs"
    Should be available in bookstores January '89.

Alternately, the older EAIFF85, ILBM, FTXT, SMUS, and 8SVX documents
can be used in combination with the IFF_News and Registry update docs
on this disk.  The older documents are available in:

  1. Addison Wesley 1.1 "Rom Kernal Manual - Exec"
  2. Old white CBM RKM Volume II
  3. Fish Disk #64


We at Commodore-Amiga have adopted this standard for internal use and we
encourage our developers to do so as well.  The standard allows programs
developed independently to easily share data with one another.  

Electronic Arts has placed all of their sample code into the public domain
to encourage others to adopt the standard and to use it.


  In order to avoid duplication in the naming of private chunks,
  Commodore will act as a clearing house for private chunk names.
  If you wish, you can either register the chunk name alone, or provide
  us with a description of the contents of the chunk along with the
  name.  By this means, we may be able to extend the standard in a
  logical fashion, making it possible for future programs to maintain
  compatibility.

  A list of new reserved FORM and Chunk names can be found on this
  disk in the "Registry" file.  These new FORMs are being
  designed by independent developers and in some cases are being
  developed cooperatively in our amiga.dev/iff conference on BIX.
  When I receive final specs on any of the new forms, I will
  post the specs in amiga.dev/iff, and they will be included
  in the next release of this disk.

  If possible, please discuss any new chunk or form ideas with
  other developers and with us before registering them.
  Our BIX amiga.dev/iff conference has been set up for this
  purpose, but any group discussion will be helpful.
  We want to create new standards, not just new chunks and forms.

  To register a new chunk or form, send a letter with whatever
  detail you wish to release, and your name/address/phone# to:

     Carolyn Scheppner
     Software Tech Support
     CBM
     1200 Wilson Drive
     West Chester, PA.  19380


IMPORTANT CODE CHANGES AND NOTES
================================

 1. Ilbm.h has been updated to include typedefs and macros for
    CAMG, CCRT, and CRNG.  Similar definitions have been removed from
    myreadpict.h (Display), and ScreenSave.c as they are no longer
    needed there.

 2. CBM requests that the upper word of CAMG.ViewModes be currently
    written as zeros, and not assumed to be zero when read (for
    possible future expansion).  In addition certain bits must be
    masked from the ViewModes low word when reading or writing CAMG.
    See the update docs, and the ScreenSave and Display sources for
    examples of CAMG masking.

 3. The PGTB and ANIM sources and examples were compressed to fit on this
    disk using "Zoo" (Copyright 1987 Rahul Dhesi, Amiga Version by
    J. Brian Waters).  Zoo is provided in the root directory of this
    disk.  One way to decompress would be to copy Zoo and a ".zoo"
    archive to a blank formatted diskette.  Cd to the disk and type:
       zoo x archivename    (Example:  zoo x animsrc.zoo)

 See the Registry and IFF_News docs on this disk for additional changes.


CONTENTS OF THIS DISK
=====================

  LINKER_INFO (dir)   /* What modules to link with each EA example */
    ilbm2raw.lnk                     ilbmdump.lnk
    other.lnks                       raw2ilbm.lnk
    read8svx.lnk                     README
    showilbm.lnk
  EXECUTABLE (dir)    /* EA example executables */
    IFFCheck                         ILBM2Raw
    ILBMDump                         Raw2ILBM
    Read8SVX                         Zapicon
  SOURCE (dir)        /* EA IFF module and example sources */
    bmprintc.c                       dunpack.c
    gio.c                            giocall.(sample)
    IFFCheck.c                       iffr.c
    iffw.c                           ILBM2Raw.c
    ILBMDump.c                       ilbmr.c
    ilbmw.c                          packer.c
    putpict.c                        Raw2ILBM.c
    Read8SVX.c                       README
    readpict.c                       remalloc.c
    ShowILBM.c                       unpacker.c
  INCLUDE (dir)       /* IFF include files */
       iff (dir)
         8SVX.h                           compiler.h
         gio.h                            iff.h
         ilbm.h                           intuall.h
         packer.h                         putpict.h
         readpict.h                       remalloc.h
         SMUS.h
  DOCUMENTS (dir)     /* Update and Tutorial Documents */
    documents.zoo
  OBJECT (dir)        /* Amiga object format (32-bit) IFF modules */
    bmprintc.o                       dunpack.o
    gio.o                            iffr.o
    iffw.o                           ilbmr.o
    ilbmw.o                          packer.o
    putpict.o                        readpict.o
    remalloc.o                       unpacker.o
  EXAMPLES (dir)      /* Other IFF examples */
       ScreenSave (dir)     /* Save front screen as ILBM */
         ScreenSave.c                     ScreenSave.README
       Display (dir)        /* Display [cycle, print] an ILBM
         Display.c                        Display.with
         dump.c                           iffmsgs.c
         myreadpict.c                     myreadpict.h
         README
       PGTB (dir)           /* Program Traceback code */
         pgtb.zoo
       ANIM (dir)           /* ANIM code */
         animexe.zoo                      animsrc.zoo
    apack.asm                        Astartup.obj
    cycvb.c
  TP_IFF_Specs (dir)        /* Third Party IFF Specs */
    8SVX.CHANandPAN                  ACBM
    ANBM                             ANIM
    HEAD                             ILBM.DPPV
    PGTB                             WORD
.info                            AboutThisRelease
AboutThisRelease.info            Cycles_ILBM
Cycles_ILBM.info                 Disk.info
Display                          Display.info
Dragon_Brush                     Dragon_Brush.info
IFF_News                         IFF_News.info
Registry                         Registry.info
ScreenSave                       ScreenSave.info
ShowILBM                         ShowILBM.info
zoo      /* For decompressing the ANIM and PGTB zoo archives */


DESCRIPTION OF THE EXAMPLES ON THIS DISK:

(In EXECUTABLE directory - C source in SOURCE dir)

  IFFCheck - Prints out the structure of an IFF file
  ILBM2Raw - Converts an ILBM to raw bitmap, colormap
  ILBMDump - Prints out ASCII representation of ILBM file
  Raw2ILBM - Converts raw bitmap file to ILBM
  Read8SVX - Reads an 8SVX sound sample and prints contents
  Zapicon  - Converts a DPaint brush to an icon (no source)


(In EXAMPLES and directory - C source in EXAMPLES directory)

  Astartup.obj - 1.3 Amiga startup code required when linking
                 some of my examples (cas)
  cycvb.c ------ Dan Silva's DPaint cycling interrupt code
  apack.asm ---- Dr. Gerald Hull's assembler packer.c replacement
  PGTB/ -------- Archived PGTB catcher and browser
  ANIM/ -------- Archived ANIM displayers, grabber, and example source


(In ROOT directory - C source in SOURCE and EXAMPLES)

  ScreenSave --- Save front screen as ILBM
                 (works with HAM, creates an icon for ILBM)

  ShowILBM ----- This ILBM viewer from EA displays one or more
                 ILBMs in a ViewPort for 5 seconds each.

     CLI Usage: Showilbm picfile1 [ picfile2 ...]
     WB Usage:  Click on ShowILBM, hold shift and
                click on pic icons, double-clicking
                on last selection

  Display ------ This ILBM viewer displays a single ILBM in a
                 screen/window until the invisible close gadget
                 in the upper left corner is clicked.

     Display supports time delays, printing, cycling,
     backscreen, and EHB default via either command
     line or Workbench tooltype options.
     Display ?<RET> shows cli options.
     Double-clicking Display icon shows WB options.

     Interactive commands are:
        TAB - toggles cycling
        "p" - prints screen
        CTRL/C - exit
        CTRL/D - exit and break a script


