NAME

       notcurses_palette - operations on notcurses palettes

SYNOPSIS

       #include <notcurses/notcurses.h>

              typedef struct ncpalette {
                // We store the RGB values as a regular ol' channel
                uint32_t chans[NCPALETTESIZE];
              } ncpalette;

       bool notcurses_cantruecolor(const struct notcurses* nc);

       ncpalette* ncpalette_new(struct notcurses* nc);

       int ncpalette_use(struct notcurses* nc, const ncpalette* p);

       int ncpalette_set_rgb8(ncpalette* p, int idx, int r, int g, int b);

       int ncpalette_set(ncpalette* p, int idx, unsigned rgb);

       int ncpalette_get(const ncpalette* p, int idx, uint32_t* palent);

       int ncpalette_get_rgb8(const ncpalette* p, int idx, int* restrict r, int* restrict g, int*
       restrict b);

       void ncpalette_free(ncpalette* p);

       bool notcurses_canchangecolors(const struct notcurses* nc);

DESCRIPTION

       Some terminals only support 256 colors, but allow the full palette to  be  specified  with
       arbitrary  RGB  colors.   In  all cases, it's more performant to use indexed colors, since
       it's much less data to write to the terminal.  If you can limit yourself  to  256  colors,
       that's probably for the best.

       In  addition,  palette-based  color  allows  for  very fast color cycling effects, since a
       single command can affect many cells on the screen.

RETURN VALUES

       Functions returning int return -1 on failure, or 0 on success.  Failure is always  due  to
       invalid  inputs.  Functions returning bool are predicates, and return the requested value.
       Functions returning unsigned forms return the input, modified as requested.

SEE ALSO

       notcurses(3),     notcurses_cell(3),      notcurses_channels(3),      notcurses_output(3),
       notcurses_plane(3)

AUTHORS

       nick black <nickblack@linux.com>.

                                              v3.0.7                         notcurses_palette(3)