raw.h

#ifndef __RAW_H__
#define __RAW_H__
/*=============================================================================   
     Module  : raw.h 1.0
     Purpose : Define routines to read and write .raw files.
     Author  : Doug Ehlenberger, CNIC Mt. Sinai School of Medicine
               
==============================================================================*/
#include <stdlib.h>
#include <stdio.h>
#include <assert.h>

#ifdef __cplusplus
extern "C"{
#endif

typedef enum
   {
   RAW_NO_ERROR,
   RAW_ERROR_FILE_OPEN,
   RAW_ERROR_FILE_READ,
   RAW_ERROR_FILE_WRITE,
   RAW_ERROR_FILE_SEEK,
   RAW_ERROR_OUT_OF_MEMORY
   }
   RAW_ERROR_CODE;


typedef enum
   {
   RAW_UNSUPPORTED,
   RAW_RGB24,                 /* 24-bit RGB. */
   RAW_RGBA32,                /* 32-bit RGBA. */
   RAW_BGR24,                 /* 24-bit BGR.  */
   RAW_BGRA32,                /* 32-bit BGRA. */
   RAW_GRAYSCALE8,            /* 8-bit grayscale. */
   RAW_GRAYSCALE16,           /* 16-bit grayscale. */
   RAW_GRAYSCALE16PACK12      /* 12-bit grayscale packed into 16 bits. */
   }
   RAW_TYPE;


enum{ RAW_LITTLE_ENDIAN, RAW_BIG_ENDIAN };


RAW_ERROR_CODE ReadRawFile
   (
   const char *const  fileName,
   void *const        header,       /* Buffer to receive optional header. NULL if no header. */
   const unsigned     headerSize,   /* Should be zero if no header. */
   const RAW_TYPE     type,         /* Type of pixels on file. */
   const unsigned     width,        /* Width(X) in pixels. */
   const unsigned     height,       /* Height(Y) in pixels. */
   const unsigned     length,       /* Length(Z) in pixels. Should be 1 if 2D image. */
   const int          endian,       /* Endian-ness of the pixels on file. */
   void             **pixels        /* Buffer to receive the pixels. The pixels are
                                       made to have the same endian-ness as the
                                       machine this code is running on. */
   );


RAW_ERROR_CODE WriteRawFile
   (
   const char *const  fileName,
   const void *const  header,
   const unsigned     headerSize,
   const RAW_TYPE     type,
   const unsigned     width,
   const unsigned     height,
   const unsigned     length,
   const void *const  pixels     /* NOTE: The pixels are written without altering
                                    the endian-ness. */
   );


RAW_ERROR_CODE ReadRawFileAt
   (
   const char *const  fileName,
   const unsigned     headerSize,
   const RAW_TYPE     type,
   const unsigned     width,
   const unsigned     height,
   const unsigned     length,
   const unsigned     z,  /* The z level to read at. */
   const int          endian,
   void             **pixels
   );


#ifdef __cplusplus
}
#endif

#endif/* __RAW_H__ */

---