projectionmgr.h

#ifndef __PROJECTIONMGR_H__
#define __PROJECTIONMGR_H__
/*=============================================================================  
     Module  : projectionmgr.h
     Purpose : Define a projection manager object.
     Author  : Doug Ehlenberger, CNIC Mt. Sinai School of Medicine
               
=============================================================================*/
#ifdef _WIN32
#include <windows.h>
#else 
#error Platform not supported
#endif

#include "configure.h"
#include "resourcemgr.h"
#include "prjmgrfuncs.h"
#include "filelist.h"
#include "handle.h"
#include "imagerw.h"
#include "progress.h"


#ifdef _WIN32

typedef struct tagDeviceContext
   {
   HDC      hMemoryDC;
   HBITMAP  hBitmap;
   HGDIOBJ  hOldObject;
   }
   DeviceContext;

#endif


/* NOTE: The parameter pixelCode is the original pixel format of the 
   images in the stack before being converted to RGB. */

typedef struct tagProjectionCube
   {
   vPIXEL_CODE_TYPE  pixelCode;
   DeviceContext     X;
   DeviceContext     Y;
   DeviceContext     Z;
   vSIZE             dimensions[ 3 ];
   void             *pixelsX;
   void             *pixelsY;
   void             *pixelsZ;
   }
   ProjectionCube;


typedef vHANDLE vHPROJCUBE;


/* NOTE: Internally all projections are stored as 24-bit RGB. */

#define vHPROJCUBE_PIXEL_CODE   vPIXEL_CODE_RGB_UCHAR   


typedef enum
   {
   vPROJ_NO_ERROR,
   vPROJ_ERROR_OUT_OF_MEMORY,
   vPROJ_ERROR_MISMATCH_PIXELS,
   vPROJ_ERROR_MISMATCH_DIMENSIONS,
   vPROJ_ERROR_MULTIPLE_FILE_TYPES,
   vPROJ_ERROR_FILE_OPEN,
   vPROJ_ERROR_FILE_READ,
   vPROJ_ERROR_FILE_WRITE,
   vPROJ_ERROR_FILE_INVALID,
   vPROJ_ERROR_FILE_TYPE,
   vPROJ_ERROR_UNSUPPORTED,
   vPROJ_ERROR_PROJ_FUNCTION,
   vPROJ_ERROR_HANDLE,
   vPROJ_ERROR_MULTIPLE_2D_3D,

   vPROJ_ERROR_SENTINEL
   }
   vPROJ_ERROR_CODE;


#define vPROJ_PROGRESS_CANCEL   vPROJ_ERROR_SENTINEL


typedef ResourceManager ProjectionManager;


/* NOTE: numProjections is the inital capacity. The manager structure
   can "grow" dynamically. */

ProjectionManager* CreateProjectionManager( vUINT numProjections );

vVOID DestroyProjectionManager( ProjectionManager **manager );


ProjectionCube* GetProjectionCube( ProjectionManager *manager, vHPROJCUBE hCube );


/* 2 ways to create the projection cube!
   CreateProjectionCube() for new projections.
   ReadProjectionCube() for previously created projections.  */


/* CreateProjectionCube():
   The function runs as a thread and updates a progress bar 
   dialog. See progress.h for how the error code is set.

   hwndVisual    = handle of the window where the projections
                   will be shown
   manager       = projection resource manager structure
   fileList      = list of files to be projected
   projDirectory = directory path to save the projections in
   projFileX     = file name to save X projection as
   projFileY     = file name to save Y projection as
   projFileZ     = file name to save Z projection as
   projFileType  = file type to save projection's as
   hCube         = stores the returned handle ( vHPROJCUBE )
   descriptor    = optional, can be NULL
*/

DERIVE_PROGRESSPROCARGS( CREATEPROJCUBEARGS,
                         vUINT              hwndVisual; 
                         ProjectionManager *manager;
                         FileList          *fileList;
                         vSTRING            projDirectory;
                         vSTRING            projFileX;
                         vSTRING            projFileY;
                         vSTRING            projFileZ;
                         vFILE_TYPE         projFileType;
                         vHPROJCUBE        *hCube;
                         const ImageDescriptor   *descriptor;
                       );

vVOID CreateProjectionCube
   (
   vVOID *createProjCubeArgs
   );


/* ReadProjectionCube(): 
   The working directory, i.e. location of the projection
   files, must be set before calling! 

   hwndVisual = handle of the window where the projections
                will be shown
   manager    = projection resource manager structure
   fileX      = file name of X projection
   fileY      = file name of Y projection
   fileZ      = file name of Z projection
   errorCode  = store the error code
*/

vHPROJCUBE ReadProjectionCube
   (
   vUINT              hwndVisual,
   ProjectionManager *manager,
   vSTRING            fileX,
   vSTRING            fileY,
   vSTRING            fileZ,
   vPROJ_ERROR_CODE  *errorCode
   );


#endif /* __PROJECTIONMGR_H__ */

---