#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