=== BinToHunk - Version 1.0 ===

BinToHunk is a utility to convert a raw data file (text, bitmapped
image, etc.) into an Amiga Hunk format object file.

Usage:

  BinToHunk [<options>] <infile> [<outfile> [<data-ident> [ <length-ident>]]]

  <infile>	 is the name of the input file.

  <outfile>	 is the name of the output file.  The default <outfile> is
		 the <infile> with a `.o' suffix.

  <data-ident>	 is the name of the symbol for the array that contains the
		 data.  It should start with an underscore if it is to be
		 used from C code.  The default <data-ident> is <infile>
		 without a suffix and a `_' prepended.

  <length-ident> is the name of the symbol that gives the number of
		 elements in the <data-ident> array.  It should start with
		 an underscore if it is to be used from C code.  The default
		 <length-ident> is <data-ident> with a `_length' appended.

  <options>:

    -c		 Make hunk load into Chip RAM.

    -f		 Make hunk load into Fast RAM.

    -l		 Don't generate a length symbol.

    -t[<term>]	 Add a terminator <term> to the end of the array.  The
		 default <term> is zero.

    -s<size>	 Specify the size of the elements in the array to be <size>
		 bytes.  If -s is not used, the default <size> is 1.

    -a		 Make length symbol an absolute definition.  This could be
		 useful for assembly programmers.

If necessary, the data will be padded with zeros to make an even number of
elements in the array.


=== Examples ===
 _______________________________________________________________________
/									\
 Command line:

   BinToHunk -l -t help.txt

 External declaration in C source code:

   extern char help[];		/* Zero terminated character string. */
\_______________________________________________________________________/
/									\
 Command line:

   BinToHunk -s4 image.data  

 External declaration in C source code:

   extern ULONG image[];	/* Array of 32-bit words. */
   extern ULONG image_length;	/* 32-bit word. */
\_______________________________________________________________________/


Ray Burr - December 1, 1991
hoggle!ryb@peora.sdc.ccur.com