A class that indicates the progress by a spinning cross. More...

#include <tpie/progress_indicator_spin.h>

Inherits tpie::progress_indicator_terminal.

Public Member Functions
	progress_indicator_spin (const std::string &title, const std::string &description, stream_size_type minRange, stream_size_type maxRange, stream_size_type stepValue)
	Initializes the indicator. More...

	progress_indicator_spin (const progress_indicator_spin &other)
	Copy-constructor. More...

progress_indicator_spin &	operator= (const progress_indicator_spin &other)
	Assignment operator. More...

virtual	~progress_indicator_spin ()
	The destructor. More...

virtual void	refresh ()
	Display the indicator. More...

void	done ()
	Advance the indicator to the end and print an (optional) message that is followed by a newline. More...

void	set_title (const std::string &title)
	Set the title of a new task to be monitored. More...

void	step (stream_size_type step=1)
	Record an increment to the indicator and advance the indicator. More...

void	raw_step (stream_size_type step)
	Internal method used in fractional progress. More...

virtual void	init (stream_size_type range=0)
	Initialize progress indicator. More...

virtual void	set_range (stream_size_type range)
	Set the upper bound of the counting range. More...

stream_size_type	get_current ()
	Get the current value of the step counter. More...

stream_size_type	get_range ()
	Get the maximum value of the current range. More...

execution_time_predictor *	get_time_predictor ()

void	set_time_predictor (execution_time_predictor *p)

std::string	estimated_remaining_time ()

virtual void	push_breadcrumb (const char *, description_importance)

virtual void	pop_breadcrumb ()

Protected Member Functions
void	display_percentage ()
	Compute and print the percentage or step count. More...

Protected Attributes
char *	m_symbols
	The characters used for the spinning indicator. More...

unsigned short	m_numberOfStates
	The number of characters used for the spinning indicator. More...

unsigned short	m_state
	The current character used for the spinning indicator. More...

std::string	m_title
	A string holding the description of the title. More...

stream_size_type	m_range
	The upper bound of the counting range. More...

stream_size_type	m_current
	The current progress count [m_minRange...m_maxRange]. More...

Detailed Description

A class that indicates the progress by a spinning cross.

Definition at line 41 of file progress_indicator_spin.h.

Constructor & Destructor Documentation

tpie::progress_indicator_spin::progress_indicator_spin	(	const std::string &	title,
		const std::string &	description,
		stream_size_type	minRange,
		stream_size_type	maxRange,
		stream_size_type	stepValue
	)

inline

Initializes the indicator.

Parameters

title	The title of the progress indicator.
description	A text to be printed in front of the indicator.
minRange	The lower bound of the range.
maxRange	The upper bound of the range.
stepValue	The increment for each step.

Definition at line 58 of file progress_indicator_spin.h.

References m_numberOfStates, and m_symbols.

                                                         : 
         progress_indicator_terminal(title, description, minRange, maxRange, stepValue), m_symbols(NULL), m_numberOfStates(0), m_state(0) {
         m_numberOfStates = 4;
         m_symbols = new char[m_numberOfStates+2];
         m_symbols[0] = '|';
         m_symbols[1] = '/';
         m_symbols[2] = '-';
         m_symbols[3] = '\\';
         m_symbols[4] = 'X';
         m_symbols[5] = '\0';
     }

tpie::progress_indicator_spin::progress_indicator_spin ( const progress_indicator_spin & other )

inline

Copy-constructor.

Definition at line 78 of file progress_indicator_spin.h.

                                                                   : 
         progress_indicator_terminal(other), m_symbols(NULL), m_numberOfStates(0), m_state(0) {
         *this = other;
     }

virtual tpie::progress_indicator_spin::~progress_indicator_spin ( )

inlinevirtual

The destructor.

Nothing is done.

Definition at line 109 of file progress_indicator_spin.h.

References m_symbols.

                                        {
         delete [] m_symbols;
     };

Member Function Documentation

void tpie::progress_indicator_terminal::display_percentage ( )

inlineprotectedinherited

Compute and print the percentage or step count.

Definition at line 143 of file progress_indicator_terminal.h.

References tpie::progress_indicator_base::m_current, and tpie::progress_indicator_base::m_range.

Referenced by tpie::progress_indicator_terminal::refresh().

     {
         //if (m_percentageUnit) {
         //  std::cout << std::setw(6) << std::setiosflags(std::ios::fixed) << std::setprecision(2) 
         //           << ((static_cast<double>(m_current) * 100.0) / 
         //               static_cast<double>(m_percentageUnit))
         //           << "%";
         //}
         //else {
         //      std::cout << 
         //}
         stream_size_type r = (m_current) * 100 / (m_range);
         m_os << r << '%';
     }

void tpie::progress_indicator_terminal::done ( )

inlinevirtualinherited

Advance the indicator to the end and print an (optional) message that is followed by a newline.

Parameters

text	The message to be printed at the end of the indicator.

Reimplemented from tpie::progress_indicator_base.

Definition at line 99 of file progress_indicator_terminal.h.

References tpie::progress_indicator_base::m_current, tpie::progress_indicator_base::m_range, and tpie::progress_indicator_terminal::refresh().

                 {
         m_current = m_range;
         refresh();
         m_os << std::endl;
     }

stream_size_type tpie::progress_indicator_base::get_current ( )

inlineinherited

Get the current value of the step counter.

Definition at line 151 of file progress_indicator_base.h.

References tpie::progress_indicator_base::m_current.

151 { return m_current; }

tpie::progress_indicator_base::m_current

stream_size_type m_current

The current progress count [m_minRange...m_maxRange].

Definition: progress_indicator_base.h:173

stream_size_type tpie::progress_indicator_base::get_range ( )

inlineinherited

Get the maximum value of the current range.

Definition at line 156 of file progress_indicator_base.h.

References tpie::progress_indicator_base::m_range.

156 { return m_range; }

tpie::progress_indicator_base::m_range

stream_size_type m_range

The upper bound of the counting range.

Definition: progress_indicator_base.h:170

virtual void tpie::progress_indicator_base::init ( stream_size_type range = 0 )

inlinevirtualinherited

Initialize progress indicator.

Parameters

range The number of times step() is going to be called.

Reimplemented in tpie::fractional_subindicator, tpie::progress_indicator_null, and tpie::progress_indicator_subindicator.

Definition at line 120 of file progress_indicator_base.h.

References tpie::progress_indicator_base::m_current, and tpie::progress_indicator_base::set_range().

Referenced by tpie::merge_sorter< T, UseProgress, pred_t, store_t >::calc(), tpie::pipelining::serialization_bits::sort_calc_t< Traits >::go(), and tpie::parallel_sort().

                                                 {
         if (range != 0) set_range(range);
         m_current = 0;
         call_refresh();
     }

progress_indicator_spin& tpie::progress_indicator_spin::operator= ( const progress_indicator_spin & other )

inline

Assignment operator.

Definition at line 87 of file progress_indicator_spin.h.

References m_numberOfStates, m_state, and m_symbols.

                                                                              {
         if (this != &other) {
 
         progress_indicator_terminal::operator=(other);
 
         m_numberOfStates = other.m_numberOfStates;
         m_state          = other.m_state;
         
         delete[] m_symbols;
 
         m_symbols = new char[m_numberOfStates+2];
         memcpy(m_symbols, other.m_symbols, m_numberOfStates+2);
         }
         return *this;
     }

void tpie::progress_indicator_base::raw_step ( stream_size_type step )

inlineinherited

Internal method used in fractional progress.

In a hierarchy of fractional progress subindicators, only the lowest level of indicators should determine how many steps should pass until the next call to refresh(). When this happens, the subindicator calls raw_step() on its parent indicator rather than step(), which will short-circuit the logic and call the virtual method refresh() directly. You should probably not use this method; use step() instead.

Definition at line 110 of file progress_indicator_base.h.

References tpie::progress_indicator_base::m_current, tpie::progress_indicator_base::refresh(), and tpie::progress_indicator_base::step().

                                          {
         m_current += step;
         // Don't call call_refresh(); call refresh() directly instead.
         refresh();
     }

virtual void tpie::progress_indicator_spin::refresh ( )

inlinevirtual

Display the indicator.

Reimplemented from tpie::progress_indicator_terminal.

Definition at line 119 of file progress_indicator_spin.h.

References tpie::progress_indicator_base::m_current, m_numberOfStates, m_state, and m_symbols.

                            {
         m_state = ++m_state % m_numberOfStates;
 
         //  Use the last symbol for indicating "done".
         if (m_current == m_maxRange) m_state = m_numberOfStates;
 
         //  Go to the beginning of the line and print the description.
         std::cout << "\r" << m_description << " " << m_symbols[m_state] << std::flush;
     }

virtual void tpie::progress_indicator_base::set_range ( stream_size_type range )

inlinevirtualinherited

Set the upper bound of the counting range.

This method also implies a reset of the counter. In order to be able to set the uper bound independent of setting the lower bound, no range checking is done.

Parameters

range The new upper bound.

Reimplemented in tpie::progress_indicator_null.

Definition at line 139 of file progress_indicator_base.h.

References tpie::progress_indicator_base::m_range.

Referenced by tpie::progress_indicator_base::init().

                                                    {
         m_range = range;
     }

void tpie::progress_indicator_terminal::set_title ( const std::string & title )

inlineinherited

Set the title of a new task to be monitored.

The terminal line will be newline'd, and the title will be followed by a newline as well.

Parameters

title The title of the new task to be monitored.

Definition at line 116 of file progress_indicator_terminal.h.

References tpie::progress_indicator_terminal::m_title.

     {
         m_title = title;
         m_os << title << std::endl;
     }

void tpie::progress_indicator_base::step ( stream_size_type step = 1 )

inlineinherited

Record an increment to the indicator and advance the indicator.

Definition at line 90 of file progress_indicator_base.h.

References tpie::progress_indicator_base::m_current.

Referenced by tpie::merge_sorter< T, UseProgress, pred_t, store_t >::calc(), tpie::pipelining::serialization_bits::sort_calc_t< Traits >::go(), tpie::progress_indicator_base::raw_step(), tpie::ami::Internal_Sorter_Obj< T, Compare >::sort(), and tpie::pipelining::node::step().

                                        {
         m_current += step;
 
         if (step >= m_remainingSteps) {
             call_refresh();
         } else {
             m_remainingSteps -= step;
         }
     }