Illustrated C/C++ source sheets, symbol index, API relationship graph, compiler console and debug trace

LIVE AI / FLEXIBLE SENSING / FLIGHT CONTEXT

Sensoraia API

Live AI and sensing, connected to the flight.
See, listen, inspect and return supported results while airborne.

Loading...
Searching...
No Matches
loom_camera_backend.h
Go to the documentation of this file.
1/*
2 * Copyright 2026 OpenUAS
3 * SPDX-License-Identifier: Apache-2.0
4 *
5 * Licensed under the Apache License, Version 2.0 (the "License");
6 * you may not use this file except in compliance with the License.
7 * You may obtain a copy of the License at
8 *
9 * http://www.apache.org/licenses/LICENSE-2.0
10 *
11 * Unless required by applicable law or agreed to in writing, software
12 * distributed under the License is distributed on an "AS IS" BASIS,
13 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 * See the License for the specific language governing permissions and
15 * limitations under the License.
16 */
17
18/**
19 * @file loom_camera_backend.h
20 * @brief LOOM-owned capture specialization and stream lifecycle. */
21#ifndef USHER_LOOM_CAMERA_BACKEND_H
22#define USHER_LOOM_CAMERA_BACKEND_H
23
24#include "camera_backend.h"
25
26/** @name LOOM deployment defaults shared with CLI wiring
27 * @{ */
28#ifndef USHER_LOOMCAM_COMMAND
29 /** @brief Native LOOM capture/saved-photo executable beside the deployed tools. */
30 #define USHER_LOOMCAM_COMMAND "./bin/loomcam"
31#endif
32#ifndef USHER_LOOMCAM_MODEL
33 /** @brief Expected RPK path; the framework does not fabricate a trained model. */
34 #define USHER_LOOMCAM_MODEL "models/ai_cam/nn_loom_v001.rpk"
35#endif
36#ifndef USHER_LOOMCAM_REFERENCE_DIR
37 /** @brief Default outbound archive; use independent reference storage per sortie. */
38 #define USHER_LOOMCAM_REFERENCE_DIR "photos/loom-reference"
39#endif
40/** @} */
41
42/**
43 * @brief Configure the LOOM plugin before selecting or initializing its owner.
44 * @param references Borrowed reference-directory path, valid until initialization.
45 * @param model Borrowed RPK path, valid for the capture backend lifetime.
46 * @pre No LOOM owner is active while configuration changes.
47 * @details Saved-photo worker initialization copies its paths; native capture
48 * continues borrowing the model until shutdown. Do not shorten that lifetime
49 * merely because the matcher has already started.
50 */
51void loom_camera_backend_configure(const char *references, const char *model);
52
53/**
54 * @brief Return LOOM's descriptor without opening a sensor or starting a thread.
55 * @param mock True for saved/mock pixels rather than the native capture owner.
56 * @return Immutable hook lifetimes with LOOM-owned naming and point semantics.
57 * @details Native LOOM advertises image capture and finish ownership, never object
58 * detection. Frame timing remains on the common capture path; matching has its
59 * own saved-photo stream lifecycle and cannot acquire the sensor again.
60 */
62/** @brief Choose one LOOM assignment before acquiring either worker.
63 * @param settings Borrowed nonempty settings path, alive until capture and analysis have stopped.
64 * @return Zero if accepted; minus one when invalid or workers already own configuration. */
65int loom_camera_backend_set_settings(const char *settings);
66
67#endif
Shared capability and lifecycle contract for USHER camera backends.
struct camera_backend loom_camera_backend_get(bool mock)
Return LOOM's descriptor without opening a sensor or starting a thread.
void loom_camera_backend_configure(const char *references, const char *model)
Configure the LOOM plugin before selecting or initializing its owner.
int loom_camera_backend_set_settings(const char *settings)
Choose one LOOM assignment before acquiring either worker.
Function table describing one backend's owned camera operations.
struct camera_backend::@243120217343377347337244154071360217343172026241 mock