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
camera_backend_registry.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 camera_backend_registry.h
20 * @brief Backend definitions and physical-camera routing. */
21#ifndef USHER_CAMERA_BACKEND_REGISTRY_H
22#define USHER_CAMERA_BACKEND_REGISTRY_H
23
24#include "camera_backend.h"
25
26/** Logical profiles are independent of stable protocol camera IDs. */
39
40/**
41 * @brief Return a descriptor without selecting, configuring or opening hardware.
42 * @param type Logical backend profile, not a protocol camera ID.
43 * @param mock Select a plugin's simulation-safe variant where applicable.
44 * @return Descriptor with stable hook lifetimes; zero for absent/invalid profiles.
45 */
47/**
48 * @brief Resolve a physical ID, preferring its configured logical profile.
49 * @param camera_id Stable protocol identity; unsupported IDs are rejected.
50 * @param preferred Configured profile, used only for its own physical camera.
51 * @param local_only Replace image acquisition with the generic local driver.
52 * @return Profile to acquire, or CAMERA_BACKEND_UNSELECTED if unavailable.
53 * @details Identity is resolved separately so local acquisition never erases
54 * the requested sensor's naming, geometry or metadata policy.
55 */
57 bool local_only);
58/**
59 * @brief Resolve naming/metadata identity from the profile used for acquisition.
60 * @param camera_id Stable protocol identity to describe.
61 * @param preferred Configured logical profile, including specialized AIcam users.
62 * @param mock Select the profile's mock-safe hooks without changing its identity.
63 * @return Side-effect-free descriptor; unavailable IDs return a zero descriptor.
64 */
66 bool mock);
67
68#endif
Shared capability and lifecycle contract for USHER camera backends.
struct camera_backend camera_backend_registry_identity(int camera_id, enum camera_backend_type preferred, bool mock)
Resolve naming/metadata identity from the profile used for acquisition.
struct camera_backend camera_backend_registry_get(enum camera_backend_type type, bool mock)
Return a descriptor without selecting, configuring or opening hardware.
@ CAMERA_BACKEND_LOCAL
@ CAMERA_BACKEND_CHDK
@ CAMERA_BACKEND_COUNT
@ CAMERA_BACKEND_AI_CAM
@ CAMERA_BACKEND_UNSELECTED
@ CAMERA_BACKEND_LOOM_CAM
@ CAMERA_BACKEND_LWIR_CAM
@ CAMERA_BACKEND_DIPLA_CAM
@ CAMERA_BACKEND_SPOTTER_CAM
@ CAMERA_BACKEND_EAR_CAM
enum camera_backend_type camera_backend_registry_route(int camera_id, enum camera_backend_type preferred, bool local_only)
Resolve a physical ID, preferring its configured logical profile.
Function table describing one backend's owned camera operations.
struct camera_backend::@243120217343377347337244154071360217343172026241 mock