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 _____________________________________________________________________________