| 0,0 → 1,153 |
|---|
| #ifndef __MCBINIII_H__ |
| #define __MCBINIII_H__ |
| |
| |
| /**************************************************************** |
| MacBinaryIII.h |
| |
| Copyright 1997 Christopher Evans (cevans@poppybank.com) |
| |
| Basic encoding and decoding of Macintosh files to the |
| MacBinary III spec. |
| ****************************************************************/ |
| |
| |
| /* |
| -------------------------------------------------------------------- |
| This source is copyrighted by Christopher Evans (cevans@poppybank.com) |
| (available at ftp://ftp.lazerware.com/MacBinaryIII_src_C.sit |
| homepage of Leonard Rosenthol leonardr@netcom.com) |
| |
| |
| |
| I made the following changes: |
| * renamed files MacBinaryIII.h / MacBinaryIII.c to |
| macbin3.c / macbin3.h |
| * removed pragmas: |
| #pragma once |
| #pragma options align=mac68k |
| * added 5 macros to make the migration into other projects easier: |
| DELETE_MACBINARY_SOURCE -> delete the macbinary file after |
| decoding |
| INCLUDE_ENCODE_MACBINARY -> include the encode-part of the source |
| INCLUDE_DECODE_MACBINARY -> include the decode-part of the source |
| INCLUDE_CRC32CALC -> include the CRC32 calculation |
| TRACE_MACBINARY -> produce some diagnostic printouts |
| * changed the source layout to fit into a 80 col window |
| * removed non-ASCII characters from the sources |
| * renamed the function CalculateCRC() to crc32() and changed |
| the order of the arguments. So the crc32() func of the InfoZip |
| package can be used instead. |
| * moved module specific macros and protos to the mcbiniii.c |
| * added comments and enhanced the documention of the MacBinary Spec |
| * changed definition crc_table[] from short to unsigned long. |
| * improved the HeaderIsMacBinary() function to be more restrictive |
| |
| The specification says: |
| "Offsets 83 and 87, Long Word, (the length of the forks) |
| should be in the range of 0-$007FFFFF " |
| However, I do not understand the reason of this range. The data fork |
| can be much larger than $007FFFFF ( 2 Gigabytes! ) and the size of the |
| resource fork can be until 16 MByte. ZipIt and Stuffit seems to be |
| ignore this limit. |
| I changed this limit (see kResourceForkMaxLen), and I removed the |
| maximum check of the data fork. |
| |
| Dirk Haase (d_haase@sitec.de); 05.Dec.1998 |
| |
| -------------------------------------------------------------------- |
| |
| |
| |
| MacBinary III |
| |
| MacBinary is a standard format for binary transfer of arbitrary Macintosh |
| documents via a telecommunication link. It is intended for use both between |
| Macintoshes and for use in uploading arbitrary Macintosh documents to remote |
| systems (where it is presumed that they will be stored as an exact image of |
| the data transmitted). It does this by combing both the resource and data |
| forks (as well as the "Finder Info") of a standard Macintosh file into a |
| single data fork only file that can be stored on non-Macintosh machines. |
| |
| |
| The format of the header for MacBinary III is as follows: |
| Offset Length Contents |
| 000 Byte old version number, must be kept at zero for |
| compatibility |
| 001 Byte Length of filename (must be in the range 1-31) |
| 002 1 to 63 Bytes filename (only "length" bytes are significant). |
| 065 Long Word file type (normally expressed as four characters) |
| 069 Long Word file creator (normally expressed as four |
| characters) |
| 073 Byte original Finder flags |
| Bit 7 - isAlias. |
| Bit 6 - isInvisible. |
| Bit 5 - hasBundle. |
| Bit 4 - nameLocked. |
| Bit 3 - isStationery. |
| Bit 2 - hasCustomIcon. |
| Bit 1 - reserved. |
| Bit 0 - hasBeenInited. |
| 074 Byte zero fill, must be zero for compatibility |
| 075 Word file's vertical position within its window. |
| 077 Word file's horizontal position within its window. |
| 079 Word file's window or folder ID. |
| 081 Byte "Protected" flag (in low order bit). |
| 082 Byte zero fill, must be zero for compatibility |
| 083 Long Word Data Fork length (bytes, zero if no Data Fork). |
| 087 Long Word Resource Fork length (bytes, zero if no R.F.). |
| 091 Long Word File's creation date |
| 095 Long Word File's "last modified" date. |
| 099 Word length of Get Info comment to be sent after the |
| resource fork (if implemented, see below). |
| 101 Byte Finder Flags, bits 0-7. (Bits 8-15 are already in |
| byte 73) |
| Bit 7 - hasNoInits |
| Bit 6 - isShared |
| Bit 5 - requiresSwitchLaunch |
| Bit 4 - ColorReserved |
| Bits 1-3 - color |
| Bit 0 - isOnDesk |
| *102 Long Word signature for indentification purposes ('mBIN') |
| *106 Byte script of file name (from the fdScript field of an |
| fxInfo record) |
| *107 Byte extended Finder flags (from the fdXFlags field of |
| an fxInfo record) |
| 108-115 Unused (must be zeroed by creators, must be |
| ignored by readers) |
| 116 Long Word Length of total files when packed files are |
| unpacked. As of the writing of this document, this |
| field has never been used. |
| 120 Word Length of a secondary header. If this is non-zero, |
| skip this many bytes (rounded up to the next |
| multiple of 128). This is for future expansion |
| only, when sending files with MacBinary, this word |
| should be zero. |
| *122 Byte Version number of MacBinary III that the uploading |
| program is written for (the version is 130 for |
| MacBinary III) |
| 123 Byte Minimum MacBinary version needed to read this file |
| (set this value at 129 for backwards compatibility |
| with MacBinary II) |
| 124 Word CRC of previous 124 bytes |
| |
| *These fields have changed for MacBinary III. |
| |
| All values are stored in normal 68000 order, with Most Significant Byte |
| appearing first then the file. Any bytes in the header not defined above |
| should be set to zero. |
| |
| */ |
| |
| |
| /* |
| Public functions |
| */ |
| |
| OSErr EncodeMacbinaryFile(FSSpec *file); |
| OSErr DecodeMacBinaryFile(FSSpec *source); |
| Boolean FSpIsMacBinary(FSSpec *file); |
| |
| |
| #endif |
| |