FTXUI/src/ftxui/dom/separator.cpp
ArthurSonzogni 6dd626a79a Fix: Add separator(Pixel) back.
It was removed by mistacke previously.
Take the opportunity to create new documentation.
2021-10-03 10:45:47 +02:00

244 lines
4.6 KiB
C++

#include <memory> // for make_shared
#include <string> // for string
#include "ftxui/dom/elements.hpp" // for Element, separator
#include "ftxui/dom/node.hpp" // for Node
#include "ftxui/dom/requirement.hpp" // for Requirement
#include "ftxui/screen/box.hpp" // for Box
#include "ftxui/screen/screen.hpp" // for Pixel, Screen
namespace ftxui {
using ftxui::Screen;
const std::string charset[][2] = {
{"", ""},
{"", ""},
{"", ""},
{"", ""},
};
class Separator : public Node {
public:
Separator(BorderStyle style) : style_(style) {}
void ComputeRequirement() override {
requirement_.min_x = 1;
requirement_.min_y = 1;
}
void Render(Screen& screen) override {
bool is_column = (box_.x_max == box_.x_min);
bool is_line = (box_.y_min == box_.y_max);
const std::string c = charset[style_][is_line && !is_column];
for (int y = box_.y_min; y <= box_.y_max; ++y) {
for (int x = box_.x_min; x <= box_.x_max; ++x) {
screen.PixelAt(x, y).character = c;
}
}
}
BorderStyle style_;
};
class SeparatorWithPixel : public Separator {
public:
SeparatorWithPixel(Pixel pixel) : Separator(LIGHT), pixel_(pixel) {}
void Render(Screen& screen) override {
for (int y = box_.y_min; y <= box_.y_max; ++y) {
for (int x = box_.x_min; x <= box_.x_max; ++x) {
screen.PixelAt(x, y) = pixel_;
}
}
}
private:
Pixel pixel_;
};
/// @brief Draw a vertical or horizontal separator in between two elements.
/// @ingroup dom
/// @see separator
/// @see separatorLight
/// @see separatorHeavy
/// @see separatorDouble
/// @see separatorStyled
///
/// ### Example
///
/// ```cpp
/// Element document = vbox({
/// text("Up"),
/// separator(),
/// text("Down"),
/// })
/// ```
///
/// ### Output
///
/// ```bash
/// Up
/// ────
/// Down
/// ```
Element separator() {
return std::make_shared<Separator>(LIGHT);
}
/// @brief Draw a vertical or horizontal separator in between two elements.
/// @ingroup dom
/// @see separator
/// @see separatorLight
/// @see separatorHeavy
/// @see separatorDouble
/// @see separatorStyled
///
/// ### Example
///
/// ```cpp
/// Element document = vbox({
/// text("Up"),
/// separatorStyled(BorderStyle::LIGHT),
/// text("Down"),
/// })
/// ```
///
/// ### Output
///
/// ```bash
/// Up
/// ────
/// Down
/// ```
Element separatorStyled(BorderStyle style) {
return std::make_shared<Separator>(style);
}
/// @brief Draw a vertical or horizontal light separator in between two
/// elements.
/// @ingroup dom
/// @see separator
/// @see separatorLight
/// @see separatorHeavy
/// @see separatorDouble
/// @see separatorStyled
///
/// ### Example
///
/// ```cpp
/// Element document = vbox({
/// text("Up"),
/// separatorLight(),
/// text("Down"),
/// })
/// ```
///
/// ### Output
///
/// ```bash
/// Up
/// ────
/// Down
/// ```
Element separatorLight() {
return std::make_shared<Separator>(LIGHT);
}
/// @brief Draw a vertical or horizontal heavy separator in between two
/// elements.
/// @ingroup dom
/// @see separator
/// @see separatorLight
/// @see separatorHeavy
/// @see separatorDouble
/// @see separatorStyled
///
/// ### Example
///
/// ```cpp
/// Element document = vbox({
/// text("Up"),
/// separatorHeavy(),
/// text("Down"),
/// })
/// ```
///
/// ### Output
///
/// ```bash
/// Up
/// ━━━━
/// Down
/// ```
Element separatorHeavy() {
return std::make_shared<Separator>(HEAVY);
}
/// @brief Draw a vertical or horizontal double separator in between two
/// elements.
/// @ingroup dom
/// @see separator
/// @see separatorLight
/// @see separatorHeavy
/// @see separatorDouble
/// @see separatorStyled
///
/// ### Example
///
/// ```cpp
/// Element document = vbox({
/// text("Up"),
/// separatorDouble(),
/// text("Down"),
/// })
/// ```
///
/// ### Output
///
/// ```bash
/// Up
/// ════
/// Down
/// ```
Element separatorDouble() {
return std::make_shared<Separator>(DOUBLE);
}
/// @brief Draw a separator in between two element filled with a given pixel.
/// @ingroup dom
/// @see separator
/// @see separatorLight
/// @see separatorHeavy
/// @see separatorDouble
/// @see separatorStyled
///
/// ### Example
///
/// ```cpp
/// Pixel empty;
/// Element document = vbox({
/// text("Up"),
/// separator(empty),
/// text("Down"),
/// })
/// ```
///
/// ### Output
///
/// ```bash
/// Up
///
/// Down
/// ```
Element separator(Pixel pixel) {
return std::make_shared<SeparatorWithPixel>(pixel);
}
} // namespace ftxui
// 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.