home *** CD-ROM | disk | FTP | other *** search
/ The CDPD Public Domain Collection for CDTV 1 / CDPD_Vol1.bin / pd / 176-200 / 185 / aboutthisrelease next >
Text File  |  1992-06-23  |  9KB  |  232 lines
  1.  
  2. ABOUT THIS RELEASE - IFF_Nov88 - CBM
  3. ====================================
  4.  
  5. "IFF" - Interchange File Format
  6.  
  7. The files contained on this disk are the source and sample code for producing
  8. and using the Interface File Format developed jointly by Electronic Arts and
  9. Commodore-Amiga, Inc.  
  10.  
  11. Due to space limitations, this disk no longer contains ASCII versions
  12. of the IFF documents EAIFF85, ILBM, FTXT, SMUS, and 8SVX.  Current
  13. versions of these documents may be found in:
  14.  
  15.  1. IFF Docs and Disk
  16.    Available thru CATS (CBM USA) and several other national CBM
  17.    support organizations.  Check with your local organization or
  18.    order direct from CATS USA.  Note that the following prices
  19.    are 1988 prices and should be good through 1989.
  20.  
  21.    Price: $20 US + shipping (Shipping: US $0, Canada $2.50, Other $5.00)
  22.    Check made out to Commodore Business Machines
  23.    Allow 6-8 weeks for delivery.
  24.    Ask for "IFF Docs and Disk" and mail to:
  25.  
  26.     CATS - Orders
  27.     Brenda Billings
  28.     CBM
  29.     1200 Wilson Drive
  30.     West Chester, PA.  19380   U.S.A.
  31.  
  32.   2. Addison-Wesley new 1.3 "Rom Kernel Manual - Includes and Autodocs"
  33.     Should be available in bookstores January '89.
  34.  
  35. Alternately, the older EAIFF85, ILBM, FTXT, SMUS, and 8SVX documents
  36. can be used in combination with the IFF_News and Registry update docs
  37. on this disk.  The older documents are available in:
  38.  
  39.   1. Addison Wesley 1.1 "Rom Kernal Manual - Exec"
  40.   2. Old white CBM RKM Volume II
  41.   3. Fish Disk #64
  42.  
  43.  
  44. We at Commodore-Amiga have adopted this standard for internal use and we
  45. encourage our developers to do so as well.  The standard allows programs
  46. developed independently to easily share data with one another.  
  47.  
  48. Electronic Arts has placed all of their sample code into the public domain
  49. to encourage others to adopt the standard and to use it.
  50.  
  51.  
  52.   In order to avoid duplication in the naming of private chunks,
  53.   Commodore will act as a clearing house for private chunk names.
  54.   If you wish, you can either register the chunk name alone, or provide
  55.   us with a description of the contents of the chunk along with the
  56.   name.  By this means, we may be able to extend the standard in a
  57.   logical fashion, making it possible for future programs to maintain
  58.   compatibility.
  59.  
  60.   A list of new reserved FORM and Chunk names can be found on this
  61.   disk in the "Registry" file.  These new FORMs are being
  62.   designed by independent developers and in some cases are being
  63.   developed cooperatively in our amiga.dev/iff conference on BIX.
  64.   When I receive final specs on any of the new forms, I will
  65.   post the specs in amiga.dev/iff, and they will be included
  66.   in the next release of this disk.
  67.  
  68.   If possible, please discuss any new chunk or form ideas with
  69.   other developers and with us before registering them.
  70.   Our BIX amiga.dev/iff conference has been set up for this
  71.   purpose, but any group discussion will be helpful.
  72.   We want to create new standards, not just new chunks and forms.
  73.  
  74.   To register a new chunk or form, send a letter with whatever
  75.   detail you wish to release, and your name/address/phone# to:
  76.  
  77.      Carolyn Scheppner
  78.      Software Tech Support
  79.      CBM
  80.      1200 Wilson Drive
  81.      West Chester, PA.  19380
  82.  
  83.  
  84. IMPORTANT CODE CHANGES AND NOTES
  85. ================================
  86.  
  87.  1. Ilbm.h has been updated to include typedefs and macros for
  88.     CAMG, CCRT, and CRNG.  Similar definitions have been removed from
  89.     myreadpict.h (Display), and ScreenSave.c as they are no longer
  90.     needed there.
  91.  
  92.  2. CBM requests that the upper word of CAMG.ViewModes be currently
  93.     written as zeros, and not assumed to be zero when read (for
  94.     possible future expansion).  In addition certain bits must be
  95.     masked from the ViewModes low word when reading or writing CAMG.
  96.     See the update docs, and the ScreenSave and Display sources for
  97.     examples of CAMG masking.
  98.  
  99.  3. The PGTB and ANIM sources and examples were compressed to fit on this
  100.     disk using "Zoo" (Copyright 1987 Rahul Dhesi, Amiga Version by
  101.     J. Brian Waters).  Zoo is provided in the root directory of this
  102.     disk.  One way to decompress would be to copy Zoo and a ".zoo"
  103.     archive to a blank formatted diskette.  Cd to the disk and type:
  104.        zoo x archivename    (Example:  zoo x animsrc.zoo)
  105.  
  106.  See the Registry and IFF_News docs on this disk for additional changes.
  107.  
  108.  
  109. CONTENTS OF THIS DISK
  110. =====================
  111.  
  112.   LINKER_INFO (dir)   /* What modules to link with each EA example */
  113.     ilbm2raw.lnk                     ilbmdump.lnk
  114.     other.lnks                       raw2ilbm.lnk
  115.     read8svx.lnk                     README
  116.     showilbm.lnk
  117.   EXECUTABLE (dir)    /* EA example executables */
  118.     IFFCheck                         ILBM2Raw
  119.     ILBMDump                         Raw2ILBM
  120.     Read8SVX                         Zapicon
  121.   SOURCE (dir)        /* EA IFF module and example sources */
  122.     bmprintc.c                       dunpack.c
  123.     gio.c                            giocall.(sample)
  124.     IFFCheck.c                       iffr.c
  125.     iffw.c                           ILBM2Raw.c
  126.     ILBMDump.c                       ilbmr.c
  127.     ilbmw.c                          packer.c
  128.     putpict.c                        Raw2ILBM.c
  129.     Read8SVX.c                       README
  130.     readpict.c                       remalloc.c
  131.     ShowILBM.c                       unpacker.c
  132.   INCLUDE (dir)       /* IFF include files */
  133.        iff (dir)
  134.          8SVX.h                           compiler.h
  135.          gio.h                            iff.h
  136.          ilbm.h                           intuall.h
  137.          packer.h                         putpict.h
  138.          readpict.h                       remalloc.h
  139.          SMUS.h
  140.   DOCUMENTS (dir)     /* Update and Tutorial Documents */
  141.     documents.zoo
  142.   OBJECT (dir)        /* Amiga object format (32-bit) IFF modules */
  143.     bmprintc.o                       dunpack.o
  144.     gio.o                            iffr.o
  145.     iffw.o                           ilbmr.o
  146.     ilbmw.o                          packer.o
  147.     putpict.o                        readpict.o
  148.     remalloc.o                       unpacker.o
  149.   EXAMPLES (dir)      /* Other IFF examples */
  150.        ScreenSave (dir)     /* Save front screen as ILBM */
  151.          ScreenSave.c                     ScreenSave.README
  152.        Display (dir)        /* Display [cycle, print] an ILBM
  153.          Display.c                        Display.with
  154.          dump.c                           iffmsgs.c
  155.          myreadpict.c                     myreadpict.h
  156.          README
  157.        PGTB (dir)           /* Program Traceback code */
  158.          pgtb.zoo
  159.        ANIM (dir)           /* ANIM code */
  160.          animexe.zoo                      animsrc.zoo
  161.     apack.asm                        Astartup.obj
  162.     cycvb.c
  163.   TP_IFF_Specs (dir)        /* Third Party IFF Specs */
  164.     8SVX.CHANandPAN                  ACBM
  165.     ANBM                             ANIM
  166.     HEAD                             ILBM.DPPV
  167.     PGTB                             WORD
  168. .info                            AboutThisRelease
  169. AboutThisRelease.info            Cycles_ILBM
  170. Cycles_ILBM.info                 Disk.info
  171. Display                          Display.info
  172. Dragon_Brush                     Dragon_Brush.info
  173. IFF_News                         IFF_News.info
  174. Registry                         Registry.info
  175. ScreenSave                       ScreenSave.info
  176. ShowILBM                         ShowILBM.info
  177. zoo      /* For decompressing the ANIM and PGTB zoo archives */
  178.  
  179.  
  180. DESCRIPTION OF THE EXAMPLES ON THIS DISK:
  181.  
  182. (In EXECUTABLE directory - C source in SOURCE dir)
  183.  
  184.   IFFCheck - Prints out the structure of an IFF file
  185.   ILBM2Raw - Converts an ILBM to raw bitmap, colormap
  186.   ILBMDump - Prints out ASCII representation of ILBM file
  187.   Raw2ILBM - Converts raw bitmap file to ILBM
  188.   Read8SVX - Reads an 8SVX sound sample and prints contents
  189.   Zapicon  - Converts a DPaint brush to an icon (no source)
  190.  
  191.  
  192. (In EXAMPLES and directory - C source in EXAMPLES directory)
  193.  
  194.   Astartup.obj - 1.3 Amiga startup code required when linking
  195.                  some of my examples (cas)
  196.   cycvb.c ------ Dan Silva's DPaint cycling interrupt code
  197.   apack.asm ---- Dr. Gerald Hull's assembler packer.c replacement
  198.   PGTB/ -------- Archived PGTB catcher and browser
  199.   ANIM/ -------- Archived ANIM displayers, grabber, and example source
  200.  
  201.  
  202. (In ROOT directory - C source in SOURCE and EXAMPLES)
  203.  
  204.   ScreenSave --- Save front screen as ILBM
  205.                  (works with HAM, creates an icon for ILBM)
  206.  
  207.   ShowILBM ----- This ILBM viewer from EA displays one or more
  208.                  ILBMs in a ViewPort for 5 seconds each.
  209.  
  210.      CLI Usage: Showilbm picfile1 [ picfile2 ...]
  211.      WB Usage:  Click on ShowILBM, hold shift and
  212.                 click on pic icons, double-clicking
  213.                 on last selection
  214.  
  215.   Display ------ This ILBM viewer displays a single ILBM in a
  216.                  screen/window until the invisible close gadget
  217.                  in the upper left corner is clicked.
  218.  
  219.      Display supports time delays, printing, cycling,
  220.      backscreen, and EHB default via either command
  221.      line or Workbench tooltype options.
  222.      Display ?<RET> shows cli options.
  223.      Double-clicking Display icon shows WB options.
  224.  
  225.      Interactive commands are:
  226.         TAB - toggles cycling
  227.         "p" - prints screen
  228.         CTRL/C - exit
  229.         CTRL/D - exit and break a script
  230.  
  231.  
  232.