reusex::vision::sam3::Sam3AssetOptions Struct Reference

Controls where the managed SAM3 model lives and how it is fetched. More...

#include <sam3_assets.hpp>

Collaboration diagram for reusex::vision::sam3::Sam3AssetOptions:

Public Attributes
std::filesystem::path	models_dir
	Base models directory.
std::string	manifest_url
	URL of the release manifest (JSON listing the ONNX bundle files + sha256).
bool	allow_download = true
	If true, missing ONNX may be downloaded.
bool	use_cuda = true
	Build engines for CUDA (true) or leave the ONNX in place for the CPU/ONNX runtime backend (false).
const std::atomic< bool > *	cancel = nullptr
	Optional cooperative-cancellation flag (not owned).

Detailed Description

Controls where the managed SAM3 model lives and how it is fetched.

Definition at line 51 of file sam3_assets.hpp.

Member Data Documentation

allow_download

bool reusex::vision::sam3::Sam3AssetOptions::allow_download = true

If true, missing ONNX may be downloaded.

If false, a missing bundle is a hard error (offline / air-gapped operation).

Definition at line 62 of file sam3_assets.hpp.

cancel

const std::atomic<bool>* reusex::vision::sam3::Sam3AssetOptions::cancel = nullptr

Optional cooperative-cancellation flag (not owned).

Checked between download chunks, between files and between engine builds; when it reads true, prepare_sam3_model() throws Sam3PrepCancelled. A single in-flight TensorRT buildSerializedNetwork call cannot be interrupted, so cancellation during a build takes effect once that engine finishes.

Definition at line 73 of file sam3_assets.hpp.

manifest_url

std::string reusex::vision::sam3::Sam3AssetOptions::manifest_url

URL of the release manifest (JSON listing the ONNX bundle files + sha256).

Empty → the built-in pinned default.

Definition at line 58 of file sam3_assets.hpp.

models_dir

std::filesystem::path reusex::vision::sam3::Sam3AssetOptions::models_dir

Base models directory.

Empty → resolve from REUSEX_MODELS_DIR or the XDG cache default.

Definition at line 54 of file sam3_assets.hpp.

use_cuda

bool reusex::vision::sam3::Sam3AssetOptions::use_cuda = true

Build engines for CUDA (true) or leave the ONNX in place for the CPU/ONNX runtime backend (false).

Definition at line 66 of file sam3_assets.hpp.

---

The documentation for this struct was generated from the following file:

• libs/reusex/include/vision/sam3/sam3_assets.hpp