#ifndef __NCPP_PLANE_HH #define __NCPP_PLANE_HH #include #include #include #include #include #include #include "Root.hh" #include "Cell.hh" #include "CellStyle.hh" #include "NCAlign.hh" #include "NCBox.hh" namespace ncpp { class NcReel; class NCPP_API_EXPORT Plane : public Root { public: Plane (Plane&& other) : Root (nullptr) { unmap_plane (&other); plane = other.plane; is_stdplane = other.is_stdplane; map_plane (plane, this); other.plane = nullptr; other.is_stdplane = false; } Plane (Plane const& other) : Root (nullptr) { plane = duplicate_plane (other, nullptr); } explicit Plane (Plane const& other, void *opaque) : Root (nullptr) { plane = duplicate_plane (other, opaque); } explicit Plane (Plane *n, int rows, int cols, int yoff, int xoff, void *opaque = nullptr) : Plane (static_cast(n), rows, cols, yoff, xoff, opaque) {} explicit Plane (const Plane *n, int rows, int cols, int yoff, int xoff, void *opaque = nullptr) : Root (nullptr) { if (n == nullptr) throw invalid_argument ("'n' must be a valid pointer"); plane = create_plane (*n, rows, cols, yoff, xoff, opaque); } explicit Plane (const Plane &n, int rows, int cols, int yoff, int xoff, void *opaque = nullptr) : Root (nullptr) { plane = create_plane (n, rows, cols, yoff, xoff, opaque); } explicit Plane (int rows, int cols, int yoff, int xoff, void *opaque = nullptr, NotCurses *ncinst = nullptr) : Root (ncinst) { plane = ncplane_new ( notcurses_stdplane(get_notcurses ()), rows, cols, yoff, xoff, opaque, nullptr ); if (plane == nullptr) throw init_error ("Notcurses failed to create a new plane"); map_plane (plane, this); } explicit Plane (Plane &n, int rows, int cols, int yoff, NCAlign align, void *opaque = nullptr) : Root (nullptr) { plane = create_plane (n, rows, cols, yoff, align, opaque); } explicit Plane (Plane const& n, int rows, int cols, int yoff, NCAlign align, void *opaque = nullptr) : Root (nullptr) { plane = create_plane (const_cast(n), rows, cols, yoff, align, opaque); } explicit Plane (Plane *n, int rows, int cols, int yoff, NCAlign align, void *opaque = nullptr) : Root (nullptr) { if (n == nullptr) throw invalid_argument ("'n' must be a valid pointer"); plane = create_plane (*n, rows, cols, yoff, align, opaque); } explicit Plane (Plane const* n, int rows, int cols, int yoff, NCAlign align, void *opaque = nullptr) : Root (nullptr) { if (n == nullptr) throw invalid_argument ("'n' must be a valid pointer"); plane = create_plane (const_cast(*n), rows, cols, yoff, align, opaque); } explicit Plane (ncplane *_plane) noexcept : Root (nullptr), plane (_plane) {} ~Plane () noexcept { if (is_stdplane || plane == nullptr) return; if (!is_notcurses_stopped ()) ncplane_destroy (plane); unmap_plane (this); } operator ncplane* () noexcept { return plane; } operator ncplane const* () const noexcept { return plane; } void center_abs (int *y, int *x) const noexcept { ncplane_center_abs (plane, y, x); } ncplane* to_ncplane () noexcept { return plane; } bool resize_realign () const NOEXCEPT_MAYBE { return error_guard (ncplane_resize_realign (plane), -1); } bool resize (int keepy, int keepx, int keepleny, int keeplenx, int yoff, int xoff, int ylen, int xlen) const NOEXCEPT_MAYBE { int ret = ncplane_resize ( plane, keepy, keepx, keepleny, keeplenx, yoff, xoff, ylen, xlen ); return error_guard (ret, -1); } bool pulse (const timespec* ts, fadecb fader, void* curry) const NOEXCEPT_MAYBE { return error_guard (ncplane_pulse (plane, ts, fader, curry), -1); } int gradient (const char* egc, uint16_t stylemask, uint64_t ul, uint64_t ur, uint64_t ll, uint64_t lr, int ystop, int xstop) const NOEXCEPT_MAYBE { return error_guard (ncplane_gradient (plane, egc, stylemask, ul, ur, ll, lr, ystop, xstop), -1); } int gradient_sized (const char* egc, uint16_t stylemask, uint64_t ul, uint64_t ur, uint64_t ll, uint64_t lr, int ylen, int xlen) const NOEXCEPT_MAYBE { return error_guard (ncplane_gradient_sized (plane, egc, stylemask, ul, ur, ll, lr, ylen, xlen), -1); } int high_gradient (uint32_t ul, uint32_t ur, uint32_t ll, uint32_t lr, int ylen, int xlen) const NOEXCEPT_MAYBE { return error_guard (ncplane_highgradient (plane, ul, ur, ll, lr, ylen, xlen), -1); } int high_gradient_sized (uint32_t ul, uint32_t ur, uint32_t ll, uint32_t lr, int ylen, int xlen) const NOEXCEPT_MAYBE { return error_guard (ncplane_highgradient_sized (plane, ul, ur, ll, lr, ylen, xlen), -1); } void greyscale () const noexcept { ncplane_greyscale (plane); } bool resize (int ylen, int xlen) const NOEXCEPT_MAYBE { return error_guard (ncplane_resize_simple (plane, ylen, xlen), -1); } bool fadeout (timespec *ts, fadecb fader = nullptr, void *curry = nullptr) const NOEXCEPT_MAYBE { return fadeout (static_cast(ts), fader, curry); } bool fadeout (timespec &ts, fadecb fader = nullptr, void *curry = nullptr) const NOEXCEPT_MAYBE { return fadeout (&ts, fader, curry); } bool fadeout (timespec const& ts, fadecb fader = nullptr, void *curry = nullptr) const NOEXCEPT_MAYBE { return fadeout (&ts, fader, curry); } bool fadeout (const timespec *ts, fadecb fader = nullptr, void *curry = nullptr) const NOEXCEPT_MAYBE { return error_guard (ncplane_fadeout (plane, ts, fader, curry), -1); } bool fadein (timespec *ts, fadecb fader = nullptr) const NOEXCEPT_MAYBE { return fadein (static_cast(ts), fader); } bool fadein (timespec &ts, fadecb fader = nullptr) const NOEXCEPT_MAYBE { return fadein (&ts, fader); } bool fadein (timespec const& ts, fadecb fader = nullptr) const NOEXCEPT_MAYBE { return fadein (&ts, fader); } bool fadein (const timespec *ts, fadecb fader = nullptr, void *curry = nullptr) const NOEXCEPT_MAYBE { return error_guard (ncplane_fadein (plane, ts, fader, curry), -1); } void erase () const noexcept { ncplane_erase (plane); } int get_x () const noexcept { return ncplane_x (plane); } int get_y () const noexcept { return ncplane_y (plane); } int get_align (NCAlign align, int c) const NOEXCEPT_MAYBE { return error_guard (ncplane_align (plane, static_cast(align), c), INT_MAX); } void get_dim (int *rows, int *cols) const noexcept { ncplane_dim_yx (plane, rows, cols); } void get_dim (int &rows, int &cols) const noexcept { get_dim (&rows, &cols); } int get_dim_x () const noexcept { return ncplane_dim_x (plane); } int get_dim_y () const noexcept { return ncplane_dim_y (plane); } void get_yx (int *y, int *x) const noexcept { ncplane_yx (plane, y, x); } void get_yx (int &y, int &x) const noexcept { get_yx (&y, &x); } Plane* reparent (Plane *newparent = nullptr) const noexcept { ncplane *ret = ncplane_reparent (plane, newparent == nullptr ? nullptr : newparent->plane); if (ret == nullptr) return nullptr; return map_plane (ret); } Plane* reparent (const Plane *newparent) const noexcept { return reparent (const_cast(newparent)); } Plane* reparent (const Plane &newparent) const noexcept { return reparent (const_cast(&newparent)); } void home () const noexcept { ncplane_home (plane); } bool move (int y, int x) const NOEXCEPT_MAYBE { return error_guard (ncplane_move_yx (plane, y, x), -1); } void move_top () noexcept { ncplane_move_top (plane); } void move_bottom () noexcept { ncplane_move_bottom (plane); } bool move_below (Plane &below) const NOEXCEPT_MAYBE { return error_guard (ncplane_move_below (plane, below.plane), -1); } bool move_below (Plane *below) const { if (below == nullptr) throw invalid_argument ("'below' must be a valid pointer"); return move_below (*below); } bool move_above (Plane &above) const NOEXCEPT_MAYBE { return error_guard (ncplane_move_above (plane, above.plane), -1); } bool move_above (Plane *above) const { if (above == nullptr) throw invalid_argument ("'above' must be a valid pointer"); return move_above (*above); } bool mergedown (Plane &dst, int begsrcy, int begsrcx, int leny, int lenx, int dsty, int dstx) const { return mergedown (&dst, begsrcy, begsrcx, leny, lenx, dsty, dstx); } bool mergedown (Plane *dst, int begsrcy, int begsrcx, int leny, int lenx, int dsty, int dstx) const { if (dst != nullptr && plane == dst->plane) throw invalid_argument ("'dst' must refer to a different plane than the one this method is called on"); return error_guard (ncplane_mergedown (plane, dst != nullptr ? dst->plane : nullptr, begsrcy, begsrcx, leny, lenx, dsty, dstx), -1); } bool mergedown_simple (Plane &dst) const { return mergedown_simple (&dst); } bool mergedown_simple (Plane *dst) const { if (dst != nullptr && plane == dst->plane) throw invalid_argument ("'dst' must refer to a different plane than the one this method is called on"); return error_guard (ncplane_mergedown_simple (plane, dst != nullptr ? dst->plane : nullptr), -1); } bool cursor_move (int y, int x) const NOEXCEPT_MAYBE { return error_guard (ncplane_cursor_move_yx (plane, y, x), -1); } void get_cursor_yx (int *y, int *x) const noexcept { ncplane_cursor_yx (plane, y, x); } void get_cursor_yx (int &y, int &x) const noexcept { get_cursor_yx (&y, &x); } int putc (const Cell &c) const NOEXCEPT_MAYBE { return error_guard (ncplane_putc (plane, c), -1); } int putc (const Cell *c) const { if (c == nullptr) throw invalid_argument ("'c' must be a valid pointer"); return putc (*c); } int putc (int y, int x, Cell const& c) const NOEXCEPT_MAYBE { return error_guard (ncplane_putc_yx (plane, y, x, c), -1); } int putc (int y, int x, Cell const* c) const NOEXCEPT_MAYBE { if (c == nullptr) return -1; return putc (y, x, *c); } int putc (char c, bool retain_styling = false) const NOEXCEPT_MAYBE { int ret; if (retain_styling) { ret = ncplane_putchar_stained (plane, c); } else { ret = ncplane_putchar (plane, c); } return error_guard (ret, -1); } int putc (int y, int x, char c) const NOEXCEPT_MAYBE { return error_guard (ncplane_putchar_yx (plane, y, x, c), -1); } int putc (const char *gclust, int *sbytes = nullptr, bool retain_styling = false) const NOEXCEPT_MAYBE { int ret; if (retain_styling) { ret = ncplane_putegc_stained (plane, gclust, sbytes); } else { ret = ncplane_putegc (plane, gclust, sbytes); } return error_guard (ret, -1); } int putc (int y, int x, const char *gclust, int *sbytes = nullptr) const NOEXCEPT_MAYBE { return error_guard (ncplane_putegc_yx (plane, y, x, gclust, sbytes), -1); } int putc (const wchar_t *gclust, int *sbytes = nullptr, bool retain_styling = false) const NOEXCEPT_MAYBE { int ret; if (retain_styling) { ret = ncplane_putwegc_stained (plane, gclust, sbytes); } else { ret = ncplane_putwegc (plane, gclust, sbytes); } return error_guard (ret, -1); } int putc (int y, int x, const wchar_t *gclust, int *sbytes = nullptr) const NOEXCEPT_MAYBE { return error_guard (ncplane_putwegc_yx (plane, y, x, gclust, sbytes), -1); } // OK, this is ugly, but we need to rename this overload or calls similar to n->putc (0, 0, '0') will be // considered ambiguous with the above `putc (int, int, char)` overload. int putwch (int y, int x, wchar_t w) const NOEXCEPT_MAYBE { return error_guard (ncplane_putwc_yx (plane, y, x, w), -1); } // Ditto int putwch (wchar_t w) const NOEXCEPT_MAYBE { return error_guard (ncplane_putwc (plane, w), -1); } int putwc_stained (wchar_t w) const NOEXCEPT_MAYBE { return error_guard (ncplane_putwc_stained (plane, w), -1); } int putstr (const char *gclustarr) const NOEXCEPT_MAYBE { int ret = ncplane_putstr (plane, gclustarr); return error_guard_cond (ret, ret < 0); } int putstr (int y, int x, const char *gclustarr) const NOEXCEPT_MAYBE { int ret = ncplane_putstr_yx (plane, y, x, gclustarr); return error_guard_cond (ret, ret < 0); } int putstr (int y, NCAlign atype, const char *s) const NOEXCEPT_MAYBE { return error_guard (ncplane_putstr_aligned (plane, y, static_cast(atype), s), -1); } int putstr (const wchar_t *gclustarr) const NOEXCEPT_MAYBE { return error_guard (ncplane_putwstr (plane, gclustarr), -1); } int putstr (int y, int x, const wchar_t *gclustarr) const NOEXCEPT_MAYBE { return error_guard (ncplane_putwstr_yx (plane, y, x, gclustarr), -1); } int putstr (int y, NCAlign atype, const wchar_t *gcluststyles) const NOEXCEPT_MAYBE { return error_guard (ncplane_putwstr_aligned (plane, y, static_cast(atype), gcluststyles), -1); } int putstr_stained (const wchar_t* gclustarr) const NOEXCEPT_MAYBE { return error_guard (ncplane_putwstr_stained (plane, gclustarr), -1); } int putstr_stained (const char* s) const NOEXCEPT_MAYBE { int ret = ncplane_putstr_stained (plane, s); return error_guard_cond (ret, ret < 0); } int printf_stained (const char* format, ...) const NOEXCEPT_MAYBE __attribute__ ((format (printf, 2, 3))) { va_list va; va_start (va, format); int ret = ncplane_vprintf_stained (plane, format, va); va_end (va); return error_guard (ret, -1); } int printf (const char* format, ...) const NOEXCEPT_MAYBE __attribute__ ((format (printf, 2, 3))) { va_list va; va_start (va, format); int ret = ncplane_vprintf (plane, format, va); va_end (va); return error_guard (ret, -1); } int printf (int y, int x, const char *format, ...) const NOEXCEPT_MAYBE __attribute__ ((format (printf, 4, 5))) { va_list va; va_start (va, format); int ret = ncplane_vprintf_yx (plane, y, x, format, va); va_end (va); return error_guard (ret, -1); } int printf (int y, NCAlign align, const char *format, ...) const NOEXCEPT_MAYBE __attribute__ ((format (printf, 4, 5))) { va_list va; va_start (va, format); int ret = vprintf (y, align, format, va); va_end (va); return error_guard (ret, -1); } int vprintf_stained (const char* format, va_list ap) const NOEXCEPT_MAYBE { return error_guard (ncplane_vprintf_stained (plane, format, ap), -1); } int vprintf (const char* format, va_list ap) const NOEXCEPT_MAYBE { return error_guard (ncplane_vprintf (plane, format, ap), -1); } int vprintf (int y, int x, const char* format, va_list ap) const NOEXCEPT_MAYBE { return error_guard (ncplane_vprintf_yx (plane, y, x, format, ap), -1); } int vprintf (int y, NCAlign align, const char *format, va_list ap) const NOEXCEPT_MAYBE { return error_guard (ncplane_vprintf_aligned (plane, y, static_cast(align), format, ap), -1); } int hline (const Cell &c, int len) const NOEXCEPT_MAYBE { return error_guard (ncplane_hline (plane, c, len), -1); } int hline (const Cell &c, int len, uint64_t c1, uint64_t c2) const NOEXCEPT_MAYBE { return error_guard (ncplane_hline_interp (plane, c, len, c1, c2), -1); } int vline (const Cell &c, int len) const NOEXCEPT_MAYBE { return error_guard (ncplane_vline (plane, c, len), -1); } int vline (const Cell &c, int len, uint64_t c1, uint64_t c2) const NOEXCEPT_MAYBE { return error_guard (ncplane_vline_interp (plane, c, len, c1, c2), -1); } bool load_box (uint16_t styles, uint64_t channels, Cell &ul, Cell &ur, Cell &ll, Cell &lr, Cell &hl, Cell &vl, const char *gclusters) const NOEXCEPT_MAYBE { return error_guard (cells_load_box (plane, styles, channels, ul, ur, ll, lr, hl, vl, gclusters), -1); } bool load_box (CellStyle style, uint64_t channels, Cell &ul, Cell &ur, Cell &ll, Cell &lr, Cell &hl, Cell &vl, const char *gclusters) const NOEXCEPT_MAYBE { return load_box (static_cast(style), channels, ul, ur, ll, lr, hl, vl, gclusters); } bool load_rounded_box (uint16_t styles, uint64_t channels, Cell &ul, Cell &ur, Cell &ll, Cell &lr, Cell &hl, Cell &vl) const NOEXCEPT_MAYBE { return error_guard (cells_rounded_box (plane, styles, channels, ul, ur, ll, lr, hl, vl), -1); } bool load_rounded_box (CellStyle style, uint64_t channels, Cell &ul, Cell &ur, Cell &ll, Cell &lr, Cell &hl, Cell &vl) const NOEXCEPT_MAYBE { return load_rounded_box (static_cast(style), channels, ul, ur, ll, lr, hl, vl); } bool load_double_box (uint16_t styles, uint64_t channels, Cell &ul, Cell &ur, Cell &ll, Cell &lr, Cell &hl, Cell &vl) const NOEXCEPT_MAYBE { return error_guard (cells_double_box (plane, styles, channels, ul, ur, ll, lr, hl, vl), -1); } bool load_double_box (CellStyle style, uint64_t channels, Cell &ul, Cell &ur, Cell &ll, Cell &lr, Cell &hl, Cell &vl) const NOEXCEPT_MAYBE { return load_double_box (static_cast(style), channels, ul, ur, ll, lr, hl, vl); } bool box (const Cell &ul, const Cell &ur, const Cell &ll, const Cell &lr, const Cell &hline, const Cell &vline, int ystop, int xstop, unsigned ctlword) const NOEXCEPT_MAYBE { return error_guard (ncplane_box (plane, ul, ur, ll, lr, hline, vline, ystop, xstop, ctlword), -1); } bool box_sized (const Cell &ul, const Cell &ur, const Cell &ll, const Cell &lr, const Cell &hline, const Cell &vline, int ylen, int xlen, unsigned ctlword) const NOEXCEPT_MAYBE { return error_guard (ncplane_box_sized (plane, ul, ur, ll, lr, hline, vline, ylen, xlen, ctlword), -1); } bool rounded_box (uint16_t styles, uint64_t channels, int ystop, int xstop, unsigned ctlword) const NOEXCEPT_MAYBE { return error_guard (ncplane_rounded_box (plane, styles, channels, ystop, xstop, ctlword), -1); } bool rounded_box_sized (uint16_t styles, uint64_t channels, int ylen, int xlen, unsigned ctlword) const NOEXCEPT_MAYBE { return error_guard (ncplane_rounded_box_sized (plane, styles, channels, ylen, xlen, ctlword), -1); } bool double_box (uint16_t styles, uint64_t channels, int ystop, int xstop, unsigned ctlword) const NOEXCEPT_MAYBE { return error_guard (ncplane_double_box (plane, styles, channels, ystop, xstop, ctlword), -1); } bool double_box_sized (uint16_t styles, uint64_t channels, int ylen, int xlen, unsigned ctlword) const NOEXCEPT_MAYBE { return error_guard (ncplane_double_box_sized (plane, styles, channels, ylen, xlen, ctlword), -1); } bool perimeter (const Cell &ul, const Cell &ur, const Cell &ll, const Cell &lr, const Cell &hline, const Cell &vline, unsigned ctlword) const NOEXCEPT_MAYBE { return error_guard (ncplane_perimeter (plane, ul, ur, ll, lr, hline, vline, ctlword), -1); } bool perimeter_rounded (uint16_t stylemask, uint64_t channels, unsigned ctlword) const NOEXCEPT_MAYBE { return error_guard (ncplane_perimeter_rounded (plane, stylemask, channels, ctlword), -1); } bool perimeter_double (uint16_t stylemask, uint64_t channels, unsigned ctlword) const NOEXCEPT_MAYBE { return error_guard (ncplane_perimeter_double (plane, stylemask, channels, ctlword), -1); } int polyfill (int y, int x, const Cell& c) const NOEXCEPT_MAYBE { return error_guard (ncplane_polyfill_yx (plane, y, x, c), -1); } uint32_t* rgba(ncblitter_e blit, int begy, int begx, int leny, int lenx) const noexcept { return ncplane_rgba (plane, blit, begy, begx, leny, lenx); } char* content(int begy, int begx, int leny, int lenx) const noexcept { return ncplane_contents (plane, begy, begx, leny, lenx); } uint64_t get_channels () const noexcept { return ncplane_channels (plane); } unsigned get_bchannel () const noexcept { return ncplane_bchannel (plane); } unsigned get_fchannel () const noexcept { return ncplane_fchannel (plane); } unsigned get_fg_rgb () const noexcept { return ncplane_fg_rgb (plane); } unsigned get_bg_rgb () const noexcept { return ncplane_bg_rgb (plane); } unsigned get_fg_alpha () const noexcept { return ncplane_fg_alpha (plane); } uint64_t set_fchannel (uint32_t channel) const noexcept { return ncplane_set_fchannel (plane, channel); } uint64_t set_bchannel (uint32_t channel) const noexcept { return ncplane_set_bchannel (plane, channel); } void set_channels (uint64_t channels) const noexcept { ncplane_set_channels (plane, channels); } bool set_fg_alpha (unsigned alpha) const NOEXCEPT_MAYBE { return error_guard (ncplane_set_fg_alpha (plane, alpha), -1); } unsigned get_bg_alpha () const noexcept { return ncplane_bg_alpha (plane); } bool set_bg_alpha (unsigned alpha) const NOEXCEPT_MAYBE { return error_guard (ncplane_set_bg_alpha (plane, alpha), -1); } unsigned get_fg_rgb8 (unsigned *r, unsigned *g, unsigned *b) const noexcept { return ncplane_fg_rgb8 (plane, r, g, b); } bool set_fg_rgb8 (int r, int g, int b, bool clipped = false) const NOEXCEPT_MAYBE { if (clipped) { ncplane_set_fg_rgb8_clipped (plane, r, g, b); return true; } return error_guard (ncplane_set_fg_rgb8 (plane, r, g, b), -1); } bool set_fg_palindex (int idx) const NOEXCEPT_MAYBE { return error_guard (ncplane_set_fg_palindex (plane, idx), -1); } bool set_fg_rgb (uint32_t channel) const NOEXCEPT_MAYBE { return error_guard (ncplane_set_fg_rgb (plane, channel), -1); } void set_fg_default () const noexcept { ncplane_set_fg_default (plane); } unsigned get_bg_rgb8 (unsigned *r, unsigned *g, unsigned *b) const noexcept { return ncplane_bg_rgb8 (plane, r, g, b); } bool set_bg_rgb8 (int r, int g, int b, bool clipped = false) const NOEXCEPT_MAYBE { if (clipped) { ncplane_set_fg_rgb8_clipped (plane, r, g, b); return true; } return error_guard (ncplane_set_bg_rgb8 (plane, r, g, b), -1); } bool set_bg_palindex (int idx) const NOEXCEPT_MAYBE { return error_guard (ncplane_set_bg_alpha (plane, idx), -1); } bool set_bg_rgb (uint32_t channel) const NOEXCEPT_MAYBE { return error_guard (ncplane_set_bg_rgb (plane, channel), -1); } void set_bg_default () const noexcept { ncplane_set_bg_default (plane); } bool set_scrolling (bool scrollp) const noexcept { return ncplane_set_scrolling (plane, scrollp); } unsigned get_styles () const noexcept { return ncplane_styles (plane); } void styles_set (CellStyle styles) const noexcept { ncplane_set_styles (plane, static_cast(styles)); } void styles_on (CellStyle styles) const noexcept { ncplane_on_styles (plane, static_cast(styles)); } void styles_off (CellStyle styles) const noexcept { ncplane_off_styles (plane, static_cast(styles)); } int format (int ystop, int xstop, uint16_t stylemask) const NOEXCEPT_MAYBE { return error_guard (ncplane_format (plane, ystop, xstop, stylemask), -1); } int stain (int ystop, int xstop, uint64_t ul, uint64_t ur, uint64_t ll, uint64_t lr) const NOEXCEPT_MAYBE { return error_guard (ncplane_stain (plane, ystop, xstop, ul, ur, ll, lr), -1); } Plane* get_below () const noexcept { return map_plane (ncplane_below (plane)); } Plane* get_above () const noexcept { return map_plane (ncplane_above (plane)); } bool set_base_cell (Cell &c) const NOEXCEPT_MAYBE { bool ret = ncplane_set_base_cell (plane, c) < 0; return error_guard_cond (ret, ret); } bool set_base (const char* egc, uint16_t stylemask, uint64_t channels) const NOEXCEPT_MAYBE { bool ret = ncplane_set_base (plane, egc, stylemask, channels) < 0; return error_guard_cond (ret, ret); } bool get_base (Cell &c) const NOEXCEPT_MAYBE { bool ret = ncplane_base (plane, c) < 0; return error_guard_cond (ret, ret); } bool at_cursor (Cell &c) const NOEXCEPT_MAYBE { bool ret = ncplane_at_cursor_cell (plane, c) < 0; return error_guard_cond (ret, ret); } bool at_cursor (Cell *c) const noexcept { if (c == nullptr) return false; return at_cursor (*c); } char* at_cursor (uint16_t* stylemask, uint64_t* channels) const { if (stylemask == nullptr || channels == nullptr) return nullptr; return ncplane_at_cursor (plane, stylemask, channels); } int get_at (int y, int x, Cell &c) const NOEXCEPT_MAYBE { return error_guard (ncplane_at_yx_cell (plane, y, x, c), -1); } int get_at (int y, int x, Cell *c) const { if (c == nullptr) return -1; return get_at (y, x, *c); } char* get_at (int y, int x, uint16_t* stylemask, uint64_t* channels) const { if (stylemask == nullptr || channels == nullptr) return nullptr; return ncplane_at_yx (plane, y, x, stylemask, channels); } void* set_userptr (void *opaque) const noexcept { return ncplane_set_userptr (plane, opaque); } template T* set_userptr (T *opaque) const noexcept { return static_cast(set_userptr (static_cast(opaque))); } void* get_userptr () const noexcept { return ncplane_userptr (plane); } template T* get_userptr () const noexcept { return static_cast(get_userptr ()); } NcReel* ncreel_create (const ncreel_options *popts = nullptr); // Some Cell APIs go here since they act on individual panels even though it may seem weird at points (e.g. // release) int load (Cell &cell, const char *gcluster) const NOEXCEPT_MAYBE { return error_guard (cell_load (plane, cell, gcluster), -1); } bool load (Cell &cell, char ch) const NOEXCEPT_MAYBE { return error_guard (cell_load_char (plane, cell, ch), -1); } int prime (Cell &cell, const char *gcluster, uint16_t styles, uint64_t channels) const NOEXCEPT_MAYBE { return error_guard (cell_prime (plane, cell, gcluster, styles, channels), -1); } void release (Cell &cell) const noexcept { cell_release (plane, cell); } int duplicate (Cell &target, Cell &source) const NOEXCEPT_MAYBE { return error_guard (cell_duplicate (plane, target, source), -1); } int duplicate (Cell &target, Cell const& source) const NOEXCEPT_MAYBE { return error_guard (cell_duplicate (plane, target, source), -1); } int duplicate (Cell &target, Cell *source) const { if (source == nullptr) throw invalid_argument ("'source' must be a valid pointer"); return duplicate (target, *source); } int duplicate (Cell &target, Cell const* source) const { if (source == nullptr) throw invalid_argument ("'source' must be a valid pointer"); return duplicate (target, *source); } int duplicate (Cell *target, Cell *source) const { if (target == nullptr) throw invalid_argument ("'target' must be a valid pointer"); if (source == nullptr) throw invalid_argument ("'source' must be a valid pointer"); return duplicate (*target, *source); } int duplicate (Cell *target, Cell const* source) const { if (target == nullptr) throw invalid_argument ("'target' must be a valid pointer"); if (source == nullptr) throw invalid_argument ("'source' must be a valid pointer"); return duplicate (*target, *source); } int duplicate (Cell *target, Cell &source) const { if (target == nullptr) throw invalid_argument ("'target' must be a valid pointer"); return duplicate (*target, source); } int duplicate (Cell *target, Cell const& source) const { if (target == nullptr) throw invalid_argument ("'target' must be a valid pointer"); return duplicate (*target, source); } void translate (const Plane *dst, int *y = nullptr, int *x = nullptr) const noexcept { ncplane_translate (*this, dst ? dst->plane: nullptr, y, x); } void translate (const Plane &dst, int *y = nullptr, int *x = nullptr) const noexcept { translate (*this, dst, y, x); } static void translate (const Plane *src, const Plane *dst, int *y = nullptr, int *x = nullptr) { if (src == nullptr) throw invalid_argument ("'src' must be a valid pointer"); ncplane_translate (*src, dst ? dst->plane : nullptr, y, x); } static void translate (const Plane &src, const Plane &dst, int *y = nullptr, int *x = nullptr) noexcept { ncplane_translate (src.plane, dst.plane, y, x); } bool translate_abs (int *y = nullptr, int *x = nullptr) const noexcept { return error_guard (ncplane_translate_abs (plane, y, x), false); } bool rotate_cw () const NOEXCEPT_MAYBE { return error_guard (ncplane_rotate_cw (plane), -1); } bool rotate_ccw () const noexcept { return error_guard (ncplane_rotate_ccw (plane), -1); } const char* get_extended_gcluster (Cell &cell) const noexcept { return cell_extended_gcluster (plane, cell); } const char* get_extended_gcluster (Cell const& cell) const noexcept { return cell_extended_gcluster (plane, cell); } static Plane* map_plane (ncplane *ncp, Plane *associated_plane = nullptr) noexcept; bool blit_bgrx (const void* data, int linesize, const struct ncvisual_options *vopts) const NOEXCEPT_MAYBE { bool ret = ncblit_bgrx (data, linesize, vopts) < 0; return error_guard_cond (ret, ret); } bool blit_rgba (const void* data, int linesize, const struct ncvisual_options *vopts) const NOEXCEPT_MAYBE { bool ret = ncblit_rgba (data, linesize, vopts) < 0; return error_guard_cond (ret, ret); } int qrcode (ncblitter_e blitter, int* ymax, int* xmax, const void *data, size_t len) const NOEXCEPT_MAYBE { int ret = ncplane_qrcode (plane, blitter, ymax, xmax, data, len); return error_guard_cond (ret, ret < 0); } bool is_fg_default () const noexcept { return ncplane_fg_default_p (plane); } bool is_bg_default () const noexcept { return ncplane_bg_default_p (plane); } bool is_valid () const noexcept { return plane != nullptr; } protected: explicit Plane (ncplane *_plane, bool _is_stdplane) : Root (nullptr), plane (_plane), is_stdplane (_is_stdplane) { if (_plane == nullptr) throw invalid_argument ("_plane must be a valid pointer"); } void release_native_plane () noexcept { if (plane == nullptr) return; unmap_plane (this); plane = nullptr; } static void unmap_plane (Plane *p) noexcept; private: ncplane* create_plane (const Plane &n, int rows, int cols, int yoff, int xoff, void *opaque) { ncplane *ret = ncplane_new ( n.plane, rows, cols, yoff, xoff, opaque, nullptr ); if (ret == nullptr) throw init_error ("Notcurses failed to create a new plane"); map_plane (plane, this); return ret; } ncplane* create_plane (Plane &n, int rows, int cols, int yoff, NCAlign align, void *opaque) { ncplane_options nopts = { yoff, { static_cast(align) }, rows, cols, opaque, nullptr, nullptr, 0 }; ncplane *ret = ncplane_create ( n.plane, &nopts ); if (ret == nullptr) throw init_error ("Notcurses failed to create an aligned plane"); map_plane (plane, this); return ret; } ncplane* duplicate_plane (const Plane &other, void *opaque) { ncplane *ret = ncplane_dup (other.plane, opaque); if (ret == nullptr) throw init_error ("Notcurses failed to duplicate plane"); return ret; } private: ncplane *plane = nullptr; bool is_stdplane = false; static std::map *plane_map; static std::mutex plane_map_mutex; friend class NotCurses; friend class NcReel; friend class Tablet; friend class Widget; template friend class PlotBase; }; } #endif