[ncpalette] add ncpalette_get() for orthogonality #2565

NEWS.md

@@ -11,6 +11,7 @@ rearrangements of Notcurses.
     shortucts using `modifiers`. Setting any of `alt`, `shift`, or
     `ctrl` will see `ncmenu_create()` fail.
   * `ncinput_equal_p()` considers `NCTYPE_UNKNOWN` equal to `NCTYPE_PRESS`.
+  * Added `ncpalette_get()` for orthogonality's sake.
 
 * 3.0.4 (2022-01-08)
   * We now use level 2 of `XTMODKEYS`, providing better differentiation

doc/man/man3/notcurses_palette.3.md

@@ -27,6 +27,8 @@ typedef struct ncpalette {
 
 **int ncpalette_set(ncpalette* ***p***, int ***idx***, unsigned ***rgb***);**
 
+**uint32_t ncpalette_get(const ncpalette* ***p***, int ***idx***);**
+
 **int ncpalette_get_rgb8(const ncpalette* ***p***, int ***idx***, int* restrict ***r***, int* restrict ***g***, int* restrict ***b***);**
 
 **void ncpalette_free(ncpalette* ***p***);**

include/notcurses/notcurses.h

@@ -1550,6 +1550,14 @@ ncpalette_set(ncpalette* p, int idx, unsigned rgb){
   return ncchannel_set(&p->chans[idx], rgb);
 }
 
+static inline uint32_t
+ncpalette_get(const ncpalette* p, int idx){
+  if(idx < 0 || (size_t)idx > sizeof(p->chans) / sizeof(*p->chans)){
+    return -1;
+  }
+  return ncchannel_rgb(p->chans[idx]);
+}
+
 static inline int
 ncpalette_get_rgb8(const ncpalette* p, int idx, unsigned* RESTRICT r, unsigned* RESTRICT g, unsigned* RESTRICT b){
   if(idx < 0 || (size_t)idx > sizeof(p->chans) / sizeof(*p->chans)){