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_profile.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_profile.h
20 * @brief Public C API for reading PANGEA camera calibration profiles.
21 * @details The file binds measured intrinsics and mount angles to a camera
22 * filename prefix so mapping geometry is never guessed from a backend ID.
23 */
24#ifndef USHER_CAMERA_PROFILE_H
25#define USHER_CAMERA_PROFILE_H
26
27#include <stdbool.h>
28#include "coverage_scheduler.h"
29
30#define CAMERA_PROFILE_MAX_BYTES 1024
31
32#ifdef __cplusplus
33extern "C" {
34#endif
35
36/**
37 * @brief One measured camera calibration loaded from the flat PANGEA profile format.
38 * @details Intrinsics use pixels, mount angles use degrees, and the filename
39 * prefix is a NUL-terminated discriminator owned by this structure.
40 */
46
47/**
48 * @brief Read a bounded PANGEA_CAMERA_V1 key=value calibration file.
49 * @param[in] filename Profile path; comments and blank lines are allowed.
50 * @param[out] profile Receives parsed geometry and filename prefix; unchanged on failure.
51 * @return True only when all required fields are present and valid.
52 * @details No heap allocation is performed. Duplicate and unknown keys are
53 * rejected so a typo cannot silently select a different camera calibration.
54 * A valid mapping prefix may have no USHER camera ID (reported as zero);
55 * consumers also check that the calibration satisfies their geometry constraints.
56 */
57bool usher_camera_profile_read(const char *filename, struct usher_camera_profile *profile);
58
59#ifdef __cplusplus
60}
61#endif
62
63#endif
bool usher_camera_profile_read(const char *filename, struct usher_camera_profile *profile)
Read a bounded PANGEA_CAMERA_V1 key=value calibration file.
Fixed-memory geometric coverage accounting, independent of camera I/O.
static struct usher_camera_profile profile
Measured pinhole calibration for the delivered image, including its mount.
One measured camera calibration loaded from the flat PANGEA profile format.
struct coverage_camera calibration