#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 restrictiveThe 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 forkcan be much larger than $007FFFFF ( 2 Gigabytes! ) and the size of theresource fork can be until 16 MByte. ZipIt and Stuffit seems to beignore this limit.I changed this limit (see kResourceForkMaxLen), and I removed themaximum check of the data fork.Dirk Haase (d_haase@sitec.de); 05.Dec.1998--------------------------------------------------------------------MacBinary IIIMacBinary is a standard format for binary transfer of arbitrary Macintoshdocuments via a telecommunication link. It is intended for use both betweenMacintoshes and for use in uploading arbitrary Macintosh documents to remotesystems (where it is presumed that they will be stored as an exact image ofthe data transmitted). It does this by combing both the resource and dataforks (as well as the "Finder Info") of a standard Macintosh file into asingle 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 Byteappearing first then the file. Any bytes in the header not defined aboveshould be set to zero.*//*Public functions*/OSErr   EncodeMacbinaryFile(FSSpec *file);OSErr   DecodeMacBinaryFile(FSSpec *source);Boolean FSpIsMacBinary(FSSpec *file);#endif