sam3_prompt.hpp

Go to the documentation of this file.

// SPDX-FileCopyrightText: 2026 Povl Filip Sonne-Frederiksen
//
// SPDX-License-Identifier: GPL-3.0-or-later
//
// Backend-agnostic SAM3 prompt type shared between the vision library and
// the GUI layer. No OpenCV, no backend headers — only the standard library.
 
#pragma once
 
#include <array>
#include <string>
#include <string_view>
#include <utility>
#include <vector>
 
namespace reusex::vision {

using SegmentBox = std::pair<std::string, std::array<float, 4>>;

inline constexpr std::string_view kGeometryOnlyPromptText = "visual";

inline int sam3_label_value(bool by_prompt_index, int prompt_index,
                            int cache_id) noexcept {
  return by_prompt_index && prompt_index >= 0 ? prompt_index : cache_id;
}

using SegmentPoint = std::array<float, 2>;

struct Sam3Prompt {
  std::string text;
  std::vector<SegmentBox> boxes;
  std::vector<SegmentPoint> points;
  float confidence = -1.0f;
 
  explicit Sam3Prompt(std::string t, std::vector<SegmentBox> b = {},
                      float conf = -1.0f)
      : text(std::move(t)), boxes(std::move(b)), confidence(conf) {}
};
 
} // namespace reusex::vision