callout_box.hpp

Go to the documentation of this file.

#pragma once

 
#include <pulp/canvas/canvas.hpp>
#include <pulp/view/geometry.hpp>
#include <pulp/view/view.hpp>
 
#include <functional>
#include <memory>
 
namespace pulp::view {

enum class CalloutSide { above, below, left_of, right_of };

CalloutSide opposite_side(CalloutSide s);

struct CalloutStyle {
    float arrow_length = 10.0f;   
    float arrow_width = 18.0f;    
    float margin = 8.0f;          
    float gap = 0.0f;             
    float corner_radius = 8.0f;   
};

struct CalloutPlacement {
    Rect body{};                  
    CalloutSide side = CalloutSide::below;  
    float arrow_tip_x = 0.0f;     
    float arrow_tip_y = 0.0f;
    float arrow_base_x = 0.0f;    
    float arrow_base_y = 0.0f;
};

CalloutPlacement place_callout(const Rect& anchor, float body_w, float body_h,
                               const Rect& window, CalloutSide preferred,
                               const CalloutStyle& style = {});

class AnchoredCallout : public View {
public:
    AnchoredCallout() { set_focusable(true); }

    void set_anchor(Rect anchor) { anchor_ = anchor; }
    Rect anchor() const { return anchor_; }
 
    void set_preferred_side(CalloutSide s) { preferred_ = s; }
    CalloutSide preferred_side() const { return preferred_; }
 
    void set_style(CalloutStyle style) { style_ = style; }
    const CalloutStyle& style() const { return style_; }

    void set_content_size(float w, float h) { content_w_ = w; content_h_ = h; }

    void set_content(std::unique_ptr<View> content);
    View* content() const { return content_; }

    CalloutPlacement compute_placement(const Rect& window) const;

    std::function<void()> on_dismiss;

    static AnchoredCallout* show(View* root, Rect anchor, std::unique_ptr<View> content,
                            CalloutSide preferred = CalloutSide::below,
                            CalloutStyle style = {});
 
    void paint(canvas::Canvas& canvas) override;
    void layout_children() override;
 
private:
    Rect anchor_{};
    CalloutSide preferred_ = CalloutSide::below;
    CalloutStyle style_{};
    float content_w_ = 0.0f, content_h_ = 0.0f;
    View* content_ = nullptr;   
    static constexpr float kBodyPadding = 12.0f;
};
 
}  // namespace pulp::view