prjmgrfuncs.h

#ifndef __PRJMGRFUNCS_H__
#define __PRJMGRFUNCS_H__
/*=============================================================================  
     Module  : prjmgrfuncs.h
     Purpose : Define various routines used by the projection manager module.
     Author  : Doug Ehlenberger, CNIC Mt. Sinai School of Medicine
               
=============================================================================*/
#include "configure.h"
#include "imagerw.h"


typedef enum
   {
   vPROJ_X,
   vPROJ_Y,
   vPROJ_Z
   }
   vPROJ_TYPE;


/* Projections: X, Y, and Z projections. The name indicates the "axis of projection". 

      __________                    z axis
     /         /    /|              /
    /   Y     /    / |             /                     NOTE:  width  Z  ==  width  Y
   /         /    /  |            /                             height Z  ==  height X
   ----------    / X |            ------- x axis                width  X  ==  height Y
   __________    |   /            |
   |         |   |  /             |                             width  of cube = width  Z
   |         |   | /              |                             height of cube = height Z
   |    Z    |   |/              y axis                         length of cube = width  X
   |         |
   -----------
*/

/* These return the width and height of the given projection in PIXELS! */

vSIZE GetProjectionWidth( vSIZE *dimensions, vPROJ_TYPE projType );
vSIZE GetProjectionHeight( vSIZE *dimensions, vPROJ_TYPE projType );


/* The supported input formats for projections. */

typedef enum
   {
   vPROJ_CODE_GRAYSCALE_UCHAR    = vPIXEL_CODE_GRAYSCALE_UCHAR,
   vPROJ_CODE_GRAYSCALE_USHORT12 = vPIXEL_CODE_GRAYSCALE_USHORT12,
   vPROJ_CODE_GRAYSCALE_USHORT16 = vPIXEL_CODE_GRAYSCALE_USHORT16
   }
   vPROJ_CODE_TYPE;


typedef struct tagProjectionBuffers
   {
   vVOID  *X;
   vVOID  *Y;
   vVOID  *Z;
   vVOID  *lockX;
   vSIZE   widthX;
   vSIZE   heightX;
   vVOID  *lockY;
   vSIZE   widthY;
   vSIZE   heightY;
   vSIZE   widthZ;
   vSIZE   heightZ;
   vSIZE   dimensions[ 3 ];

   vPROJ_CODE_TYPE projCode;
   }
   ProjectionBuffers;


/* Allocates and initalized the pointers. The dimensions and
   projCode of the structure must be set before calling. */

vBOOL CreateProjectionBuffers( ProjectionBuffers *buffers );

vVOID DestroyProjectionBuffers( ProjectionBuffers *buffers );


/* Functions to do the projections. */

typedef vVOID ( *ProjectionFunction_t )( ProjectionBuffers*, Image_t* );


/* Functions to convert pixel formats to 24-bit RGB. 
   IMPORTANT: These functions assume "dest" buffer
   rows are padded to LONG( 4 byte ) boundaries. */
typedef vVOID ( *RGB24_Function_t )( vVOID *source, vSIZE width, vSIZE height, vVOID *dest );

/* Functions to convert pixel formats to 32-bit RGBA. 
   IMPORTANT: These functions assume "dest" buffer
   rows are padded to LONG( 4 byte ) boundaries. */
typedef vVOID ( *RGBA32_Function_t )( vVOID *source, vSIZE width, vSIZE height, vVOID *dest );


/* Function to gamma correct the images. */

typedef vVOID ( *Gamma_Function_t )( vVOID *source, vSIZE width, vSIZE height, vDOUBLE gamma );

/* 'brightness' and 'contrast' must range from -100 to 100. */
#define V_BRIGHTNESS_CONTRAST_MIN  -100
#define V_BRIGHTNESS_CONTRAST_MAX   100
typedef void ( *VBrightnessContrastFunc )
( vpointer pixels, vsize width, vsize height, vint brightness, vint contrast );


/* Align the number of bytes to a long boundary. */

#define AlignBytes( bytes )\
(  ( bytes + ( sizeof( vLONG ) - 1 ) ) & ( ~( sizeof( vLONG ) - 1 ) )  )


/* These functions return NULL if invalid or unsupported projection code. */

ProjectionFunction_t GetProjectionFunction( vPROJ_CODE_TYPE projCode );


RGB24_Function_t GetRGB24_Function( vPROJ_CODE_TYPE projCode );

RGBA32_Function_t GetRGBA32_Function( vPROJ_CODE_TYPE projCode );


Gamma_Function_t GetGammaFunction( vPROJ_CODE_TYPE projCode );

VBrightnessContrastFunc v_brightness_constrast_func( vPROJ_CODE_TYPE proj_code );

/* Functions to apply a palette to 24-bit RGB.
   IMPORTANT: These functions assume "dest" buffer
   rows are padded to LONG( 4 byte ) boundaries. */

typedef enum
   {
   PALETTE_STANDARD,
   PALETTE_INVERSE,
   PALETTE_SOLAR_FLARE
   }
   PaletteType;

void palettes_init( void );


#endif/* __PRJMGRFUNCS_H__ */

---