Segmentation.h

Go to the documentation of this file.

#ifndef SEGMENTATION_H
#define SEGMENTATION_H

#include "SimplePixelImage.h"
#include "MedianFilter.h"
#include "AllocMem.h"


//################################################################################
//# OPTIONS' DEFINES
//################################################################################


    //### SEGMENTATION OPTIONS 

//*** Median filtering options
#define PERFORM_MEDIAN_FILTER false 
#define FRAME_TYPE FRAME_UNCHANGED 
                                 

//*** Parameters
//Default segmentation parameters
#define K_DEFAULT 0.5  
#define MIN_AREA_DEFAULT 100.0 
#define MAX_AREA_DEFAULT 5000.0         
#define SEGMENTATION_METRIC METRIC_TONE





    //### OUTPUT OPTIONS

#define EXTREME_SPOTS_SHADING false 
#define EXTREME_SPOTS_DISOLVING false   
#define SPOTS_MARKING false 
//*** File Printing options
#define PRINT_FILE_STATISTICS true 






#define PRINT_FILE_MEDIAN true      



                                
#define PRINT_FILE_SEGMENTED true  







#define DECIMAL_POSITIONS 4 





//**************
//* NOTE: when EXTREME_SPOTS_DISOLVING is true, EXTREME_SPOTS_SHADING true becomes
//* useless because there's no small spot left to shade.
//***************



//########################################################################******
//* TYPEDEFS DATA TYPES
//########################################################################******

typedef enum _PixelMetric 
{
    METRIC_EUCLIDEAN,   








                        
    METRIC_TONE, 

















                                 
    METRIC_HUE,  













                 
    //************************************************************************
    //* WARNING: When adding terms to the enumeration
    //*          keep always this item at the end of the enumeration.
    //************************************************************************
    METRICS_NUMBER 
}
PixelMetric;


// SEGMENTATION ALGORITHM PARAMETERS STRUCTURE DATA TYPE

typedef struct _SegmentationParameters {
  double K;    





  double minarea; 







  
  double maxarea; 





  PixelMetric segmentationMetric; 





} SegmentationParameters;


//***************************************************************************
//* FileName: INPUT and/or OUTPUT files involved in the segmentation program
//***************************************************************************
typedef enum _FileName 
{
    SOURCE_FILE, 


    IMAGE_NAME, 

    MEDIAN_FILE, 

    SEGMENTED_FILE, 

    SPOT_STATISTICS_FILE, 


    //************************************************************************
    //* WARNING: When adding terms to the enumeration
    //*          keep always this item at the end of the enumeration.
    //************************************************************************
    FILES_NUMBER 



}
FileName;

typedef struct _SegmentationOptions
{

    bool shouldPerformMedianFilter;









    FrameProcessing frameMedian;   







    SegmentationParameters parameters;  
    //}


    bool shouldDisolveExtremeSpots; 





                                            
    size_t expectedParents;             










}
SegmentationOptions;

typedef struct _FilesOptions
{
    bool shouldPrint[ FILES_NUMBER ];   










    char **list;                        












}
FilesOptions;

typedef struct _OutputOptions
{
    FilesOptions files;                     
    bool shouldShadeExtremeSpots; 








    bool shouldMarkSpots; 










                           
}
OutputOptions;

typedef struct _PointDouble
{
    double dRow;    
    double dCol;    
} PointDouble;

typedef struct _SpotStatistics
{
    size_t sizeSpotSize;    
    double ucAverageRed;    
    double ucAverageGreen;  
    double ucAverageBlue;   
    PointDouble massCentre; 
} 
SpotStatistics;

void allocateFilesList ( char**& filesList ); 
void freeFilesList (char** fileslist); 

#define KEEP_ORIGINAL_PATH true
                             //0 Value uses OUTPUT_PATH as the output path (forgive the repetition ;-))
                             //Otherwise conserves the original input path as the output path.
#define OUTPUT_PATH "" //Path for output images (i.e. median.ppm, segm.ppm, and so forth)
                       //When "" the output path is the current work path

//################################################
// main() FUNCTIONS
//################################################

void copyImageBW (PixelPlane final, PixelPlane initial, int rows, int cols);
void copyImageColour (PixelPlane finalr, PixelPlane finalg, PixelPlane finalb, PixelPlane initialr, PixelPlane initialg, PixelPlane initialb, int rows, int cols);



void initializeOptionsViaDefine ( SegmentationOptions &segmentation, OutputOptions &output);

void getArgumentsFromUser (int argc, char *argv[], SegmentationParameters &parms, char *filesList[]);


void generateFileNames (char *filesList[], SegmentationParameters &parms);


//################################################
//SEGMENTATION FUNCTIONS
//################################################


size_t segmentSimplePixelImage(SimplePixelImage const &inputImage, int *(**iSpotPixels), 
                          SegmentationOptions const &options, 
                          SpotStatistics *(*sSegmentationStatistics), 
                          FilesOptions const &files);

#endif //SEGMENTATION_H

---