[comp.binaries.apple2] ftn.about.89.11

mjohnson@APPLE.COM (Mark B. Johnson) (12/02/89)

This message  was originally  submitted by  mjohnson@APPLE.COM to  the APPLE2-L
list  at BROWNVM.  If  you simply  forward  it back  to the  list,  it will  be
distributed with the paragraph you are now reading being automatically removed.
If you  edit the  contributions you  receive into  a digest,  you will  need to
remove this  paragraph before mailing the  result to the list.  Finally, if you
need more information from the author of this message, you should be able to do
so by simply replying to this note.

----------------- Message requiring your approval (302 lines) -----------------
Apple II
File Type Notes
_____________________________________________________________________________
                                                  Developer Technical Support


About Apple II File Type Notes                                  November 1989
_____________________________________________________________________________


This Note accompanies each release of Apple II File Type Notes.  This release
includes a new format for file type $BB, as well as an updated list of all
currently assigned Apple II file types and auxiliary types.

Developer Technical Support requires four things from a developer before
publishing a file format for your application in a File Type Note:

1.    The file format itself, preferably in an ASCII text file.
2.    Assurances that the product is shipping.  We don't want to jump
      the gun by releasing a Note for an unannounced product or a
      product which is unavailable.  The enclosed list of file type
      assignments includes only those products which we know are
      currently shipping.
Note: If your product is shipping, but your file type is not
      listed, you need to let us know since engineering uses this list
      to identify files in future Apple products, such as future
      releases of the Apple IIGS Finder.  If this Note does not list
      your file type and auxiliary type assignments, engineering will
      not be able to include them in future products.  The "short"
      names listed in this Note will be used as the descriptors for such
      files, so you should contact DTS if a descriptor for one of your
      files is unsuitable.  The list published in this month's Note
      reflects file descriptors that are to be shipped with System
      Software 5.0.  This list is final for 5.0.
3.    Written permission to publish the file format.  We don't want you
      to submit the format and then be surprised when we publish it.
4.    Your company name and address, so we can refer readers to you for
      more information about your product.

We welcome your file formats, suggestions on existing Notes, and your requests
for file type or auxiliary type assignments.  Please contact us at:

                    Apple II File Type Notes
                    Developer Technical Support
                    Apple Computer, Inc.
                    20525 Mariani Avenue, M/S 75-3T
                    Cupertino, CA  95014
                    AppleLink:  AIIDTS
                    MCI Mail:  AIIDTS (264-0103)

The universal sharing of file formats opens new dimensions to personal
computing, so we want Apple II File Type Notes distributed as widely as
possible.  We send them to all Partners and Associates at no charge, and we
also post them on AppleLink in the Developer Services bulletin board and other
electronic sources, including the Apple FTP site (IP 130.43.2.2).  You can
also order them through APDA.  As an APDA customer, you have access to the
tools and documentation necessary to develop Apple-compatible products.  For
more information about APDA, contact:

                    APDA
                    Apple Computer, Inc.
                    20525 Mariani Avenue, M/S 33-G
                    Cupertino, CA 95014
                    (800) 282-APDA or (800) 282-2732
                    Fax:  (408) 562-3971
                    Telex:  171-576
                    AppleLink:  APDA

We place no restrictions on copying the Notes, with the exception that you
cannot resell them.  You should note, however, that some of the file formats
are the copyrighted property of the companies which own them.  These formats
are identified in the appropriate Notes, and you should treat them with
respect to the applicable copyright laws.

Following is a current list of all file type and auxiliary type assignments.
Assignments with a date indicate the release date of the File Type Note for
that assignment, and all file types and auxiliary types which are not listed
in this Note are reserved and should not be used.


Definitions

The following definitions apply to all Apple II File Type Notes and will not
be repeated in each Note:

Boolean        A binary indicator.  If the most significant bit of a
               boolean is set, the boolean is TRUE.  If it is clear, it is
               FALSE.
Byte           An 8-bit value.
Double Long    A 64-bit value, composed of eight byte, four words or two
               long words.  The most significant byte is stored last.
Fixed          A four-byte signed value where the least significant word
               represents a fractional part and the most significant word
               represents an integer part (i.e., the value 32767.0 would be
               stored as $00 $00 $FF $7F to represent the integer part of
               $7FFF (+32767) and the fractional part of $0000 (0)).  The
               value 4.5 would be stored as $00 $80 $04 $00 to represent
               the integer part of $0004 and the fractional part of $8000.
               The value $8000 is represented as 1000000000000000 in
               binary.  The bit immediately following the decimal point is
               set, which indicates the value of 2^-1, or one-half.  The
               full binary expansion of 4.5 is
               0000000000000100.1000000000000000, which indicates 2^2 + 2^-
               1 or 4 + 0.5, which is 4.5.  The Apple IIGS Integer Math
               Tools contain routines to assist with Fixed arithmetic.
Flag unit      Any storage unit (byte, word, long) treated as a series of
               flag bits rather than as a numeric value.
Long           A 32-bit value, composed of four bytes or two words.  The
               most significant byte is stored last.  For example,
               $00E102A8 would be stored as $A8 $02 $E1 $00.
Reverse        The 65xxx series microprocessors normally store values with
               the least significant byte (LSB) first, while other
               microprocessors may store values with the most significant
               byte (MSB) first.  The designation Reverse (Rev.) indicates
               that values must be rearranged before using them  (i.e., a
               Long value of $11223344 would be stored as $44 $33 $22 $11,
               but a Reverse Long value would be stored as $11 $22 $33
               $44).
String         A Pascal-type string.  It consists of a length byte followed
               by up to 255 bytes of ASCII data.
Word           A 16-bit value, composed of two bytes.  The most significant
               byte of the word is stored after the least significant byte.
               For example, $02FF would be stored $FF $02.

All bit definitions are given as bit numbers.  Bit 0 is always the least
significant bit.  The most significant bit of a byte is bit 7; the most
significant bit of a word is bit 15, etc.

_____________________________________________________________________________

File Type Assignments                                           November 1989

* = Finder identifies for System Software 5.0                         New ***
+ = Finder identifies for System Software 5.0 only on machines    Revised *R*
    with more than 512K memory

File Aux.
Type Type   File Type Description            Auxiliary Type Description  Date
_____________________________________________________________________________
$00*        Unknown
$01*        Bad blocks
$02+        Apple /// Pascal code
$03+        Apple /// Pascal text
$04*        ASCII text                       Random-access record-length
$05+        Apple /// Pascal data
$06*        Binary                           Load address in bank 0
$07+        Apple /// Font
$08*        Apple II or /// Graphics                                    05/89
$08+ $4000  Packed Hi-Res Image              Image Format               11/88
$08+ $4001  Packed Double Hi-Res Image       Image Format               11/88
$09+        Apple /// BASIC program
$0A+        Apple /// BASIC data
$0B+        Apple /// Word Processor
$0C+        Apple /// SOS System
$0F*        Folder
$10+        Apple /// RPS data
$11+        Apple /// RPS index
$12+        Apple /// AppleFile discard
$13+        Apple /// AppleFile model
$14+        Apple /// AppleFile report format
$15+        Apple /// screen library
$16+        PFS document
$16+ $0001  PFS:File document                Program Specific
$16+ $0002  PFS:Write document               Program Specific
$16+ $0003  PFS:Graph document               Program Specific
$16+ $0004  PFS:Plan document                Program Specific
$16+ $0016  PFS internal data                Program Specific
$19*        AppleWorks Data Base             Upper-/lowercase in name   09/89
$1A*        AppleWorks Word Processor        Upper-/lowercase in name   09/89
$1B*        AppleWorks Spreadsheet           Upper-/lowercase in name   09/89
$20+        Desktop Manager document
$29+        Apple /// SOS Dictionary
$2A+        Apple II Source Code             Application Specific
$2B+        Apple II Object Code             Application Specific
$2C+        Apple II Interpreted Code        Application Specific
$2D+        Apple II Language Data           Application Specific
$42*        File Type Names                  Search order               07/89
$50*        Apple IIGS Word Processor
$50+ $8001  DeluxeWrite document             Application Specific
$50+ $8010  AppleWorks GS Word Processor     Application Specific
$51*        Apple IIGS Spreadsheet
$51+ $8010  AppleWorks GS Spreadsheet        Application Specific
$52*        Apple IIGS Data Base
$52+ $8010  AppleWorks GS Data Base          Application Specific
$52+ $8011  AppleWorks GS DB Template        Application Specific
$53*        Drawing
$53+ $8010  AppleWorks GS Graphics           Application Specific
$54*        Desktop Publishing
$54+ $8010  AppleWorks GS Page Layout        Application Specific
$54+ $DD3E  Medley document                  Application Specific       05/89
$55*        Hypermedia                       Application Specific
$55+ $8001  Tutor-Tech document              Application Specific
$55+ $8002  HyperStudio document             Application Specific
$56*        Educational Data                 Application Specific
$56+ $8001  Tutor-Tech Scores                Application Specific
$57*        Stationery
$58*        Help File
$59*        Communications File              Application Specific
$59+ $8010  AppleWorks GS Communications     Application Specific
$5A*        Configuration file               Application Specific
$5A+ $8001  Master Tracks Jr. preferences
$5A+ $8010  AppleWorks GS configuration      Application Specific
$5B*        Animation file                   Application Specific
$5B+ $8001  Cartooners movie                 Application Specific
$5B+ $8002  Cartooners actors                Application Specific
$6B+        PC Transporter BIOS
$6D+        PC Transporter driver
$6E+        PC Transporter pre-boot
$6F+        PC Transporter volume
$A0*        WordPerfect document             WordPerfect                01/89
$AB+        Apple IIGS BASIC program
$AC+        Apple IIGS BASIC TDF
$AD+        Apple IIGS BASIC data
$B0*        Apple IIGS source code           APW Language type
$B0+ $0001  APW Text file
$B0+ $0003  APW 65816 Assembly source code
$B0+ $0005  ORCA/Pascal source code
$B0+ $0006  APW command file
$B0+ $0008  ORCA/C source code
$B0+ $0009  APW Linker command file
$B0+ $000A  APW C source code
$B0+ $000C  ORCA/Desktop command file
$B0+ $0015  APW Rez source file
$B0+ $001E  TML Pascal source code
$B1*        Apple IIGS object code
$B2*        Apple IIGS Library file
$B3*        GS/OS application                                           09/89
$B4*        GS/OS Run-Time Library
$B5*        GS/OS Shell application                                     09/89
$B6*        Permanent initialization file    Not loaded if bit 15 set
$B7*        Temporary initialization file    Not loaded if bit 15 set
$B8*        New desk accessory               Not loaded if bit 15 set
$B9*        Classic desk accessory           Not loaded if bit 15 set
$BA*        Tool
$BB*        Apple IIGS Device Driver File    Not loaded if bit 15 set***11/89
$BC*        Load file (generic)
$BD*        GS/OS File System Translator     Not loaded if bit 15 set
$BF+        GS/OS document
$C0*        Packed Super Hi-Res picture      Application Specific
$C0+ $0000  Paintworks Packed picture        Application Specific       11/88
$C0+ $0001  Packed Super Hi-Res Image        Application Specific       11/88
$C0+ $0002  Apple Preferred Format picture   Application Specific       11/88
$C0+ $0003  Packed QuickDraw II PICT file    Application Specific       11/88
$C1*        Super Hi-Res picture             Application Specific       11/88
$C1+ $0000  Super Hi-Res Screen image        Application Specific       11/88
$C1+ $0001  QuickDraw PICT file              Application Specific       11/88
$C2+        Paintworks animation
$C3+        Paintworks palette
$C5*        Object-oriented graphics         Application Specific
$C5+ $8000  Draw Plus document               Application Specific
$C5+ $C000  DYOH: Architecture document      Application Specific
$C5+ $C001  DYOH predrawn objects            Application Specific
$C5+ $C002  DYOH custom objects              Application Specific
$C5+ $C003  DYOH clipboard                   Application Specific
$C5+ $C006  DYOH: Landscape Document         Application Specific
$C7*        Control Panel document           Not loaded if bit 15 set   09/89
$C8*        Font
$C8 $0000   Font (Standard QuickDraw II Font)Reserved                   01/89
$C9*        Finder data
$CA*        Icons                                                       07/89
$D5*        Music sequence                   Application Specific
$D5+ $0000  Music Construction Set song      Application Specific
$D5+ $8002  Diversi-Tune sequence            Application Specific
$D6*        Instrument                       Application Specific
$D6+ $0000  Music Construction Set inst.     Application Specific
$D6+ $8002  Diversi-Tune instrument          Application Specific
$D7*        MIDI data
$D7+ $0000  MIDI standard data               Application Specific
$D8*        Sampled sound                    Application Specific
$D8+ $0000  Audio IFF document               Application Specific       03/89
$D8+ $0001  Compressed sound
$D8+ $0002  ASIF instrument                  Application Specific       03/89
$D8+ $8001  HyperStudio sound                Application Specific
$DB*        DB Master document               Application Specific
$DB+ $0001  DB Master document               Application Specific
$E0*        Archival library                 Application Specific
$E0+ $0000  ALU library                      Carolina System Software
$E0  $0001  AppleSingle File                 Application Specific       03/89
$E0  $0002  AppleDouble Header File          Application Specific       03/89
$E0  $0003  AppleDouble Data File            Application Specific       03/89
$E0  $8000  Binary II File                   Application Specific       07/89
$E0+ $8001  AppleLink ACU document           Application Specific
$E0+ $8002  ShrinkIt (NuFX) document         Application Specific       07/89
$E2*        AppleTalk data
$EF+        Pascal area
$F0+        BASIC command
$F1*        User #1
$F2*        User #2
$F3*        User #3
$F4*        User #4
$F5*        User #5
$F6*        User #6
$F7*        User #7
$F8*        User #8
$F9*        GS/OS System file
$FA+        Integer BASIC program
$FB+        Integer BASIC variables
$FC*        AppleSoft BASIC program
$FD*        AppleSoft BASIC variables
$FE+        Relocatable code
$FF*        ProDOS 8 application
_____________________________________________________________________________