progress.c File Reference

Progress bar. More...

#include "config.h"
#include <stdarg.h>
#include <stdbool.h>
#include <stdio.h>
#include <unistd.h>
#include "mutt/lib.h"
#include "config/lib.h"
#include "core/lib.h"
#include "gui/lib.h"
#include "lib.h"
#include "globals.h"
#include "mutt_logging.h"
#include "window.h"

Include dependency graph for progress.c:

Go to the source code of this file.

Functions
static size_t	choose_increment (enum ProgressType type)
	Choose the right increment given a ProgressType.
bool	progress_update (struct Progress *progress, size_t pos, int percent)
	Update the state of the progress bar.
void	progress_free (struct Progress **ptr)
	Free a Progress Bar.
struct Progress *	progress_new (enum ProgressType type, size_t size)
	Create a new Progress Bar.
void	progress_set_message (struct Progress *progress, const char *fmt,...)
	Set the progress message.
void	progress_set_size (struct Progress *progress, size_t size)
	Set the progress size.

Detailed Description

Progress bar.

Authors

• Richard Russon
• Pietro Cerutti

Copyright

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.

This program 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 this program. If not, see http://www.gnu.org/licenses/.

Definition in file progress.c.

Function Documentation

choose_increment()

static size_t choose_increment ( enum ProgressType  type )

static

Choose the right increment given a ProgressType.

Parameters

type	ProgressType

Return values

num	Increment value

Definition at line 52 of file progress.c.

{
  switch (type)
  {
    case MUTT_PROGRESS_NET:
      return cs_subset_number(NeoMutt->sub, "net_inc");
    case MUTT_PROGRESS_READ:
      return cs_subset_number(NeoMutt->sub, "read_inc");
    case MUTT_PROGRESS_WRITE:
      return cs_subset_number(NeoMutt->sub, "write_inc");
    default:
      return 0;
  }
}

Here is the call graph for this function:

Here is the caller graph for this function:

progress_update()

bool progress_update	(	struct Progress *	progress,
		size_t	pos,
		int	percent
	)

Update the state of the progress bar.

Parameters

progress	Progress bar
pos	Position, or count
percent	Percentage complete

Return values

true	Screen update is needed

If percent is -1, then the percentage will be calculated using pos and the size in progress.

If percent is positive, it is displayed as percentage, otherwise percentage is calculated from size and pos if progress was initialized with positive size, otherwise no percentage is shown

Definition at line 81 of file progress.c.

{
  if (!progress)
    return false;
 
  // Decloak an opaque pointer
  struct MuttWindow *win = (struct MuttWindow *) progress;
  const bool updated = progress_window_update(win, pos, percent);
 
  if (SigWinch)
  {
    SigWinch = false;
    notify_send(NeoMutt->notify_resize, NT_RESIZE, 0, NULL);
    window_redraw(NULL);
  }
  else
  {
    if (updated)
    {
      window_redraw(win);
    }
  }
 
  return updated;
}

Here is the call graph for this function:

Here is the caller graph for this function:

progress_free()

void progress_free

(

struct Progress **

ptr

)

Free a Progress Bar.

Parameters

ptr	Progress Bar to free

Definition at line 111 of file progress.c.

{
  if (!ptr)
    return;
 
  if (!*ptr)
  {
    mutt_clear_error();
    return;
  }
 
  // Decloak an opaque pointer
  struct MuttWindow **wptr = (struct MuttWindow **) ptr;
  struct MuttWindow *win_pop = msgcont_pop_window();
  if (win_pop != *wptr)
    return;
 
  mutt_window_free(wptr);
}

Here is the call graph for this function:

Here is the caller graph for this function:

progress_new()

struct Progress * progress_new	(	enum ProgressType	type,
		size_t	size
	)

Create a new Progress Bar.

Parameters

type	Type, e.g. MUTT_PROGRESS_READ
size	Total size of expected file / traffic

Return values

ptr	New Progress Bar

If the user has disabled the progress bar, e.g. set read_inc = 0 then a simple message will be displayed instead.

Definition at line 140 of file progress.c.

{
  if (OptNoCurses)
    return NULL;
 
  const size_t size_inc = choose_increment(type);
  if (size_inc == 0) // The user has disabled the progress bar
    return NULL;
 
  const short c_time_inc = cs_subset_number(NeoMutt->sub, "time_inc");
  const bool is_bytes = (type == MUTT_PROGRESS_NET);
 
  struct MuttWindow *win = progress_window_new(size, size_inc, c_time_inc, is_bytes);
 
  msgcont_push_window(win);
 
  // Return an opaque pointer
  return (struct Progress *) win;
}

Here is the call graph for this function:

Here is the caller graph for this function:

progress_set_message()

void progress_set_message	(	struct Progress *	progress,
		const char *	fmt,
			...
	)

Set the progress message.

Parameters

progress	Progress bar
fmt	Format string
...	Format parameters

Definition at line 166 of file progress.c.

{
  // Decloak an opaque pointer
  struct MuttWindow *win = (struct MuttWindow *) progress;
 
  va_list ap;
  va_start(ap, fmt);
 
  if (win)
  {
    progress_window_set_message(win, fmt, ap);
  }
  else
  {
    char msg[1024] = { 0 };
    vsnprintf(msg, sizeof(msg), fmt, ap);
    mutt_message("%s", msg);
  }
 
  va_end(ap);
}

Here is the call graph for this function:

progress_set_size()

void progress_set_size	(	struct Progress *	progress,
		size_t	size
	)

Set the progress size.

Definition at line 191 of file progress.c.

{
  // Decloak an opaque pointer
  struct MuttWindow *win = (struct MuttWindow *) progress;
 
  progress_window_set_size(win, size);
}

Here is the call graph for this function: