imagestackmgr.h

#ifndef __IMAGESTACKMGR_H__
#define __IMAGESTACKMGR_H__
/*=============================================================================  
     Module  : imagestack.h
     Purpose : Define a simple image stack manager object.
     Author  : Doug Ehlenberger, CNIC Mt. Sinai School of Medicine
               
=============================================================================*/
#include "configure.h"
#include "resourcemgr.h"
#include "handle.h"
#include "projectionmgr.h"
#include "vectori.h"
#include "imagerw.h"


#define vPROJECTION_FILETYPE            vFILE_TYPE_TIFF
#define vPROJECTION_PREFIX_MAX          32
#define vPROJECTION_EXTENSION_MAX       15
#define vPROJECTION_FILENAME_MAX        ( vPROJECTION_PREFIX_MAX + vPROJECTION_EXTENSION_MAX )
#define vIMAGESTACK_DESC_MAX            63


/* NOTE: Have "old" and "new" variables to allow certain operations, 
   such as moving or cropping stacks, to be undone. */

typedef struct tagImageStack
   {
   /* Location of the image stack in coordinate space. 
      This "workspace" coordinate space is used to align 
      the stacks. */
   Vector3i   oldPosition;
   Vector3i   currentPosition;

   /* Crop bounds of the stack, i.e. the region of the stack 
      being viewed. */
   vSIZE      oldCropCube[ 6 ];
   vSIZE      currentCropCube[ 6 ];

   /* FULL size of the stack. */
   vSIZE      dimensions[ 3 ]; 

   /* Various control states that should be saved. */
   vSTATES    states;
   /* Various control flags that should NOT be saved. */
   vFLAGS     flags;

   /* Handle to this stack's "projection cube". */
   vHPROJCUBE hCube;

   /* Saved file names for this stack's projections. These files
      should be located in the same directory as the .vws file.
      NOTE: +1 for '\0' */
   vCHAR      nameX[ vPROJECTION_FILENAME_MAX + 1 ];
   vCHAR      nameY[ vPROJECTION_FILENAME_MAX + 1 ];
   vCHAR      nameZ[ vPROJECTION_FILENAME_MAX + 1 ];

   /* Source directory for the stack images and "sample" file name, 
      i.e. filter, for the images. */
   vCHAR      source[ vMAX_PATH + 1 ];
   vCHAR      filter[ vMAX_PATH + 1 ];

   /* Current client rectangle of this image stack. */
   vRECTANGLE client;

   /* Opacity/Transparency level. */
   vUINT      alpha;

   /* A small description/name of this stack. e.g. "column a". */
   vCHAR      description[ vIMAGESTACK_DESC_MAX + 1 ];

   GImageInfo  image_info;
   gboolean    use_image_info;

   gboolean    is_inverted;
   }
   ImageStack;


/* Values for variable "states" */
#define vSTACK_STATE_VISIBLE           vBIT_0
#define vSTACK_STATE_POSITION_LOCKED   vBIT_1
#define vSTACK_STATE_SELECTED          vBIT_2

/* Values for variable "flags"  */
#define vSTACK_FLAG_CROP_STACK   vBIT_0
//#define vSTACK_FLAG_SELECTED     vBIT_1
#define vSTACK_FLAG_DELETED      vBIT_2
/* This flag indicates whether the stack has been saved to the workspace(.vws ) file. */
#define vSTACK_FLAG_ON_FILE      vBIT_3


#define vALPHA_FULLY_OPAQUE         255
#define vALPHA_FULLY_TRANSPARENT      0


/* Macros to convert an alpha value to a opacity percentage( 0 - 100 ),
   and vica-versa. */

#define vALPHA_TO_PERCENT( alpha )    ( ( vUINT )( ( ( ( vFLOAT )alpha ) / vALPHA_FULLY_OPAQUE ) * 100 + .5f ) )
#define vPERCENT_TO_ALPHA( percent )  ( ( vUINT )( ( ( ( vFLOAT )percent ) / 100 ) * vALPHA_FULLY_OPAQUE + .5f ) )


typedef struct tagImageStackProjection
   {
   vUINT     hProjection;
   vSIZE     cropLeft;
   vSIZE     cropTop;         // NOTE: uncropped left and top are always 0, 0.
   vSIZE     cropWidth;
   vSIZE     cropHeight;
   vSIZE     uncropWidth;
   vSIZE     uncropHeight;
   Vector2i  cropPosition;    // Position's are in WORKSPACE coordinates
   Vector2i  uncropPosition;  
   }
   ImageStackProjection;


typedef vHANDLE          vHIMAGESTACK;
typedef ResourceManager  ImageStackManager;


/* IMPORTANT!! Releasing an vHIMAGESTACK handle does NOT release it's 
   projection cube handle. Therefore if the stack has a valid handle
   to a projection cube, it must be released FIRST! */

ImageStackManager* CreateImageStackManager( vUINT initialCapacity );

vVOID DestroyImageStackManager( ImageStackManager **manager );


#endif/* __IMAGESTACKMGR_H__ */

---