dom/util.cpp

Aller à la documentation de ce fichier.

// Copyright 2020 Arthur Sonzogni. Tous droits réservés.
// L'utilisation de ce code source est régie par la licence MIT que l'on peut trouver dans
// le fichier LICENSE.
#include <algorithm>   // for min
#include <functional>  // for function
#include <memory>      // for __shared_ptr_access, make_unique
#include <utility>     // for move
 
#include "ftxui/dom/elements.hpp"  // for Element, Decorator, Elements, operator|, Fit, emptyElement, nothing, operator|=
#include "ftxui/dom/node.hpp"      // for Node, Node::Status
#include "ftxui/dom/requirement.hpp"  // for Requirement
#include "ftxui/screen/box.hpp"       // for Box
#include "ftxui/screen/screen.hpp"    // for Full
#include "ftxui/screen/terminal.hpp"  // for Dimensions
 
namespace ftxui {
 
namespace {
Decorator compose(Decorator a, Decorator b) {
  return [a = std::move(a), b = std::move(b)](Element element) {
    return b(a(std::move(element)));
  };
}
}  // namespace
 
/// @brief Une décoration qui ne fait absolument rien.
/// @ingroup dom
Element nothing(Element element) {
  return element;
}
 
/// @brief Compose deux décorateurs en un seul.
///
/// ### Exemple
///
/// ```cpp
/// auto decorator = bold | blink;
/// ```
Decorator operator|(Decorator a, Decorator b) {
  return compose(std::move(a),  //
                 std::move(b));
}
 
/// À partir d'un ensemble d'éléments, appliquer un décorateur à tous les éléments.
/// @return l'ensemble des éléments décorés.
/// @ingroup dom
Elements operator|(Elements elements, Decorator decorator) {  // NOLINT
  Elements output;
  output.reserve(elements.size());
  for (auto& it : elements) {
    output.push_back(std::move(it) | decorator);
  }
  return output;
}
 
/// @brief À partir d'un élément, appliquer un décorateur.
/// @return l'élément décoré.
///
/// ### Exemple
///
/// Les deux sont équivalents :
Element operator|(Element element, Decorator decorator) {  // NOLINT
  return decorator(std::move(element));
}
 
/// @brief Applique un décorateur à un élément.
/// @return l'élément décoré.
/// @ingroup dom
///
/// ### Exemple
///
/// Les deux sont équivalents :
/// ```cpp
/// auto element = text("Hello");
/// element |= bold;
/// ```
Element& operator|=(Element& e, Decorator d) {
  e = e | std::move(d);
  return e;
}
 
/// La dimension minimale qui correspondra à l'élément donné.
/// @see Fixed
/// @see Full
Dimensions Dimension::Fit(Element& e, bool extend_beyond_screen) {
  const Dimensions fullsize = Dimension::Full();
  Box box;
  box.x_min = 0;
  box.y_min = 0;
  box.x_max = fullsize.dimx;
  box.y_max = fullsize.dimy;
 
  Node::Status status;
  e->Check(&status);
  const int max_iteration = 20;
  while (status.need_iteration && status.iteration < max_iteration) {
    e->ComputeRequirement();
 
    // Don't give the element more space than it needs:
    box.x_max = std::min(box.x_max, e->requirement().min_x);
    box.y_max = e->requirement().min_y;
    if (!extend_beyond_screen) {
      box.y_max = std::min(box.y_max, fullsize.dimy);
    }
 
    e->SetBox(box);
    status.need_iteration = false;
    status.iteration++;
    e->Check(&status);
 
    if (!status.need_iteration) {
      break;
    }
    // Increase the size of the box until it fits...
    box.x_max = std::min(e->requirement().min_x, fullsize.dimx);
    box.y_max = e->requirement().min_y;
 
    // ... but don't go beyond the screen size:
    if (!extend_beyond_screen) {
      box.y_max = std::min(box.y_max, fullsize.dimy);
    }
  }
 
  return {
      box.x_max,
      box.y_max,
  };
}
 
/// Un élément de taille 0x0 ne dessinant rien.
/// @ingroup dom
Element emptyElement() {
  class Impl : public Node {
    void ComputeRequirement() override {
      requirement_.min_x = 0;
      requirement_.min_y = 0;
    }
  };
  return std::make_unique<Impl>();
}
 
}  // namespace ftxui