source: tags/release-1.6.1/src/Utils/feedback.hh @ 1441

// -----------------------------------------------------------------------
// feedback.hh: Definition of the ProgressBar class, used to indicate
//              progress through a lengthy iteration.
// -----------------------------------------------------------------------
// Copyright (C) 2006, Matthew Whiting, ATNF
//
// This program is free software; you can redistribute it and/or modify it
// under the terms of the GNU General Public License as published by the
// Free Software Foundation; either version 2 of the License, or (at your
// option) any later version.
//
// Duchamp is distributed in the hope that it will be useful, but WITHOUT
// ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
// FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
// for more details.
//
// You should have received a copy of the GNU General Public License
// along with Duchamp; if not, write to the Free Software Foundation,
// Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA
//
// Correspondence concerning Duchamp may be directed to:
//    Internet email: Matthew.Whiting [at] atnf.csiro.au
//    Postal address: Dr. Matthew Whiting
//                    Australia Telescope National Facility, CSIRO
//                    PO Box 76
//                    Epping NSW 1710
//                    AUSTRALIA
// -----------------------------------------------------------------------
#ifndef FEEDBACK_HH
#define FEEDBACK_HH

#include <iostream>
#include <string>

// Simple functions to print a given number of backspaces or spaces
//  to std::cout
void printBackSpace(std::ostream &stream, int num);
void printSpace(std::ostream &stream, int num);
void printHash(std::ostream &stream, int num);

/// @brief
///  Controls printing out a progress bar.
/// @details
///   A class that prints out a progress bar in the form 
///    \f$|\#\#\#\ \ \ \ \ \ \ \ \ \ |\f$
///    that shows how far through a function or loop you are.
///   The length of it defaults to 20 hashes, but can be set when
///   declaring the object.
///   There are five functions: 
///    <ul><li>init(int)   Prints an empty bar, and defines the increment
///        <li>update(int) Prints the correct number of hashes, but only when
///                         num is a multiple of the increment.
///        <li>rewind()    Prints backspaces to cover the entire bar.
///        <li>remove()    Does a rewind(), then prints spaces to overwrite
///                         the bar area -- more clean.
///        <li>fillSpace(std::string) Does a remove(), then writes
///                                    the string into the same space.
/// </ul>

const int DefaultLength=20;             ///< Default number of hashes
const int PercentWidth=3;               ///< Space required for percent value
const int ExtraSpaces=PercentWidth+1+2; ///< Extra spaces other than hashes - the percent value, plus two '|' and a '%'

class ProgressBar
{
public:
    ProgressBar();                          ///< Default Constructor
    ProgressBar(int newlength);             ///< Alternative constructor
    virtual ~ProgressBar();                 ///< Destructor.
    enum POS {BEG=0,END};                   ///< So that we can record where we are.

    void init(unsigned int size);           ///< Prints empty bar, defines increment.
    void update(unsigned int num);          ///< Prints correct number of hashes
    void rewind();                          ///< Prints backspaces over bar.
    void remove();                          ///< Overwrites bar with blanks
    void fillSpace(std::string someString); ///< Overwrites bar with a string.

    void printPercentage();
    void backSpace(int num){printBackSpace(std::cout,num+ExtraSpaces); itsLoc=BEG;};
    void space(int num){printSpace(std::cout,num);};
    void hash(int num){printHash(std::cout,num);};


private:
    POS itsLoc;                                ///< Are we at the start or end?
    float itsStepSize;                         ///< What is the interval between hashes?
    unsigned int itsLength;                    ///< What's the maximum number of hashes?
    unsigned int itsNumVisible;                ///< How many hashes are there currently visible?
    unsigned int itsSize;                      ///< The total number of things to be considered
    unsigned int itsPercentage;                ///< What percentage of the way through are we?
};



#endif // FEEDBACK_HH