forked from KolibriOS/kolibrios
154 lines
6.6 KiB
C
154 lines
6.6 KiB
C
#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
|
|
|