NAME

notcurses_progbar - high level widget for progress bars

SYNOPSIS

#include <notcurses/notcurses.h>

#define NCPROGBAR_OPTION_RETROGRADE        0x0001u // proceed left/down
#define NCPROGBAR_OPTION_LOCK_ORIENTATION  0x0002u // lock in orientation
#define NCPROGBAR_OPTION_FORCE_VERTICAL    0x0003u // lock in vert

typedef struct ncprogbar_options {
  uint64_t maxchannels;
  uint64_t minchannels;
  const char egcs;
  uint64_t flags;
} ncprogbar_options;

struct ncuplot ncprogbar_create(struct ncplane n, const ncprogbar_options* opts)**

struct ncplane ncprogbar_plane(struct ncprogbar n)**

int ncprogbar_set_progress(struct ncprogbar n, double p)*

double ncprogbar_progress(const struct ncprogbar n)*

void ncprogbar_destroy(struct ncprogbar n)*

DESCRIPTION

These functions draw progress bars in any of four directions. The progress measure is a double between zero and one, inclusive, provided to ncprogbar_set_progress. This will be scaled to the size of the provided ncplane n. By default, the axis of progression is the longer element of the plane's geometry, but it can be explicitly chosen with NCPROGBAR_OPTION_LOCK_ORIENTATION and NCPROGBAR_OPTION_FORCE_VERTICAL. Horizontal bars proceed to the right by default, and vertical bars proceed up. This can be changed with NCPROGBAR_OPTION_RETROGRADE.

NOTES

ncprogbar_create takes ownership of n in all cases. On failure, n will be destroyed immediately. It is otherwise destroyed by ncprogbar_destroy.

RETURN VALUES

ncprogbar_plane returns the ncplane on which the progress bar is drawn. ncprogbar_progress returns the current progress, a value between zero and one, inclusive. They cannot fail.

ncprogbar_set_progress returns -1 if p is less than zero or greater than one, or if there is an internal error redrawing the progress bar. It returns 0 otherwise.

BUGS

Whether progression is to the left or right by default probably ought be an aspect of the current locale.

2.2 KiB Raw Blame History