msSysPrompt.cpp

/*******************************************************
 
                 Mean Shift Analysis Library
    =============================================
 
    The mean shift library is a collection of routines
    that use the mean shift algorithm. Using this algorithm,
    the necessary output will be generated needed
    to analyze a given input set of data.
 
  Mean Shift System:
  ==================
 
    The Mean Shift System class provides a mechanism for the
    mean shift library classes to prompt progress and to
    time its computations. When porting the mean shift library
    to an application the methods of this class may be changed
    such that the output of the mean shift class prompts
    will be given to whatever hardware or software device that
    is desired.
 
    The definition for the mean shift system class is provided
    below. Its prototype is provided in "msSys.cc".
 
The theory is described in the papers:
 
  D. Comaniciu, P. Meer: Mean Shift: A robust approach toward feature
                                     space analysis.
 
  C. Christoudias, B. Georgescu, P. Meer: Synergism in low level vision.
 
and they are is available at:
  http://www.caip.rutgers.edu/riul/research/papers/
 
Implemented by Chris M. Christoudias, Bogdan Georgescu
********************************************************/
 
// Command Line Version:
//   This version of mean shift system is written for the command
//   line version of EDISON.
 
//include the msSystem class prototype
#include    "segm/msSys.h"
 
//include needed system libraries
#include    <time.h>
#include    <stdio.h>
#include    <stdarg.h>
#include    <stdlib.h>
 
//define bgLog
bool CmCDisplayProgress;
void bgLog(const char *PromptStr, ...)
{
    //obtain argument list using ANSI standard...
    va_list argList;
    va_start(argList, PromptStr);
 
    //print the output string to stderr using
    if(CmCDisplayProgress) vfprintf(stdout, PromptStr, argList);
    va_end(argList);
 
    //done.
    return;
}
 
/*@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@*/
/*@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@*/
/*@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@      PUBLIC METHODS     @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@*/
/*@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@*/
/*@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@*/
 
  /*/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\*/
  /*** Class Constructor and Destructor ***/
  /*\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/*/
 
/*******************************************************/
/*Class Constructor                                    */
/*******************************************************/
/*Constructs a mean shift system object.               */
/*******************************************************/
/*Post:                                                */
/*      - an msSystem object has been properly init-   */
/*        ialized.                                     */
/*******************************************************/
 
msSystem::msSystem( void )
{
 
    //initialize currentTime
    currentTime = clock();
 
    //done.
 
}
 
/*******************************************************/
/*Class Destructor                                     */
/*******************************************************/
/*Destroys a mean shift system object.                 */
/*******************************************************/
/*Post:                                                */
/*      - an msSystem object has been properly dest-   */
/*        royed.                                       */
/*******************************************************/
 
msSystem::~msSystem( void )
{
    /* do nothing */
}
 
 /*/\/\/\/\/\/\/\/\/\*/
 /*** System Timer ***/
 /*\/\/\/\/\/\/\/\/\/*/
 
/*******************************************************/
/*Start Timer                                          */
/*******************************************************/
/*Sets the mean shift system time to the current       */
/*system time.                                         */
/*******************************************************/
/*Post:                                                */
/*      - the mean shift system time has been set to   */
/*        the current system time.                     */
/*******************************************************/
 
void msSystem::StartTimer( void )
{
 
    //set msSystem time to system time
    currentTime = clock();
 
    //done.
    return;
 
}
 
/*******************************************************/
/*Elapsed Time                                         */
/*******************************************************/
/*Returns the amount of time in seconds since the      */
/*mean shift system time was last set.                 */
/*******************************************************/
/*Post:                                                */
/*      - the amount of time in seconds since the mean */
/*        shift system time was last set is returned.  */
/*******************************************************/
 
double msSystem::ElapsedTime( void )
{
 
    //return the amount of time elapsed in seconds
    //since the msSystem time was last set...
    return ((double) (clock() - currentTime))/(CLOCKS_PER_SEC);
 
}
 
 /*/\/\/\/\/\/\/\/\/\/\*/
 /***  System Output ***/
 /*\/\/\/\/\/\/\/\/\/\/*/
 
/*******************************************************/
/*Prompt                                               */
/*******************************************************/
/*Output a text message to the user.                   */
/*******************************************************/
/*Pre:                                                 */
/*      - PromptStr is a string containing delimeters  */
/*        that is to be output to the user.            */
/*      - a variable set of arguments is also passed   */
/*        to this method that are used to replace      */
/*        the delimeters contained by PromptStr        */
/*Post:                                                */
/*      - the delimeters of PromptStr have been        */
/*        replaced accordingly using the variable      */
/*        set of arguments and the resulting string    */
/*        has been output to the user.                 */
/*******************************************************/
 
void msSystem::Prompt(const char *PromptStr, ...)
{
 
    //obtain argument list using ANSI standard...
    va_list argList;
    va_start(argList, PromptStr);
 
    //print the output string to stderr using
    if(CmCDisplayProgress) vfprintf(stdout, PromptStr, argList);
    va_end(argList);
 
    //done.
    return;
 
}
 
/*******************************************************/
/*Progress                                             */
/*******************************************************/
/*The progress of a specific algorithm of the mean     */
/*shift library is output to the user.                 */
/*******************************************************/
/*Pre:                                                 */
/*      - percentComplete indicates the percentage     */
/*        of the algorithm that has executed and is    */
/*        a floating point number from zero to one     */
/*Post:                                                */
/*      - the percentComplete has been noted by the    */
/*        interface (possibly to update a progress     */
/*        bar).                                        */
/*      - if the thread executing the mean shift code  */
/*        must halt execution msSYS_HALT is returned,  */
/*        msSYS_OK is returned otherwise               */
/*******************************************************/
 
//NOTE: This implementation is specific to EDISON. In order
//      for one to port the mean shift class to another project
//      or program one must re-implement this method.
 
ErrorLevel msSystem::Progress(float percentComplete)
{
    return EL_OKAY;
}
 
/*@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@*/
/*@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@*/
/*@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ END OF CLASS DEFINITION @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@*/
/*@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@*/
/*@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@*/