notcurses/include/ncpp/Reel.hh
Nick Black 162f9910c2
Tons of work on ncreel (#776)
Tons of work on ncreel (#627, #749, #694)
Improve reel demo: get input wired up once more, avoid the FPS demo at bottom, print pointer and line count in each tablet, use new ncreel API. Improve notcurses-ncreel explorer: kill memory leaks (#694), draw tablets better, use new ncreel API. Fix bug in ncreel core where cruft could be left on the screen, via a very gross brute force algorithm. I'll likely come back and make this a bit less ghastly in the future #749. Remove weird one-off input system from ncreel, residue from outcurses. Make some of the normalizing changes speced out in #627

* ncreel: give each tablet an index, and print it #749
* reel: eliminate FIXME + param to insert_tabler() #749
* ncreel: label tablets with their adress to correlate against debugging logs #749
* more terminal environment variable notes
* TERMS.md: add Sakura, st
* ncreel: move legend out of reel proper
* ncreel_options: dump min/max_supported_rows/cols #627
* ncreel: remove weird one-off input layer #627
* ncreel: add ncreel_offer_input()
* reel demo: call demo_getc()
* reel demo: rig up input to demo main
* ncreel: drop ncreel_del_focused(), properly bind tablets
* reel demo: don't free up necessary plane
* ncreel: don't pull absolute locations of tablets
* ncreel: place tablets correctly in boundrel
* reel demo: add back support for left/right
* reel demo: restore thread movement
* ncreel: remove a great deal of complexity
* reel demo: stay out of FPS graph's way
* ncreel: give each tablet an index, and print it #749
* reel: eliminate FIXME + param to insert_tabler() #749
* ncreel: label tablets with their adress to correlate against debugging logs #749
* ncreel: move legend out of reel proper
* ncreel_options: dump min/max_supported_rows/cols #627
* ncreel: remove weird one-off input layer #627
* ncreel: add ncreel_offer_input()
* reel demo: call demo_getc()
* reel demo: rig up input to demo main
* ncreel: drop ncreel_del_focused(), properly bind tablets
* reel demo: don't free up necessary plane
* ncreel: don't pull absolute locations of tablets
* ncreel: place tablets correctly in boundrel
* reel demo: add back support for left/right
* reel demo: restore thread movement
* ncreel: remove a great deal of complexity
* reel demo: stay out of FPS graph's way
* reel: tighten up reel following redraw
* reel: fix upper-left corner of topless perimeter
* ncreel: print linecount, return clipped value
* reel: draw focused tablet relative to reel
* reel: brute force decruftification, how embarrassing #749
2020-07-09 02:02:23 -04:00

144 lines
3.2 KiB
C++

#ifndef __NCPP_REEL_HH
#define __NCPP_REEL_HH
#include <memory>
#include <notcurses/notcurses.h>
#include "Tablet.hh"
#include "Plane.hh"
#include "Utilities.hh"
namespace ncpp
{
class NCPP_API_EXPORT NcReel : public Root
{
public:
static ncreel_options default_options;
explicit NcReel (Plane &plane, const ncreel_options *popts = nullptr)
: NcReel (static_cast<Plane const&>(plane), popts)
{}
explicit NcReel (Plane const&plane, const ncreel_options *popts = nullptr)
: Root (Utilities::get_notcurses_cpp (plane))
{
common_init (Utilities::to_ncplane (plane), popts);
}
explicit NcReel (Plane *plane, const ncreel_options *popts = nullptr)
: NcReel (static_cast<const Plane*>(plane), popts)
{}
explicit NcReel (const Plane *plane, const ncreel_options *popts = nullptr)
: Root (Utilities::get_notcurses_cpp (plane))
{
if (plane == nullptr)
throw invalid_argument ("'plane' must be a valid pointer");
common_init (Utilities::to_ncplane (plane), popts);
}
~NcReel ()
{
if (!is_notcurses_stopped ())
ncreel_destroy (reel);
}
operator ncreel* () const noexcept
{
return reel;
}
operator ncreel const* () const noexcept
{
return reel;
}
// TODO: add an overload using callback that takes NcTablet instance instead of struct tablet
NcTablet* add (NcTablet *after, NcTablet *before, tabletcb cb, void *opaque = nullptr) const
{
nctablet *t = ncreel_add (reel, get_tablet (after), get_tablet (before), cb, opaque);
if (t == nullptr)
throw init_error ("Notcurses failed to create a new tablet");
return NcTablet::map_tablet (t, get_notcurses_cpp ());
}
NcTablet* add (NcTablet &after, NcTablet &before, tabletcb cb, void *opaque = nullptr) const noexcept
{
return add (&after, &before, cb, opaque);
}
int get_tabletcount () const noexcept
{
return ncreel_tabletcount (reel);
}
bool del (NcTablet *t) const NOEXCEPT_MAYBE
{
return error_guard (ncreel_del (reel, get_tablet (t)), -1);
}
bool del (NcTablet &t) const NOEXCEPT_MAYBE
{
return del (&t);
}
bool redraw () const NOEXCEPT_MAYBE
{
return error_guard (ncreel_redraw (reel), -1);
}
NcTablet* get_focused () const noexcept
{
nctablet *t = ncreel_focused (reel);
if (t == nullptr)
return nullptr;
return NcTablet::map_tablet (t, get_notcurses_cpp ());
}
NcTablet* next () const noexcept
{
nctablet *t = ncreel_next (reel);
if (t == nullptr)
return nullptr;
return NcTablet::map_tablet (t, get_notcurses_cpp ());
}
NcTablet* prev () const noexcept
{
nctablet *t = ncreel_prev (reel);
if (t == nullptr)
return nullptr;
return NcTablet::map_tablet (t, get_notcurses_cpp ());
}
Plane* get_plane () const noexcept;
private:
nctablet* get_tablet (NcTablet *t) const noexcept
{
if (t == nullptr)
return nullptr;
return t->get_tablet ();
}
void common_init (ncplane *plane, const ncreel_options *popts = nullptr)
{
reel = ncreel_create (plane, popts == nullptr ? &default_options : popts);
if (reel == nullptr)
throw init_error ("Notcurses failed to create a new ncreel");
}
private:
ncreel *reel = nullptr;
friend class Plane;
};
}
#endif