press_reach.hpp

Go to the documentation of this file.

#pragma once


 
#include <pulp/view/view.hpp>
 
#include <optional>
#include <string>
#include <vector>
 
namespace pulp::view {

enum class PressChannel {
    click,
    context_menu,
};

const char* press_channel_name(PressChannel channel);

struct PressReach {
    View* hit = nullptr;
    View* handler = nullptr;
    Point local{};
};

PressReach reach_of_press(View& root, Point root_pt, PressChannel channel = PressChannel::click);

std::optional<Rect> rect_in_root(const View& view, View& root);

struct UnreachablePressTarget {
    View* view = nullptr;
    std::string id;
    Rect painted{};
    PressChannel channel = PressChannel::click;
    Point probe{};
    View* reached = nullptr;
    std::string reached_id;
    std::string reason;
};

struct PressReachAudit {
    int examined = 0;
    int skipped_offscreen = 0;
    int skipped_not_interactive = 0;
    int skipped_indeterminate = 0;
    std::vector<UnreachablePressTarget> unreachable;

    bool clean() const {
        return unreachable.empty();
    }
};

struct PressReachOptions {
    bool audit_click = true;
    bool audit_context_menu = true;
    float min_dimension = 0.0f;
};

PressReachAudit audit_press_reach(View& root, const PressReachOptions& options = {});

std::string format_press_reach_audit(const PressReachAudit& audit);
 
} // namespace pulp::view