mirror of
https://github.com/ArthurSonzogni/FTXUI.git
synced 2024-11-26 04:31:34 +08:00
0acfd8f255
It can be used to give developers a better control on the loop. Users can use it not to take full control of the thread, and poll FTXUI from time to time as part of an external loop. This resolves: https://github.com/ArthurSonzogni/FTXUI/issues/474
121 lines
3.3 KiB
C++
121 lines
3.3 KiB
C++
#ifndef FTXUI_COMPONENT_SCREEN_INTERACTIVE_HPP
|
|
#define FTXUI_COMPONENT_SCREEN_INTERACTIVE_HPP
|
|
|
|
#include <atomic> // for atomic
|
|
#include <ftxui/component/receiver.hpp> // for Receiver, Sender
|
|
#include <functional> // for function
|
|
#include <memory> // for shared_ptr
|
|
#include <string> // for string
|
|
#include <thread> // for thread
|
|
#include <variant> // for variant
|
|
|
|
#include "ftxui/component/animation.hpp" // for TimePoint
|
|
#include "ftxui/component/captured_mouse.hpp" // for CapturedMouse
|
|
#include "ftxui/component/event.hpp" // for Event
|
|
#include "ftxui/component/task.hpp" // for Task, Closure
|
|
#include "ftxui/screen/screen.hpp" // for Screen
|
|
|
|
namespace ftxui {
|
|
class ComponentBase;
|
|
class Loop;
|
|
struct Event;
|
|
|
|
using Component = std::shared_ptr<ComponentBase>;
|
|
class ScreenInteractivePrivate;
|
|
|
|
class ScreenInteractive : public Screen {
|
|
public:
|
|
// Constructors:
|
|
static ScreenInteractive FixedSize(int dimx, int dimy);
|
|
static ScreenInteractive Fullscreen();
|
|
static ScreenInteractive FitComponent();
|
|
static ScreenInteractive TerminalOutput();
|
|
|
|
// Return the currently active screen, nullptr if none.
|
|
static ScreenInteractive* Active();
|
|
|
|
// Start/Stop the main loop.
|
|
void Loop(Component);
|
|
void Exit();
|
|
Closure ExitLoopClosure();
|
|
|
|
// Post tasks to be executed by the loop.
|
|
void Post(Task task);
|
|
void PostEvent(Event event);
|
|
void RequestAnimationFrame();
|
|
|
|
CapturedMouse CaptureMouse();
|
|
|
|
// Decorate a function. The outputted one will execute similarly to the
|
|
// inputted one, but with the currently active screen terminal hooks
|
|
// temporarily uninstalled.
|
|
Closure WithRestoredIO(Closure);
|
|
|
|
private:
|
|
void Install();
|
|
void Uninstall();
|
|
|
|
void PreMain();
|
|
void PostMain();
|
|
|
|
bool HasQuitted();
|
|
void RunOnce(Component component);
|
|
void RunOnceBlocking(Component component);
|
|
|
|
void HandleTask(Component component, Task& task);
|
|
void Draw(Component component);
|
|
|
|
void SigStop();
|
|
|
|
ScreenInteractive* suspended_screen_ = nullptr;
|
|
enum class Dimension {
|
|
FitComponent,
|
|
Fixed,
|
|
Fullscreen,
|
|
TerminalOutput,
|
|
};
|
|
Dimension dimension_ = Dimension::Fixed;
|
|
bool use_alternative_screen_ = false;
|
|
ScreenInteractive(int dimx,
|
|
int dimy,
|
|
Dimension dimension,
|
|
bool use_alternative_screen);
|
|
|
|
Sender<Task> task_sender_;
|
|
Receiver<Task> task_receiver_;
|
|
|
|
std::string set_cursor_position;
|
|
std::string reset_cursor_position;
|
|
|
|
std::atomic<bool> quit_ = false;
|
|
std::thread event_listener_;
|
|
std::thread animation_listener_;
|
|
bool animation_requested_ = false;
|
|
animation::TimePoint previous_animation_time_;
|
|
|
|
int cursor_x_ = 1;
|
|
int cursor_y_ = 1;
|
|
|
|
bool mouse_captured = false;
|
|
bool previous_frame_resized_ = false;
|
|
|
|
bool frame_valid_ = false;
|
|
|
|
friend class Loop;
|
|
|
|
public:
|
|
class Private {
|
|
public:
|
|
static void SigStop(ScreenInteractive& s) { return s.SigStop(); }
|
|
};
|
|
friend Private;
|
|
};
|
|
|
|
} // namespace ftxui
|
|
|
|
#endif /* end of include guard: FTXUI_COMPONENT_SCREEN_INTERACTIVE_HPP */
|
|
|
|
// Copyright 2020 Arthur Sonzogni. All rights reserved.
|
|
// Use of this source code is governed by the MIT license that can be found in
|
|
// the LICENSE file.
|