integrate.h

#ifndef __INTEGRATE_H__
#define __INTEGRATE_H__
/*=============================================================================   
     Module  : integrate.h
     Purpose : Define the main function of the entire system.
     Author  : Doug Ehlenberger, CNIC Mt. Sinai School of Medicine
               
==============================================================================*/
#include <process.h>
#include <limits.h>
#include "configure.h"
#include "workspace.h"
#include "imagerw.h"
#include "progress.h"


/* NOTE: The current integration routine can only create 
   volumes of the same pixel type as the source images. */


/* The supported pixel formats for volume integration. */

typedef enum
   {
   vVI_CODE_GRAYSCALE_UCHAR    = vPIXEL_CODE_GRAYSCALE_UCHAR,
   vVI_CODE_GRAYSCALE_USHORT12 = vPIXEL_CODE_GRAYSCALE_USHORT12,
   vVI_CODE_GRAYSCALE_USHORT16 = vPIXEL_CODE_GRAYSCALE_USHORT16
   }
   vVI_CODE_TYPE;


/* The supported integration type routines. */

typedef enum
   {
   vVI_FUNC_REPLACE,
   vVI_FUNC_MAXIMUM,
   vVI_FUNC_AVERAGE,

   vVI_FUNC_SENTINEL
   }
   vVI_FUNC_TYPE;

#define vVI_NUM_FUNC_TYPES  ( ( vINT )vVI_FUNC_SENTINEL )

vCHAR* GetVolumeIntegrationFuncStr( vVI_FUNC_TYPE type );
vCHAR* GetVolumeIntegrationDescStr( vVI_FUNC_TYPE type );


typedef enum
   {
   vVI_NO_ERROR,
   vVI_ERROR_OUT_OF_MEMORY,
   vVI_ERROR_VI_FUNC,
   vVI_ERROR_STACK_CHDIR,
   vVI_ERROR_FILE_LIST_HANDLE,
   vVI_ERROR_NO_FILES,
   vVI_ERROR_INVALID_SPEC,
   vVI_ERROR_NUM_FILES,
   vVI_ERROR_DEST_CHDIR,
   vVI_ERROR_FILE_OPEN,
   vVI_ERROR_FILE_READ,
   vVI_ERROR_FILE_WRITE,
   vVI_ERROR_FILE_INVALID,
   vVI_ERROR_FILE_TYPE,
   vVI_ERROR_UNSUPPORTED,
   vVI_ERROR_MAX_DIMENSIONS,
   vVI_ERROR_PATH_LENGTH,
   vVI_ERROR_IMAGE_PIXEL_TYPE,
   vVI_ERROR_IMAGE_DIMENSIONS,
   vVI_WARNING_LOG_FILE,

   vVI_ERROR_SENTINEL
   }
   vVI_ERROR_CODE;

#define vNUM_VI_ERROR_CODES  ( ( vINT )vVI_ERROR_SENTINEL )
#define vVI_PROGRESS_CANCEL  vVI_ERROR_SENTINEL

vSTRING GetVolumeIntegrationErrorStr( vVI_ERROR_CODE errorCode );


/* Prevent integer overflow. */

#define vMAX_INTEGRATION_WIDTH    ( UINT_MAX >> 17 )       /* = 32767 on Win32 */
#define vMAX_INTEGRATION_HEIGHT   vMAX_INTEGRATION_WIDTH    


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

DERIVE_PROGRESSPROCARGS( VOLUMEINTEGRATIONARGS, 
                         Workspace     *workspace;     
                         vCHAR          destDir[ vMAX_PATH ];
                         vCHAR          prefix[ vMAX_PATH ];
                         vFILE_TYPE     destType;
                         vVI_FUNC_TYPE  funcType;
                         vUNITS_TYPE    unitsType;
                         Color3ub       bkgrndColor;
                         vBOOL          doPadNumber;   
                         vFLOAT         voxelX;
                         vFLOAT         voxelY;
                         vFLOAT         voxelZ;
                       );

vVOID VolumeIntegration( vVOID *volumeIntegrationArgs );


/* Call this function before VolumeIntegration() to check if any 
   files in the destination directory will be overwritten. */

vVI_ERROR_CODE CheckIntegrationOverwrite( VOLUMEINTEGRATIONARGS *args, vBOOL *willOverwrite );


/* Can use to do a quick deterimination of how many files will be
   produced if workspace is integrated in its current state. */

vSIZE GetNumIntegratedFiles( Workspace *workspace );


/* The "fileName" buffer is assumed to be of vMAX_PATH size. */

vBOOL MakeIntegrationFileName
   (
   vSTRING  prefix, 
   vSTRING  extension,
   vBOOL    doPadNumber,
   vINT     fileNumber,
   vINT     maxFileNumber, 
   vSTRING  fileName
   );
   

#endif /* __INTEGRATE_H__ */

---