ImmediateUI.h

浏览该文件的文档.

#pragma once
 
#include <optional>
#include <string>
#include <vector>
 
#include "UI/Layout/LayoutTypes.h"
#include <DirectXMath.h>
 
namespace z8::ui {
class BaseNode;
class ButtonNode;
class Layout;
class MenuItemNode;
class MenuNode;
class SliderNode;
class TextInputNode;
class ToggleNode;
class ToolBarNode;
 
struct UIStyle {
  std::optional<float> Width;
  std::optional<float> Height;
  std::optional<float> MinWidth;
  std::optional<float> MinHeight;
  std::optional<float> FlexGrow;
  std::optional<float> FlexShrink;
  std::optional<float> Margin;
  std::optional<float> Padding;
  std::optional<DirectX::XMFLOAT4> Color;
  std::optional<DirectX::XMFLOAT4> BorderColor;
  std::optional<float> BorderWidth;
  std::optional<float> CornerRadius;
  std::optional<FlexDirection> Direction;
};
 
class ImmediateUI {
public:
  explicit ImmediateUI(Layout &layout);
 
  void BeginFrame();
  bool BeginMenu(const std::string &key, const std::string &text,
                 const UIStyle &style = {});
  bool Button(const std::string &key, const std::string &text,
              const UIStyle &style = {});
  bool BeginPanel(const std::string &key, const std::string &title,
                  const UIStyle &style = {});
  bool BeginToolBar(const std::string &key, const UIStyle &style = {});
  BaseNode *Terminal(const std::string &key,
                     const std::string &title = "Output Log",
                     const UIStyle &style = {});
  void EndMenu();
  void EndPanel();
  void EndToolBar();
  BaseNode *Image(const std::string &key, const std::string &source,
                  const UIStyle &style = {});
  bool MenuItem(const std::string &key, const std::string &text,
                const UIStyle &style = {});
  BaseNode *Rect(const std::string &key, const UIStyle &style = {});
  bool Slider(const std::string &key, float &value, float minimum = 0.0f,
              float maximum = 1.0f, const UIStyle &style = {});
  BaseNode *Scene(const std::string &key, const UIStyle &style = {});
  bool TextInput(const std::string &key, std::string &value,
                 const std::string &placeholder = "",
                 const UIStyle &style = {});
  bool Toggle(const std::string &key, const std::string &text, bool &value,
              const UIStyle &style = {});
  bool EndFrame();
 
  const std::string &LastError() const { return Error; }
 
private:
  struct Scope {
    BaseNode *Host;
    size_t NextChild;
  };
  Layout *TargetLayout;
  std::vector<Scope> ScopeStack;
  bool Changed = false;
  std::string Error;
 
  BaseNode *Acquire(const std::string &type, const std::string &key);
  static void ResetStyle(BaseNode &node, bool keepsInteractiveGeometry);
  static void ApplyStyle(BaseNode &node, const UIStyle &style);
  void CloseScope();
};
} // namespace z8::ui