layout_helpers.h

Go to the documentation of this file.

#ifndef YAZE_APP_GUI_LAYOUT_HELPERS_H
#define YAZE_APP_GUI_LAYOUT_HELPERS_H
 
#include <string>
#include <vector>
 
#include "absl/strings/str_format.h"
#include "absl/strings/string_view.h"
#include "app/gui/core/theme_manager.h"
#include "imgui/imgui.h"
 
namespace yaze {
namespace gui {
 
class LayoutHelpers {
 public:
  struct SafeAreaInsets {
    float left = 0.0f;
    float right = 0.0f;
    float top = 0.0f;
    float bottom = 0.0f;
  };
 
  struct WindowClampResult {
    ImVec2 pos{};
    bool clamped = false;
  };
 
  // Core sizing functions (respect theme compact_factor + multipliers)
  static float GetStandardWidgetHeight();
  static float GetStandardSpacing();
  static float GetToolbarHeight();
  static float GetPanelPadding();
  static float GetStandardInputWidth();
  static float GetHexInputWidth();
  static float GetComboWidth();
  static float GetSliderWidth();
  static float GetCompactInputWidth();
  static float GetButtonPadding();
  static float GetTableRowHeight();
  static float GetCanvasToolbarHeight();
 
  // Layout utilities
  static void BeginPaddedPanel(const char* label, float padding = -1.0f);
  static void EndPaddedPanel();
 
  // Call EndTableWithTheming() only when BeginTableWithTheming() returns
  // true, the same rule as ImGui::BeginTable(). On false the theme pushes
  // are already undone.
  static bool BeginTableWithTheming(const char* str_id, int columns,
                                    ImGuiTableFlags flags = 0,
                                    const ImVec2& outer_size = ImVec2(0, 0),
                                    float inner_width = 0.0f);
  static void EndTableWithTheming();
 
  static void BeginCanvasPanel(const char* label,
                               ImVec2* canvas_size = nullptr);
  static void EndCanvasPanel();
 
  // Content child with minimum size (fill available, never smaller than min_size)
  static bool BeginContentChild(const char* id, const ImVec2& min_size,
                                bool border = false,
                                ImGuiWindowFlags flags = 0);
  static void EndContentChild() { ImGui::EndChild(); }
 
  // Input field helpers
  static bool AutoSizedInputField(const char* label, char* buf, size_t buf_size,
                                  ImGuiInputTextFlags flags = 0);
  static bool AutoSizedInputInt(const char* label, int* v, int step = 1,
                                int step_fast = 100,
                                ImGuiInputTextFlags flags = 0);
  static bool AutoSizedInputFloat(const char* label, float* v,
                                  float step = 0.0f, float step_fast = 0.0f,
                                  const char* format = "%.3f",
                                  ImGuiInputTextFlags flags = 0);
 
  // Input preset functions for common patterns
  static bool InputHexRow(const char* label, uint8_t* data);
  static bool InputHexRow(const char* label, uint16_t* data);
  static bool InputToolbarField(const char* label, char* buf, size_t buf_size);
 
  // Toolbar helpers
  static void BeginToolbar(const char* label);
  static void EndToolbar();
  static void ToolbarSeparator();
  static bool ToolbarButton(const char* label,
                            const ImVec2& size = ImVec2(0, 0));
 
  // Common layout patterns
  static void PropertyRow(const char* label,
                          std::function<void()> widget_callback);
  static void SectionHeader(const char* label);
  static void HelpMarker(const char* desc);
 
  // Platform/layout helpers
  static SafeAreaInsets GetSafeAreaInsets();
  static float GetTopInset();
  static bool IsTouchDevice();
 
  // Touch-aware sizing (Apple HIG 44pt minimum)
  static float GetMinTouchTarget();
  static float GetTouchSafeWidgetHeight();
 
  // Clamp a window position so at least min_visible pixels remain within rect.
  static WindowClampResult ClampWindowToRect(const ImVec2& pos,
                                             const ImVec2& size,
                                             const ImVec2& rect_pos,
                                             const ImVec2& rect_size,
                                             float min_visible = 32.0f);
 
  // Get current theme
  static const Theme& GetTheme() {
    return ThemeManager::Get().GetCurrentTheme();
  }
 
 private:
  static float GetBaseFontSize() { return ImGui::GetFontSize(); }
  static float ApplyCompactFactor(float base_value) {
    return base_value * GetTheme().compact_factor;
  }
};
 
// Returns "text###stable_id" for ImGui::TableSetupColumn(). ImGui matches
// saved column width, order and visibility by the label's ID, and only the
// part after "###" goes into that ID. Use this when `text` is translated
// (tr()), so a language change keeps the saved column settings. The header
// still shows only `text`.
std::string ColumnLabel(absl::string_view text, absl::string_view stable_id);
 
}  // namespace gui
}  // namespace yaze
 
#endif  // YAZE_APP_GUI_LAYOUT_HELPERS_H