terminal.hpp

Go to the documentation of this file.

// 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.
#ifndef FTXUI_SCREEN_TERMINAL_HPP
#define FTXUI_SCREEN_TERMINAL_HPP
 
#include <cstdint>
 
#include <memory>
#include <string_view>
#include <vector>
 
#include "ftxui/util/export.hpp"
 
namespace ftxui {
 
/// @brief Dimensions es una estructura que representa el tamaño de la terminal
/// @ingroup screen
struct FTXUI_EXPORT(SCREEN) Dimensions {
  int dimx;
  int dimy;
};
 
namespace Terminal {
FTXUI_EXPORT(SCREEN) Dimensions Size();
FTXUI_EXPORT(SCREEN) void SetFallbackSize(const Dimensions& fallbackSize);
 
/// @brief Color es una enumeración que representa el soporte de color de la
/// terminal.
/// @ingroup screen
enum Color : uint8_t {
  Palette1,
  Palette16,
  Palette256,
  TrueColor,
};
FTXUI_EXPORT(SCREEN) Color ColorSupport();
FTXUI_EXPORT(SCREEN) void SetColorSupport(Color color);
 
/// @brief Quirks es una estructura que representa varios comportamientos
/// específicos de la terminal que pueden requerir alternativas.
/// @ingroup screen
class FTXUI_EXPORT(SCREEN) Quirks {
 public:
  Quirks();
  ~Quirks();
  Quirks(const Quirks&);
  Quirks& operator=(const Quirks&);
  Quirks(Quirks&&) noexcept;
  Quirks& operator=(Quirks&&) noexcept;
 
  /// @brief Si la fuente de la terminal admite los 8 caracteres de bloque Unicode.
  bool BlockCharacters() const;
  void SetBlockCharacters(bool v);
 
  /// @brief Si la terminal maneja correctamente ocultar el cursor.
  bool CursorHiding() const;
  void SetCursorHiding(bool v);
 
  /// @brief Si la terminal debe usar caracteres ASCII para los componentes.
  bool ComponentAscii() const;
  void SetComponentAscii(bool v);
 
  /// @brief El nivel de soporte de color de la terminal.
  Color ColorSupport() const;
  void SetColorSupport(Color v);
 
 private:
  struct Impl;
  std::unique_ptr<Impl> impl_;
};
FTXUI_EXPORT(SCREEN) Quirks GetQuirks();
FTXUI_EXPORT(SCREEN) void SetQuirks(const Quirks& quirks);
 
/// @brief TerminalInfo es una estructura que contiene información sobre la
/// terminal.
/// @ingroup screen
class FTXUI_EXPORT(SCREEN) TerminalInfo {
 public:
  TerminalInfo();
  ~TerminalInfo();
  TerminalInfo(const TerminalInfo&) = delete;
  TerminalInfo& operator=(const TerminalInfo&) = delete;
  TerminalInfo(TerminalInfo&&) noexcept;
  TerminalInfo& operator=(TerminalInfo&&) noexcept;
 
  void SetTerm(std::string_view term);
  void SetColorterm(std::string_view colorterm);
  void SetTermProgram(std::string_view term_program);
  void SetTerminalName(std::string_view terminal_name);
  void SetTerminalEmulatorName(std::string_view terminal_emulator_name);
  void SetCapabilities(std::vector<int> capabilities);
 
  Color ComputeColorSupport() const;
 
 private:
  struct Impl;
  std::unique_ptr<Impl> impl_;
};
 
/// @brief Calcula el soporte de color según variables de entorno e
/// identificación de la terminal.
/// @param term La variable de entorno TERM.
/// @param colorterm La variable de entorno COLORTERM.
/// @param term_program La variable de entorno TERM_PROGRAM.
/// @param terminal_name El nombre de la terminal (de DA2).
/// @param terminal_emulator_name El nombre del emulador de terminal (de XTVERSION).
/// @param capabilities Las capacidades de la terminal (de DA1).
FTXUI_EXPORT(SCREEN)
Color ComputeColorSupport(std::string_view term,
                          std::string_view colorterm,
                          std::string_view term_program,
                          std::string_view terminal_name,
                          std::string_view terminal_emulator_name,
                          const std::vector<int>& capabilities);
 
}  // namespace Terminal
 
}  // namespace ftxui
 
#endif  // FTXUI_SCREEN_TERMINAL_HPP